Namespaces
Variants

strtof, strtod, strtold

From cppreference.net
< c ‎ | string ‎ | byte
헤더 파일에 정의됨 <stdlib.h>
float strtof ( const char * restrict str, char ** restrict str_end ) ;
(1) (C99부터)
(2)
double strtod ( const char * str, char ** str_end ) ;
(C99 이전)
double strtod ( const char * restrict str, char ** restrict str_end ) ;
(C99부터)
long double strtold ( const char * restrict str, char ** restrict str_end ) ;
(3) (C99부터)

str 이 가리키는 바이트 문자열에서 부동 소수점 값을 해석합니다.

함수는 첫 번째 공백이 아닌 문자가 발견될 때까지 ( isspace 에 의해 결정되는) 모든 공백 문자를 버립니다. 그런 다음 유효한 부동 소수점 표현을 형성하기 위해 가능한 많은 문자를 취하여 부동 소수점 값으로 변환합니다. 유효한 부동 소수점 값은 다음 중 하나일 수 있습니다:

  • decimal floating-point expression. 다음과 같은 부분들로 구성됩니다:
  • (선택사항) 양수 또는 음수 부호
  • 현재 C locale 에 따라 결정되는 소수점 문자를 포함할 수 있는 비어 있지 않은 십진수 시퀀스 (유효숫자 정의)
  • (선택사항) e 또는 E 뒤에 선택적 마이너스 또는 플러스 부호와 비어 있지 않은 십진수 시퀀스가 옴 ( 10 을 밑으로 하는 지수 정의)
  • 16진수 부동 소수점 표현식. 다음 부분들로 구성됩니다:
  • (선택사항) 플러스 또는 마이너스 기호
  • 0x 또는 0X
  • 현재 C locale 에 의해 결정되는 소수점 문자를 선택적으로 포함할 수 있는 16진수 숫자의 비어 있지 않은 시퀀스 (가수를 정의함)
  • (선택사항) p 또는 P 뒤에 선택적인 마이너스 또는 플러스 기호와 10진수 숫자의 비어 있지 않은 시퀀스가 옴 (밑수 2 의 지수를 정의함)
  • 무한대 표현식. 다음 부분들로 구성됩니다:
  • (선택사항) 플러스 또는 마이너스 기호
  • INF 또는 INFINITY (대소문자 구분 없음)
  • NaN(Not-a-Number) 표현식. 다음 부분들로 구성됩니다:
  • (선택사항) 플러스 또는 마이너스 기호
  • NAN 또는 NAN( char_sequence  ) ( NAN 부분은 대소문자 구분 없음). char_sequence 는 숫자, 라틴 문자, 밑줄만 포함할 수 있습니다. 결과는 quiet NaN 부동 소수점 값입니다.
(C99 이후)
  • 현재 설치된 C locale 에서 허용될 수 있는 다른 표현.

이 함수는 str_end 가 가리키는 포인터를 해석된 마지막 문자 다음 문자를 가리키도록 설정합니다. str_end 가 null 포인터인 경우, 이는 무시됩니다.

목차

매개변수

str - 해석할 null로 종료되는 바이트 문자열에 대한 포인터
str_end - 문자에 대한 포인터의 포인터

반환값

성공 시 str 의 내용에 해당하는 부동 소수점 값. 변환된 값이 해당 반환 타입의 범위를 벗어나는 경우 범위 오류가 발생하며 ( errno ERANGE 로 설정됨) HUGE_VAL , HUGE_VALF 또는 HUGE_VALL 이 반환됩니다. 변환을 수행할 수 없는 경우 0 이 반환됩니다.

예제

#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
    // 오류 처리를 포함한 파싱
    const char* p = "111.11 -2.22 Nan nan(2) inF 0X1.BC70A3D70A3D7P+6  1.18973e+4932zzz";
    printf("Parsing '%s':\n", p);
    char* end = NULL;
    for (double f = strtod(p, &end); p != end; f = strtod(p, &end))
    {
        printf("'%.*s' -> ", (int)(end - p), p);
        p = end;
        if (errno == ERANGE)
        {
            printf("range error, got ");
            errno = 0;
        }
        printf("%f\n", f);
    }
    // 오류 처리 없이 파싱
    printf("\"  -0.0000000123junk\"  -->  %g\n", strtod("  -0.0000000123junk", NULL));
    printf("\"junk\"                 -->  %g\n", strtod("junk", NULL));
}

가능한 출력:

Parsing '111.11 -2.22 Nan nan(2) inF 0X1.BC70A3D70A3D7P+6  1.18973e+4932zzz':
'111.11' -> 111.110000
' -2.22' -> -2.220000
' Nan' -> nan
' nan(2)' -> nan
' inF' -> inf
' 0X1.BC70A3D70A3D7P+6' -> 111.110000
'  1.18973e+4932' -> range error, got inf
"  -0.0000000123junk"  -->  -1.23e-08
"junk"                 -->  0

참고문헌

  • C23 표준 (ISO/IEC 9899:2024):
  • 7.22.1.3 strtod, strtof, strtold 함수 (p: TBD)
  • C17 표준 (ISO/IEC 9899:2018):
  • 7.22.1.3 strtod, strtof, strtold 함수 (p: 249-251)
  • C11 표준 (ISO/IEC 9899:2011):
  • 7.22.1.3 strtod, strtof, strtold 함수 (p: 342-344)
  • C99 표준 (ISO/IEC 9899:1999):
  • 7.20.1.3 strtod, strtof, strtold 함수 (p: 308-310)
  • C89/C90 표준 (ISO/IEC 9899:1990):
  • 4.10.1.4 strtod 함수

참고 항목

바이트 문자열을 부동 소수점 값으로 변환
(함수)
(C99) (C95) (C99)
와이드 문자열을 부동 소수점 값으로 변환
(함수)
C++ documentation for strtof , strtod , strtold