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

CKTIS / C

strtoull — texte vers unsigned long long

strtoull convertit le début d’une chaîne en unsigned long long ; endptr permet de détecter une absence de conversion et du texte restant.

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

Syntaxe

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

strtoull, déclaré dans <stdlib.h>, ignore les espaces initiaux et accepte + ou -. base vaut de 2 à 36, ou 0 pour la détection automatique de la base. C23 prend en compte les préfixes 0b/0B ; la prise en charge par l’environnement d’exécution n’est pas attestée.

Si endptr n’est pas nul, *endptr désigne le premier caractère non consommé. En l’absence de conversion, la fonction renvoie 0 et *endptr == nptr. Remettez errno à zéro avant l’appel : en cas de dépassement, la fonction renvoie ULLONG_MAX avec ERANGE. Le résultat seul ne suffit pas à valider l’entrée.

Le signe moins n’est pas rejeté : "-1" produit ULLONG_MAX. Si les valeurs négatives sont interdites, vérifiez le signe séparément. Une validation complète exige aussi de vérifier la fin de la chaîne.

Exemples

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

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

    if (end == text || errno == ERANGE || *end != '\0') {
        puts("invalid");
        return 1;
    }
    printf("%llu\n", value);
    return 0;
}

Résultat

12345

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