CKTIS / C
strtold — converter texto em long double
strtold, de <stdlib.h>, lê o número inicial de um texto como long double. endptr permite verificar onde terminou a conversão.
Versão: C23; repository compiler flag, production runtime not attested
Sintaxe
#include <stdlib.h>
long double strtold(const char *restrict nptr, char **restrict endptr);strtold ignora os espaços em branco iniciais e reconhece as formas decimal e hexadecimal, bem como as representações de infinito. Só reconhece as formas NaN se o tipo devolvido suportar NaN silenciosos. Caso contrário, uma entrada em formato NaN é tratada como não estando no formato esperado e não é efetuada qualquer conversão. O separador decimal depende da localidade.
nptr tem de apontar para uma cadeia terminada em nulo. Se endptr não for nulo, a função guarda aí um ponteiro para o primeiro carácter não convertido; é permitido passar NULL. Se não ocorrer qualquer conversão, o resultado é zero e *endptr == nptr; o valor zero, por si só, não permite detetar uma falha.
Coloque errno a zero antes da chamada. Se ocorrer um overflow com o modo de arredondamento predefinido ativo, a função atribui ERANGE a errno. Nos outros modos de arredondamento, esta atribuição não é garantida. Em caso de underflow, a atribuição de ERANGE a errno depende da implementação. Para exigir uma conversão completa, passe um ponteiro não nulo como endptr e, após a chamada, verifique também **endptr == '\0'. O exemplo deixa kg intencionalmente.
Exemplos
#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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.