Funciones de la biblioteca C -strtol()
Biblioteca estándar de C - <stdlib.h>
Descripción
La función de la biblioteca Clong int strtol(const char *str, char **endptr, int base)el parámetrostrla cadena a la que apunta según labasese convierte en un entero largo (de tipo long int); la base debe estar entre 2 y 36 (incluidos), o ser el valor especial 0.
Declaración
La siguiente es la declaración de la función strtol().
long int strtol(const char *str, char **endptr, int base)
Parámetros
- str-- La cadena que se va a convertir en un entero largo.
- endptr-- Referencia a un objeto de tipo char*, cuyo valor es establecido por la función alstrsiguiente carácter después del valor numérico en str.
- base-- La base, debe estar entre 2 y 36 (incluidos), o ser el valor especial 0. Si base es 0, se determina la base según el prefijo de la cadena: si la cadena comienza con '0x' o '0X', se considera hexadecimal; si comienza con '0', se considera octal; de lo contrario, se considera decimal.
Valor de retorno
La función devuelve el valor entero largo convertido. Si la cadena de entrada no tiene un formato numérico válido, strtol() devolverá 0. Si el resultado de la conversión excede el rango de representación de long, se producirá un desbordamiento y se establecerá errno a ERANGE. Puede usar la variable errno del archivo de cabecera <errno.h> para comprobar si se ha producido un desbordamiento.
Ejemplo
El siguiente ejemplo demuestra el uso de la función strtol().
En el siguiente ejemplo convertiremos la cadena "12345" a un entero largo. La función strtol() convertirá esta cadena al valor entero correspondiente 12345. Como hemos especificado base como 10, se realizará la conversión en decimal.
Ejemplo
#include <stdlib.h>
int main() {
char str[] = "12345";
char *endptr;
long int num;
num = strtol(str, &endptr, 10);
if (*endptr != '\0') {
printf("Conversión fallida: la cadena de entrada no es un entero válido.\n");
} else {
printf("Resultado de la conversión: %ld\n", num);
}
return 0;
}
Compilemos y ejecutemos el programa anterior, esto producirá el siguiente resultado:
转换结果:12345
Si la cadena de entrada no se puede convertir completamente en un entero, la función strtol() devolverá la parte convertida con éxito, y endptr apuntará al primer carácter de la parte no convertida. En este ejemplo, endptr apunta al carácter nulo '\0' al final de la cadena, lo que indica que toda la cadena de entrada se convirtió correctamente en un entero.
Si la cadena de entrada contiene caracteres no numéricos, por ejemplo "12ab", entonces endptr apuntará a la posición inicial de "ab", indicando que la conversión falló.
Ejemplo
#include <stdlib.h>
int main() {
char str[] = "12ab";
char *endptr;
long int num;
num = strtol(str, &endptr, 10);
if (*endptr != '\0') {
printf("Conversión fallida: la cadena de entrada no es un entero válido. Parte no convertida: %s\n", endptr);
} else {
printf("Resultado de la conversión: %ld\n", num);
}
return 0;
}
En el ejemplo anterior convertiremos la cadena "12ab" a un entero largo. La función strtol() intentará convertir esta cadena al valor entero correspondiente 12, pero como la cadena contiene caracteres no numéricos "ab", la conversión no se puede completar.
La salida será:
转换失败:输入字符串不是一个有效的整数。未转换部分:abOtras extensiones