atol
, _atol_l
, _wtol
, _wtol_l
Convertissent une chaîne en un entier long.
Syntaxe
long atol(
const char *str
);
long _atol_l(
const char *str,
_locale_t locale
);
long _wtol(
const wchar_t *str
);
long _wtol_l(
const wchar_t *str,
_locale_t locale
);
Paramètres
str
Chaîne à convertir.
locale
Paramètres régionaux à utiliser.
Valeur retournée
Chaque fonction retourne la valeur long
produite en interprétant les caractères d’entrée en tant que nombre. La valeur de retour est 0L
pour atol
laquelle l’entrée ne peut pas être convertie en valeur de ce type.
Si ces fonctions dépassent de grandes valeurs intégrales positives, elles retournent LONG_MAX
. Si les fonctions dépassent les valeurs intégrales négatives volumineuses, LONG_MIN
sont retournées. Dans tous les cas hors limites, errno
est défini sur ERANGE
. Si le paramètre passé est NULL
, le gestionnaire de paramètres non valide est appelé, comme décrit dans la validation des paramètres. Si l’exécution est autorisée à se poursuivre, ces fonctions définissent errno
avec la valeur EINVAL
et retournent 0.
Notes
Ces fonctions convertissent une chaîne de caractères en une valeur entière longue (atol
).
La chaîne d’entrée est une séquence de caractères qui peut être interprétée comme une valeur numérique du type spécifié. La fonction cesse de lire la chaîne d’entrée au premier caractère qu’elle ne peut pas reconnaître dans le cadre d’un nombre. Ce caractère peut être le caractère null (\0
ou L\0
) terminant la chaîne.
L’argument str
de atol
prend la forme suivante :
[
whitespace
] [sign
] [digits
]
Un whitespace
espace ou des caractères de tabulation, qui sont ignorés , sign
est plus (+
) ou moins (-
) ; et digits
est un ou plusieurs chiffres.
_wtol
est identique à atol
, à ceci près qu’elle prend une chaîne à caractères larges.
Les versions de ces fonctions avec le suffixe _l
sont identiques, sauf qu'elles utilisent les paramètres régionaux passés au lieu des paramètres régionaux actuels. Pour plus d’informations, consultez Locale.
Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.
Mappages de routine de texte générique
TCHAR.H Routine |
_UNICODE et _MBCS non défini |
_MBCS Défini |
_UNICODE Défini |
---|---|---|---|
_tstol |
atol |
atol |
_wtol |
_ttol |
atol |
atol |
_wtol |
Spécifications
Routines | En-tête requis |
---|---|
atol |
<stdlib.h> |
_atol_l , _wtol , _wtol_l |
<stdlib.h> et <wchar.h> |
Exemple
Ce programme montre comment les nombres stockés sous forme de chaînes peuvent être convertis en valeurs numériques à l’aide de la fonction atol
.
// crt_atol.c
// This program shows how numbers stored as
// strings can be converted to numeric values
// using the atol functions.
#include <stdlib.h>
#include <stdio.h>
#include <errno.h>
int main( void )
{
char *str = NULL;
long value = 0;
// An example of the atol function
// with leading and trailing white spaces.
str = " -2309 ";
value = atol( str );
printf( "Function: atol( \"%s\" ) = %d\n", str, value );
// Another example of the atol function
// with an arbitrary decimal point.
str = "314127.64";
value = atol( str );
printf( "Function: atol( \"%s\" ) = %d\n", str, value );
// Another example of the atol function
// with an overflow condition occurring.
str = "3336402735171707160320";
value = atol( str );
printf( "Function: atol( \"%s\" ) = %d\n", str, value );
if (errno == ERANGE)
{
printf("Overflow condition occurred.\n");
}
}
Function: atol( " -2309 " ) = -2309
Function: atol( "314127.64" ) = 314127
Function: atol( "3336402735171707160320" ) = 2147483647
Overflow condition occurred.
Voir aussi
Conversion de données
Prise en charge mathématique et à virgule flottante
Paramètres régionaux
_ecvt
_fcvt
_gcvt
setlocale
, _wsetlocale
_atodbl
, _atodbl_l
, _atoldbl
, _atoldbl_l
, _atoflt
, _atoflt_l
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour