CKTIS / C
strtold — convertir texto a long double
strtold, de <stdlib.h>, lee el número inicial de un texto como long double. endptr permite comprobar dónde terminó la conversión.
Versión: C23; repository compiler flag, production runtime not attested
Sintaxis
#include <stdlib.h>
long double strtold(const char *restrict nptr, char **restrict endptr);strtold omite los espacios en blanco iniciales y reconoce las formas decimal y hexadecimal, así como las representaciones de infinito. Solo reconoce las formas NaN si el tipo de retorno admite NaN silenciosos. De lo contrario, una entrada con forma NaN se considera ajena al formato esperado y no se realiza ninguna conversión. El separador decimal depende de la configuración regional.
nptr debe apuntar a una cadena terminada en nulo. Si endptr no es nulo, la función almacena allí un puntero al primer carácter no convertido; se permite pasar NULL. Si no hay conversión, el resultado es cero y *endptr == nptr; el cero por sí solo no permite detectar un error.
Pon errno a cero antes de llamar a la función. Si se produce un desbordamiento con el modo de redondeo predeterminado activo, la función asigna ERANGE a errno. Esto no está garantizado en otros modos de redondeo. En caso de subdesbordamiento, que se asigne ERANGE a errno depende de la implementación. Para exigir una conversión completa, pasa un puntero no nulo como endptr y comprueba también **endptr == '\0' después de la llamada. El ejemplo deja kg deliberadamente.
Ejemplos
#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
const char *text = "12.5kg";
char *end;
errno = 0;
long double value = strtold(text, &end);
if (end == text || errno == ERANGE) {
puts("conversion failed");
return EXIT_FAILURE;
}
printf("value=%.1Lf\nrest=%s\n", value, end);
return EXIT_SUCCESS;
}
Resultado
value=12.5 rest=kg
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.