Parsing numeric arguments

Introduction

Parsing numeric arguments means reading numbers given as text and turning them into actual numbers the program can use.

When your program gets numbers from the command line and needs to use them.

When reading numbers from a text file or user input.

When converting strings to numbers for calculations.

When validating that input is a proper number before using it.

Syntax

C

#include <stdlib.h>

int number = atoi("123");

// or

long number = strtol("123", NULL, 10);

atoi converts a string to an int but does not handle errors well.

strtol is better because it can detect invalid input and supports different number bases.

Examples

Simple use of atoi to convert "42" to the number 42.

C

#include <stdlib.h>

int main() {
    int num = atoi("42");
    return 0;
}

Using strtol to parse a number and check if the whole string was a valid number.

C

#include <stdio.h>
#include <stdlib.h>

int main() {
    char *endptr;
    long num = strtol("123abc", &endptr, 10);
    if (*endptr != '\0') {
        printf("Invalid characters after number: %s\n", endptr);
    } else {
        printf("Number is %ld\n", num);
    }
    return 0;
}

Sample Program

This program reads the first command line argument, tries to convert it to a number, and prints it. If the input is not a valid number, it shows an error.

C

#include <stdio.h>
#include <stdlib.h>

int main(int argc, char *argv[]) {
    if (argc < 2) {
        printf("Please provide a number as argument.\n");
        return 1;
    }

    char *endptr;
    long number = strtol(argv[1], &endptr, 10);

    if (*endptr != '\0') {
        printf("Error: '%s' is not a valid number.\n", argv[1]);
        return 1;
    }

    printf("You entered the number: %ld\n", number);
    return 0;
}

Important Notes

Always check if the input is valid after parsing to avoid errors.

Use strtol instead of atoi for safer parsing.

Remember to include stdlib.h for these functions.

Summary

Parsing numeric arguments means converting text to numbers.

atoi is simple but unsafe; strtol is safer and better.

Always check for invalid input after parsing.

Practice

1. What does the atoi function do in C when parsing numeric arguments?

easy

A. Converts a string to an integer without error checking

B. Converts a string to a floating-point number

C. Checks if a string contains only digits

D. Parses a string and returns a pointer to the next character

Solution

1. Step 1: Understand atoi function purpose

   atoi converts a string to an integer but does not check for errors or invalid input.

2. Step 2: Compare with other parsing functions

   Unlike strtol, atoi does not provide error detection or pointer to next character.

3. Final Answer:

   Converts a string to an integer without error checking -> Option A

4. Quick Check:

   atoi = simple integer conversion [OK]

Hint: Remember: atoi converts but doesn't check errors [OK]

Common Mistakes:

• Thinking atoi checks for invalid input
• Confusing atoi with strtol
• Assuming atoi returns pointer to next char

2. Which of the following is the correct syntax to parse a string "1234" to an integer using strtol in C?

easy

A. int num = strtol("1234", NULL, 10);

B. long num = strtol("1234", NULL, 10);

C. long num = atoi("1234", NULL, 10);

D. int num = strtol("1234", 10, NULL);

Solution

1. Step 1: Check strtol return type

   strtol returns a long, so the variable must be long.

2. Step 2: Verify argument order

   Arguments are: string, pointer to char* for end, and base (10 for decimal). So strtol("1234", NULL, 10) is correct.

3. Final Answer:

   long num = strtol("1234", NULL, 10); -> Option B

4. Quick Check:

   strtol returns long, args: string, endptr, base [OK]

Hint: Remember strtol returns long, not int [OK]

Common Mistakes:

• Using int instead of long for strtol result
• Mixing argument order in strtol
• Using atoi syntax with strtol

3. What will be the output of this C code snippet?

#include 
#include 

int main() {
    char *str = "42abc";
    char *endptr;
    long val = strtol(str, &endptr, 10);
    printf("%ld %s\n", val, endptr);
    return 0;
}

medium

A. Error

B. 0 42abc

C. 42abc (null)

D. 42 abc

Solution

1. Step 1: Understand strtol parsing behavior

   strtol converts initial numeric part "42" to long and sets endptr to point after parsed number, which is "abc".

2. Step 2: Analyze printf output

   It prints the number 42 and then the string starting at endptr, which is "abc".

3. Final Answer:

   42 abc -> Option D

4. Quick Check:

   Parsed number + leftover string = 42 abc [OK]

Hint: Check where endptr points after strtol [OK]

Common Mistakes:

• Assuming strtol parses entire string
• Ignoring endptr usage
• Expecting error on non-digit suffix

4. Identify the error in this code snippet that parses a numeric argument:

#include 

int main(int argc, char *argv[]) {
    int num = atoi(argv[1]);
    if (num == 0) {
        printf("Invalid number\n");
    }
    return 0;
}

medium

A. Missing check if argc > 1 before accessing argv[1]

B. Using int instead of long for atoi result

C. atoi returns 0 for invalid input and valid zero, causing confusion

D. No error, code is correct

Solution

1. Step 1: Check argument count before access

   The code uses argv[1] without verifying argc > 1, risking out-of-bounds access.

2. Step 2: Understand atoi zero ambiguity

   While atoi returns 0 for invalid input and valid zero, the bigger issue is missing argument check causing runtime error.

3. Final Answer:

   Missing check if argc > 1 before accessing argv[1] -> Option A

4. Quick Check:

   Always check argc before argv access [OK]

Hint: Always check argc before argv usage [OK]

Common Mistakes:

• Ignoring argc check leads to crashes
• Confusing atoi zero return meaning
• Assuming atoi handles errors

5. You want to safely parse a command-line argument as a positive integer in C. Which approach correctly handles invalid input and zero?

#include <stdio.h>
#include <stdlib.h>

int main(int argc, char *argv[]) {
    if (argc <= 1) {
        printf("No input provided\n");
        return 1;
    }
    char *endptr;
    long val = strtol(argv[1], &endptr, 10);
    if (*endptr != '\0' || val <= 0) {
        printf("Invalid positive integer\n");
        return 1;
    }
    printf("Parsed value: %ld\n", val);
    return 0;
}

hard

A. Fails to check if argv[1] is NULL before parsing

B. Does not handle negative numbers correctly

C. Correctly parses positive integers and rejects invalid or zero input

D. Should use atoi instead of strtol for safety

Solution

1. Step 1: Check argument count

   The code checks if argc <= 1 to ensure input is provided.

2. Step 2: Use strtol with endptr to detect invalid characters and check if value is positive

   It verifies *endptr == '\0' to confirm full string parsed and val > 0 to ensure positive integer.

3. Final Answer:

   Correctly parses positive integers and rejects invalid or zero input -> Option C

4. Quick Check:

   strtol + endptr + value check = safe parsing [OK]

Hint: Use strtol with endptr and check value > 0 [OK]

Common Mistakes:

• Using atoi which can't detect invalid input
• Not checking endptr for leftover chars
• Ignoring zero or negative values