SysTutorials

Converting Strings to Long Integers in C

· Q A · updated April 11, 2026

Converting strings to long integers is fundamental in C. The standard library provides strtol(), strtoul(), strtoll(), and strtoull() for this purpose. These functions handle the conversion robustly and let you detect parsing errors through their return value and endptr argument.

Function Signatures

All four functions share a similar interface:

long strtol(const char *str, char **endptr, int base);
unsigned long strtoul(const char *str, char **endptr, int base);
long long strtoll(const char *str, char **endptr, int base);
unsigned long long strtoull(const char *str, char **endptr, int base);

Parameters:

Basic Usage with strtol

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

int main() {
    char str[] = "12345";
    char *endptr;
    long num = strtol(str, &endptr, 10);

    if (*endptr != '\0') {
        printf("Unconverted portion: %s\n", endptr);
    }
    printf("Converted value: %ld\n", num);
    return 0;
}

Error Handling

The functions set errno on overflow/underflow. Always check for this:

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

int main() {
    char str[] = "99999999999999999999999999";
    char *endptr;

    errno = 0;
    long num = strtol(str, &endptr, 10);

    if (errno == ERANGE) {
        if (num == LONG_MAX) {
            printf("String overflowed: clamped to LONG_MAX\n");
        } else if (num == LONG_MIN) {
            printf("String underflowed: clamped to LONG_MIN\n");
        }
    }

    if (*endptr != '\0') {
        printf("Invalid character at position: %s\n", endptr);
    }

    return 0;
}

Unsigned Variants

Use strtoul() for unsigned long or strtoull() for unsigned long long:

unsigned long ul = strtoul("18446744073709551615", NULL, 10);
unsigned long long ull = strtoull("18446744073709551615", NULL, 10);

Long Long Integers

For values beyond the long range, use strtoll() or strtoull():

char str[] = "9223372036854775807";  // LLONG_MAX
char *endptr;
long long num = strtoll(str, &endptr, 10);

Base Detection

Set base to 0 for automatic detection:

strtol("0x1F", NULL, 0);   // Returns 31 (hex)
strtol("077", NULL, 0);    // Returns 63 (octal)
strtol("99", NULL, 0);     // Returns 99 (decimal)

Detecting Failed Conversions

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

int parse_long(const char *str, long *result, int base) {
    char *endptr;
    errno = 0;

    *result = strtol(str, &endptr, base);

    // Check for range error
    if (errno == ERANGE) {
        return -1;  // Overflow/underflow
    }

    // Check for invalid characters
    if (endptr == str || *endptr != '\0') {
        return -1;  // No conversion or trailing garbage
    }

    return 0;  // Success
}

int main() {
    long val;
    if (parse_long("12345", &val, 10) == 0) {
        printf("Success: %ld\n", val);
    } else {
        printf("Parse failed\n");
    }
    return 0;
}

Whitespace and Sign Handling

The functions skip leading whitespace and handle optional + or - signs:

strtol("  -1234", NULL, 10);   // Returns -1234
strtol("\t+999", NULL, 10);    // Returns 999

Key Points

← All posts