Fonction atoi

Entête à inclure

#include <stdlib.h>  // <cstdlib> en C++

Fonction atoi

int atoi( const char * theString );

Cette fonction permet de transformer une chaîne de caractères, représentant une valeur entière, en une valeur numérique de type int. Le terme d'atoi est un acronyme signifiant : ASCII to integer.

la fonction atoi retourne la valeur 0 si la chaîne de caractères ne contient pas une représentation de valeur numérique. Du coup, il n'est pas possible de distinguer la chaîne "0" d'une chaîne ne contenant pas un nombre entier. Si vous avez cette difficulté, veuillez préférer l'utilisation de la fonction strtol qui permet bien de distinguer les deux cas.

Paramètres

theString : ce paramètre contient la chaîne de caractères à convertir en une donnée de type int.

Valeur de retour

Si la chaîne à convertir ne contient pas une donnée numérique entière, la valeur 0 vous sera retournée. Sinon, une valeur de type int équivalente à la chaîne passée en paramètre vous sera retournée.

Exemple de code

Exemple d'utilisation de la fonction atoi
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40	#include <stdio.h> #include <stdlib.h> int main( int argc, char * argv[] ) { /* * Doit-on afficher l'usage de la commande. / if ( argc == 1 ) { printf( "Usage: %s intValue ...\n", argv[0] ); exit( EXIT_SUCCESS ); } / * On passe le nom de l'exécutable qui est * en première position dans les arguments. / argc--; argv++; int sum = 0; / * On somme toutes les valeurs passées en arguments du programme. * Pour ce faire on déplace le pointeur argv pour scanner tous les arguments. / while ( argc != 0 ) { sum += atoi( argv++ ); argc--; } /* * Et on affiche le résultat */ printf( "La somme des valeurs saisies est de %d.\n", sum ); return EXIT_SUCCESS; }

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


int main( int argc, char * argv[] ) {

    /*
     * Doit-on afficher l'usage de la commande.
     */
    if ( argc == 1 ) {
        printf( "Usage: %s intValue ...\n", argv[0] );
        exit( EXIT_SUCCESS );
    }

    /*
     * On passe le nom de l'exécutable qui est
     * en première position dans les arguments.
     */
    argc--;   argv++;

    int sum = 0;

    /*
     * On somme toutes les valeurs passées en arguments du programme.
     * Pour ce faire on déplace le pointeur argv pour scanner tous les arguments.
     */
    while ( argc != 0 ) {

        sum += atoi( *argv++ );
        argc--;

    }

    /*
     * Et on affiche le résultat
     */
    printf( "La somme des valeurs saisies est de %d.\n", sum );

    return EXIT_SUCCESS;
}

Exemple d'utilisation de la fonction atoi

Et voici le résultat produit par cet exemple.

$> gcc -o sample sample.c
$> ./sample 10 20 30
La somme des valeurs saisies est de 60.
$>

Sujets connexes

<stdlib.h>
abs
atof, atol, atoll
strtod, strtof, strtol, strtoll, strtold, strtoul, strtoull

La fonction atof

La fonction atol

Améliorations / Corrections

Fonction atoi

Entête à inclure

Fonction atoi

Paramètres

Valeur de retour

Exemple de code

Sujets connexes