Funzione StrToIntExW (shlwapi.h)

Articolo
11/20/2024

Converte una stringa che rappresenta un numero decimale o esadecimale in un numero intero.

Sintassi

BOOL StrToIntExW(
  [in]  PCWSTR     pszString,
        STIF_FLAGS dwFlags,
  [out] int        *piRet
);

Parametri

[in] pszString

Tipo: PCTSTR

Puntatore alla stringa con terminazione Null da convertire. Per altri dettagli sulle forme valide della stringa, vedere la sezione Osservazioni.

dwFlags

Tipo: STIF_FLAGS

Uno dei valori seguenti che specificano come pszString deve essere analizzato per la conversione in un numero intero.

STIF_DEFAULT

La stringa in corrispondenza di pszString contiene la rappresentazione di un valore decimale.

STIF_SUPPORT_HEX

La stringa in corrispondenza di pszString contiene la rappresentazione di un valore decimale o esadecimale. Si noti che nelle rappresentazioni esadecimali i caratteri A-F non fanno distinzione tra maiuscole e minuscole.

[out] piRet

Tipo: int*

Puntatore a un int che riceve la stringa convertita. Ad esempio, nel caso della stringa "123", l'intero a cui punta questo valore riceve il valore intero 123.

Se questa funzione restituisce FALSE, questo valore non è definito.

Se il valore restituito è troppo grande per essere contenuto in una variabile di tipo int, questo parametro contiene i 32 bit di ordine basso del valore. Tutti i bit di ordine elevato oltre i quali vengono persi.

Valore restituito

Tipo: bool

Restituisce TRUE se la stringa viene convertita; in caso contrario, FALSE.

Osservazioni

La stringa a cui punta il parametro pszString deve essere analizzata correttamente una delle forme seguenti.

Questo modulo viene accettato come valore decimale in entrambi i flag. Sintassi ''' (spazio vuoto facoltativo)(segno facoltativo)(una o più cifre decimali) '''
Questi moduli sono necessari per i valori esadecimali quando viene passato il flag STIF_SUPPORT_HEX. Sintassi ''' (spazio vuoto facoltativo)(segno facoltativo)0x(una o più cifre esadecimali) '''
```
(optional white space)(optional sign)0X(one or more hexadecimal digits)
```

Il segno facoltativo può essere il carattere '-' o '+'; se omesso, si presuppone che il segno sia positivo.

Nota Se il valore viene analizzato come esadecimale, il segno facoltativo viene ignorato, anche se è un carattere "-". Ad esempio, la stringa "-0x1" viene analizzata come 1 anziché -1.

Se la stringa a cui punta pszString contiene un carattere non valido, tale carattere viene considerato la fine della stringa da convertire e il resto viene ignorato. Ad esempio, data la stringa esadecimale non valida "0x00am123", StrToIntEx riconosce solo "0x00a", la converte nel valore intero 10 e restituisce TRUE.

Nota

L'intestazione shlwapi.h definisce StrToIntEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	shlwapi.h
libreria	Shlwapi.lib
dll	Shlwapi.dll (versione 4.71 o successiva)

Condividi tramite