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.