strtold, _strtold_l, wcstold, _wcstold_l

将字符串转换为长双精度浮点值。

语法

long double strtold(
   const char *strSource,
   char **endptr
);
long double _strtold_l(
   const char *strSource,
   char **endptr,
   _locale_t locale
);
long double wcstold(
   const wchar_t *strSource,
   wchar_t **endptr
);
long double wcstold_l(
   const wchar_t *strSource,
   wchar_t **endptr,
   _locale_t locale
);

参数

strSource
要转换的 null 终止的字符串。

endptr
指向停止扫描的字符的指针。

locale
要使用的区域设置。

返回值

strtold 返回 long double 的浮点数值，只有当表示形式会导致溢出时，该函数才返回 +/-HUGE_VALL。 HUGE_VALL 的符号与无法表示的值的符号相匹配。 如果无法执行转换或出现下溢，则 strtold 返回 0。

wcstold 返回类似于 strtold 的值。 对于这两个函数，如果发生溢出或下溢，则将 errno 设置为 ERANGE，并调用无效的参数处理程序，如参数验证中所述。

有关返回代码的详细信息，请参阅 errno、_doserrno、_sys_errlist 和 _sys_nerr。

注解

每个函数均将输入字符串 strSource 转换为 long double。 strtold 函数在首个无法识别为数字一部分的字符处停止读取字符串 strSource。 这可能是终止空字符。 strtold 的宽字符版本是 wcstold；它的 strSource 参数是宽字符字符串。 否则，这些函数具有相同行为。

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。

一般文本例程映射

TCHAR.H 例程	_UNICODE 和 _MBCS 未定义	_MBCS 已定义	_UNICODE 已定义
_tcstold	strtold	strtold	wcstold
_tcstold_l	_strtold_l	_strtold_l	_wcstold_l

当前区域设置的 LC_NUMERIC 类别设置确定 strSource 中的基数字符的识别。 有关详细信息，请参阅 setlocale、 _wsetlocale。 不带 _l 后缀的函数使用当前区域设置；_strtold_l 和 _wcstold_l 与 _strtold 和 _wcstold 相同，只不过它们改用传入的区域设置。 有关详细信息，请参阅 Locale。

如果 endptr 不为 NULL，则在 endptr 所指向的位置存储指向字符的指针（该指针停止扫描）。 如果不能执行任何转换（未找到任何有效的数字或指定了无效的基数），则将 strSource 的值存储在由 endptr 指向的位置。

strtold 需要 strSource 指向以下形式的字符串：

[whitespace][sign][digits][.digits][{d | D | e | E}[sign]digits]

whitespace 可能包含被忽略的空格和制表符；sign 是加号 (+) 或减号 (-)；digits 是一个或多个十进制数字。 如果基数字符前没有任何数字，则基数字符后必须至少有一个数字。 十进制数字可以后跟一个指数，其中包含介绍性字母（d、D、e 或 E）和可选的带符号的整数。 如果指数部分和基数字符都没有出现，则假定基数字符跟随字符串中的最后一个数字。 不符合此形式的第一个字符将停止扫描。

要求

例程	必需的标头
strtold，_strtold_l	<stdlib.h>
wcstold，_wcstold_l	<stdlib.h> 或 <wchar.h>

有关兼容性的详细信息，请参阅 兼容性。

示例

// crt_strtold.c
// Build with: cl /W4 /Tc crt_strtold.c
// This program uses strtold to convert a
// string to a long double-precision value.

#include <stdlib.h>
#include <stdio.h>

int main( void )
{
   char *string;
   char *stopstring;
   long double x;

   string = "3.1415926535898This stopped it";
   x = strtold(string, &stopstring);
   printf("string = %s\n", string);
   printf("   strtold = %.13Lf\n", x);
   printf("   Stopped scan at: %s\n\n", stopstring);
}

string = 3.1415926535898This stopped it
   strtold = 3.1415926535898
   Stopped scan at: This stopped it

另请参阅

数据转换
数学和浮点支持
多字节字符序列的解释
区域设置
字符串到数值函数
strtod、_strtod_l、wcstod、_wcstod_l
strtol、wcstol、_strtol_l、_wcstol_l
strtoul、_strtoul_l、wcstoul、_wcstoul_l
atof、_atof_l、_wtof、_wtof_l
localeconv
_create_locale、_wcreate_locale
_free_locale