Funzione CharNextA (winuser.h)

  • Articolo

Recupera un puntatore al carattere successivo in una stringa. Questa funzione può gestire stringhe costituite da caratteri a byte singolo o multi-byte.

Sintassi

LPSTR CharNextA(
  [in] LPCSTR lpsz
);

Parametri

[in] lpsz

Tipo: LPCTSTR

Carattere in una stringa con terminazione Null.

Valore restituito

Tipo: LPTSTR

Il valore restituito è un puntatore al carattere successivo nella stringa o al carattere Null di terminazione se alla fine della stringa.

Se lpsz punta al carattere Null di terminazione, il valore restituito è uguale a lpsz.

Commenti

Quando viene chiamato come funzione ANSI, CharNext usa la tabella codici predefinita del sistema, mentre CharNextExA specifica una tabella codici da usare.

Questa funzione funziona con le aspettative predefinite dei caratteri "utente" quando si gestiscono segni diacritici. Ad esempio: una stringa che contiene U+0061 U+030a "LATIN SMALL LETTER A" + COMBINING RING ABOVE( simile a "å", fa avanzare due punti di codice, non uno. Una stringa che contiene U+0061 U+0301 U+0302 U+0303 U+0304, simile a "a'^~ ̄", farà avanzare cinque punti di codice, non uno e così via.

Nota

L'intestazione winuser.h definisce CharNext 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winuser.h (include Windows.h)
Libreria User32.lib
DLL User32.dll

Vedi anche

CharNextExA

CharPrev

Informazioni concettuali

Riferimento

Stringhe