A função wcstol () em C ++ interpreta o conteúdo de uma string larga como um número integral da base especificada e retorna seu valor como um inteiro longo.
A função wcstol () também define um ponteiro para apontar para o primeiro caractere após o último caractere válido da string larga, se houver algum, caso contrário, o ponteiro é definido como nulo.
É definido no arquivo de cabeçalho.
Para a base 10 e a string larga L "12abc" Parte numérica válida -> 12 Primeiro caractere após a parte numérica válida -> a
protótipo wcstol ()
wcstol longo (const wchar_t * str, wchar_t ** str_end, int base);
A função wcstol () pega uma string larga, um ponteiro para um caractere largo e um valor inteiro - base como seu parâmetro, interpreta o conteúdo da string larga como um número inteiro da base dada e retorna um valor inteiro longo.
Parâmetros wcstol ()
- str: Uma string larga com a representação de um número inteiro.
- str_end: Um ponteiro para um ponteiro para um caractere largo. O valor de str_end é definido pela função para o próximo caractere em str após o último caractere válido. Este parâmetro também pode ser um ponteiro nulo, caso em que não é usado.
- base: a base do valor integral. O conjunto de valores válidos para a base é (0, 2, 3,…, 35, 36).
wcstol () Valor de retorno
A função wcstol () retorna:
- um valor int longo (que é convertido da string).
- 0 se nenhuma conversão válida puder ser realizada.
Exemplo 1: Como funciona a função 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; )
Quando você executa o programa, a saída será:
String valor = 101aa ᚶ Long Int valor = 101 End String = aa ᚶ String valor = 59 Long Int value = 59 End String =
Um valor inteiro válido para a função wcstol () consiste em:
- Um sinal opcional + ou -.
- Um prefixo 0 para base octal (aplica-se apenas quando base = 8 ou 0).
- Um prefixo 0x ou 0X para base hexadecimal (aplica-se apenas quando base = 16 ou 0).
- Uma sequência de dígitos e / ou alfabetos (se a base for maior que 10).
Os valores válidos para a base do parâmetro são (0, 2, 3,…, 35, 36). Um conjunto de dígitos válidos para a base 2 é (0, 1), para a base 3 é (0, 1, 2) e assim por diante. Para bases de 11 a 36, os dígitos válidos incluem alfabetos. O conjunto de dígitos válidos para a base 11 é (0, 1,…, 9, A, a), para a base 12 é (0, 1,…, 9, A, a, B, b) e assim por diante.
Exemplo 2: função wcstol () com bases diferentes
#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; )
Quando você executa o programa, a saída será:
311bzϾϿ para Long Int com base-5 = 81 End String = bzϾϿ 311bzϾϿ para Long Int com base-5 = 5351 End String = zϾϿ 311bzϾϿ para Long Int com base-5 = 5087231 End String = ϾϿ
A função wcstol () ignora todos os caracteres de espaço em branco iniciais até que o caractere de espaço em branco principal seja encontrado.
Em geral, um argumento inteiro válido para a função wcstol () tem o seguinte formato:
(espaço em branco) (- | +) (0 | 0x) (caracteres alfanuméricos)
Então, começando com este caractere, ele pega tantos caracteres quanto possível que forma uma representação de inteiro válida e os converte em um valor inteiro longo. O que restar da string após o último caractere válido é ignorado e não tem efeito no resultado.
Exemplo 3: função wcstol () para primeiro espaço em branco e conversão invá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; )
Quando você executa o programa, a saída será:
205Ϣx para Long Int com base-5 = 10 End String = 5Ϣx xƜz201 para Long Int com base-12 = 0 End String = xƜz201
Se a base for 0, a base numérica é determinada automaticamente observando o formato da string. Se o prefixo for 0, a base é octal (8). Se o prefixo for 0x ou 0X, a base é hexadecimal (16), caso contrário, a base é decimal (10).
Exemplo 4: função wcstol () com 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; )
Quando você executa o programa, a saída será:
0539Ẅ para Long Int com base-0 = 43 End String = 9Ẅ 0xa31 ע para Long Int com base-0 = 2609 End String = ע 119x ؏ para Long Int com base-0 = 119 End String = x ؏
