wcstof, wcstod, wcstold
|
Definido en el encabezado
<wchar.h>
|
||
|
float
wcstof
(
const
wchar_t
*
restrict
str,
wchar_t
**
restrict
str_end
)
;
|
(desde C99) | |
|
double
wcstod
(
const
wchar_t
*
str,
wchar_t
**
str_end
)
;
|
(desde C95)
(hasta C99) |
|
|
double
wcstod
(
const
wchar_t
*
restrict
str,
wchar_t
**
restrict
str_end
)
;
|
(desde C99) | |
|
long
double
wcstold
(
const
wchar_t
*
restrict
str,
wchar_t
**
restrict
str_end
)
;
|
(desde C99) | |
Interpreta un valor de punto flotante en la cadena ancha señalada por str .
La función descarta cualquier carácter de espacio en blanco (según lo determinado por iswspace ) hasta que se encuentra el primer carácter que no es un espacio en blanco. Luego toma tantos caracteres como sea posible para formar una representación válida de punto flotante y los convierte en un valor de punto flotante. El valor válido de punto flotante puede ser uno de los siguientes:
- expresión decimal de punto flotante. Consta de las siguientes partes:
-
- (opcional) signo más o menos
- secuencia no vacía de dígitos decimales que opcionalmente contiene el carácter de punto decimal (según lo determinado por la configuración regional actual de C) (define el significando)
-
(opcional)
eoEseguido de signo menos o más opcional y secuencia no vacía de dígitos decimales (define el exponente en base 10 )
|
(desde C99) |
- cualquier otra expresión que pueda ser aceptada por la configuración regional de C actualmente instalada locale .
Las funciones establecen el puntero apuntado por str_end para que apunte al carácter ancho después del último carácter interpretado. Si str_end es un puntero nulo, se ignora.
Contenidos |
Parámetros
| str | - | puntero a la cadena ancha terminada en nulo que se va a interpretar |
| str_end | - | puntero a un puntero a un carácter ancho. |
Valor de retorno
Valor de punto flotante correspondiente al contenido de str en caso de éxito. Si el valor convertido cae fuera del rango del tipo de retorno correspondiente, ocurre un error de rango y se retorna HUGE_VAL , HUGE_VALF o HUGE_VALL . Si no se puede realizar ninguna conversión, se retorna 0 .
Ejemplo
#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); } }
Salida:
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
Referencias
- Estándar C23 (ISO/IEC 9899:2024):
-
- 7.29.4.1.1 Las funciones wcstod, wcstof y wcstold (p: TBD)
- Estándar C17 (ISO/IEC 9899:2018):
-
- 7.29.4.1.1 Las funciones wcstod, wcstof y wcstold (p: TBD)
- Estándar C11 (ISO/IEC 9899:2011):
-
- 7.29.4.1.1 Las funciones wcstod, wcstof y wcstold (p: 426-428)
- Estándar C99 (ISO/IEC 9899:1999):
-
- 7.24.4.1.1 Las funciones wcstod, wcstof y wcstold (p: 372-374)
Véase también
|
(C99)
(C99)
|
convierte una cadena de bytes a un valor de punto flotante
(función) |
|
Documentación de C++
para
wcstof
,
wcstod
,
wcstold
|
|