StrToInt64ExA, fonction (shlwapi.h)

Article
11/20/2024

Convertit une chaîne représentant une valeur décimale ou hexadécimale en entier 64 bits.

Syntaxe

BOOL StrToInt64ExA(
  [in]  PCSTR      pszString,
        STIF_FLAGS dwFlags,
  [out] LONGLONG   *pllRet
);

Paramètres

[in] pszString

Type : PCTSTR

Pointeur vers la chaîne null-terminated à convertir. Pour plus d’informations sur les formes valides de la chaîne, consultez la section Remarques.

dwFlags

Type : STIF_FLAGS

L’une des valeurs suivantes qui spécifient comment pszString doit être analysée pour sa conversion en entier 64 bits.

STIF_DEFAULT

La chaîne à pszString contient la représentation d’une valeur décimale.

STIF_SUPPORT_HEX

La chaîne à pszString contient la représentation d’une valeur décimale ou hexadécimale. Notez que dans les représentations hexadécimales, les caractères A-F ne respectent pas la casse.

[out] pllRet

Type : LONGLONG*

Pointeur vers une variable de type LONGLONG qui reçoit la valeur entière 64 bits de la chaîne convertie. Par exemple, dans le cas de la chaîne « 123 », l’entier pointé par cette valeur reçoit la valeur 123.

Si cette fonction retourne FALSE, cette valeur n’est pas définie.

Si la valeur retournée est trop grande pour être contenue dans une variable de type LONGLONG, ce paramètre contient les 64 bits de faible ordre de la valeur. Tous les bits de haut ordre au-delà de ce qui sont perdus.

Valeur de retour

Type : BOOL

Retourne TRUE si la chaîne est convertie ; sinon, FALSE.

Remarques

La chaîne pointée par le paramètre pszString doit avoir l’un des formulaires suivants pour être analysé avec succès.

Ce formulaire est accepté comme valeur décimale sous l’un ou l’autre indicateur. Syntaxe ''' (espace blanc facultatif)(signe facultatif)(un ou plusieurs chiffres décimaux) '''
Ces formulaires sont requis pour les valeurs hexadécimales lorsque l’indicateur de STIF_SUPPORT_HEX est passé. Syntaxe ''' (espace blanc facultatif)(signe facultatif)0x(un ou plusieurs chiffres hexadécimaux) '''
```
(optional white space)(optional sign)0X(one or more hexadecimal digits)
```

Le signe facultatif peut être le caractère « - » ou « + » ; s’il est omis, le signe est supposé être positif.

Remarque Si la valeur est analysée en hexadécimal, le signe facultatif est ignoré, même s’il s’agit d’un caractère « - ». Par exemple, la chaîne « -0x1 » est analysée comme 1 au lieu de -1.

Si la chaîne pointée par pszString contient un caractère non valide, ce caractère est considéré comme la fin de la chaîne à convertir et le reste est ignoré. Par exemple, étant donné la chaîne hexadécimale non valide « 0x00am123 », StrToInt64Ex reconnaît uniquement « 0x00a », la convertit en valeur entière 10 et retourne TRUE.

Si pllRet est NULL, la fonction retourne TRUE si la chaîne peut être convertie, même si elle n’effectue pas la conversion.

Note

L’en-tête shlwapi.h définit StrToInt64Ex comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	shlwapi.h
bibliothèque	Shlwapi.lib
DLL	Shlwapi.dll (version 5.0 ou ultérieure)

Partager via