Command-Line Arguments in C: Building Programs That Accept User Input
What is Command-Line Arguments in C: Building Programs That Accept User Input? In real-world systems, command-line utilities rarely rely on just one mechanism to receive instructions from the outside world. A production tool—such as curl,...
How do robust command-line programs parse option flags (`-v`, `--output`) and parameters using POSIX `getopt()` or custom parsers?
Explanation & In-Depth Details
<div class="code-card-actions">
<button type="button" class="btn-code-action copy-code-btn" onclick="copyCode(this)" title="Copy Code">
<i class="far fa-copy"></i>
</button>
<a href="/tools/c-compiler" target="_blank" class="btn-code-action run-code-btn" title="Run Online">
<i class="fas fa-play"></i>
</a>
</div>
<pre class="bg-[var(--sdm-bg,inherit)] dark:bg-[var(--shiki-dark-bg,var(--sdm-bg,inherit))] code-box" style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text; background: 0px 0px; --sdm-bg: transparent; --sdm-fg: inherit;"><code style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text;"> ┌────────────────────────────────────────────────────────┐ │ <span class="js-id">INPUT</span> <span class="js-id">SOURCE</span> <span class="js-id">PRECEDENCE</span> <span class="js-id">PIPELINE</span> │ └────────────────────────────────────────────────────────┘
[ <span class="js-id">Hardcoded</span> <span class="js-id">Defaults</span> ] ───► <span class="js-id">timeout</span><span class="js-op">=</span><span class="js-num">30</span><span class="js-op">,</span> <span class="js-id">retries</span><span class="js-op">=</span><span class="js-num">3</span><span class="js-op">,</span> <span class="js-id">port</span><span class="js-op">=</span><span class="js-num">8080</span> │ ▼ [ <span class="js-id">Config</span> <span class="js-id">File</span> <span class="js-op">/</span> <span class="js-id">Env</span> ] ───► <span class="js-id">Overrides</span> <span class="js-id">unassigned</span> <span class="js-id">defaults</span> │ ▼ [ <span class="js-id">CLI</span> <span class="js-id">Arguments</span> ] ───► <span class="js-id">Highest</span> <span class="js-id">precedence</span> <span class="js-op">(</span><span class="js-id">explicit</span> <span class="js-id">user</span> <span class="js-id">intent</span><span class="js-op">)</span> │ ▼ <span class="js-id">Missing</span> <span class="js-id">Required</span> <span class="js-id">Values</span><span class="js-op">?</span> ├── <span class="js-id">NO</span> ───────────────► <span class="js-id">Execute</span> <span class="js-id">business</span> <span class="js-id">logic</span> <span class="js-id">immediately</span> └── <span class="js-id">YES</span> ───────────────► <span class="js-id">Interactive</span> <span class="js-id">Mode</span> <span class="js-op">(-</span><span class="js-id">i</span><span class="js-op">)</span> <span class="js-id">Enabled</span><span class="js-op">?</span> ├── <span class="js-id">YES</span> ──► <span class="js-id">Prompt</span> <span class="js-id">with</span> <span class="js-id">validation</span> <span class="js-id">loops</span> └── <span class="js-id">NO</span> ──► <span class="js-id">Emit</span> <span class="js-id">error</span> <span class="js-op">+</span> <span class="js-id">usage</span> <span class="js-id">exit</span><span class="js-op">(</span><span class="js-num">1</span><span class="js-op">)</span></code></pre></div></div></div><hr class="my-6" data-streamdown="horizontal-rule" style="border-width: 1px 0px 0px; border-style: solid; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); height: 0px; margin-block: 1rem 0.75rem; --tw-space-y-reverse: 0; font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);"><h2 class="mt-6 mb-2 font-semibold text-2xl" data-streamdown="heading-2" dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 22.5px 0px 7.5px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-size: 1.125rem; line-height: 1.35; --tw-space-y-reverse: 0; letter-spacing: -0.105469px; --tw-font-weight: 600; margin-block: 1.25rem 0.75rem; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; background-color: rgb(18, 18, 22);">1. Non-Interactive Input: Command-Line Flags (<code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; letter-spacing: normal; padding: 0.1em 0.35em;">argc</code>, <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; letter-spacing: normal; padding: 0.1em 0.35em;">argv</code>)</h2><p dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);">Command-line parameters arrive as an array of null-terminated string pointers (<code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">char *argv[]</code>). Because all command-line arguments enter your program as raw text, every numerical value requires explicit lexical validation using <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">strtol()</code> or <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">strtod()</code>.</p><h3 class="mt-6 mb-2 font-semibold text-xl" data-streamdown="heading-3" dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 22.5px 0px 7.5px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-size: 1rem; line-height: 1.35; --tw-space-y-reverse: 0; letter-spacing: -0.075px; --tw-font-weight: 600; margin-block: 1.25rem 0.75rem; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; background-color: rgb(18, 18, 22);">The Dangers of <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; letter-spacing: normal; padding: 0.1em 0.35em;">atoi()</code> and Unchecked <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; letter-spacing: normal; padding: 0.1em 0.35em;">scanf()</code></h3><p dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);">Never use <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">atoi()</code> for command-line parsing or interactive user input:</p><ul class="list-inside list-disc whitespace-normal [li_&]:pl-6" data-streamdown="unordered-list" style="border: 0px solid rgb(47, 47, 55); margin: 0px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); list-style: outside disc; padding-inline-start: 1.375rem; margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);"><li class="py-1 [&>p]:inline" data-streamdown="list-item" dir="ltr" style="border: 0px solid rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); padding-block: 0.125rem;"><code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">atoi("foo")</code> silently returns <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">0</code>, making it impossible to distinguish between the valid number <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">0</code> and non-numeric garbage.</li><li class="py-1 [&>p]:inline" data-streamdown="list-item" dir="ltr" style="border: 0px solid rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); padding-block: 0.125rem;"><code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">atoi()</code> causes undefined behavior on integer overflow.</li><li class="py-1 [&>p]:inline" data-streamdown="list-item" dir="ltr" style="border: 0px solid rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); padding-block: 0.125rem;"><code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">scanf("%d", ...)</code> leaves unprocessed character noise and newline characters (<code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">\n</code>) in the standard input stream buffer, triggering infinite parsing loops on subsequent calls.</li></ul><h3 class="mt-6 mb-2 font-semibold text-xl" data-streamdown="heading-3" dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 22.5px 0px 7.5px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-size: 1rem; line-height: 1.35; --tw-space-y-reverse: 0; letter-spacing: -0.075px; --tw-font-weight: 600; margin-block: 1.25rem 0.75rem; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; background-color: rgb(18, 18, 22);">Robust Numerical Parsing with <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; letter-spacing: normal; padding: 0.1em 0.35em;">strtol()</code></h3><p dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);">The following function verifies that the entire input string constitutes a valid integer within an explicit range:</p><div class="my-4 flex w-full flex-col gap-2 rounded-xl bg-sidebar p-2" data-language="c" data-streamdown="code-block" dir="ltr" style="border-width: medium; border-style: none; border-color: currentcolor; border-image: none; margin: 0px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); max-width: 100%; border-radius: 7.5px; margin-block: 1rem 0.75rem; background: 0px 0px rgb(18, 18, 22); gap: 0px; --tw-space-y-reverse: 0; display: flex; width: 960px; flex-direction: column; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; content-visibility: auto; contain-intrinsic-size: auto 200px;"><div class="language-c" data-language="c" data-streamdown="code-block-body" dir="ltr" style="border: 1px solid rgb(47, 47, 55); padding: 0.625rem 0.75rem; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); background: none 0% 0% / auto repeat scroll padding-box border-box rgb(24, 25, 27); border-radius: 0.5rem; font-size: 0.8125rem; line-height: 1.6; max-height: 400px;"><div class="code-card position-relative my-2">
<div class="code-card-actions">
<button type="button" class="btn-code-action copy-code-btn" onclick="copyCode(this)" title="Copy Code">
<i class="far fa-copy"></i>
</button>
<a href="/tools/c-compiler" target="_blank" class="btn-code-action run-code-btn" title="Run Online">
<i class="fas fa-play"></i>
</a>
</div>
<pre class="language-c bg-[var(--sdm-bg,inherit)] dark:bg-[var(--shiki-dark-bg,var(--sdm-bg,inherit))] code-box" style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text; background: 0px 0px; --sdm-bg: transparent; --sdm-fg: inherit;"><code style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text;">#<span class="js-id">include</span> <span class="js-op"><</span><span class="js-id">stdio</span><span class="js-op">.</span><span class="js-id">h</span><span class="js-op">></span>#<span class="js-id">include</span> <span class="js-op"><</span><span class="js-id">stdlib</span><span class="js-op">.</span><span class="js-id">h</span><span class="js-op">></span>#<span class="js-id">include</span> <span class="js-op"><</span><span class="js-id">errno</span><span class="js-op">.</span><span class="js-id">h</span><span class="js-op">></span>
<span class="js-id">int</span> <span class="js-id">parse_int_safe</span><span class="js-op">(</span><span class="js-kw">const</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">str</span><span class="js-op">,</span> <span class="js-id">int</span> <span class="js-id">min_val</span><span class="js-op">,</span> <span class="js-id">int</span> <span class="js-id">max_val</span><span class="js-op">,</span> <span class="js-id">int</span> <span class="js-op">*</span><span class="js-id">out_val</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-kw">if</span> <span class="js-op">(!</span><span class="js-id">str</span> <span class="js-op">||</span> <span class="js-op">*</span><span class="js-id">str</span> <span class="js-op">==</span> <span class="js-str">'\0'</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-kw">return</span> <span class="js-num">0</span><span class="js-op">;</span> <span class="js-cm">/* Reject NULL or empty strings */</span> <span class="js-op">}</span>
<span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">endptr</span> <span class="js-op">=</span> <span class="js-id">NULL</span><span class="js-op">;</span> <span class="js-id">errno</span> <span class="js-op">=</span> <span class="js-num">0</span><span class="js-op">;</span> <span class="js-id">long</span> <span class="js-id">val</span> <span class="js-op">=</span> <span class="js-id">strtol</span><span class="js-op">(</span><span class="js-id">str</span><span class="js-op">,</span> <span class="js-op">&</span><span class="js-id">endptr</span><span class="js-op">,</span> <span class="js-num">10</span><span class="js-op">);</span>
<span class="js-cm">/* Check for range errors (overflow/underflow) */</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">errno</span> <span class="js-op">!=</span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-kw">return</span> <span class="js-num">0</span><span class="js-op">;</span> <span class="js-op">}</span>
<span class="js-cm">/* Reject if no digits were consumed or if trailing junk exists (e.g. "42abc") */</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">endptr</span> <span class="js-op">==</span> <span class="js-id">str</span> <span class="js-op">||</span> <span class="js-op">*</span><span class="js-id">endptr</span> <span class="js-op">!=</span> <span class="js-str">'\0'</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-kw">return</span> <span class="js-num">0</span><span class="js-op">;</span> <span class="js-op">}</span>
<span class="js-cm">/* Clamp to allowed domain bounds */</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">val</span> <span class="js-op"><</span> <span class="js-id">min_val</span> <span class="js-op">||</span> <span class="js-id">val</span> <span class="js-op">></span> <span class="js-id">max_val</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-kw">return</span> <span class="js-num">0</span><span class="js-op">;</span> <span class="js-op">}</span>
<span class="js-op">*</span><span class="js-id">out_val</span> <span class="js-op">=</span> <span class="js-op">(</span><span class="js-id">int</span><span class="js-op">)</span><span class="js-id">val</span><span class="js-op">;</span> <span class="js-kw">return</span> <span class="js-num">1</span><span class="js-op">;}</span></code></pre></div></div></div><hr class="my-6" data-streamdown="horizontal-rule" style="border-width: 1px 0px 0px; border-style: solid; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); height: 0px; margin-block: 1rem 0.75rem; --tw-space-y-reverse: 0; font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);"><h2 class="mt-6 mb-2 font-semibold text-2xl" data-streamdown="heading-2" dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 22.5px 0px 7.5px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-size: 1.125rem; line-height: 1.35; --tw-space-y-reverse: 0; letter-spacing: -0.105469px; --tw-font-weight: 600; margin-block: 1.25rem 0.75rem; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; background-color: rgb(18, 18, 22);">2. Ambient Configuration: Environment Variables (<code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; letter-spacing: normal; padding: 0.1em 0.35em;">getenv</code>)</h2><p dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);">Environment variables supply configuration values without modifying command-line invocations. In standard C (<code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;"><stdlib.h></code>), access them using <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">getenv()</code>:</p><div class="my-4 flex w-full flex-col gap-2 rounded-xl bg-sidebar p-2" data-language="c" data-streamdown="code-block" dir="ltr" style="border-width: medium; border-style: none; border-color: currentcolor; border-image: none; margin: 0px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); max-width: 100%; border-radius: 7.5px; margin-block: 1rem 0.75rem; background: 0px 0px rgb(18, 18, 22); gap: 0px; --tw-space-y-reverse: 0; display: flex; width: 960px; flex-direction: column; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; content-visibility: auto; contain-intrinsic-size: auto 200px;"><div class="language-c" data-language="c" data-streamdown="code-block-body" dir="ltr" style="border: 1px solid rgb(47, 47, 55); padding: 0.625rem 0.75rem; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); background: none 0% 0% / auto repeat scroll padding-box border-box rgb(24, 25, 27); border-radius: 0.5rem; font-size: 0.8125rem; line-height: 1.6; max-height: 400px;"><div class="code-card position-relative my-2">
<div class="code-card-actions">
<button type="button" class="btn-code-action copy-code-btn" onclick="copyCode(this)" title="Copy Code">
<i class="far fa-copy"></i>
</button>
<a href="/tools/c-compiler" target="_blank" class="btn-code-action run-code-btn" title="Run Online">
<i class="fas fa-play"></i>
</a>
</div>
<pre class="language-c bg-[var(--sdm-bg,inherit)] dark:bg-[var(--shiki-dark-bg,var(--sdm-bg,inherit))] code-box" style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text; background: 0px 0px; --sdm-bg: transparent; --sdm-fg: inherit;"><code style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text;"><span class="js-kw">const</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">env_host</span> <span class="js-op">=</span> <span class="js-id">getenv</span><span class="js-op">(</span><span class="js-str">"APP_HOST"</span><span class="js-op">);</span>
<span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">env_host</span> <span class="js-op">!=</span> <span class="js-id">NULL</span> <span class="js-op">&&</span> <span class="js-id">strlen</span><span class="js-op">(</span><span class="js-id">env_host</span><span class="js-op">)</span> <span class="js-op">></span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-op">{</span>
<span class="js-cm">/* Safe to copy or assign */</span>
<span class="js-op">}</span></code></pre></div></div></div><h3 class="mt-6 mb-2 font-semibold text-xl" data-streamdown="heading-3" dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 22.5px 0px 7.5px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-size: 1rem; line-height: 1.35; --tw-space-y-reverse: 0; letter-spacing: -0.075px; --tw-font-weight: 600; margin-block: 1.25rem 0.75rem; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; background-color: rgb(18, 18, 22);">Critical Semantics of <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; letter-spacing: normal; padding: 0.1em 0.35em;">getenv()</code></h3><ol class="list-inside list-decimal whitespace-normal [li_&]:pl-6" data-streamdown="ordered-list" style="border: 0px solid rgb(47, 47, 55); margin: 0px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); list-style: outside decimal; padding-inline-start: 1.375rem; margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);"><li class="py-1 [&>p]:inline" data-streamdown="list-item" dir="ltr" style="border: 0px solid rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); padding-block: 0.125rem;"><span class="font-semibold" data-streamdown="strong" style="border: 0px solid rgb(47, 47, 55); outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); --tw-font-weight: 600; font-weight: 600;">Unset vs. Empty:</span> If an environment variable has not been defined in the parent process, <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">getenv()</code> returns <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">NULL</code>. If it was exported with an empty value (<code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">export APP_PORT=""</code>), <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">getenv()</code> returns a pointer to an empty string <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">""</code> (<code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">*ptr == '\0'</code>). Always check both conditions!</li><li class="py-1 [&>p]:inline" data-streamdown="list-item" dir="ltr" style="border: 0px solid rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); padding-block: 0.125rem;"><span class="font-semibold" data-streamdown="strong" style="border: 0px solid rgb(47, 47, 55); outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); --tw-font-weight: 600; font-weight: 600;">Read-Only Storage:</span> Never attempt to call <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">free()</code> on or mutate the memory returned by <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">getenv()</code>. The pointer points to operating-system-managed process environment strings. Copy values into local buffers if modification is required.</li></ol><hr class="my-6" data-streamdown="horizontal-rule" style="border-width: 1px 0px 0px; border-style: solid; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); height: 0px; margin-block: 1rem 0.75rem; --tw-space-y-reverse: 0; font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);"><h2 class="mt-6 mb-2 font-semibold text-2xl" data-streamdown="heading-2" dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 22.5px 0px 7.5px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-size: 1.125rem; line-height: 1.35; --tw-space-y-reverse: 0; letter-spacing: -0.105469px; --tw-font-weight: 600; margin-block: 1.25rem 0.75rem; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; background-color: rgb(18, 18, 22);">3. Interactive Input: Safe Prompts, Re-prompting, and EOF Traps</h2><p dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);">When mandatory arguments are missing or an interactive flag (such as <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">-i</code> or <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">--interactive</code>) is passed, programs request input through standard input (<code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">stdin</code>).</p><h3 class="mt-6 mb-2 font-semibold text-xl" data-streamdown="heading-3" dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 22.5px 0px 7.5px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-size: 1rem; line-height: 1.35; --tw-space-y-reverse: 0; letter-spacing: -0.075px; --tw-font-weight: 600; margin-block: 1.25rem 0.75rem; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; background-color: rgb(18, 18, 22);">The Golden Rule: Read Full Lines with <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; letter-spacing: normal; padding: 0.1em 0.35em;">fgets()</code></h3><p dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);">To prevent buffer overflow attacks, never use the banned <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">gets()</code> function. Instead, use <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">fgets()</code>, which reads up to $N - 1$ characters into a buffer and guarantees null-termination:</p><div class="my-4 flex w-full flex-col gap-2 rounded-xl bg-sidebar p-2" data-language="c" data-streamdown="code-block" dir="ltr" style="border-width: medium; border-style: none; border-color: currentcolor; border-image: none; margin: 0px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); max-width: 100%; border-radius: 7.5px; margin-block: 1rem 0.75rem; background: 0px 0px rgb(18, 18, 22); gap: 0px; --tw-space-y-reverse: 0; display: flex; width: 960px; flex-direction: column; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; content-visibility: auto; contain-intrinsic-size: auto 200px;"><div class="language-c" data-language="c" data-streamdown="code-block-body" dir="ltr" style="border: 1px solid rgb(47, 47, 55); padding: 0.625rem 0.75rem; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); background: none 0% 0% / auto repeat scroll padding-box border-box rgb(24, 25, 27); border-radius: 0.5rem; font-size: 0.8125rem; line-height: 1.6; max-height: 400px;"><div class="code-card position-relative my-2">
<div class="code-card-actions">
<button type="button" class="btn-code-action copy-code-btn" onclick="copyCode(this)" title="Copy Code">
<i class="far fa-copy"></i>
</button>
<a href="/tools/c-compiler" target="_blank" class="btn-code-action run-code-btn" title="Run Online">
<i class="fas fa-play"></i>
</a>
</div>
<pre class="language-c bg-[var(--sdm-bg,inherit)] dark:bg-[var(--shiki-dark-bg,var(--sdm-bg,inherit))] code-box" style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text; background: 0px 0px; --sdm-bg: transparent; --sdm-fg: inherit;"><code style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text;"><span class="js-id">char</span> <span class="js-id">buffer</span>[<span class="js-num">128</span>]<span class="js-op">;</span>
<span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">fgets</span><span class="js-op">(</span><span class="js-id">buffer</span><span class="js-op">,</span> <span class="js-id">sizeof</span><span class="js-op">(</span><span class="js-id">buffer</span><span class="js-op">),</span> <span class="js-id">stdin</span><span class="js-op">)</span> <span class="js-op">==</span> <span class="js-id">NULL</span><span class="js-op">)</span> <span class="js-op">{</span>
<span class="js-cm">/* Handle EOF or hardware read failure */</span>
<span class="js-op">}</span></code></pre></div></div></div><h3 class="mt-6 mb-2 font-semibold text-xl" data-streamdown="heading-3" dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 22.5px 0px 7.5px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-size: 1rem; line-height: 1.35; --tw-space-y-reverse: 0; letter-spacing: -0.075px; --tw-font-weight: 600; margin-block: 1.25rem 0.75rem; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; background-color: rgb(18, 18, 22);">The Pitfall of Piped Input and EOF</h3><p dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);">When users run your program interactively at a terminal keyboard, typing characters followed by <kbd dir="ltr" style="border: 0px solid rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em;">Enter</kbd> submits a newline (<code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">\n</code>). However, if a user pipes input into your program (<code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">./app < input.txt</code>), the stream eventually reaches <span class="font-semibold" data-streamdown="strong" style="border: 0px solid rgb(47, 47, 55); outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); --tw-font-weight: 600; font-weight: 600;">End-of-File (EOF)</span>.</p><p dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);">If your interactive loop assumes input will always arrive and only checks for newline characters:</p><div class="my-4 flex w-full flex-col gap-2 rounded-xl bg-sidebar p-2" data-language="c" data-streamdown="code-block" dir="ltr" style="border-width: medium; border-style: none; border-color: currentcolor; border-image: none; margin: 0px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); max-width: 100%; border-radius: 7.5px; margin-block: 1rem 0.75rem; background: 0px 0px rgb(18, 18, 22); gap: 0px; --tw-space-y-reverse: 0; display: flex; width: 960px; flex-direction: column; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; content-visibility: auto; contain-intrinsic-size: auto 200px;"><div class="language-c" data-language="c" data-streamdown="code-block-body" dir="ltr" style="border: 1px solid rgb(47, 47, 55); padding: 0.625rem 0.75rem; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); background: none 0% 0% / auto repeat scroll padding-box border-box rgb(24, 25, 27); border-radius: 0.5rem; font-size: 0.8125rem; line-height: 1.6; max-height: 400px;"><div class="code-card position-relative my-2">
<div class="code-card-actions">
<button type="button" class="btn-code-action copy-code-btn" onclick="copyCode(this)" title="Copy Code">
<i class="far fa-copy"></i>
</button>
<a href="/tools/c-compiler" target="_blank" class="btn-code-action run-code-btn" title="Run Online">
<i class="fas fa-play"></i>
</a>
</div>
<pre class="language-c bg-[var(--sdm-bg,inherit)] dark:bg-[var(--shiki-dark-bg,var(--sdm-bg,inherit))] code-box" style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text; background: 0px 0px; --sdm-bg: transparent; --sdm-fg: inherit;"><code style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text;"><span class="js-cm">/* BUGGY CODE: Do not do this! */</span><span class="js-kw">while</span> <span class="js-op">(</span><span class="js-num">1</span><span class="js-op">)</span> <span class="js-op">{</span>
<span class="js-id">fgets</span><span class="js-op">(</span><span class="js-id">buffer</span><span class="js-op">,</span> <span class="js-id">sizeof</span><span class="js-op">(</span><span class="js-id">buffer</span><span class="js-op">),</span> <span class="js-id">stdin</span><span class="js-op">);</span>
<span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">strlen</span><span class="js-op">(</span><span class="js-id">buffer</span><span class="js-op">)</span> <span class="js-op">></span> <span class="js-num">1</span><span class="js-op">)</span> <span class="js-kw">break</span><span class="js-op">;</span> <span class="js-cm">/* If EOF occurs, fgets returns NULL without modifying buffer! */</span>
<span class="js-op">}</span></code></pre></div></div></div><p dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);">When <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">fgets()</code> reaches EOF, it returns <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">NULL</code> and leaves the existing memory in <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">buffer</code> unmodified. The loop continues forever, <span class="font-semibold" data-streamdown="strong" style="border: 0px solid rgb(47, 47, 55); outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); --tw-font-weight: 600; font-weight: 600;">spinning at 100% CPU utilization</span>.</p><h3 class="mt-6 mb-2 font-semibold text-xl" data-streamdown="heading-3" dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 22.5px 0px 7.5px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-size: 1rem; line-height: 1.35; --tw-space-y-reverse: 0; letter-spacing: -0.075px; --tw-font-weight: 600; margin-block: 1.25rem 0.75rem; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; background-color: rgb(18, 18, 22);">Verified Interactive Validation Loops</h3><p dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);">A robust interactive input loop must:</p><ol class="list-inside list-decimal whitespace-normal [li_&]:pl-6" data-streamdown="ordered-list" style="border: 0px solid rgb(47, 47, 55); margin: 0px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); list-style: outside decimal; padding-inline-start: 1.375rem; margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);"><li class="py-1 [&>p]:inline" data-streamdown="list-item" dir="ltr" style="border: 0px solid rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); padding-block: 0.125rem;">Detect <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">NULL</code> return values from <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">fgets()</code>, signaling EOF (<kbd dir="ltr" style="border: 0px solid rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em;">Ctrl+D</kbd> on POSIX, <kbd dir="ltr" style="border: 0px solid rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em;">Ctrl+Z</kbd> on Windows).</li><li class="py-1 [&>p]:inline" data-streamdown="list-item" dir="ltr" style="border: 0px solid rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); padding-block: 0.125rem;">Strip trailing <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">\r</code> and <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">\n</code> characters left by carriage returns.</li><li class="py-1 [&>p]:inline" data-streamdown="list-item" dir="ltr" style="border: 0px solid rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); padding-block: 0.125rem;">Trim surrounding whitespace.</li><li class="py-1 [&>p]:inline" data-streamdown="list-item" dir="ltr" style="border: 0px solid rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); padding-block: 0.125rem;">Reprompt the user upon validation failure without terminating the process.</li></ol><div class="my-4 flex w-full flex-col gap-2 rounded-xl bg-sidebar p-2" data-language="c" data-streamdown="code-block" dir="ltr" style="border-width: medium; border-style: none; border-color: currentcolor; border-image: none; margin: 0px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); max-width: 100%; border-radius: 7.5px; margin-block: 1rem 0.75rem; background: 0px 0px rgb(18, 18, 22); gap: 0px; --tw-space-y-reverse: 0; display: flex; width: 960px; flex-direction: column; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; content-visibility: auto; contain-intrinsic-size: auto 200px;"><div class="language-c" data-language="c" data-streamdown="code-block-body" dir="ltr" style="border: 1px solid rgb(47, 47, 55); padding: 0.625rem 0.75rem; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); background: none 0% 0% / auto repeat scroll padding-box border-box rgb(24, 25, 27); border-radius: 0.5rem; font-size: 0.8125rem; line-height: 1.6; max-height: 400px;"><div class="code-card position-relative my-2">
<div class="code-card-actions">
<button type="button" class="btn-code-action copy-code-btn" onclick="copyCode(this)" title="Copy Code">
<i class="far fa-copy"></i>
</button>
<a href="/tools/c-compiler" target="_blank" class="btn-code-action run-code-btn" title="Run Online">
<i class="fas fa-play"></i>
</a>
</div>
<pre class="language-c bg-[var(--sdm-bg,inherit)] dark:bg-[var(--shiki-dark-bg,var(--sdm-bg,inherit))] code-box" style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text; background: 0px 0px; --sdm-bg: transparent; --sdm-fg: inherit;"><code style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text;">#<span class="js-id">include</span> <span class="js-op"><</span><span class="js-id">stdio</span><span class="js-op">.</span><span class="js-id">h</span><span class="js-op">></span>#<span class="js-id">include</span> <span class="js-op"><</span><span class="js-id">string</span><span class="js-op">.</span><span class="js-id">h</span><span class="js-op">></span>#<span class="js-id">include</span> <span class="js-op"><</span><span class="js-id">ctype</span><span class="js-op">.</span><span class="js-id">h</span><span class="js-op">></span>
<span class="js-cm">/* Helper: strip newline and carriage return characters */</span><span class="js-id">static</span> <span class="js-kw">void</span> <span class="js-id">strip_crlf</span><span class="js-op">(</span><span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">str</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-kw">if</span> <span class="js-op">(!</span><span class="js-id">str</span><span class="js-op">)</span> <span class="js-kw">return</span><span class="js-op">;</span> <span class="js-id">size_t</span> <span class="js-id">len</span> <span class="js-op">=</span> <span class="js-id">strlen</span><span class="js-op">(</span><span class="js-id">str</span><span class="js-op">);</span> <span class="js-kw">while</span> <span class="js-op">(</span><span class="js-id">len</span> <span class="js-op">></span> <span class="js-num">0</span> <span class="js-op">&&</span> <span class="js-op">(</span><span class="js-id">str</span>[<span class="js-id">len</span> <span class="js-op">-</span> <span class="js-num">1</span>] <span class="js-op">==</span> <span class="js-str">'\n'</span> <span class="js-op">||</span> <span class="js-id">str</span>[<span class="js-id">len</span> <span class="js-op">-</span> <span class="js-num">1</span>] <span class="js-op">==</span> <span class="js-str">'\r'</span><span class="js-op">))</span> <span class="js-op">{</span> <span class="js-id">str</span>[<span class="js-id">len</span> <span class="js-op">-</span> <span class="js-num">1</span>] <span class="js-op">=</span> <span class="js-str">'\0'</span><span class="js-op">;</span> <span class="js-id">len</span><span class="js-op">--;</span> <span class="js-op">}}</span>
<span class="js-cm">/* Helper: trim leading and trailing whitespace in-place */</span><span class="js-id">static</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">trim_whitespace</span><span class="js-op">(</span><span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">str</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-kw">if</span> <span class="js-op">(!</span><span class="js-id">str</span><span class="js-op">)</span> <span class="js-kw">return</span> <span class="js-id">NULL</span><span class="js-op">;</span> <span class="js-kw">while</span> <span class="js-op">(</span><span class="js-id">isspace</span><span class="js-op">((</span><span class="js-id">unsigned</span> <span class="js-id">char</span><span class="js-op">)*</span><span class="js-id">str</span><span class="js-op">))</span> <span class="js-id">str</span><span class="js-op">++;</span> <span class="js-kw">if</span> <span class="js-op">(*</span><span class="js-id">str</span> <span class="js-op">==</span> <span class="js-str">'\0'</span><span class="js-op">)</span> <span class="js-kw">return</span> <span class="js-id">str</span><span class="js-op">;</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">end</span> <span class="js-op">=</span> <span class="js-id">str</span> <span class="js-op">+</span> <span class="js-id">strlen</span><span class="js-op">(</span><span class="js-id">str</span><span class="js-op">)</span> <span class="js-op">-</span> <span class="js-num">1</span><span class="js-op">;</span> <span class="js-kw">while</span> <span class="js-op">(</span><span class="js-id">end</span> <span class="js-op">></span> <span class="js-id">str</span> <span class="js-op">&&</span> <span class="js-id">isspace</span><span class="js-op">((</span><span class="js-id">unsigned</span> <span class="js-id">char</span><span class="js-op">)*</span><span class="js-id">end</span><span class="js-op">))</span> <span class="js-id">end</span><span class="js-op">--;</span> <span class="js-id">end</span>[<span class="js-num">1</span>] <span class="js-op">=</span> <span class="js-str">'\0'</span><span class="js-op">;</span> <span class="js-kw">return</span> <span class="js-id">str</span><span class="js-op">;}</span>
<span class="js-cm">/* Interactive prompt for strings */</span><span class="js-id">int</span> <span class="js-id">prompt_string</span><span class="js-op">(</span><span class="js-kw">const</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">prompt</span><span class="js-op">,</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">buffer</span><span class="js-op">,</span> <span class="js-id">size_t</span> <span class="js-id">buf_size</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-id">char</span> <span class="js-id">temp</span>[<span class="js-num">256</span>]<span class="js-op">;</span> <span class="js-kw">while</span> <span class="js-op">(</span><span class="js-num">1</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"%s"</span><span class="js-op">,</span> <span class="js-id">prompt</span><span class="js-op">);</span> <span class="js-id">fflush</span><span class="js-op">(</span><span class="js-id">stdout</span><span class="js-op">);</span> <span class="js-cm">/* Ensure prompt flushes to unbuffered consoles */</span>
<span class="js-kw">if</span> <span class="js-op">(!</span><span class="js-id">fgets</span><span class="js-op">(</span><span class="js-id">temp</span><span class="js-op">,</span> <span class="js-id">sizeof</span><span class="js-op">(</span><span class="js-id">temp</span><span class="js-op">),</span> <span class="js-id">stdin</span><span class="js-op">))</span> <span class="js-op">{</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"\n[EOF encountered: input aborted]\n"</span><span class="js-op">);</span> <span class="js-kw">return</span> <span class="js-num">0</span><span class="js-op">;</span> <span class="js-cm">/* Failure / Stream closed */</span> <span class="js-op">}</span>
<span class="js-id">strip_crlf</span><span class="js-op">(</span><span class="js-id">temp</span><span class="js-op">);</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">trimmed</span> <span class="js-op">=</span> <span class="js-id">trim_whitespace</span><span class="js-op">(</span><span class="js-id">temp</span><span class="js-op">);</span>
<span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">strlen</span><span class="js-op">(</span><span class="js-id">trimmed</span><span class="js-op">)</span> <span class="js-op">==</span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"Error: input cannot be empty. Please try again.\n"</span><span class="js-op">);</span> <span class="js-kw">continue</span><span class="js-op">;</span> <span class="js-op">}</span>
<span class="js-id">strncpy</span><span class="js-op">(</span><span class="js-id">buffer</span><span class="js-op">,</span> <span class="js-id">trimmed</span><span class="js-op">,</span> <span class="js-id">buf_size</span> <span class="js-op">-</span> <span class="js-num">1</span><span class="js-op">);</span> <span class="js-id">buffer</span>[<span class="js-id">buf_size</span> <span class="js-op">-</span> <span class="js-num">1</span>] <span class="js-op">=</span> <span class="js-str">'\0'</span><span class="js-op">;</span> <span class="js-kw">return</span> <span class="js-num">1</span><span class="js-op">;</span> <span class="js-cm">/* Success */</span> <span class="js-op">}}</span>
<span class="js-cm">/* Interactive prompt for bounded integers with optional default fallback */</span><span class="js-id">int</span> <span class="js-id">prompt_int</span><span class="js-op">(</span><span class="js-kw">const</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">prompt</span><span class="js-op">,</span> <span class="js-id">int</span> <span class="js-id">min_val</span><span class="js-op">,</span> <span class="js-id">int</span> <span class="js-id">max_val</span><span class="js-op">,</span> <span class="js-id">int</span> <span class="js-id">default_val</span><span class="js-op">,</span> <span class="js-id">int</span> <span class="js-op">*</span><span class="js-id">out_val</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-id">char</span> <span class="js-id">temp</span>[<span class="js-num">64</span>]<span class="js-op">;</span> <span class="js-kw">while</span> <span class="js-op">(</span><span class="js-num">1</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">default_val</span> <span class="js-op">>=</span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"%s [%d]: "</span><span class="js-op">,</span> <span class="js-id">prompt</span><span class="js-op">,</span> <span class="js-id">default_val</span><span class="js-op">);</span> <span class="js-op">}</span> <span class="js-kw">else</span> <span class="js-op">{</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"%s (%d-%d): "</span><span class="js-op">,</span> <span class="js-id">prompt</span><span class="js-op">,</span> <span class="js-id">min_val</span><span class="js-op">,</span> <span class="js-id">max_val</span><span class="js-op">);</span> <span class="js-op">}</span> <span class="js-id">fflush</span><span class="js-op">(</span><span class="js-id">stdout</span><span class="js-op">);</span>
<span class="js-kw">if</span> <span class="js-op">(!</span><span class="js-id">fgets</span><span class="js-op">(</span><span class="js-id">temp</span><span class="js-op">,</span> <span class="js-id">sizeof</span><span class="js-op">(</span><span class="js-id">temp</span><span class="js-op">),</span> <span class="js-id">stdin</span><span class="js-op">))</span> <span class="js-op">{</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"\n[EOF encountered: input aborted]\n"</span><span class="js-op">);</span> <span class="js-kw">return</span> <span class="js-num">0</span><span class="js-op">;</span> <span class="js-op">}</span>
<span class="js-id">strip_crlf</span><span class="js-op">(</span><span class="js-id">temp</span><span class="js-op">);</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">trimmed</span> <span class="js-op">=</span> <span class="js-id">trim_whitespace</span><span class="js-op">(</span><span class="js-id">temp</span><span class="js-op">);</span>
<span class="js-cm">/* User pressed Enter without typing; select default if provided */</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">strlen</span><span class="js-op">(</span><span class="js-id">trimmed</span><span class="js-op">)</span> <span class="js-op">==</span> <span class="js-num">0</span> <span class="js-op">&&</span> <span class="js-id">default_val</span> <span class="js-op">>=</span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-op">*</span><span class="js-id">out_val</span> <span class="js-op">=</span> <span class="js-id">default_val</span><span class="js-op">;</span> <span class="js-kw">return</span> <span class="js-num">1</span><span class="js-op">;</span> <span class="js-op">}</span>
<span class="js-id">int</span> <span class="js-id">val</span> <span class="js-op">=</span> <span class="js-num">0</span><span class="js-op">;</span> <span class="js-kw">if</span> <span class="js-op">(!</span><span class="js-id">parse_int_safe</span><span class="js-op">(</span><span class="js-id">trimmed</span><span class="js-op">,</span> <span class="js-id">min_val</span><span class="js-op">,</span> <span class="js-id">max_val</span><span class="js-op">,</span> <span class="js-op">&</span><span class="js-id">val</span><span class="js-op">))</span> <span class="js-op">{</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"Error: invalid number or out of range (%d to %d). Try again.\n"</span><span class="js-op">,</span> <span class="js-id">min_val</span><span class="js-op">,</span> <span class="js-id">max_val</span><span class="js-op">);</span> <span class="js-kw">continue</span><span class="js-op">;</span> <span class="js-op">}</span>
<span class="js-op">*</span><span class="js-id">out_val</span> <span class="js-op">=</span> <span class="js-id">val</span><span class="js-op">;</span> <span class="js-kw">return</span> <span class="js-num">1</span><span class="js-op">;</span> <span class="js-op">}}</span></code></pre></div></div></div><hr class="my-6" data-streamdown="horizontal-rule" style="border-width: 1px 0px 0px; border-style: solid; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); height: 0px; margin-block: 1rem 0.75rem; --tw-space-y-reverse: 0; font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);"><h2 class="mt-6 mb-2 font-semibold text-2xl" data-streamdown="heading-2" dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 22.5px 0px 7.5px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-size: 1.125rem; line-height: 1.35; --tw-space-y-reverse: 0; letter-spacing: -0.105469px; --tw-font-weight: 600; margin-block: 1.25rem 0.75rem; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; background-color: rgb(18, 18, 22);">4. End-to-End Implementation: Multi-Source Configuration Program</h2><p dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);">The following production-grade program integrates all three input mechanisms. It models a network utility establishing a connection based on target hostname, port, and retry limit:</p><ol class="list-inside list-decimal whitespace-normal [li_&]:pl-6" data-streamdown="ordered-list" style="border: 0px solid rgb(47, 47, 55); margin: 0px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); list-style: outside decimal; padding-inline-start: 1.375rem; margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);"><li class="py-1 [&>p]:inline" data-streamdown="list-item" dir="ltr" style="border: 0px solid rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); padding-block: 0.125rem;">Defaults are defined internally.</li><li class="py-1 [&>p]:inline" data-streamdown="list-item" dir="ltr" style="border: 0px solid rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); padding-block: 0.125rem;"><code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">APP_HOST</code>, <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">APP_PORT</code>, and <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">APP_RETRIES</code> environment variables override defaults.</li><li class="py-1 [&>p]:inline" data-streamdown="list-item" dir="ltr" style="border: 0px solid rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); padding-block: 0.125rem;">Command-line flags (<code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">-h</code>, <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">-p</code>, <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">-r</code>) override environment variables.</li><li class="py-1 [&>p]:inline" data-streamdown="list-item" dir="ltr" style="border: 0px solid rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); padding-block: 0.125rem;">If <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">-i</code> / <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">--interactive</code> is passed or the host remains missing, the application prompts the user interactively with full re-prompt validation loops.</li></ol><div class="my-4 flex w-full flex-col gap-2 rounded-xl bg-sidebar p-2" data-language="c" data-streamdown="code-block" dir="ltr" style="border-width: medium; border-style: none; border-color: currentcolor; border-image: none; margin: 0px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); max-width: 100%; border-radius: 7.5px; margin-block: 1rem 0.75rem; background: 0px 0px rgb(18, 18, 22); gap: 0px; --tw-space-y-reverse: 0; display: flex; width: 960px; flex-direction: column; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; content-visibility: auto; contain-intrinsic-size: auto 200px;"><div class="language-c" data-language="c" data-streamdown="code-block-body" dir="ltr" style="border: 1px solid rgb(47, 47, 55); padding: 0.625rem 0.75rem; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); background: none 0% 0% / auto repeat scroll padding-box border-box rgb(24, 25, 27); border-radius: 0.5rem; font-size: 0.8125rem; line-height: 1.6; max-height: 400px;"><div class="code-card position-relative my-2">
<div class="code-card-actions">
<button type="button" class="btn-code-action copy-code-btn" onclick="copyCode(this)" title="Copy Code">
<i class="far fa-copy"></i>
</button>
<a href="/tools/c-compiler" target="_blank" class="btn-code-action run-code-btn" title="Run Online">
<i class="fas fa-play"></i>
</a>
</div>
<pre class="language-c bg-[var(--sdm-bg,inherit)] dark:bg-[var(--shiki-dark-bg,var(--sdm-bg,inherit))] code-box" style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text; background: 0px 0px; --sdm-bg: transparent; --sdm-fg: inherit;"><code style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text;">#<span class="js-id">include</span> <span class="js-op"><</span><span class="js-id">stdio</span><span class="js-op">.</span><span class="js-id">h</span><span class="js-op">></span>#<span class="js-id">include</span> <span class="js-op"><</span><span class="js-id">stdlib</span><span class="js-op">.</span><span class="js-id">h</span><span class="js-op">></span>#<span class="js-id">include</span> <span class="js-op"><</span><span class="js-id">string</span><span class="js-op">.</span><span class="js-id">h</span><span class="js-op">></span>#<span class="js-id">include</span> <span class="js-op"><</span><span class="js-id">ctype</span><span class="js-op">.</span><span class="js-id">h</span><span class="js-op">></span>#<span class="js-id">include</span> <span class="js-op"><</span><span class="js-id">errno</span><span class="js-op">.</span><span class="js-id">h</span><span class="js-op">></span>
#<span class="js-id">define</span> <span class="js-id">MAX_NAME_LEN</span> <span class="js-num">64</span>#<span class="js-id">define</span> <span class="js-id">DEFAULT_PORT</span> <span class="js-num">8080</span>#<span class="js-id">define</span> <span class="js-id">DEFAULT_RETRIES</span> <span class="js-num">3</span>
<span class="js-id">typedef</span> <span class="js-id">struct</span> <span class="js-op">{</span> <span class="js-id">char</span> <span class="js-id">host</span>[<span class="js-id">MAX_NAME_LEN</span>]<span class="js-op">;</span> <span class="js-id">int</span> <span class="js-id">port</span><span class="js-op">;</span> <span class="js-id">int</span> <span class="js-id">retries</span><span class="js-op">;</span> <span class="js-id">int</span> <span class="js-id">interactive</span><span class="js-op">;}</span> <span class="js-id">AppConfig</span><span class="js-op">;</span>
<span class="js-cm">/* Lexical string-to-int converter with bounds enforcement */</span><span class="js-id">static</span> <span class="js-id">int</span> <span class="js-id">parse_int_safe</span><span class="js-op">(</span><span class="js-kw">const</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">str</span><span class="js-op">,</span> <span class="js-id">int</span> <span class="js-id">min_val</span><span class="js-op">,</span> <span class="js-id">int</span> <span class="js-id">max_val</span><span class="js-op">,</span> <span class="js-id">int</span> <span class="js-op">*</span><span class="js-id">out_val</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-kw">if</span> <span class="js-op">(!</span><span class="js-id">str</span> <span class="js-op">||</span> <span class="js-op">!*</span><span class="js-id">str</span><span class="js-op">)</span> <span class="js-kw">return</span> <span class="js-num">0</span><span class="js-op">;</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">endptr</span> <span class="js-op">=</span> <span class="js-id">NULL</span><span class="js-op">;</span> <span class="js-id">errno</span> <span class="js-op">=</span> <span class="js-num">0</span><span class="js-op">;</span> <span class="js-id">long</span> <span class="js-id">val</span> <span class="js-op">=</span> <span class="js-id">strtol</span><span class="js-op">(</span><span class="js-id">str</span><span class="js-op">,</span> <span class="js-op">&</span><span class="js-id">endptr</span><span class="js-op">,</span> <span class="js-num">10</span><span class="js-op">);</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">errno</span> <span class="js-op">!=</span> <span class="js-num">0</span> <span class="js-op">||</span> <span class="js-id">endptr</span> <span class="js-op">==</span> <span class="js-id">str</span> <span class="js-op">||</span> <span class="js-op">*</span><span class="js-id">endptr</span> <span class="js-op">!=</span> <span class="js-str">'\0'</span><span class="js-op">)</span> <span class="js-kw">return</span> <span class="js-num">0</span><span class="js-op">;</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">val</span> <span class="js-op"><</span> <span class="js-id">min_val</span> <span class="js-op">||</span> <span class="js-id">val</span> <span class="js-op">></span> <span class="js-id">max_val</span><span class="js-op">)</span> <span class="js-kw">return</span> <span class="js-num">0</span><span class="js-op">;</span> <span class="js-op">*</span><span class="js-id">out_val</span> <span class="js-op">=</span> <span class="js-op">(</span><span class="js-id">int</span><span class="js-op">)</span><span class="js-id">val</span><span class="js-op">;</span> <span class="js-kw">return</span> <span class="js-num">1</span><span class="js-op">;}</span>
<span class="js-id">static</span> <span class="js-kw">void</span> <span class="js-id">strip_crlf</span><span class="js-op">(</span><span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">str</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-kw">if</span> <span class="js-op">(!</span><span class="js-id">str</span><span class="js-op">)</span> <span class="js-kw">return</span><span class="js-op">;</span> <span class="js-id">size_t</span> <span class="js-id">len</span> <span class="js-op">=</span> <span class="js-id">strlen</span><span class="js-op">(</span><span class="js-id">str</span><span class="js-op">);</span> <span class="js-kw">while</span> <span class="js-op">(</span><span class="js-id">len</span> <span class="js-op">></span> <span class="js-num">0</span> <span class="js-op">&&</span> <span class="js-op">(</span><span class="js-id">str</span>[<span class="js-id">len</span> <span class="js-op">-</span> <span class="js-num">1</span>] <span class="js-op">==</span> <span class="js-str">'\n'</span> <span class="js-op">||</span> <span class="js-id">str</span>[<span class="js-id">len</span> <span class="js-op">-</span> <span class="js-num">1</span>] <span class="js-op">==</span> <span class="js-str">'\r'</span><span class="js-op">))</span> <span class="js-op">{</span> <span class="js-id">str</span>[<span class="js-id">len</span> <span class="js-op">-</span> <span class="js-num">1</span>] <span class="js-op">=</span> <span class="js-str">'\0'</span><span class="js-op">;</span> <span class="js-id">len</span><span class="js-op">--;</span> <span class="js-op">}}</span>
<span class="js-id">static</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">trim_whitespace</span><span class="js-op">(</span><span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">str</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-kw">if</span> <span class="js-op">(!</span><span class="js-id">str</span><span class="js-op">)</span> <span class="js-kw">return</span> <span class="js-id">NULL</span><span class="js-op">;</span> <span class="js-kw">while</span> <span class="js-op">(</span><span class="js-id">isspace</span><span class="js-op">((</span><span class="js-id">unsigned</span> <span class="js-id">char</span><span class="js-op">)*</span><span class="js-id">str</span><span class="js-op">))</span> <span class="js-id">str</span><span class="js-op">++;</span> <span class="js-kw">if</span> <span class="js-op">(*</span><span class="js-id">str</span> <span class="js-op">==</span> <span class="js-str">'\0'</span><span class="js-op">)</span> <span class="js-kw">return</span> <span class="js-id">str</span><span class="js-op">;</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">end</span> <span class="js-op">=</span> <span class="js-id">str</span> <span class="js-op">+</span> <span class="js-id">strlen</span><span class="js-op">(</span><span class="js-id">str</span><span class="js-op">)</span> <span class="js-op">-</span> <span class="js-num">1</span><span class="js-op">;</span> <span class="js-kw">while</span> <span class="js-op">(</span><span class="js-id">end</span> <span class="js-op">></span> <span class="js-id">str</span> <span class="js-op">&&</span> <span class="js-id">isspace</span><span class="js-op">((</span><span class="js-id">unsigned</span> <span class="js-id">char</span><span class="js-op">)*</span><span class="js-id">end</span><span class="js-op">))</span> <span class="js-id">end</span><span class="js-op">--;</span> <span class="js-id">end</span>[<span class="js-num">1</span>] <span class="js-op">=</span> <span class="js-str">'\0'</span><span class="js-op">;</span> <span class="js-kw">return</span> <span class="js-id">str</span><span class="js-op">;}</span>
<span class="js-id">static</span> <span class="js-id">int</span> <span class="js-id">prompt_string</span><span class="js-op">(</span><span class="js-kw">const</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">prompt</span><span class="js-op">,</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">buffer</span><span class="js-op">,</span> <span class="js-id">size_t</span> <span class="js-id">buf_size</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-id">char</span> <span class="js-id">temp</span>[<span class="js-num">256</span>]<span class="js-op">;</span> <span class="js-kw">while</span> <span class="js-op">(</span><span class="js-num">1</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"%s"</span><span class="js-op">,</span> <span class="js-id">prompt</span><span class="js-op">);</span> <span class="js-id">fflush</span><span class="js-op">(</span><span class="js-id">stdout</span><span class="js-op">);</span> <span class="js-kw">if</span> <span class="js-op">(!</span><span class="js-id">fgets</span><span class="js-op">(</span><span class="js-id">temp</span><span class="js-op">,</span> <span class="js-id">sizeof</span><span class="js-op">(</span><span class="js-id">temp</span><span class="js-op">),</span> <span class="js-id">stdin</span><span class="js-op">))</span> <span class="js-op">{</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"\n[EOF encountered: input aborted]\n"</span><span class="js-op">);</span> <span class="js-kw">return</span> <span class="js-num">0</span><span class="js-op">;</span> <span class="js-op">}</span> <span class="js-id">strip_crlf</span><span class="js-op">(</span><span class="js-id">temp</span><span class="js-op">);</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">trimmed</span> <span class="js-op">=</span> <span class="js-id">trim_whitespace</span><span class="js-op">(</span><span class="js-id">temp</span><span class="js-op">);</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">strlen</span><span class="js-op">(</span><span class="js-id">trimmed</span><span class="js-op">)</span> <span class="js-op">==</span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"Error: input cannot be empty. Please try again.\n"</span><span class="js-op">);</span> <span class="js-kw">continue</span><span class="js-op">;</span> <span class="js-op">}</span> <span class="js-id">strncpy</span><span class="js-op">(</span><span class="js-id">buffer</span><span class="js-op">,</span> <span class="js-id">trimmed</span><span class="js-op">,</span> <span class="js-id">buf_size</span> <span class="js-op">-</span> <span class="js-num">1</span><span class="js-op">);</span> <span class="js-id">buffer</span>[<span class="js-id">buf_size</span> <span class="js-op">-</span> <span class="js-num">1</span>] <span class="js-op">=</span> <span class="js-str">'\0'</span><span class="js-op">;</span> <span class="js-kw">return</span> <span class="js-num">1</span><span class="js-op">;</span> <span class="js-op">}}</span>
<span class="js-id">static</span> <span class="js-id">int</span> <span class="js-id">prompt_int</span><span class="js-op">(</span><span class="js-kw">const</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">prompt</span><span class="js-op">,</span> <span class="js-id">int</span> <span class="js-id">min_val</span><span class="js-op">,</span> <span class="js-id">int</span> <span class="js-id">max_val</span><span class="js-op">,</span> <span class="js-id">int</span> <span class="js-id">default_val</span><span class="js-op">,</span> <span class="js-id">int</span> <span class="js-op">*</span><span class="js-id">out_val</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-id">char</span> <span class="js-id">temp</span>[<span class="js-num">64</span>]<span class="js-op">;</span> <span class="js-kw">while</span> <span class="js-op">(</span><span class="js-num">1</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">default_val</span> <span class="js-op">>=</span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"%s [%d]: "</span><span class="js-op">,</span> <span class="js-id">prompt</span><span class="js-op">,</span> <span class="js-id">default_val</span><span class="js-op">);</span> <span class="js-op">}</span> <span class="js-kw">else</span> <span class="js-op">{</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"%s (%d-%d): "</span><span class="js-op">,</span> <span class="js-id">prompt</span><span class="js-op">,</span> <span class="js-id">min_val</span><span class="js-op">,</span> <span class="js-id">max_val</span><span class="js-op">);</span> <span class="js-op">}</span> <span class="js-id">fflush</span><span class="js-op">(</span><span class="js-id">stdout</span><span class="js-op">);</span> <span class="js-kw">if</span> <span class="js-op">(!</span><span class="js-id">fgets</span><span class="js-op">(</span><span class="js-id">temp</span><span class="js-op">,</span> <span class="js-id">sizeof</span><span class="js-op">(</span><span class="js-id">temp</span><span class="js-op">),</span> <span class="js-id">stdin</span><span class="js-op">))</span> <span class="js-op">{</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"\n[EOF encountered: input aborted]\n"</span><span class="js-op">);</span> <span class="js-kw">return</span> <span class="js-num">0</span><span class="js-op">;</span> <span class="js-op">}</span> <span class="js-id">strip_crlf</span><span class="js-op">(</span><span class="js-id">temp</span><span class="js-op">);</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">trimmed</span> <span class="js-op">=</span> <span class="js-id">trim_whitespace</span><span class="js-op">(</span><span class="js-id">temp</span><span class="js-op">);</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">strlen</span><span class="js-op">(</span><span class="js-id">trimmed</span><span class="js-op">)</span> <span class="js-op">==</span> <span class="js-num">0</span> <span class="js-op">&&</span> <span class="js-id">default_val</span> <span class="js-op">>=</span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-op">*</span><span class="js-id">out_val</span> <span class="js-op">=</span> <span class="js-id">default_val</span><span class="js-op">;</span> <span class="js-kw">return</span> <span class="js-num">1</span><span class="js-op">;</span> <span class="js-op">}</span> <span class="js-id">int</span> <span class="js-id">val</span> <span class="js-op">=</span> <span class="js-num">0</span><span class="js-op">;</span> <span class="js-kw">if</span> <span class="js-op">(!</span><span class="js-id">parse_int_safe</span><span class="js-op">(</span><span class="js-id">trimmed</span><span class="js-op">,</span> <span class="js-id">min_val</span><span class="js-op">,</span> <span class="js-id">max_val</span><span class="js-op">,</span> <span class="js-op">&</span><span class="js-id">val</span><span class="js-op">))</span> <span class="js-op">{</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"Error: invalid number or out of range (%d to %d). Please try again.\n"</span><span class="js-op">,</span> <span class="js-id">min_val</span><span class="js-op">,</span> <span class="js-id">max_val</span><span class="js-op">);</span> <span class="js-kw">continue</span><span class="js-op">;</span> <span class="js-op">}</span> <span class="js-op">*</span><span class="js-id">out_val</span> <span class="js-op">=</span> <span class="js-id">val</span><span class="js-op">;</span> <span class="js-kw">return</span> <span class="js-num">1</span><span class="js-op">;</span> <span class="js-op">}}</span>
<span class="js-id">static</span> <span class="js-kw">void</span> <span class="js-id">print_usage</span><span class="js-op">(</span><span class="js-kw">const</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">prog_name</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"Usage: %s [OPTIONS]\n"</span><span class="js-op">,</span> <span class="js-id">prog_name</span><span class="js-op">);</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"Options:\n"</span><span class="js-op">);</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">" -h, --host <hostname> Target server hostname or IP address\n"</span><span class="js-op">);</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">" -p, --port <port> Target port (1 - 65535, default: %d)\n"</span><span class="js-op">,</span> <span class="js-id">DEFAULT_PORT</span><span class="js-op">);</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">" -r, --retries <num> Connection retry count (1 - 10, default: %d)\n"</span><span class="js-op">,</span> <span class="js-id">DEFAULT_RETRIES</span><span class="js-op">);</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">" -i, --interactive Prompt interactively for missing settings\n"</span><span class="js-op">);</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">" --help Display this help message and exit\n"</span><span class="js-op">);</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"\nEnvironment variables:\n"</span><span class="js-op">);</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">" APP_HOST Fallback target host if -h is not specified\n"</span><span class="js-op">);</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">" APP_PORT Fallback target port if -p is not specified\n"</span><span class="js-op">);</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">" APP_RETRIES Fallback retry count if -r is not specified\n"</span><span class="js-op">);}</span>
<span class="js-id">int</span> <span class="js-id">main</span><span class="js-op">(</span><span class="js-id">int</span> <span class="js-id">argc</span><span class="js-op">,</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">argv</span>[]<span class="js-op">)</span> <span class="js-op">{</span> <span class="js-id">AppConfig</span> <span class="js-id">config</span><span class="js-op">;</span> <span class="js-id">memset</span><span class="js-op">(&</span><span class="js-id">config</span><span class="js-op">,</span> <span class="js-num">0</span><span class="js-op">,</span> <span class="js-id">sizeof</span><span class="js-op">(</span><span class="js-id">config</span><span class="js-op">));</span> <span class="js-id">config</span><span class="js-op">.</span><span class="js-id">port</span> <span class="js-op">=</span> <span class="js-op">-</span><span class="js-num">1</span><span class="js-op">;</span> <span class="js-cm">/* Sentinel: indicates unassigned */</span> <span class="js-id">config</span><span class="js-op">.</span><span class="js-id">retries</span> <span class="js-op">=</span> <span class="js-op">-</span><span class="js-num">1</span><span class="js-op">;</span> <span class="js-cm">/* Sentinel: indicates unassigned */</span> <span class="js-id">config</span><span class="js-op">.</span><span class="js-id">interactive</span> <span class="js-op">=</span> <span class="js-num">0</span><span class="js-op">;</span>
<span class="js-cm">/* Phase 1: Parse Command-Line Arguments */</span> <span class="js-kw">for</span> <span class="js-op">(</span><span class="js-id">int</span> <span class="js-id">i</span> <span class="js-op">=</span> <span class="js-num">1</span><span class="js-op">;</span> <span class="js-id">i</span> <span class="js-op"><</span> <span class="js-id">argc</span><span class="js-op">;</span> <span class="js-id">i</span><span class="js-op">++)</span> <span class="js-op">{</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">strcmp</span><span class="js-op">(</span><span class="js-id">argv</span>[<span class="js-id">i</span>]<span class="js-op">,</span> <span class="js-str">"--help"</span><span class="js-op">)</span> <span class="js-op">==</span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-id">print_usage</span><span class="js-op">(</span><span class="js-id">argv</span>[<span class="js-num">0</span>]<span class="js-op">);</span> <span class="js-kw">return</span> <span class="js-num">0</span><span class="js-op">;</span> <span class="js-op">}</span> <span class="js-kw">else</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">strcmp</span><span class="js-op">(</span><span class="js-id">argv</span>[<span class="js-id">i</span>]<span class="js-op">,</span> <span class="js-str">"-i"</span><span class="js-op">)</span> <span class="js-op">==</span> <span class="js-num">0</span> <span class="js-op">||</span> <span class="js-id">strcmp</span><span class="js-op">(</span><span class="js-id">argv</span>[<span class="js-id">i</span>]<span class="js-op">,</span> <span class="js-str">"--interactive"</span><span class="js-op">)</span> <span class="js-op">==</span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-id">config</span><span class="js-op">.</span><span class="js-id">interactive</span> <span class="js-op">=</span> <span class="js-num">1</span><span class="js-op">;</span> <span class="js-op">}</span> <span class="js-kw">else</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">strcmp</span><span class="js-op">(</span><span class="js-id">argv</span>[<span class="js-id">i</span>]<span class="js-op">,</span> <span class="js-str">"-h"</span><span class="js-op">)</span> <span class="js-op">==</span> <span class="js-num">0</span> <span class="js-op">||</span> <span class="js-id">strcmp</span><span class="js-op">(</span><span class="js-id">argv</span>[<span class="js-id">i</span>]<span class="js-op">,</span> <span class="js-str">"--host"</span><span class="js-op">)</span> <span class="js-op">==</span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">i</span> <span class="js-op">+</span> <span class="js-num">1</span> <span class="js-op">>=</span> <span class="js-id">argc</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-id">fprintf</span><span class="js-op">(</span><span class="js-id">stderr</span><span class="js-op">,</span> <span class="js-str">"Error: %s requires a hostname argument.\n"</span><span class="js-op">,</span> <span class="js-id">argv</span>[<span class="js-id">i</span>]<span class="js-op">);</span> <span class="js-kw">return</span> <span class="js-num">1</span><span class="js-op">;</span> <span class="js-op">}</span> <span class="js-id">strncpy</span><span class="js-op">(</span><span class="js-id">config</span><span class="js-op">.</span><span class="js-id">host</span><span class="js-op">,</span> <span class="js-id">argv</span>[<span class="js-op">++</span><span class="js-id">i</span>]<span class="js-op">,</span> <span class="js-id">sizeof</span><span class="js-op">(</span><span class="js-id">config</span><span class="js-op">.</span><span class="js-id">host</span><span class="js-op">)</span> <span class="js-op">-</span> <span class="js-num">1</span><span class="js-op">);</span> <span class="js-id">config</span><span class="js-op">.</span><span class="js-id">host</span>[<span class="js-id">sizeof</span><span class="js-op">(</span><span class="js-id">config</span><span class="js-op">.</span><span class="js-id">host</span><span class="js-op">)</span> <span class="js-op">-</span> <span class="js-num">1</span>] <span class="js-op">=</span> <span class="js-str">'\0'</span><span class="js-op">;</span> <span class="js-op">}</span> <span class="js-kw">else</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">strcmp</span><span class="js-op">(</span><span class="js-id">argv</span>[<span class="js-id">i</span>]<span class="js-op">,</span> <span class="js-str">"-p"</span><span class="js-op">)</span> <span class="js-op">==</span> <span class="js-num">0</span> <span class="js-op">||</span> <span class="js-id">strcmp</span><span class="js-op">(</span><span class="js-id">argv</span>[<span class="js-id">i</span>]<span class="js-op">,</span> <span class="js-str">"--port"</span><span class="js-op">)</span> <span class="js-op">==</span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">i</span> <span class="js-op">+</span> <span class="js-num">1</span> <span class="js-op">>=</span> <span class="js-id">argc</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-id">fprintf</span><span class="js-op">(</span><span class="js-id">stderr</span><span class="js-op">,</span> <span class="js-str">"Error: %s requires a port argument.\n"</span><span class="js-op">,</span> <span class="js-id">argv</span>[<span class="js-id">i</span>]<span class="js-op">);</span> <span class="js-kw">return</span> <span class="js-num">1</span><span class="js-op">;</span> <span class="js-op">}</span> <span class="js-kw">if</span> <span class="js-op">(!</span><span class="js-id">parse_int_safe</span><span class="js-op">(</span><span class="js-id">argv</span>[<span class="js-op">++</span><span class="js-id">i</span>]<span class="js-op">,</span> <span class="js-num">1</span><span class="js-op">,</span> <span class="js-num">65535</span><span class="js-op">,</span> <span class="js-op">&</span><span class="js-id">config</span><span class="js-op">.</span><span class="js-id">port</span><span class="js-op">))</span> <span class="js-op">{</span> <span class="js-id">fprintf</span><span class="js-op">(</span><span class="js-id">stderr</span><span class="js-op">,</span> <span class="js-str">"Error: invalid port '%s'. Must be an integer between 1 and 65535.\n"</span><span class="js-op">,</span> <span class="js-id">argv</span>[<span class="js-id">i</span>]<span class="js-op">);</span> <span class="js-kw">return</span> <span class="js-num">1</span><span class="js-op">;</span> <span class="js-op">}</span> <span class="js-op">}</span> <span class="js-kw">else</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">strcmp</span><span class="js-op">(</span><span class="js-id">argv</span>[<span class="js-id">i</span>]<span class="js-op">,</span> <span class="js-str">"-r"</span><span class="js-op">)</span> <span class="js-op">==</span> <span class="js-num">0</span> <span class="js-op">||</span> <span class="js-id">strcmp</span><span class="js-op">(</span><span class="js-id">argv</span>[<span class="js-id">i</span>]<span class="js-op">,</span> <span class="js-str">"--retries"</span><span class="js-op">)</span> <span class="js-op">==</span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">i</span> <span class="js-op">+</span> <span class="js-num">1</span> <span class="js-op">>=</span> <span class="js-id">argc</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-id">fprintf</span><span class="js-op">(</span><span class="js-id">stderr</span><span class="js-op">,</span> <span class="js-str">"Error: %s requires a retry count argument.\n"</span><span class="js-op">,</span> <span class="js-id">argv</span>[<span class="js-id">i</span>]<span class="js-op">);</span> <span class="js-kw">return</span> <span class="js-num">1</span><span class="js-op">;</span> <span class="js-op">}</span> <span class="js-kw">if</span> <span class="js-op">(!</span><span class="js-id">parse_int_safe</span><span class="js-op">(</span><span class="js-id">argv</span>[<span class="js-op">++</span><span class="js-id">i</span>]<span class="js-op">,</span> <span class="js-num">1</span><span class="js-op">,</span> <span class="js-num">10</span><span class="js-op">,</span> <span class="js-op">&</span><span class="js-id">config</span><span class="js-op">.</span><span class="js-id">retries</span><span class="js-op">))</span> <span class="js-op">{</span> <span class="js-id">fprintf</span><span class="js-op">(</span><span class="js-id">stderr</span><span class="js-op">,</span> <span class="js-str">"Error: invalid retries count '%s'. Must be between 1 and 10.\n"</span><span class="js-op">,</span> <span class="js-id">argv</span>[<span class="js-id">i</span>]<span class="js-op">);</span> <span class="js-kw">return</span> <span class="js-num">1</span><span class="js-op">;</span> <span class="js-op">}</span> <span class="js-op">}</span> <span class="js-kw">else</span> <span class="js-op">{</span> <span class="js-id">fprintf</span><span class="js-op">(</span><span class="js-id">stderr</span><span class="js-op">,</span> <span class="js-str">"Error: unrecognized option '%s'. Run with --help for usage.\n"</span><span class="js-op">,</span> <span class="js-id">argv</span>[<span class="js-id">i</span>]<span class="js-op">);</span> <span class="js-kw">return</span> <span class="js-num">1</span><span class="js-op">;</span> <span class="js-op">}</span> <span class="js-op">}</span>
<span class="js-cm">/* Phase 2: Environment Variables Fallback */</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">strlen</span><span class="js-op">(</span><span class="js-id">config</span><span class="js-op">.</span><span class="js-id">host</span><span class="js-op">)</span> <span class="js-op">==</span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-kw">const</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">env_host</span> <span class="js-op">=</span> <span class="js-id">getenv</span><span class="js-op">(</span><span class="js-str">"APP_HOST"</span><span class="js-op">);</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">env_host</span> <span class="js-op">&&</span> <span class="js-id">strlen</span><span class="js-op">(</span><span class="js-id">env_host</span><span class="js-op">)</span> <span class="js-op">></span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-id">strncpy</span><span class="js-op">(</span><span class="js-id">config</span><span class="js-op">.</span><span class="js-id">host</span><span class="js-op">,</span> <span class="js-id">env_host</span><span class="js-op">,</span> <span class="js-id">sizeof</span><span class="js-op">(</span><span class="js-id">config</span><span class="js-op">.</span><span class="js-id">host</span><span class="js-op">)</span> <span class="js-op">-</span> <span class="js-num">1</span><span class="js-op">);</span> <span class="js-id">config</span><span class="js-op">.</span><span class="js-id">host</span>[<span class="js-id">sizeof</span><span class="js-op">(</span><span class="js-id">config</span><span class="js-op">.</span><span class="js-id">host</span><span class="js-op">)</span> <span class="js-op">-</span> <span class="js-num">1</span>] <span class="js-op">=</span> <span class="js-str">'\0'</span><span class="js-op">;</span> <span class="js-op">}</span> <span class="js-op">}</span>
<span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">config</span><span class="js-op">.</span><span class="js-id">port</span> <span class="js-op"><</span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-kw">const</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">env_port</span> <span class="js-op">=</span> <span class="js-id">getenv</span><span class="js-op">(</span><span class="js-str">"APP_PORT"</span><span class="js-op">);</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">env_port</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-id">int</span> <span class="js-id">p</span> <span class="js-op">=</span> <span class="js-num">0</span><span class="js-op">;</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">parse_int_safe</span><span class="js-op">(</span><span class="js-id">env_port</span><span class="js-op">,</span> <span class="js-num">1</span><span class="js-op">,</span> <span class="js-num">65535</span><span class="js-op">,</span> <span class="js-op">&</span><span class="js-id">p</span><span class="js-op">))</span> <span class="js-op">{</span> <span class="js-id">config</span><span class="js-op">.</span><span class="js-id">port</span> <span class="js-op">=</span> <span class="js-id">p</span><span class="js-op">;</span> <span class="js-op">}</span> <span class="js-kw">else</span> <span class="js-op">{</span> <span class="js-id">fprintf</span><span class="js-op">(</span><span class="js-id">stderr</span><span class="js-op">,</span> <span class="js-str">"Warning: APP_PORT '%s' is invalid, ignoring.\n"</span><span class="js-op">,</span> <span class="js-id">env_port</span><span class="js-op">);</span> <span class="js-op">}</span> <span class="js-op">}</span> <span class="js-op">}</span>
<span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">config</span><span class="js-op">.</span><span class="js-id">retries</span> <span class="js-op"><</span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-kw">const</span> <span class="js-id">char</span> <span class="js-op">*</span><span class="js-id">env_retries</span> <span class="js-op">=</span> <span class="js-id">getenv</span><span class="js-op">(</span><span class="js-str">"APP_RETRIES"</span><span class="js-op">);</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">env_retries</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-id">int</span> <span class="js-id">r</span> <span class="js-op">=</span> <span class="js-num">0</span><span class="js-op">;</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">parse_int_safe</span><span class="js-op">(</span><span class="js-id">env_retries</span><span class="js-op">,</span> <span class="js-num">1</span><span class="js-op">,</span> <span class="js-num">10</span><span class="js-op">,</span> <span class="js-op">&</span><span class="js-id">r</span><span class="js-op">))</span> <span class="js-op">{</span> <span class="js-id">config</span><span class="js-op">.</span><span class="js-id">retries</span> <span class="js-op">=</span> <span class="js-id">r</span><span class="js-op">;</span> <span class="js-op">}</span> <span class="js-kw">else</span> <span class="js-op">{</span> <span class="js-id">fprintf</span><span class="js-op">(</span><span class="js-id">stderr</span><span class="js-op">,</span> <span class="js-str">"Warning: APP_RETRIES '%s' is invalid, ignoring.\n"</span><span class="js-op">,</span> <span class="js-id">env_retries</span><span class="js-op">);</span> <span class="js-op">}</span> <span class="js-op">}</span> <span class="js-op">}</span>
<span class="js-cm">/* Phase 3: Interactive Prompt Fallback */</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">config</span><span class="js-op">.</span><span class="js-id">interactive</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">strlen</span><span class="js-op">(</span><span class="js-id">config</span><span class="js-op">.</span><span class="js-id">host</span><span class="js-op">)</span> <span class="js-op">==</span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-kw">if</span> <span class="js-op">(!</span><span class="js-id">prompt_string</span><span class="js-op">(</span><span class="js-str">"Enter target host (e.g., api.example.com): "</span><span class="js-op">,</span> <span class="js-id">config</span><span class="js-op">.</span><span class="js-id">host</span><span class="js-op">,</span> <span class="js-id">sizeof</span><span class="js-op">(</span><span class="js-id">config</span><span class="js-op">.</span><span class="js-id">host</span><span class="js-op">)))</span> <span class="js-op">{</span> <span class="js-kw">return</span> <span class="js-num">1</span><span class="js-op">;</span> <span class="js-op">}</span> <span class="js-op">}</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">config</span><span class="js-op">.</span><span class="js-id">port</span> <span class="js-op"><</span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-kw">if</span> <span class="js-op">(!</span><span class="js-id">prompt_int</span><span class="js-op">(</span><span class="js-str">"Enter target port"</span><span class="js-op">,</span> <span class="js-num">1</span><span class="js-op">,</span> <span class="js-num">65535</span><span class="js-op">,</span> <span class="js-id">DEFAULT_PORT</span><span class="js-op">,</span> <span class="js-op">&</span><span class="js-id">config</span><span class="js-op">.</span><span class="js-id">port</span><span class="js-op">))</span> <span class="js-op">{</span> <span class="js-kw">return</span> <span class="js-num">1</span><span class="js-op">;</span> <span class="js-op">}</span> <span class="js-op">}</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">config</span><span class="js-op">.</span><span class="js-id">retries</span> <span class="js-op"><</span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-kw">if</span> <span class="js-op">(!</span><span class="js-id">prompt_int</span><span class="js-op">(</span><span class="js-str">"Enter retry limit"</span><span class="js-op">,</span> <span class="js-num">1</span><span class="js-op">,</span> <span class="js-num">10</span><span class="js-op">,</span> <span class="js-id">DEFAULT_RETRIES</span><span class="js-op">,</span> <span class="js-op">&</span><span class="js-id">config</span><span class="js-op">.</span><span class="js-id">retries</span><span class="js-op">))</span> <span class="js-op">{</span> <span class="js-kw">return</span> <span class="js-num">1</span><span class="js-op">;</span> <span class="js-op">}</span> <span class="js-op">}</span> <span class="js-op">}</span>
<span class="js-cm">/* Phase 4: Apply Hardcoded Defaults */</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">config</span><span class="js-op">.</span><span class="js-id">port</span> <span class="js-op"><</span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-id">config</span><span class="js-op">.</span><span class="js-id">port</span> <span class="js-op">=</span> <span class="js-id">DEFAULT_PORT</span><span class="js-op">;</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">config</span><span class="js-op">.</span><span class="js-id">retries</span> <span class="js-op"><</span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-id">config</span><span class="js-op">.</span><span class="js-id">retries</span> <span class="js-op">=</span> <span class="js-id">DEFAULT_RETRIES</span><span class="js-op">;</span>
<span class="js-cm">/* Phase 5: Final Validation Gate */</span> <span class="js-kw">if</span> <span class="js-op">(</span><span class="js-id">strlen</span><span class="js-op">(</span><span class="js-id">config</span><span class="js-op">.</span><span class="js-id">host</span><span class="js-op">)</span> <span class="js-op">==</span> <span class="js-num">0</span><span class="js-op">)</span> <span class="js-op">{</span> <span class="js-id">fprintf</span><span class="js-op">(</span><span class="js-id">stderr</span><span class="js-op">,</span> <span class="js-str">"Error: host was not specified.\n"</span><span class="js-op">);</span> <span class="js-id">fprintf</span><span class="js-op">(</span><span class="js-id">stderr</span><span class="js-op">,</span> <span class="js-str">"Provide it via -h/--host, APP_HOST environment variable, or run with -i.\n"</span><span class="js-op">);</span> <span class="js-kw">return</span> <span class="js-num">1</span><span class="js-op">;</span> <span class="js-op">}</span>
<span class="js-cm">/* Display Active Configuration */</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"\n=== Active Program Configuration ===\n"</span><span class="js-op">);</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"Target Host : %s\n"</span><span class="js-op">,</span> <span class="js-id">config</span><span class="js-op">.</span><span class="js-id">host</span><span class="js-op">);</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"Target Port : %d\n"</span><span class="js-op">,</span> <span class="js-id">config</span><span class="js-op">.</span><span class="js-id">port</span><span class="js-op">);</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"Retry Limit : %d\n"</span><span class="js-op">,</span> <span class="js-id">config</span><span class="js-op">.</span><span class="js-id">retries</span><span class="js-op">);</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"Interactive : %s\n"</span><span class="js-op">,</span> <span class="js-id">config</span><span class="js-op">.</span><span class="js-id">interactive</span> <span class="js-op">?</span> <span class="js-str">"Enabled"</span> <span class="js-op">:</span> <span class="js-str">"Disabled"</span><span class="js-op">);</span> <span class="js-id">printf</span><span class="js-op">(</span><span class="js-str">"Status : Ready to connect.\n"</span><span class="js-op">);</span>
<span class="js-kw">return</span> <span class="js-num">0</span><span class="js-op">;}</span></code></pre></div></div></div><hr class="my-6" data-streamdown="horizontal-rule" style="border-width: 1px 0px 0px; border-style: solid; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); height: 0px; margin-block: 1rem 0.75rem; --tw-space-y-reverse: 0; font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);"><h2 class="mt-6 mb-2 font-semibold text-2xl" data-streamdown="heading-2" dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 22.5px 0px 7.5px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-size: 1.125rem; line-height: 1.35; --tw-space-y-reverse: 0; letter-spacing: -0.105469px; --tw-font-weight: 600; margin-block: 1.25rem 0.75rem; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; background-color: rgb(18, 18, 22);">5. Execution Traces Across Multiple Scenarios</h2><h3 class="mt-6 mb-2 font-semibold text-xl" data-streamdown="heading-3" dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 22.5px 0px 7.5px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-size: 1rem; line-height: 1.35; --tw-space-y-reverse: 0; letter-spacing: -0.075px; --tw-font-weight: 600; margin-block: 1.25rem 0.75rem; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; background-color: rgb(18, 18, 22);">Scenario A: Fully Automated Scripting Mode</h3><p dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);">Supplying all parameters via command line flags bypasses terminal interaction entirely:</p><div class="my-4 flex w-full flex-col gap-2 rounded-xl bg-sidebar p-2" data-language="bash" data-streamdown="code-block" dir="ltr" style="border-width: medium; border-style: none; border-color: currentcolor; border-image: none; margin: 0px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); max-width: 100%; border-radius: 7.5px; margin-block: 1rem 0.75rem; background: 0px 0px rgb(18, 18, 22); gap: 0px; --tw-space-y-reverse: 0; display: flex; width: 960px; flex-direction: column; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; content-visibility: auto; contain-intrinsic-size: auto 200px;"><div class="language-bash" data-language="bash" data-streamdown="code-block-body" dir="ltr" style="border: 1px solid rgb(47, 47, 55); padding: 0.625rem 0.75rem; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); background: none 0% 0% / auto repeat scroll padding-box border-box rgb(24, 25, 27); border-radius: 0.5rem; font-size: 0.8125rem; line-height: 1.6; max-height: 400px;"><div class="code-card position-relative my-2">
<div class="code-card-actions">
<button type="button" class="btn-code-action copy-code-btn" onclick="copyCode(this)" title="Copy Code">
<i class="far fa-copy"></i>
</button>
<a href="/tools/c-compiler" target="_blank" class="btn-code-action run-code-btn" title="Run Online">
<i class="fas fa-play"></i>
</a>
</div>
<pre class="language-bash bg-[var(--sdm-bg,inherit)] dark:bg-[var(--shiki-dark-bg,var(--sdm-bg,inherit))] code-box" style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text; background: 0px 0px; --sdm-bg: transparent; --sdm-fg: inherit;"><code style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text;">$ <span class="js-op">./</span><span class="js-id">cli_input_demo</span> <span class="js-op">-</span><span class="js-id">h</span> <span class="js-id">db</span><span class="js-op">.</span><span class="js-id">internal</span><span class="js-op">.</span><span class="js-id">net</span> <span class="js-op">-</span><span class="js-id">p</span> <span class="js-num">5432</span> <span class="js-op">-</span><span class="js-id">r</span> <span class="js-num">5</span>
<span class="js-op">===</span> <span class="js-id">Active</span> <span class="js-id">Program</span> <span class="js-id">Configuration</span> <span class="js-op">===</span><span class="js-id">Target</span> <span class="js-id">Host</span> <span class="js-op">:</span> <span class="js-id">db</span><span class="js-op">.</span><span class="js-id">internal</span><span class="js-op">.</span><span class="js-id">netTarget</span> <span class="js-id">Port</span> <span class="js-op">:</span> 5432Retry <span class="js-id">Limit</span> <span class="js-op">:</span> 5Interactive <span class="js-op">:</span> <span class="js-id">DisabledStatus</span> <span class="js-op">:</span> <span class="js-id">Ready</span> <span class="js-id">to</span> <span class="js-id">connect</span><span class="js-op">.</span></code></pre></div></div></div><h3 class="mt-6 mb-2 font-semibold text-xl" data-streamdown="heading-3" dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 22.5px 0px 7.5px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-size: 1rem; line-height: 1.35; --tw-space-y-reverse: 0; letter-spacing: -0.075px; --tw-font-weight: 600; margin-block: 1.25rem 0.75rem; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; background-color: rgb(18, 18, 22);">Scenario B: Environmental Precedence in Containers</h3><p dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);">Defaults injected via container environment variables are seamlessly adopted without user prompts:</p><div class="my-4 flex w-full flex-col gap-2 rounded-xl bg-sidebar p-2" data-language="bash" data-streamdown="code-block" dir="ltr" style="border-width: medium; border-style: none; border-color: currentcolor; border-image: none; margin: 0px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); max-width: 100%; border-radius: 7.5px; margin-block: 1rem 0.75rem; background: 0px 0px rgb(18, 18, 22); gap: 0px; --tw-space-y-reverse: 0; display: flex; width: 960px; flex-direction: column; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; content-visibility: auto; contain-intrinsic-size: auto 200px;"><div class="language-bash" data-language="bash" data-streamdown="code-block-body" dir="ltr" style="border: 1px solid rgb(47, 47, 55); padding: 0.625rem 0.75rem; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); background: none 0% 0% / auto repeat scroll padding-box border-box rgb(24, 25, 27); border-radius: 0.5rem; font-size: 0.8125rem; line-height: 1.6; max-height: 400px;"><div class="code-card position-relative my-2">
<div class="code-card-actions">
<button type="button" class="btn-code-action copy-code-btn" onclick="copyCode(this)" title="Copy Code">
<i class="far fa-copy"></i>
</button>
<a href="/tools/c-compiler" target="_blank" class="btn-code-action run-code-btn" title="Run Online">
<i class="fas fa-play"></i>
</a>
</div>
<pre class="language-bash bg-[var(--sdm-bg,inherit)] dark:bg-[var(--shiki-dark-bg,var(--sdm-bg,inherit))] code-box" style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text; background: 0px 0px; --sdm-bg: transparent; --sdm-fg: inherit;"><code style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text;">$ <span class="js-kw">export</span> <span class="js-id">APP_HOST</span><span class="js-op">=</span><span class="js-str">"api.service.local"</span>$ <span class="js-kw">export</span> <span class="js-id">APP_PORT</span><span class="js-op">=</span><span class="js-str">"9000"</span>$ <span class="js-op">./</span><span class="js-id">cli_input_demo</span>
<span class="js-op">===</span> <span class="js-id">Active</span> <span class="js-id">Program</span> <span class="js-id">Configuration</span> <span class="js-op">===</span><span class="js-id">Target</span> <span class="js-id">Host</span> <span class="js-op">:</span> <span class="js-id">api</span><span class="js-op">.</span><span class="js-id">service</span><span class="js-op">.</span><span class="js-id">localTarget</span> <span class="js-id">Port</span> <span class="js-op">:</span> 9000Retry <span class="js-id">Limit</span> <span class="js-op">:</span> 3Interactive <span class="js-op">:</span> <span class="js-id">DisabledStatus</span> <span class="js-op">:</span> <span class="js-id">Ready</span> <span class="js-id">to</span> <span class="js-id">connect</span><span class="js-op">.</span></code></pre></div></div></div><p dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);">If a command-line flag is added, it wins over the environment variable:</p><div class="my-4 flex w-full flex-col gap-2 rounded-xl bg-sidebar p-2" data-language="bash" data-streamdown="code-block" dir="ltr" style="border-width: medium; border-style: none; border-color: currentcolor; border-image: none; margin: 0px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); max-width: 100%; border-radius: 7.5px; margin-block: 1rem 0.75rem; background: 0px 0px rgb(18, 18, 22); gap: 0px; --tw-space-y-reverse: 0; display: flex; width: 960px; flex-direction: column; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; content-visibility: auto; contain-intrinsic-size: auto 200px;"><div class="language-bash" data-language="bash" data-streamdown="code-block-body" dir="ltr" style="border: 1px solid rgb(47, 47, 55); padding: 0.625rem 0.75rem; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); background: none 0% 0% / auto repeat scroll padding-box border-box rgb(24, 25, 27); border-radius: 0.5rem; font-size: 0.8125rem; line-height: 1.6; max-height: 400px;"><div class="code-card position-relative my-2">
<div class="code-card-actions">
<button type="button" class="btn-code-action copy-code-btn" onclick="copyCode(this)" title="Copy Code">
<i class="far fa-copy"></i>
</button>
<a href="/tools/c-compiler" target="_blank" class="btn-code-action run-code-btn" title="Run Online">
<i class="fas fa-play"></i>
</a>
</div>
<pre class="language-bash bg-[var(--sdm-bg,inherit)] dark:bg-[var(--shiki-dark-bg,var(--sdm-bg,inherit))] code-box" style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text; background: 0px 0px; --sdm-bg: transparent; --sdm-fg: inherit;"><code style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text;">$ <span class="js-op">./</span><span class="js-id">cli_input_demo</span> <span class="js-op">-</span><span class="js-id">p</span> <span class="js-num">443</span>
<span class="js-op">===</span> <span class="js-id">Active</span> <span class="js-id">Program</span> <span class="js-id">Configuration</span> <span class="js-op">===</span>
<span class="js-id">Target</span> <span class="js-id">Host</span> <span class="js-op">:</span> <span class="js-id">api</span><span class="js-op">.</span><span class="js-id">service</span><span class="js-op">.</span><span class="js-id">local</span>
<span class="js-id">Target</span> <span class="js-id">Port</span> <span class="js-op">:</span> <span class="js-num">443</span>
<span class="js-id">Retry</span> <span class="js-id">Limit</span> <span class="js-op">:</span> <span class="js-num">3</span>
<span class="js-id">Interactive</span> <span class="js-op">:</span> <span class="js-id">Disabled</span>
<span class="js-id">Status</span> <span class="js-op">:</span> <span class="js-id">Ready</span> <span class="js-id">to</span> <span class="js-id">connect</span><span class="js-op">.</span></code></pre></div></div></div><h3 class="mt-6 mb-2 font-semibold text-xl" data-streamdown="heading-3" dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 22.5px 0px 7.5px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-size: 1rem; line-height: 1.35; --tw-space-y-reverse: 0; letter-spacing: -0.075px; --tw-font-weight: 600; margin-block: 1.25rem 0.75rem; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; background-color: rgb(18, 18, 22);">Scenario C: Interactive Prompts with Input Validation and Re-prompting</h3><p dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);">Running with <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">-i</code> activates interactive prompting with range validation and graceful default selection:</p><div class="my-4 flex w-full flex-col gap-2 rounded-xl bg-sidebar p-2" data-language="text" data-streamdown="code-block" dir="ltr" style="border-width: medium; border-style: none; border-color: currentcolor; border-image: none; margin: 0px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); max-width: 100%; border-radius: 7.5px; margin-block: 1rem 0.75rem; background: 0px 0px rgb(18, 18, 22); gap: 0px; --tw-space-y-reverse: 0; display: flex; width: 960px; flex-direction: column; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; content-visibility: auto; contain-intrinsic-size: auto 200px;"><div class="language-text" data-language="text" data-streamdown="code-block-body" dir="ltr" style="border: 1px solid rgb(47, 47, 55); padding: 0.625rem 0.75rem; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); background: none 0% 0% / auto repeat scroll padding-box border-box rgb(24, 25, 27); border-radius: 0.5rem; font-size: 0.8125rem; line-height: 1.6; max-height: 400px;"><div class="code-card position-relative my-2">
<div class="code-card-actions">
<button type="button" class="btn-code-action copy-code-btn" onclick="copyCode(this)" title="Copy Code">
<i class="far fa-copy"></i>
</button>
<a href="/tools/c-compiler" target="_blank" class="btn-code-action run-code-btn" title="Run Online">
<i class="fas fa-play"></i>
</a>
</div>
<pre class="language-text bg-[var(--sdm-bg,inherit)] dark:bg-[var(--shiki-dark-bg,var(--sdm-bg,inherit))] code-box" style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text; background: 0px 0px; --sdm-bg: transparent; --sdm-fg: inherit;"><code style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text;">$ <span class="js-op">./</span><span class="js-id">cli_input_demo</span> <span class="js-op">-</span><span class="js-id">i</span>
<span class="js-id">Enter</span> <span class="js-id">target</span> <span class="js-id">host</span> <span class="js-op">(</span><span class="js-id">e</span><span class="js-op">.</span><span class="js-id">g</span><span class="js-op">.,</span> <span class="js-id">api</span><span class="js-op">.</span><span class="js-id">example</span><span class="js-op">.</span><span class="js-id">com</span><span class="js-op">):</span>
<span class="js-id">Error</span><span class="js-op">:</span> <span class="js-id">input</span> <span class="js-id">cannot</span> <span class="js-id">be</span> <span class="js-id">empty</span><span class="js-op">.</span> <span class="js-id">Please</span> <span class="js-kw">try</span> <span class="js-id">again</span><span class="js-op">.</span>
<span class="js-id">Enter</span> <span class="js-id">target</span> <span class="js-id">host</span> <span class="js-op">(</span><span class="js-id">e</span><span class="js-op">.</span><span class="js-id">g</span><span class="js-op">.,</span> <span class="js-id">api</span><span class="js-op">.</span><span class="js-id">example</span><span class="js-op">.</span><span class="js-id">com</span><span class="js-op">):</span> <span class="js-id">gateway</span><span class="js-op">.</span><span class="js-id">prod</span><span class="js-op">.</span><span class="js-id">org</span>
<span class="js-id">Enter</span> <span class="js-id">target</span> <span class="js-id">port</span> [<span class="js-num">8080</span>]<span class="js-op">:</span> <span class="js-num">99999</span>
<span class="js-id">Error</span><span class="js-op">:</span> <span class="js-id">invalid</span> <span class="js-id">number</span> <span class="js-id">or</span> <span class="js-id">out</span> <span class="js-kw">of</span> <span class="js-id">range</span> <span class="js-op">(</span><span class="js-num">1</span> <span class="js-id">to</span> <span class="js-num">65535</span><span class="js-op">).</span> <span class="js-id">Please</span> <span class="js-kw">try</span> <span class="js-id">again</span><span class="js-op">.</span>
<span class="js-id">Enter</span> <span class="js-id">target</span> <span class="js-id">port</span> [<span class="js-num">8080</span>]<span class="js-op">:</span>
<span class="js-id">Enter</span> <span class="js-id">retry</span> <span class="js-id">limit</span> [<span class="js-num">3</span>]<span class="js-op">:</span> <span class="js-num">4</span>
<span class="js-op">===</span> <span class="js-id">Active</span> <span class="js-id">Program</span> <span class="js-id">Configuration</span> <span class="js-op">===</span>
<span class="js-id">Target</span> <span class="js-id">Host</span> <span class="js-op">:</span> <span class="js-id">gateway</span><span class="js-op">.</span><span class="js-id">prod</span><span class="js-op">.</span><span class="js-id">org</span>
<span class="js-id">Target</span> <span class="js-id">Port</span> <span class="js-op">:</span> <span class="js-num">8080</span>
<span class="js-id">Retry</span> <span class="js-id">Limit</span> <span class="js-op">:</span> <span class="js-num">4</span>
<span class="js-id">Interactive</span> <span class="js-op">:</span> <span class="js-id">Enabled</span>
<span class="js-id">Status</span> <span class="js-op">:</span> <span class="js-id">Ready</span> <span class="js-id">to</span> <span class="js-id">connect</span><span class="js-op">.</span></code></pre></div></div></div><p dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);">Notice:</p><ul class="list-inside list-disc whitespace-normal [li_&]:pl-6" data-streamdown="unordered-list" style="border: 0px solid rgb(47, 47, 55); margin: 0px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); list-style: outside disc; padding-inline-start: 1.375rem; margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);"><li class="py-1 [&>p]:inline" data-streamdown="list-item" dir="ltr" style="border: 0px solid rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); padding-block: 0.125rem;">The empty host was rejected with an error message, and the user was re-prompted.</li><li class="py-1 [&>p]:inline" data-streamdown="list-item" dir="ltr" style="border: 0px solid rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); padding-block: 0.125rem;">The port <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">99999</code> exceeded the valid range ($1$–$65535$) and was rejected.</li><li class="py-1 [&>p]:inline" data-streamdown="list-item" dir="ltr" style="border: 0px solid rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); padding-block: 0.125rem;">Pressing <kbd dir="ltr" style="border: 0px solid rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em;">Enter</kbd> at <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">Enter target port [8080]:</code> immediately selected the default port <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">8080</code>.</li></ul><hr class="my-6" data-streamdown="horizontal-rule" style="border-width: 1px 0px 0px; border-style: solid; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); height: 0px; margin-block: 1rem 0.75rem; --tw-space-y-reverse: 0; font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);"><h2 class="mt-6 mb-2 font-semibold text-2xl" data-streamdown="heading-2" dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 22.5px 0px 7.5px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-size: 1.125rem; line-height: 1.35; --tw-space-y-reverse: 0; letter-spacing: -0.105469px; --tw-font-weight: 600; margin-block: 1.25rem 0.75rem; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; background-color: rgb(18, 18, 22);">6. Common Pitfalls and Anti-Patterns</h2><h3 class="mt-6 mb-2 font-semibold text-xl" data-streamdown="heading-3" dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 22.5px 0px 7.5px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-size: 1rem; line-height: 1.35; --tw-space-y-reverse: 0; letter-spacing: -0.075px; --tw-font-weight: 600; margin-block: 1.25rem 0.75rem; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; background-color: rgb(18, 18, 22);">1. The <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; letter-spacing: normal; padding: 0.1em 0.35em;">fflush(stdout)</code> Omission</h3><p dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);">When printing prompts that do not end in a newline character (e.g., <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">printf("Enter port: ");</code>), output buffering may prevent the prompt from displaying on terminal screens before <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">fgets()</code> blocks execution. <span class="font-semibold" data-streamdown="strong" style="border: 0px solid rgb(47, 47, 55); outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); --tw-font-weight: 600; font-weight: 600;">Always call <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">fflush(stdout)</code> immediately following a prompt.</span></p><h3 class="mt-6 mb-2 font-semibold text-xl" data-streamdown="heading-3" dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 22.5px 0px 7.5px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-size: 1rem; line-height: 1.35; --tw-space-y-reverse: 0; letter-spacing: -0.075px; --tw-font-weight: 600; margin-block: 1.25rem 0.75rem; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; background-color: rgb(18, 18, 22);">2. Failure to Strip Newlines</h3><p dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);"><code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">fgets()</code> retains the trailing newline character (<code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">\n</code>) if buffer capacity allows. Comparing strings with <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">strcmp(input, "yes")</code> will fail if <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">input</code> actually contains <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">"yes\n"</code>. Always strip carriage returns (<code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">\r</code>) and newlines (<code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">\n</code>) before comparison.</p><h3 class="mt-6 mb-2 font-semibold text-xl" data-streamdown="heading-3" dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 22.5px 0px 7.5px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-size: 1rem; line-height: 1.35; --tw-space-y-reverse: 0; letter-spacing: -0.075px; --tw-font-weight: 600; margin-block: 1.25rem 0.75rem; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; background-color: rgb(18, 18, 22);">3. Mixing <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; letter-spacing: normal; padding: 0.1em 0.35em;">scanf()</code> and <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; letter-spacing: normal; padding: 0.1em 0.35em;">fgets()</code></h3><p dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);">Calling <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">scanf("%d", &port)</code> followed by <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">fgets(name, sizeof(name), stdin)</code> is one of the most common C student bugs. <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">scanf</code> consumes numeric digits but leaves the subsequent newline (<code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">\n</code>) in <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">stdin</code>. When <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">fgets()</code> runs, it immediately reads the leftover newline and returns an empty string without waiting for the user. <span class="font-semibold" data-streamdown="strong" style="border: 0px solid rgb(47, 47, 55); outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); --tw-font-weight: 600; font-weight: 600;">Standardize on <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">fgets()</code> for all terminal reading.</span></p><h3 class="mt-6 mb-2 font-semibold text-xl" data-streamdown="heading-3" dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 22.5px 0px 7.5px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-size: 1rem; line-height: 1.35; --tw-space-y-reverse: 0; letter-spacing: -0.075px; --tw-font-weight: 600; margin-block: 1.25rem 0.75rem; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; background-color: rgb(18, 18, 22);">4. Memory Overwrite on <code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; letter-spacing: normal; padding: 0.1em 0.35em;">strncpy</code></h3><p dir="ltr" style="border: 0px solid rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); margin-block: 0px 0.75rem; --tw-space-y-reverse: 0; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; background-color: rgb(18, 18, 22);"><code class="rounded bg-muted px-1.5 py-0.5 font-mono text-sm" data-streamdown="inline-code" dir="ltr" style="border-width: 0px; border-color: rgb(47, 47, 55); margin: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 0.8125rem; user-select: text; border-radius: 0.25rem; background-color: rgb(33, 34, 37); padding-inline: 5.625px; padding-block: 1.875px; line-height: 18.75px; padding: 0.1em 0.35em;">strncpy</code> does not guarantee null-termination if the source string exceeds the destination length. Always manually set the final byte to null:</p><div class="my-4 flex w-full flex-col gap-2 rounded-xl bg-sidebar p-2" data-language="c" data-streamdown="code-block" dir="ltr" style="border-width: medium; border-style: none; border-color: currentcolor; border-image: none; margin: 0px; padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); max-width: 100%; border-radius: 7.5px; margin-block: 1rem 0.75rem; background: 0px 0px rgb(18, 18, 22); gap: 0px; --tw-space-y-reverse: 0; display: flex; width: 960px; flex-direction: column; color: rgb(252, 252, 253); font-family: "Inter Variable", sans-serif; font-size: 13px; content-visibility: auto; contain-intrinsic-size: auto 200px;"><div class="language-c" data-language="c" data-streamdown="code-block-body" dir="ltr" style="border: 1px solid rgb(47, 47, 55); padding: 0.625rem 0.75rem; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); background: none 0% 0% / auto repeat scroll padding-box border-box rgb(24, 25, 27); border-radius: 0.5rem; font-size: 0.8125rem; line-height: 1.6; max-height: 400px;"><div class="code-card position-relative my-2">
<div class="code-card-actions">
<button type="button" class="btn-code-action copy-code-btn" onclick="copyCode(this)" title="Copy Code">
<i class="far fa-copy"></i>
</button>
<a href="/tools/c-compiler" target="_blank" class="btn-code-action run-code-btn" title="Run Online">
<i class="fas fa-play"></i>
</a>
</div>
<pre class="language-c bg-[var(--sdm-bg,inherit)] dark:bg-[var(--shiki-dark-bg,var(--sdm-bg,inherit))] code-box" style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); padding: 0px; outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text; background: 0px 0px; --sdm-bg: transparent; --sdm-fg: inherit;"><code style="border-width: 0px; border-style: solid; border-color: rgb(47, 47, 55); outline-color: oklab(0.51773 0.045283 -0.122431 / 0.5); font-family: "Geist Mono Variable", ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-feature-settings: normal; font-variation-settings: normal; font-size: 1em; user-select: text;"><span class="js-id">strncpy</span><span class="js-op">(</span><span class="js-id">dest</span><span class="js-op">,</span> <span class="js-id">src</span><span class="js-op">,</span> <span class="js-id">sizeof</span><span class="js-op">(</span><span class="js-id">dest</span><span class="js-op">)</span> <span class="js-op">-</span> <span class="js-num">1</span><span class="js-op">);</span></code></pre></div></div></div>
Code Example
#include <stdio.h>
#include <string.h>
int main(int argc, char *argv[]) {
int verbose = 0;
const char *inputFile = NULL;
for (int i = 1; i < argc; i++) {
if (strcmp(argv[i], "-v") == 0 || strcmp(argv[i], "--verbose") == 0) {
verbose = 1;
} else if (strcmp(argv[i], "-i") == 0 && i + 1 < argc) {
inputFile = argv[++i];
}
}
printf("CLI Configuration:\
");
printf(" Verbose Mode: %s\
", verbose ? "ENABLED" : "DISABLED");
printf(" Input File: %s\
", inputFile ? inputFile : "(none specified)");
return 0;
}Interview Question & Tips
A: `getopt()` standardizes POSIX option syntax (flag grouping like `-zxvf`, argument handling, and `--` operand separators) with robust error reporting.
Q: How do you handle unknown command line flags?
A: Print an error message to `stderr`, display usage documentation, and return an exit code such as `EXIT_FAILURE` (1).
Best Practices
This study reference for Command-Line Arguments in C: Building Programs That Accept User Input is curated and verified against recognized curriculum benchmarks, peer-reviewed textbooks, and official technical documentation: