Função StrToInt64ExW (shlwapi.h)

Artigo
11/20/2024

Converte uma cadeia de caracteres que representa um valor decimal ou hexadecimal em um inteiro de 64 bits.

Sintaxe

BOOL StrToInt64ExW(
  [in]  PCWSTR     pszString,
        STIF_FLAGS dwFlags,
  [out] LONGLONG   *pllRet
);

Parâmetros

[in] pszString

Tipo: PCTSTR

Um ponteiro para o cadeia de caracteres nulaterminada a ser convertida. Para obter mais detalhes sobre os formulários válidos da cadeia de caracteres, consulte a seção Comentários.

dwFlags

Tipo: STIF_FLAGS

Um dos valores a seguir que especificam como pszString deve ser analisado para sua conversão em um inteiro de 64 bits.

STIF_DEFAULT

A cadeia de caracteres em pszString contém a representação de um valor decimal.

STIF_SUPPORT_HEX

A cadeia de caracteres em pszString contém a representação de um valor decimal ou hexadecimal. Observe que, em representações hexadecimal, os caracteres A-F não diferenciam maiúsculas de minúsculas.

[out] pllRet

Tipo: LONGLONG*

Um ponteiro para uma variável do tipo LONGLONG que recebe o valor inteiro de 64 bits da cadeia de caracteres convertida. Por exemplo, no caso da cadeia de caracteres "123", o inteiro apontado por esse valor recebe o valor 123.

Se essa função retornar FALSE, esse valor será indefinido.

Se o valor retornado for muito grande para ser contido em uma variável do tipo LONGLONG, esse parâmetro conterá os 64 bits de ordem baixa do valor. Todos os bits de alta ordem além disso são perdidos.

Valor de retorno

Tipo: BOOL

Retorna VERDADEIRO se a cadeia de caracteres for convertida; caso contrário, FALSE .

Observações

A cadeia de caracteres apontada pelo parâmetro pszString deve ter um dos seguintes formulários a serem analisados com êxito.

Esse formulário é aceito como um valor decimal em qualquer sinalizador. Sintaxe ''' (espaço em branco opcional)(sinal opcional)(um ou mais dígitos decimais) '''
Esses formulários são necessários para valores hexadecimal quando o sinalizador STIF_SUPPORT_HEX é passado. Sintaxe ''' (espaço em branco opcional)(sinal opcional)0x(um ou mais dígitos hexadecimal) '''
```
(optional white space)(optional sign)0X(one or more hexadecimal digits)
```

O sinal opcional pode ser o caractere '-' ou '+'; se omitido, o sinal será considerado positivo.

Observação Se o valor for analisado como hexadecimal, o sinal opcional será ignorado, mesmo que seja um caractere '-'. Por exemplo, a cadeia de caracteres "-0x1" é analisada como 1 em vez de -1.

Se a cadeia de caracteres apontada por pszString 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 hexadecimal inválida "0x00am123", StrToInt64Ex reconhece apenas "0x00a", converte-a no valor inteiro 10 e retorna TRUE.

Se pllRet for NULL, a função retornará VERDADEIRO se a cadeia de caracteres puder ser convertida, mesmo que não execute a conversão.

Nota

O cabeçalho shlwapi.h define StrToInt64Ex 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. 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 5.0 ou posterior)

Compartilhar via