Função StrToIntA (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 StrToIntA(
[in] PCSTR 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 de retorno
Tipo: int
Retorna o valor int representado por pszSrc. Por exemplo, a cadeia de caracteres "123" retorna o valor inteiro 123.
Observações
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 convertido e o restante será ignorado. Por exemplo, considerando a cadeia de caracteres decimais inválida "12b34", StrToInt reconhece apenas "12" e retorna esse valor inteiro.
Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | shlwapi.h |
| biblioteca | Shlwapi.lib |
| de DLL |
Shlwapi.dll (versão 4.71 ou posterior) |