CKTIS / C
strtoll — convertir texto a long long
strtoll lee un entero con signo al principio del texto y lo convierte a long long. endptr y errno permiten comprobar el resultado de la conversión.
Versión: C23; repository compiler flag, production runtime not attested
Sintaxis
#include <stdlib.h>
long long int strtoll(const char *restrict nptr, char **restrict endptr, int base);strtoll omite los espacios en blanco iniciales y acepta un + o - opcional. base debe ser 0 o estar entre 2 y 36. Con 0 se detecta la base: decimal, octal (0), hexadecimal (0x) o binaria (0b). C23 también acepta 0b con base 2; no está confirmada la compatibilidad en entornos de ejecución de producción.
Si endptr no es NULL, la función guarda en *endptr la dirección del primer carácter no convertido. Si no se realiza ninguna conversión, la función devuelve 0 y, cuando endptr no es NULL, se cumple *endptr == nptr. Si el valor queda fuera de rango, se obtiene LLONG_MIN o LLONG_MAX y errno == ERANGE. Asigna errno = 0 antes de la llamada.
Un resultado de 0 por sí solo no indica un error. Para rechazar cualquier carácter posterior al entero, pasa un endptr distinto de NULL y comprueba, en ese orden, que haya habido conversión, que no se haya producido un error de rango y que se cumpla **endptr == '\0'. Esta última comprobación también rechaza los espacios en blanco finales que hayan quedado sin convertir. C23 permite separadores de dígitos (') en las constantes enteras del código fuente, pero strtoll aplica reglas de conversión distintas. En la configuración regional C, cuando base es 0, esas reglas excluyen explícitamente los sufijos y los separadores de dígitos de la forma de constante entera. Para las bases de 2 a 36, la secuencia de dígitos no incluye separadores ni se contempla un sufijo independiente. Otras configuraciones regionales pueden admitir formas adicionales propias, así que no des por hecho que siempre se rechazan los separadores de grupos de dígitos.
Ejemplos
#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
const char *text = "-4200";
char *end;
errno = 0;
long long value = strtoll(text, &end, 10);
if (end == text) {
puts("no digits");
return EXIT_FAILURE;
}
if (errno == ERANGE) {
puts("out of range");
return EXIT_FAILURE;
}
if (*end != '\0') {
puts("trailing characters");
return EXIT_FAILURE;
}
printf("%lld\n", value);
return EXIT_SUCCESS;
}Resultado
-4200
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.