Xi Xu's More Things

wcstof, wcstod, wcstold

来自cppreference.com
< c‎ | string‎ | wide
 
 
 
空终止宽字符串
函数
字符操作
(C95)
(C95)
(C95)
(C95)
(C95)
(C95)
(C99)
(C95)
(C95)
(C95)
(C95)
(C95)
(C95)
(C95)
(C95)
(C95)
(C95)
(C95)
转换成数值格式
(C95)(C99)
(C95)(C99)
wcstofwcstodwcstold
(C99)(C95)(C99)
(C99)(C99)
字符串操作
(C95)(C11)
(C95)(C11)
(C95)(C11)
(C95)(C11)
(C95)(C11)
(C95)
(C95)
(C95)
(C95)
(C95)
(C95)
(C95)
(C95)
(C95)
(C95)
(C95)(C11)
数组操作
(C95)(C11)
(C95)(C11)
(C95)
(C95)
(C95)
 
在标头 <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 所指向的宽字符串中的浮点值。

函数会舍弃任何空白符(由 std::iswspace() 确定),直至找到首个非空白符。然后它会取用尽可能多的字符,以构成合法的浮点数表示,并将它们转换成浮点值。合法的浮点值可以为下列之一:

  • 十进制浮点数表达式。它由下列部分组成:
  • (可选) 正或负号
  • 非空的十进制数字序列,可选地包含一个小数点字符(由当前的 C 本地环境确定)(定义有效数字)
  • (可选) eE ,并跟随可选的正或负号,以及非空十进制数字序列(以 10 为底定义指数)
  • 十六进制浮点数表达式。它由下列部分组成:
  • (可选) 正或负号
  • 0x0X
  • 非空的十六进制数字序列,选地包含一个小数点字符(由当前的 C 本地环境确定)(定义有效数字)
  • (可选) pP ,并跟随可选的正或负号,以及非空十进制数字序列(以 2 为底定义指数)
  • 无穷大表达式。它由下列部分组成:
  • (可选) 正或负号
  • INFINFINITY ,忽略大小写
  • 非数(NaN)表达式。它由下列部分组成:
  • (可选) 正或负号
  • NANNAN(char_sequence) ,忽略 NAN 部分的大小写。 char_sequence 只能由数字、拉丁字母和下划线构成。结果是一个静态的 NaN 浮点值。
(C99 起)

函数设置 str_end 所指向的指针为指向最后被转译宽字符的后一字符。若 str_end 为空指针,则忽略它。

参数

str - 指向要转译的空终止宽字符串的指针
str_end - 指向指向宽字符指针的指针。

返回值

成功时为对应 str 内容的浮点值。若转换得到的值落在对应返回类型的范围外,则发生值域错误并返回 HUGE_VALHUGE_VALFHUGE_VALL 。若不能进行转换,则返回 0

示例

#include <stdio.h>
#include <errno.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

引用

  • C11 标准(ISO/IEC 9899:2011):
  • 7.29.4.1.1 The wcstod, wcstof, and wcstold functions (第 426-428 页)
  • C99 标准(ISO/IEC 9899:1999):
  • 7.24.4.1.1 The wcstod, wcstof, and wcstold functions (第 372-374 页)

参阅

将字节字符串转换成浮点值
(函数)