Fonction CharNextA (winuser.h)
Récupère un pointeur vers le caractère suivant dans une chaîne. Cette fonction peut gérer des chaînes composées de caractères uniques ou multioctets.
Syntaxe
LPSTR CharNextA(
[in] LPCSTR lpsz
);
Paramètres
[in] lpsz
Type : LPCTSTR
Caractère d’une chaîne terminée par null.
Valeur de retour
Type : LPTSTR
La valeur de retour est un pointeur vers le caractère suivant de 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’elle est appelée en tant que fonction ANSI, CharNext utilise la page de codes par défaut du système, tandis que CharNextExA spécifie une page de codes à utiliser.
Cette fonction fonctionne avec les attentes « utilisateur » par défaut des caractères lors de la gestion des signes diacritiques. Par exemple : chaîne qui contient U+0061 U+030a « LATIN SMALL LETTER A » + COMBINING RING ABOVE », qui ressemble à « å », avance deux points de code, et non un. 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.
Note
L’en-tête winuser.h définit CharNext 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 [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | winuser.h (include Windows.h) |
| bibliothèque | User32.lib |
| DLL | User32.dll |
Voir aussi
conceptuelle
de référence