Fonction IsDBCSLeadByte (winnls.h)

Détermine si un caractère spécifié est un octet de prospect pour la page de code ANSI Windows par défaut (CP_ACP). Un octet principal est le premier octet d’un caractère de deux octets dans un jeu de caractères double octet (DBCS) pour la page de code.

Note Pour utiliser une autre page de code, votre application doit utiliser la fonction IsDBCSLeadByteEx .

 

Syntaxe

BOOL IsDBCSLeadByte(
  [in] BYTE TestChar
);

Paramètres

[in] TestChar

Caractère à tester.

Valeur retournée

Retourne une valeur différente de zéro si le caractère de test est potentiellement un octet de prospect. La fonction retourne 0 si le caractère de test n’est pas un octet de prospect ou s’il s’agit d’un caractère à un octet. Pour obtenir des informations d’erreur étendues, l’application peut appeler GetLastError.

Remarques

Note Cette fonction ne valide pas la présence ou la validité d’un octet de piste. Par conséquent, MultiByteToWideChar peut ne pas reconnaître une séquence que l’application utilisant IsDBCSLeadByte signale en tant qu’octet principal. L’application peut facilement être désynchronisée avec les résultats de MultiByteToWideChar, ce qui peut entraîner des erreurs inattendues ou des incompatibilités de taille de mémoire tampon.

 

En général, au lieu de tenter de manipuler de bas niveau des données de page de code, les applications doivent utiliser MultiByteToWideChar pour convertir les données en UTF-16 et les utiliser dans cet encodage.

Les valeurs d’octet de prospect sont spécifiques à chaque DBCS distinct. Certaines valeurs d’octet peuvent apparaître dans une page de code unique en tant qu’octet de prospect et d’octet de fin d’un caractère DBCS.

Pour donner un sens à une chaîne DBCS, une application démarre normalement au début d’une chaîne et analyse vers l’avant, en gardant le suivi lorsqu’elle rencontre un octet de prospect et en traitant l’octet suivant comme la partie de fin du même caractère. Si l’application doit effectuer une sauvegarde, elle doit utiliser CharPrev au lieu de tenter de développer son propre algorithme.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	winnls.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

IsDBCSLeadByteEx

MultiByteToWideChar

Fonctions Unicode et jeu de caractères

Unicode et jeux de caractères