atoi(3)                    Library Functions Manual                    atoi(3)

NOM
       atoi, atol, atoll - Convertir une chaine en un entier

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <stdlib.h>

       int atoi(const char *nptr);
       long atol(const char *nptr);
       long long atoll(const char *nptr);

   Exigences de macros de test de fonctionnalites pour la glibc (consulter
   feature_test_macros(7)) :

       atoll() :
           _ISOC99_SOURCE
               || /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE

DESCRIPTION
       La fonction atoi() convertit le debut de la chaine pointee par nptr en
       entier de type int. Le resultat est identique a un appel a

           strtol(nptr, NULL, 10);

       a la difference que atoi() ne detecte pas d'erreur.

       Les fonctions atol() et atoll() se comportent comme atoi() sauf
       qu'elles convertissent la portion initiale de la chaine dans leur type
       de retour long ou long long.

VALEUR RENVOYEE
       Le resultat de la conversion ou 0 en cas d'erreur.

ATTRIBUTS
       Pour une explication des termes utilises dans cette section, consulter
       attributes(7).

       +--------------------------+--------------------------+----------------+
       |Interface                 | Attribut                 | Valeur         |
       +--------------------------+--------------------------+----------------+
       |atoi(), atol(), atoll()   | Securite des threads     | MT-Safe locale |
       +--------------------------+--------------------------+----------------+
VERSIONS
       POSIX.1 ne specifie aucune valeur de retour pour atoi() en cas
       d'erreur. Les bibliotheques glibc, musl libc et uClibc renvoient 0 en
       cas d'erreur.

STANDARDS
       C11, POSIX.1-2008.

HISTORIQUE
       C99, POSIX.1-2001, SVr4, 4.3BSD.

       C89 et POSIX.1-1996 n'incluent que les fonctions atoi() et atol().

BOGUES
       Comme errno n'est pas fixe en cas d'erreur, il n'est pas possible de
       differencier 0 d'une erreur ou de la valeur convertie. Aucune
       verification de depassement par le haut ou pas le bas n'est effectuee.
       Seules les entrees en base 10 peuvent etre converties. Il est
       recommande d'utiliser a la place la famille de fonctions strtol() et
       strtoul() dans les nouveaux programmes.

VOIR AUSSI
       atof(3), strtod(3), strtol(3), strtoul(3)

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org> et Gregoire Scano <gregoire.scano@malloc.fr>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       la GNU General Public License version 3
       <https://www.gnu.org/licenses/gpl-3.0.html> concernant les conditions
       de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE.

       Si vous decouvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message a <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.06   31 octobre 2023                        atoi(3)