Namespaces
Variants

atof

From cppreference.net
< c ‎ | string ‎ | byte
헤더 파일에 정의됨 <stdlib.h>
double atof ( const char * str ) ;

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 - 해석할 null로 종료되는 바이트 문자열을 가리키는 포인터

반환값

double 값에 해당하는 내용이 str 에 있을 경우 성공적으로 반환됩니다. 변환된 값이 반환 타입의 범위를 벗어나면 반환 값은 정의되지 않습니다. 변환이 수행될 수 없는 경우, 0.0 이 반환됩니다.

참고 사항

이름은 "ASCII to float"을 의미합니다.

예제

#include <stdio.h>
#include <stdlib.h>
int main(void)
{
    printf("%g\n", atof("  -0.0000000123junk"));
    printf("%g\n", atof("0.012"));
    printf("%g\n", atof("15e16"));
    printf("%g\n", atof("-0x1afp-2"));
    printf("%g\n", atof("inF"));
    printf("%g\n", atof("Nan"));
    printf("%g\n", atof("1.0e+309"));   // UB: double 범위를 벗어남
    printf("%g\n", atof("0.0"));
    printf("%g\n", atof("junk"));       // 변환을 수행할 수 없음
}

가능한 출력:

-1.23e-08
0.012
1.5e+17
-107.75
inf
nan
inf
0
0

참고문헌

  • C23 표준 (ISO/IEC 9899:2024):
  • 7.22.1.1 The atof 함수 (p: TBD)
  • C17 표준 (ISO/IEC 9899:2018):
  • 7.22.1.1 atof 함수 (p: TBD)
  • C11 표준 (ISO/IEC 9899:2011):
  • 7.22.1.1 atof 함수 (p: 341)
  • C99 표준 (ISO/IEC 9899:1999):
  • 7.20.1.1 atof 함수 (p: 307)
  • C89/C90 표준 (ISO/IEC 9899:1990):
  • 4.10.1.1 atof 함수

참고 항목

바이트 문자열을 부동 소수점 값으로 변환
(함수)