atoll, _atoll_l, _wtoll, _wtoll_l

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Convierte una cadena en un long long entero.

long long atoll(  
   const char *str   
);  
long long _wtoll(  
   const wchar_t *str   
);  
long long _atoll_l(  
   const char *str,  
   _locale_t locale  
);  
long long _wtoll_l(  
   const wchar_t *str,  
   _locale_t locale  
);  

Parámetros

str
Cadena que se va a convertir.

locale
Configuración regional que se va a usar.

Cada función devuelve el long long valor generado mediante la interpretación de los caracteres de entrada como un número. El valor devuelto de atoll es 0 si la entrada no se puede convertir en un valor de ese tipo.

Desbordamiento con grandes valores enteros positivos, atoll devuelve LLONG_MAX, y desbordamiento con valores enteros negativos grandes, devuelve LLONG_MIN.

En todos los casos de fuera de intervalo, errno está establecido en ERANGE. Si el parámetro que se pasa es NULL, se invoca el controlador de parámetros no válidos, como se describe en validación del parámetro. Si la ejecución puede continuar, estas funciones establecen errno a EINVAL y devuelven 0.

Estas funciones convierten una cadena de caracteres para un long long valor entero.

La cadena de entrada es una secuencia de caracteres que se puede interpretar como un valor numérico del tipo especificado. La función deja de leer la cadena de entrada en el primer carácter que no se reconoce como parte de un número. Este podría ser el carácter null ('\0' o L '\0') que termina la cadena.

El str argumento atoll tiene la forma siguiente:

[whitespace] [sign] [digits]  

Un whitespace consta de caracteres de espacio o tabulación, que se omiten; sign sea más (+) o menos (-); y digits son uno o más dígitos.

_wtolles idéntico a atoll excepto en que toma una cadena de caracteres anchos como parámetro.

Las versiones de estas funciones que tienen el _l sufijo son idénticas a las versiones que no lo tiene, salvo que usan el parámetro de configuración regional que se pasa en lugar de la configuración regional actual. Para obtener más información, vea Locale.

Asignaciones de rutina de texto genérico

Rutina Tchar.h_UNICODE y _MBCS no definidos_MBCS definido_UNICODE definido
_tstollatollatoll_wtoll
_tstoll_l_atoll_l_atoll_l_wtoll_l
_ttoll_atoll_atoll_wtoll
RutinasEncabezado necesario
atoll, _atoll_l<stdlib.h>
_wtoll, _wtoll_l<stdlib.h> o <wchar.h>

Este programa muestra cómo utilizar el atoll funciones para convertir números almacenados como cadenas en valores numéricos.

// crt_atoll.c  
// Build with: cl /W4 /Tc crt_atoll.c  
// This program shows how to use the atoll   
// functions to convert numbers stored as   
// strings to numeric values.  
#include <stdlib.h>  
#include <stdio.h>  
#include <errno.h>  
  
int main(void)  
{  
    char *str = NULL;  
    long long value = 0;  
  
    // An example of the atoll function  
    // with leading and trailing white spaces.  
    str = "  -27182818284 ";  
    value = atoll(str);  
    printf("Function: atoll(\"%s\") = %lld\n", str, value);  
  
    // Another example of the atoll function   
    // with an arbitrary decimal point.  
    str = "314127.64";  
    value = atoll(str);  
    printf("Function: atoll(\"%s\") = %lld\n", str, value);  
  
    // Another example of the atoll function  
    // with an overflow condition occurring.  
    str = "3336402735171707160320";  
    value = atoll(str);  
    printf("Function: atoll(\"%s\") = %lld\n", str, value);  
    if (errno == ERANGE)  
    {  
       printf("Overflow condition occurred.\n");  
    }  
}  

Function: atoll("  -27182818284 ") = -27182818284  
Function: atoll("314127.64") = 314127  
Function: atoll("3336402735171707160320") = 9223372036854775807  
Overflow condition occurred.  
  

Conversión de datos
Compatibilidad de punto flotante
Configuración regional
_ecvt
_fcvt
_gcvt
setlocale, _wsetlocale
_atodbl, _atodbl_l, _atoldbl, _atoldbl_l, _atoflt, _atoflt_l

Mostrar: