La función wcstol () en C ++ interpreta el contenido de una cadena ancha como un número entero de la base especificada y devuelve su valor como un int largo.
La función wcstol () también establece un puntero para apuntar al primer carácter después del último carácter válido de la cadena ancha si lo hay, de lo contrario el puntero se establece en nulo.
Está definido en el archivo de encabezado.
Para base 10 y la cadena ancha L "12abc" Parte numérica válida -> 12 Primer carácter después de la parte numérica válida -> a
prototipo de wcstol ()
long wcstol (const wchar_t * str, wchar_t ** str_end, int base);
La función wcstol () toma una cadena ancha, un puntero a un carácter ancho y un valor entero - base como parámetro, interpreta el contenido de la cadena ancha como un número entero de la base dada y devuelve un valor int largo.
Parámetros de wcstol ()
- str: Una cadena ancha que tiene la representación de un número entero.
- str_end: un puntero a un puntero a un carácter ancho. El valor de str_end lo establece la función en el siguiente carácter de str después del último carácter válido. Este parámetro también puede ser un puntero nulo, en cuyo caso no se utiliza.
- base: La base del valor integral. El conjunto de valores válidos para la base es (0, 2, 3,…, 35, 36).
wcstol () Valor de retorno
La función wcstol () devuelve:
- un valor int largo (que se convierte de la cadena).
- 0 si no se pudo realizar una conversión válida.
Ejemplo 1: ¿Cómo funciona la función wcstol ()?
#include #include #include using namespace std; int main() ( setlocale(LC_ALL, "en_US.UTF-8"); wchar_t str1() = L"101aau16b6"; wchar_t str2() = L"59"; wchar_t *end; long value; int base = 10; value = wcstol(str1, &end, base); wcout << L"String value = " << str1 << endl; wcout << L"Long Int value = " << value << endl; wcout << L"End String = " << end << endl; value = wcstol(str2, &end, base); wcout << L"String value = " << str2 << endl; wcout << L"Long Int value = " << value << endl; wcout << L"End String = " << end << endl; return 0; )
Cuando ejecute el programa, la salida será:
Valor de cadena = 101aa ᚶ Valor int largo = 101 Cadena final = aa ᚶ Valor de cadena = 59 Valor int largo = 59 Cadena final =
Un valor entero válido para la función wcstol () consta de:
- Un signo + o - opcional.
- Un prefijo 0 para base octal (se aplica solo cuando base = 8 o 0).
- Un prefijo 0x o 0X para base hexadecimal (se aplica solo cuando base = 16 o 0).
- Una secuencia de dígitos y / o alfabetos (si la base es mayor que 10).
Los valores válidos para la base de parámetros son (0, 2, 3,…, 35, 36). Un conjunto de dígitos válidos para la base 2 es (0, 1), para la base 3 es (0, 1, 2) y así sucesivamente. Para las bases que comienzan del 11 al 36, los dígitos válidos incluyen alfabetos. El conjunto de dígitos válidos para la base 11 es (0, 1,…, 9, A, a), para la base 12 es (0, 1,…, 9, A, a, B, b) y así sucesivamente.
Ejemplo 2: función wcstol () con diferentes bases
#include #include #include using namespace std; int main() ( setlocale(LC_ALL, "en_US.UTF-8"); wchar_t *end; wchar_t str() = L"311bzu03feu03ff"; wcout << str << L" to Long Int with base-5 = " << wcstol(str, &end, 5) << endl; wcout << L"End String = " << end << endl << endl; wcout << str << L" to Long Int with base-5 = " << wcstol(str, &end, 12) << endl; wcout << L"End String = " << end << endl << endl; wcout << str << L" to Long Int with base-5 = " << wcstol(str, &end, 36) << endl; wcout << L"End String = " << end << endl << endl; return 0; )
Cuando ejecute el programa, la salida será:
311bzϾϿ a Long Int con base-5 = 81 End String = bzϾϿ 311bzϾϿ a Long Int con base-5 = 5351 End String = zϾϿ 311bzϾϿ a Long Int con base-5 = 5087231 End String = ϾϿ
La función wcstol () ignora todos los espacios en blanco iniciales hasta que se encuentra el carácter primario que no es un espacio en blanco.
En general, un argumento entero válido para la función wcstol () tiene la siguiente forma:
(espacio en blanco) (- | +) (0 | 0x) (caracteres alfanuméricos)
Luego, a partir de este carácter, toma tantos caracteres como sea posible que forman una representación de entero válida y los convierte en un valor int largo. Lo que quede de la cadena después del último carácter válido se ignora y no tiene ningún efecto en el resultado.
Ejemplo 3: función wcstol () para espacios en blanco iniciales y conversión no válida
#include #include #include using namespace std; int main() ( setlocale(LC_ALL, "en_US.UTF-8"); wchar_t *end; wcout << L" 205u03e2x to Long Int with base-5 = " << wcstol(L" 205u03e2x", &end, 5) << endl; wcout << L"End String = " << end << endl << endl; wcout << L"xu019cz201 to Long Int with base-12 = " << wcstol(L"xu019cz201", &end, 12) << endl; wcout << L"End String = " << end << endl << endl; return 0; )
Cuando ejecute el programa, la salida será:
205Ϣx a Long Int con base-5 = 10 End String = 5Ϣx xƜz201 a Long Int con base-12 = 0 End String = xƜz201
Si la base es 0, la base numérica se determina automáticamente al observar el formato de la cadena. Si el prefijo es 0, la base es octal (8). Si el prefijo es 0x o 0X, la base es hexadecimal (16); de lo contrario, la base es decimal (10).
Ejemplo 4: función wcstol () con base 0
#include #include #include using namespace std; int main() ( setlocale(LC_ALL, "en_US.UTF-8"); wchar_t *end; wcout << L"0539u1e84 to Long Int with base-0 = " << wcstol(L"0539u1e84", &end, 0) << endl; wcout << L"End String = " << end << endl << endl; wcout << L"0xa31u05e2 to Long Int with base-0 = " << wcstol(L"0xa31u05e2", &end, 0) << endl; wcout << L"End String = " << end << endl << endl; wcout << L"119xu060f to Long Int with base-0 = " << wcstol(L"119xu060f", &end, 0) << endl; wcout << L"End String = " << end << endl << endl; return 0; )
Cuando ejecute el programa, la salida será:
0539Ẅ a Long Int con base-0 = 43 End String = 9Ẅ 0xa31 ע a Long Int con base-0 = 2609 End String = ע 119x ؏ a Long Int con base-0 = 119 End String = x ؏
