HOWTO · C

C에서 문자열을 정수로 변환

이 기사에서는 C에서 문자열을 정수로 변환하는 다양한 방법을 소개합니다.

이 페이지의 내용

C 문자열을 정수로 변환할 때는 허용할 입력과 프로그램에 필요한 검사에 따라 방법을 선택해야 합니다. 표준 라이브러리는 atoi(), strtol(), strtoumax()를 제공합니다. 입력을 이미 신뢰할 수 있을 때만 atoi()를 사용하세요. 입력 형식이 잘못되었거나 대상 자료형의 범위를 벗어날 수 있다면 strtol() 또는 strtoumax()를 사용해 변환 결과를 검사하는 편이 좋습니다.

C에서 atoi()를 사용해 문자열을 정수로 변환하기

atoi()는 <stdlib.h>에 선언되어 있습니다. 앞부분의 공백을 건너뛰고 선택적 부호와 10진 숫자를 읽은 뒤, 숫자에 속하지 않는 첫 문자에서 멈춥니다. 반환값은 int이지만, 인터페이스만으로는 파싱이 어디에서 멈췄는지 알 수 없고 유효한 0과 변환 실패도 구분할 수 없습니다. 변환한 값을 int로 표현할 수 없다면 동작은 정의되지 않습니다. 다른 방법으로 입력 형식과 범위가 보장되는 경우에만 사용하세요.

다음 예제를 실행합니다. 코드와 출력에 포함된 문자열은 바이트 일치 규칙에 따라 영어 그대로 유지됩니다.

이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.

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

int main(void) {
    const char *input = "123";
    int value = atoi(input);
    printf("%s -> %d\n", input, value);
    return 0;
}

관찰된 출력:

123 -> 123

C에서 strtol()를 사용해 문자열을 정수로 변환하기

strtol()는 <stdlib.h>에 선언되어 있으며 long을 반환합니다. 밑은 2부터 36까지 지정할 수 있습니다. 밑이 10이면 10진수로 읽고, 밑이 0이면 일반적인 C 정수 접두사를 인식합니다. 앞부분의 공백을 건너뛴 뒤 숫자에 속하지 않는 첫 문자에서 멈춥니다. 멈춘 위치를 확인하려면 끝 포인터의 주소를 전달하세요. 끝 포인터가 여전히 입력 문자열의 첫 문자를 가리키면 숫자를 변환하지 않은 것입니다. 변환 후 끝 포인터가 널 문자가 아닌 문자를 가리키면 입력 뒤에 다른 문자가 남아 있는 것입니다.

strtol()를 호출하기 전에 errno를 0으로 설정하세요. 결과가 LONG_MIN 또는 LONG_MAX이고 errno == ERANGE이면 값이 long의 범위를 벗어난 것입니다. 대상 자료형이 int라면 형 변환 전에 INT_MIN과 INT_MAX 범위에도 드는지 확인하세요. 다음 예제는 int 범위에 들어오는 온전한 10진수 값만 허용합니다. 코드의 출력 문자열과 예제 출력은 바이트 일치 규칙에 따라 영어 그대로 유지됩니다.

이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.

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

int main(void) {
    const char *input = "123";
    char *end;
    errno = 0;
    long parsed = strtol(input, &end, 10);

    if (end == input || *end != '\0' || errno == ERANGE ||
        parsed < INT_MIN || parsed > INT_MAX) {
        puts("conversion failed");
        return 0;
    }

    printf("value=%d\n", (int)parsed);
    return 0;
}

관찰된 출력:

value=123

실제 코드에서는 앞뒤 공백이나 뒤에 붙은 문자열을 허용할지 정하세요. strtol() 자체는 앞부분의 공백을 허용하며, 위 예제의 끝 포인터 검사는 숫자 뒤에 다른 문자가 있으면 거부합니다.

C에서 strtoumax()를 사용해 문자열을 정수로 변환하기

strtoumax()는 <inttypes.h>에 선언되어 있으며, 구현에서 제공하는 가장 넓은 부호 없는 정수형인 uintmax_t로 변환합니다. strtol()와 마찬가지로 끝 포인터와 밑을 받습니다. 호출 전에 errno를 0으로 설정하면 범위 초과를 errno == ERANGE로 알립니다. uintmax_t 형식에는 <stdint.h>를, 함수와 PRIuMAX 형식 지정 매크로에는 <inttypes.h>를 포함하세요.

부호 없는 변환은 앞에 마이너스 부호가 있는 입력도 받아 함수의 규칙에 따른 부호 없는 결과를 만들 수 있습니다. 애플리케이션에서 음수가 아닌 입력만 허용한다면 마이너스 부호를 명시적으로 거부하세요. 아래 예제는 숫자가 하나 이상 있는지 확인하고, 뒤에 다른 문자가 있으면 거부하며, 값에 맞는 형식 지정 매크로로 출력합니다. 코드의 출력 문자열과 예제 출력은 바이트 일치 규칙에 따라 영어 그대로 유지됩니다.

이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.

#include <ctype.h>
#include <errno.h>
#include <inttypes.h>
#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>

int main(void) {
    const char *input = "123";
    const char *sign = input;
    while (isspace((unsigned char)*sign)) {
        ++sign;
    }

    if (*sign == '-') {
        puts("conversion failed");
        return 0;
    }

    char *end;
    errno = 0;
    uintmax_t value = strtoumax(input, &end, 10);
    if (end == input || *end != '\0' || errno == ERANGE) {
        puts("conversion failed");
        return 0;
    }

    printf("value=%" PRIuMAX "\n", value);
    return 0;
}

관찰된 출력:

value=123

결과는 부호 없는 형식이며 int보다 넓을 수도 있습니다. 더 좁은 형식으로 변환하기 전에 값이 대상 형식의 최댓값을 넘지 않는지 확인하세요.

C에서 문자열을 정수로 변환하는 함수 선택하기

입력을 신뢰할 수 있고 int 범위에 들며 잘못된 입력과 0을 구분할 필요가 없다면 atoi()를 선택하세요. 사용자 입력이나 파일처럼 예상한 형식을 따르지 않을 수 있는 데이터에는 strtol()가 일반적으로 더 나은 부호 있는 변환 함수입니다. 끝 포인터와 errno를 사용해 유효성을 검사할 수 있습니다. long의 범위와 더 좁은 대상 자료형의 범위를 모두 확인하세요.

long의 양수 범위를 넘어설 수 있는 음이 아닌 값에는 strtoumax()를 선택하세요. 숫자를 하나 이상 변환했는지 확인하고, 문자열 전체가 숫자여야 한다면 뒤에 다른 문자가 남지 않도록 검사하세요. ERANGE를 확인하고 더 좁은 애플리케이션별 제한도 적용해야 합니다. 두 검사형 변환 함수 모두 애플리케이션에서 어떤 입력을 허용할지 정해 주지는 않습니다. 결과를 사용하기 전에 공백, 부호, 접두사, 뒤따르는 문자를 허용할지 호출 코드에서 결정하고 해당 규칙을 검사하세요.