atoi, atol, atoll

Interprète une valeur entière dans une chaîne d'octets pointée par str . La base implicite est toujours 10 .

Ignore tous les caractères d'espacement jusqu'à ce que le premier caractère non-espace soit trouvé, puis prend autant de caractères que possible pour former une représentation valide de nombre entier et les convertit en une valeur entière. La valeur entière valide se compose des parties suivantes :

• (optionnel) signe plus ou moins
• chiffres numériques

Si la valeur du résultat ne peut pas être représentée, c'est-à-dire si la valeur convertie sort de la plage du type de retour correspondant, le comportement est indéfini.

Paramètres

Valeur de retour

Valeur entière correspondant au contenu de str en cas de succès.

Si aucune conversion ne peut être effectuée, ​ 0 ​ est retourné.

Notes

Le nom signifie « ASCII vers entier ».

Exemple

#include <stdio.h>
#include <stdlib.h>
int main(void)
{
    printf("%i\n", atoi(" -123junk"));
    printf("%i\n", atoi(" +321dust"));
    printf("%i\n", atoi("0"));
    printf("%i\n", atoi("0042")); // traité comme un nombre décimal avec des zéros en tête
    printf("%i\n", atoi("0x2A")); // seul le zéro initial est converti en ignorant "x2A"
    printf("%i\n", atoi("junk")); // aucune conversion ne peut être effectuée
    printf("%i\n", atoi("2147483648")); // UB : hors de la plage de int
}

-123
321
0
42
0
0
-2147483648

Références

Voir aussi