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

CKTIS / C

strtol — convertir un texte en long

strtol lit un entier long au début d’un texte. Vérifiez endptr et errno pour détecter les erreurs et les caractères non consommés à la fin.

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

Syntaxe

#include <stdlib.h>
long int strtol(const char *restrict nptr, char **restrict endptr, int base);

strtol, déclarée dans <stdlib.h>, ignore les espaces blancs initiaux, accepte un signe + ou - facultatif et convertit les chiffres en long.

base doit être 0 ou compris entre 2 et 36. La valeur 0 détecte les écritures décimale, octale (0), hexadécimale (0x) et, en C23, binaire (0b). Les bases explicites 16 et 2 autorisent leurs préfixes respectifs. Un indicateur de compilation C23 ne garantit pas la prise en charge par la bibliothèque d’exécution.

Si endptr != NULL, *endptr pointe vers le premier caractère non consommé. En l’absence de conversion, la fonction renvoie 0 et *endptr == nptr ; 0 seul n’indique pas une erreur.

Définissez errno = 0 avant l’appel. Une valeur hors limites renvoie LONG_MIN ou LONG_MAX et définit ERANGE. Si endptr != NULL et que tout le texte doit être consommé, vérifiez aussi **endptr == '\0' : comparez le caractère pointé par *endptr au caractère de fin de chaîne, et non le pointeur lui-même. Avec les paramètres régionaux C, les espaces blancs finaux ne sont pas consommés. Avec d’autres paramètres régionaux, la fonction peut accepter des formes de saisie supplémentaires propres à ces paramètres. Atteindre le caractère de fin confirme que toute la chaîne a été consommée, mais pas que la saisie respecte la syntaxe des paramètres régionaux C.

Exemples

#include <errno.h>
#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    const char *text = "123";
    char *end;
    errno = 0;
    long value = strtol(text, &end, 10);

    if (end == text) {
        puts("no digits");
        return EXIT_FAILURE;
    }
    if (errno == ERANGE) {
        puts("out of range");
        return EXIT_FAILURE;
    }
    if (*end != '\0') {
        puts("trailing characters");
        return EXIT_FAILURE;
    }
    printf("value=%ld\n", value);
    return EXIT_SUCCESS;
}

Résultat

value=123

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