strtof, strtod, strtold
|
헤더 파일에 정의됨
<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 을 밑으로 하는 지수 정의)
|
(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
|
|