Namespaces
Variants

wcstof, wcstod, wcstold

From cppreference.net
< c ‎ | string ‎ | wide
헤더 파일에 정의됨 <wchar.h>
float wcstof ( const wchar_t * restrict str, wchar_t ** restrict str_end ) ;
(C99부터)
double wcstod ( const wchar_t * str, wchar_t ** str_end ) ;
(C95부터)
(C99까지)
double wcstod ( const wchar_t * restrict str, wchar_t ** restrict str_end ) ;
(C99부터)
long double wcstold ( const wchar_t * restrict str, wchar_t ** restrict str_end ) ;
(C99부터)

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

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

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

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

목차

매개변수

str - 해석할 null 종료 와이드 문자열에 대한 포인터
str_end - 와이드 문자에 대한 포인터의 포인터

반환값

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

예제

#include <errno.h>
#include <stdio.h>
#include <wchar.h>
int main(void)
{
    const wchar_t* p = L"111.11 -2.22 0X1.BC70A3D70A3D7P+6  1.18973e+4932zzz";
    printf("Parsing L\"%ls\":\n", p);
    wchar_t* end;
    for (double f = wcstod(p, &end); p != end; f = wcstod(p, &end))
    {
        printf("'%.*ls' -> ", (int)(end-p), p);
        p = end;
        if (errno == ERANGE){
            printf("range error, got ");
            errno = 0;
        }
        printf("%f\n", f);
    }
}

출력:

Parsing L"111.11 -2.22 0X1.BC70A3D70A3D7P+6  1.18973e+4932zzz":
'111.11' -> 111.110000
' -2.22' -> -2.220000
' 0X1.BC70A3D70A3D7P+6' -> 111.110000
'  1.18973e+4932' -> range error, got inf

참고문헌

  • C23 표준 (ISO/IEC 9899:2024):
  • 7.29.4.1.1 wcstod, wcstof, wcstold 함수 (p: TBD)
  • C17 표준 (ISO/IEC 9899:2018):
  • 7.29.4.1.1 wcstod, wcstof, wcstold 함수 (p: TBD)
  • C11 표준 (ISO/IEC 9899:2011):
  • 7.29.4.1.1 wcstod, wcstof, wcstold 함수 (p: 426-428)
  • C99 표준 (ISO/IEC 9899:1999):
  • 7.24.4.1.1 wcstod, wcstof, 및 wcstold 함수 (p: 372-374)

참고 항목

바이트 문자열을 부동 소수점 값으로 변환
(함수)
C++ 문서 for wcstof , wcstod , wcstold