Função StrToIntA (shlwapi.h)

  • Artigo

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 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)

Confira também

StrToIntEx