Fonction CharNextA (winuser.h)

Article
03/04/2024

Récupère un pointeur vers le caractère suivant d’une chaîne. Cette fonction peut gérer des chaînes composées de caractères simples ou de plusieurs octets.

Syntaxe

LPSTR CharNextA(
  [in] LPCSTR lpsz
);

Paramètres

[in] lpsz

Type : LPCTSTR

Caractère dans une chaîne terminée par null.

Valeur retournée

Type : LPTSTR

La valeur de retour est un pointeur vers le caractère suivant dans la chaîne, ou vers le caractère null de fin si à la fin de la chaîne.

Si lpsz pointe vers le caractère null de fin, la valeur de retour est égale à lpsz.

Remarques

Lorsqu’il est appelé en tant que fonction ANSI, CharNext utilise la page de code par défaut du système, tandis que CharNextExA spécifie une page de code à utiliser.

Cette fonction fonctionne avec les attentes « utilisateur » par défaut de caractères lors du traitement des diacritiques. Par exemple : une chaîne qui contient U+0061 U+030a « LETTRE MINUSCULE LATINE A » + COMBINING RING ABOVE » — qui ressemble à « å », avance deux points de code, et non un. Une chaîne qui contient U+0061 U+0301 U+0302 U+0303 U+0304 — qui ressemble à « a'^~ », avance cinq points de code, pas un, et ainsi de suite.

Notes

L’en-tête winuser.h définit CharNext 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 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll