wcstof, wcstod, wcstold

函数

字符操作

iswalnum (C95)
iswalpha (C95)
iswlower (C95)
iswupper (C95)
iswdigit (C95)
iswxdigit (C95)
iswblank (C99)
wctype (C95)
iswctype (C95)

iswcntrl (C95)
iswgraph (C95)
iswspace (C95)
iswprint (C95)
iswpunct (C95)
towlower (C95)
towupper (C95)
wctrans (C95)
towctrans (C95)

转换成数值格式

wcstolwcstoll (C95)(C99)
wcstoulwcstoull (C95)(C99)

wcstofwcstodwcstold (C99)(C95)(C99)
wcstoimaxwcstoumax (C99)(C99)

字符串操作

wcslenwcsnlen_s (C95)(C11)
wcscpywcscpy_s (C95)(C11)
wcsncpywcsncpy_s (C95)(C11)
wcscatwcscat_s (C95)(C11)
wcsncatwcsncat_s (C95)(C11)
wcsstr (C95)

wcscmp (C95)
wcsncmp (C95)
wcscoll (C95)
wcsxfrm (C95)
wcschr (C95)
wcsrchr (C95)
wcspbrk (C95)
wcsspn (C95)
wcscspn (C95)
wcstokwcstok_s (C95)(C11)

数组操作

wmemcpywmemcpy_s (C95)(C11)
wmemmovewmemmove_s (C95)(C11)

wmemcmp (C95)
wmemchr (C95)
wmemset (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 本地环境确定）（定义有效数字）
(可选) e 或 E ，并跟随可选的正或负号，以及非空十进制数字序列（以 10 为底定义指数）

二进制浮点数表达式。它由下列部分组成：

(可选) 正或负号
0x 或 0X
非空的十六进制数字序列，选地包含一个小数点字符（由当前的 C 本地环境确定）（定义有效数字）
(可选) p 或 P ，并跟随可选的正或负号，以及非空十进制数字序列（以 2 为底定义指数）

无穷大表达式。它由下列部分组成：

(可选) 正或负号
INF 或 INFINITY ，忽略大小写

非数（NaN）表达式。它由下列部分组成：

(可选) 正或负号
NAN 或 NAN(char_sequence) ，忽略 NAN 部分的大小写。 char_sequence 只能由数字、拉丁字母和下划线构成。结果是一个安静的 NaN 浮点值。

任何其他可由当前 C 本地环境接受的表达式

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

参数

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

返回值

成功时为对应 str 内容的浮点值。若转换得到的值落在对应返回类型的范围外，则发生值域错误并返回 HUGE_VAL 、 HUGE_VALF 或 HUGE_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 standard (ISO/IEC 9899:2011):

7.29.4.1.1 The wcstod, wcstof, and wcstold functions (p: 426-428)

C99 standard (ISO/IEC 9899:1999):

7.24.4.1.1 The wcstod, wcstof, and wcstold functions (p: 372-374)

参阅

strtofstrtodstrtold

(C99)(C99)

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

语言
头文件
类型支持
程序工具
变参数函数支持
动态内存管理
错误处理
日期和时间工具
字符串库
算法
数值
输入/输出支持
本地化支持
线程支持 (C11)
原子操作 (C11)
技术规范