Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

strtold — convertir du texte en long double

strtold, déclarée dans <stdlib.h>, lit le nombre initial d’un texte sous forme de long double. endptr permet de vérifier où la conversion s’est arrêtée.

Version : C23; repository compiler flag, production runtime not attested

Syntaxe

#include <stdlib.h>
long double strtold(const char *restrict nptr, char **restrict endptr);

strtold ignore les espaces blancs initiaux et reconnaît les formes décimales et hexadécimales ainsi que les représentations de l’infini. Les formes NaN ne sont reconnues que si le type de retour prend en charge les NaN silencieux. Sinon, une entrée de forme NaN est considérée comme non conforme au format attendu et aucune conversion n’est effectuée. Le séparateur décimal dépend de la locale.

nptr doit pointer vers une chaîne terminée par un caractère nul. Si endptr n’est pas nul, la fonction y stocke un pointeur vers le premier caractère non converti ; il est permis de passer NULL. En l’absence de conversion, le résultat est zéro et *endptr == nptr ; la valeur zéro, à elle seule, ne permet pas de détecter un échec.

Mettez errno à zéro avant l’appel. Si un dépassement de capacité survient alors que le mode d’arrondi par défaut est actif, la fonction donne à errno la valeur ERANGE. Ce comportement n’est pas garanti dans les autres modes d’arrondi. En cas de sous-dépassement, l’attribution de la valeur ERANGE à errno dépend de l’implémentation. Pour exiger une conversion complète, passez un pointeur non nul pour endptr et vérifiez aussi **endptr == '\0' après l’appel. L’exemple laisse volontairement kg.

Exemples

#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;
}

Résultat

value=12.5
rest=kg

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources