StrToIntExA, fonction (shlwapi.h)

Article
11/20/2024

Convertit une chaîne représentant un nombre décimal ou hexadécimal en entier.

Syntaxe

BOOL StrToIntExA(
  [in]  PCSTR      pszString,
        STIF_FLAGS dwFlags,
  [out] int        *piRet
);

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ée pour sa conversion en entier.

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] piRet

Type : int*

Pointeur vers un int qui reçoit la chaîne convertie. Par exemple, dans le cas de la chaîne « 123 », l’entier pointé par cette valeur reçoit la valeur entière 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 int, ce paramètre contient les 32 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 », StrToIntEx reconnaît uniquement « 0x00a », la convertit en valeur entière 10 et retourne TRUE.

Note

L’en-tête shlwapi.h définit StrToIntEx 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 4.71 ou ultérieure)

Partager via