A função wcstod () em C ++ interpreta o conteúdo de uma string ampla como um número de ponto flutuante e retorna seu valor como um duplo.
A função wcstod () também define um ponteiro para apontar para o primeiro caractere largo 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.
protótipo wcstod ()
wcstod duplo (const wchar_t * str, wchar_t ** str_end);
A função wcstod () usa a string larga e um ponteiro para o caractere largo como parâmetro, interpreta o conteúdo da string larga como um número de ponto flutuante e retorna um valor duplo.
Parâmetros wcstod ()
- str: Uma string larga com a representação de um número de ponto flutuante.
- str_end: 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.
wcstod () Valor de retorno
A função wcstod () retorna:
- um valor duplo (que é convertido da string larga).
- 0,0 se nenhuma conversão válida puder ser realizada.
Se o valor convertido estiver fora do intervalo, ocorre um erro de intervalo e um HUGE_VAL positivo ou negativo é retornado.
Exemplo 1: Como funciona a função wcstod ()?
#include #include #include using namespace std; int main() ( setlocale(LC_ALL, "en_US.UTF-8"); wchar_t str() = L"83.201xzu0496u0687"; wchar_t *end; double value; value = wcstod(str,&end); wcout << L"Wide String = " << str << endl; wcout << L"Double value = " << value << endl; wcout << L"End String = " << end << endl; return 0; )
Quando você executa o programa, a saída será:
String ampla = 83.201xzҖ ڇ Valor duplo = 83.201 String final = xzҖ ڇ
Exemplo 2: função wcstod () sem caracteres finais
#include #include #include using namespace std; int main() ( setlocale(LC_ALL, "en_US.UTF-8"); wchar_t str() = L"83.201"; wchar_t *end; double value; value = wcstod(str,&end); wcout << L"Wide String = " << str << endl; wcout << L"Double value = " << value << endl; wcout << L"End String = " << end << endl; return 0; )
Quando você executa o programa, a saída será:
Wide String = 83.201 Double value = 83.201 End String =
Um valor de ponto flutuante válido para a função wcstod () consiste em um sinal opcional + ou - seguido por um dos seguintes conjuntos:
- Para valor de ponto flutuante decimal :
- Um grupo de dígitos decimais (0-9), contendo opcionalmente um ponto decimal (.). Por exemplo: 13,170, -5,63, etc.
- Uma parte expoente opcional (e ou E) seguida por um sinal opcional + ou - e uma sequência não vazia de dígitos decimais. Por exemplo: 3.46101e + 007, 13.19e-013, etc.
- Para valor de ponto flutuante hexadecimal :
- Uma string começando com 0x ou 0X, seguida por uma sequência não vazia de dígitos hexadecimais, opcionalmente contendo um ponto decimal (.). Por exemplo: 0xfa5, -0xb1f.24, etc.
- Uma parte expoente opcional (p ou P) seguida por um sinal opcional + ou - e uma sequência não vazia de dígitos hexadecimais. Por exemplo: 0x51c.23p5, -0x2a.3p-3, etc.
- Infinito :
- INF ou INFINITY (ignorando maiúsculas e minúsculas). Por exemplo: -Inf, InfiNiTy, etc.
- NaN (não é um número) :
- Seqüência NAN ou NAN (ignorando maiúsculas e minúsculas) em que seqüência é uma seqüência de caracteres que consiste apenas em caracteres alfanuméricos ou o sublinhado (_). O resultado é um NaN silencioso. Por exemplo: Nan, NaNab1, etc.
Exemplo 3: Como wcstod () funciona com expoentes e hexadecimais?
#include #include #include using namespace std; int main() ( setlocale(LC_ALL, "en_US.UTF-8"); wchar_t str1() = L"-136.31e-2Endu03c8"; wchar_t str2() = L"0x11a.2cu05ea"; wchar_t *end; double value; value = wcstod(str1,&end); wcout << L"Wide String = " << str1 << endl; wcout << L"Double value = " << value << endl; wcout << L"End String = " << end << endl; value = wcstod(str2,&end); wcout << L"Wide String = " << str2 << endl; wcout << L"Double value = " << value << endl; wcout << L"End String = " << end << endl; return 0; )
Quando você executa o programa, a saída será:
String ampla = -136.31e-2Endψ Valor duplo = -1.3631 String final = String ampla = 0x11a.2c ת Valor duplo = 282.172 String final = ת
Exemplo 4: Casos wcstod para INFINITY e NaN
#include #include #include using namespace std; int main() ( setlocale(LC_ALL, "en_US.UTF-8"); wchar_t str1() = L"-inFinityxu03a3y"; wchar_t str2() = L"NaN11u0429"; wchar_t *end; double value; value = wcstod(str1,&end); wcout << L"Wide String = " << str1 << endl; wcout << L"Double value = " << value << endl; wcout << L"End String = " << end << endl; value = wcstod(str2,&end); wcout << L"Wide String = " << str2 << endl; wcout << L"Double value = " << value << endl; wcout << L"End String = " << end << endl; return 0; )
Quando você executa o programa, a saída será:
String ampla = -inFinityxΣy Valor duplo = -inf String final = xΣy String ampla = NaN11Щ Valor duplo = nan String final = 11Щ
Em geral, um argumento de ponto flutuante válido para a função wcstod () tem o seguinte formato:
(espaço em branco) (- | +) (dígitos) (. dígitos) ((e | E) (- | +) dígitos)
A função wcstod () ignora todos os caracteres de espaço em branco iniciais até que o caractere de espaço em branco principal seja encontrado.
Então, começando com este caractere, ele pega tantos caracteres quanto possíveis que formam uma representação de ponto flutuante válida e os converte em um valor de ponto flutuante. O que restar da string após o último caractere válido é armazenado no objeto apontado por str_end.
Exemplo 5: função wcstod () com espaço em branco à esquerda
#include #include #include using namespace std; int main() ( setlocale(LC_ALL, "en_US.UTF-8"); wchar_t str() = L" 21.69u04f8aa"; wchar_t *end; double value; value = wcstod(str,&end); wcout << L"Wide String = " << str << endl; wcout << L"Double value = " << value << endl; wcout << L"End String = " << end << endl; return 0; )
Quando você executa o programa, a saída será:
String ampla = 21,69Ӹaa Valor duplo = 21,69 String final = Ӹaa