Fonction atoll

Entête à inclure

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

Fonction atoll

long long atoll( const char * theString); 

Cette fonction, signifiant ASCII to long long, permet de transformer une chaîne de caractères, contenant la représentation textuelle d'un entier, en un entier très long (type long long ou long long int : ce sont des synonymes).

Attention : cette fonction est disponible à partir de la version C99 ISO du langage. De même, le type long long a été introduit dans cette norme C99 ISO. Si vous utilisez un compilateur C++, cette fonction necessitera un compilateur compatible C++11.

Paramètres

  • theString : ce paramètre contient la chaîne de caractères à convertir.

Valeur de retour

La valeur de retour, de type long long (ou long long int), contient la valeur associée à la chaîne de caractères passée en paramètre.

Attention : si la valeur passée en paramètre n'est pas la représentation textuelle d'un entier, la valeur 0 vous sera renvoyée. Il ne sera donc pas possible de différencier ce cas, du cas ou la chaîne de caractères serait "0". C'est pour cette raison que, si vous ne pouvez garantir que le contenu de la chaîne de caractères fournie en paramètre soit correcte, il sera préferable d'utiliser la fonction strtoll.wp.

Exemple de code

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


int main() {
    
    long long value = atoll( "123456789123456789" ); 
    printf( "value1 == %lld\n", value );

    value = atoll( "0" ); 
    printf( "value2 == %lld\n", value );

    value = atoll( "Toto" ); 
    printf( "value3 == %lld\n", value );

    return EXIT_SUCCESS;
}

Voici l'affichage produit par cet exemple :

$> gcc -o Essai Essai.c
$> ./Essai
value1 == 123456789123456789
value2 == 0
value3 == 0
$> 

Sujets connexes