Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes