CKTIS / C
atoi — fonction de bibliothèque C23
`atoi(const char *nptr)` de `<stdlib.h>` convertit l’entier décimal initial d’une chaîne et renvoie un `int`. Elle ignore les espaces initiaux, accepte un signe facultatif et s’arrête au premier caractère étranger au nombre.
Version : C23
Syntaxe
int atoi(const char *nptr);atoi(const char *nptr) de <stdlib.h> convertit l’entier décimal initial d’une chaîne et renvoie un int. Elle ignore les espaces initiaux, accepte un signe facultatif et s’arrête au premier caractère étranger au nombre.
Elle ne convient qu’aux petites valeurs de configuration déjà validées. L’exemple transmet réellement " -42items", obtient donc -42 et ignore le suffixe items.
Sans chiffre, elle renvoie 0, impossible à distinguer d’un zéro valide. Si le résultat n’est pas représentable en int, C23 rend le comportement indéfini ; nptr ne doit pas être NULL. Pour un texte non fiable, utilise strtol et vérifie le pointeur de fin, errno et INT_MIN..INT_MAX.
Exemples
#include <stdio.h>
#include <stdlib.h>
int main(void) {
int count = atoi(" -42items");
printf("%d\n", count);
return 0;
}
Résultat
-42
Elle ne convient qu’aux petites valeurs de configuration déjà validées. L’exemple transmet réellement `" -42items"`, obtient donc `-42` et ignore le suffixe `items`.