wcstof, wcstod, wcstold
|
Определено в заголовочном файле
<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 ) до тех пор, пока не будет найден первый непробельный символ. Затем она принимает максимально возможное количество символов, формирующих корректное представление числа с плавающей точкой, и преобразует их в значение с плавающей точкой. Корректное значение с плавающей точкой может быть одним из следующих:
- десятичное выражение с плавающей запятой. Оно состоит из следующих частей:
-
- (необязательно) знак плюс или минус
- непустая последовательность десятичных цифр, возможно содержащая символ десятичной точки (как определено текущей локалью C ) (определяет мантиссу)
-
(необязательно)
eилиEс последующим необязательным знаком минус или плюс и непустой последовательностью десятичных цифр (определяет экспоненту по основанию 10 )
|
(начиная с C99) |
- любое другое выражение, которое может быть принято текущей установленной C локалью .
Функция устанавливает указатель, на который указывает str_end , чтобы он указывал на широкий символ после последнего интерпретированного символа. Если str_end является нулевым указателем, он игнорируется.
Содержание |
Параметры
| str | - | указатель на нуль-терминированную широкую строку для интерпретации |
| 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 (стр.: TBD)
- Стандарт C17 (ISO/IEC 9899:2018):
-
- 7.29.4.1.1 Функции wcstod, wcstof и wcstold (стр.: TBD)
- Стандарт C11 (ISO/IEC 9899:2011):
-
- 7.29.4.1.1 Функции wcstod, wcstof и wcstold (стр: 426-428)
- Стандарт C99 (ISO/IEC 9899:1999):
-
- 7.24.4.1.1 Функции wcstod, wcstof и wcstold (стр. 372-374)
Смотрите также
|
(C99)
(C99)
|
преобразует строку байтов в значение с плавающей запятой
(функция) |
|
C++ документация
для
wcstof
,
wcstod
,
wcstold
|
|