Fonction StrToInt64ExA (shlwapi.h)

Article
08/26/2023

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 terminée par null à convertir. Pour plus d’informations sur les formes valides de la chaîne, consultez la section Remarques.

dwFlags

Type : STIF_FLAGS

Une des valeurs suivantes qui spécifient comment pszString doit être analysé 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 instance, dans le cas de la chaîne « 123 », l’entier pointé vers 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 d’ordre inférieur de la valeur. Tous les bits d’ordre élevé au-delà sont perdus.

Valeur retournée

Type : BOOL

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

Remarques

La chaîne pointée vers le paramètre pszString doit avoir l’une des formes suivantes pour être analysée avec succès.

Ce formulaire est accepté sous la forme d’une 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 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 « + » ; en cas d’omission, le signe est supposé positif.

Note Si la valeur est analysée comme hexadécimale, 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 instance, compte tenu de la chaîne hexadécimale « 0x00am123 » non valide, StrToInt64Ex reconnaît uniquement « 0x00a », la convertit en valeur entière 10 et retourne TRUE.

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

Notes

L’en-tête shlwapi.h définit StrToInt64Ex comme un 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlwapi.h
Bibliothèque	Shlwapi.lib
DLL	Shlwapi.dll (version 5.0 ou ultérieure)

Partager via