CKTIS / C
strtoll — convertir du texte en long long
strtoll lit un entier signé au début du texte et le convertit en long long. endptr et errno permettent de vérifier le résultat de la conversion.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <stdlib.h>
long long int strtoll(const char *restrict nptr, char **restrict endptr, int base);strtoll ignore les caractères blancs initiaux et accepte un + ou un - facultatif. base doit valoir 0 ou être compris entre 2 et 36. Avec 0, la base est détectée : décimale, octale (0), hexadécimale (0x) ou binaire (0b). C23 accepte aussi 0b avec la base 2 ; la prise en charge par les environnements d’exécution en production n’est pas attestée.
Si endptr ne vaut pas NULL, la fonction stocke dans *endptr l’adresse du premier caractère non converti. Si aucune conversion n’a lieu, la fonction renvoie 0 et, lorsque endptr ne vaut pas NULL, *endptr == nptr. Pour une valeur hors plage, la fonction renvoie LLONG_MIN ou LLONG_MAX et errno == ERANGE. Définissez errno = 0 avant l’appel.
Un résultat égal à 0 ne signale pas à lui seul un échec. Pour refuser tout caractère après l’entier, passez un endptr non nul et vérifiez, dans l’ordre, que la conversion a eu lieu, qu’aucune erreur de plage ne s’est produite et que **endptr == '\0'. Ce dernier contrôle rejette aussi les caractères blancs finaux qui n’ont pas été convertis. C23 autorise les séparateurs de chiffres (') dans les constantes entières du code source, mais strtoll suit des règles de conversion distinctes. Dans les paramètres régionaux C, lorsque base vaut 0, ces règles excluent explicitement les suffixes et les séparateurs de chiffres de la forme des constantes entières. Pour les bases de 2 à 36, la suite de chiffres ne comporte pas de séparateur et aucun suffixe distinct n’est prévu. D’autres paramètres régionaux peuvent autoriser des formes supplémentaires qui leur sont propres : ne supposez donc pas que les séparateurs de groupes de chiffres sont toujours rejetés.
Exemples
#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
const char *text = "-4200";
char *end;
errno = 0;
long long value = strtoll(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("%lld\n", value);
return EXIT_SUCCESS;
}Résultat
-4200
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.