Função StrToIntW (shlwapi.h)
Converte uma cadeia de caracteres que representa um valor decimal em um inteiro. A macro StrToLong é idêntica a essa função.
Sintaxe
int StrToIntW(
[in] PCWSTR pszSrc
);
Parâmetros
[in] pszSrc
Tipo: PCTSTR
Um ponteiro para a cadeia de caracteres terminada em nulo a ser convertida. Uma cadeia de caracteres válida que representa um valor decimal contém apenas os caracteres 0-9 e deve ter o formulário a seguir para ser analisado com êxito.
(optional white space)(optional sign)(one or more decimal digits)
O sinal opcional pode ser o caractere '-' ou '+'; se omitido, o sinal será considerado positivo.
Valor retornado
Tipo: int
Retorna o valor int representado por pszSrc. Por exemplo, a cadeia de caracteres "123" retorna o valor inteiro 123.
Comentários
Se a cadeia de caracteres apontada por pszSrc contiver um caractere inválido, esse caractere será considerado o final da cadeia de caracteres a ser convertida e o restante será ignorado. Por exemplo, dada a cadeia de caracteres decimal inválida "12b34", StrToInt reconhece apenas "12" e retorna esse valor inteiro.
Observação
O cabeçalho shlwapi.h define StrToInt como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | shlwapi.h |
| Biblioteca | Shlwapi.lib |
| DLL | Shlwapi.dll (versão 4.71 ou posterior) |