INFO : conseils pour la cr�ation d'applications compatibles de DBCS

Num�ro d'article: 75439 - Voir les produits auxquels s'applique cet article

ATTENTION : Cet article est issu du syst�me de traduction automatique

Cliquez ici si vous souhaitez afficher en c�te � c�te l?article anglais et sa traduction automatique en fran�ais

Exclusion de responsabilit� concernant les contenus obsol�tes dans la Base de connaissances

3,00 3.10 Kbprg WINDOWS

Agrandir tout | R�duire tout

R�sum�

Op�rations dans les syst�mes qui utilisent un Double-Byte Character jeu (sur deux octets DBCS) sur les cha�nes sont l�g�rement diff�rentes d'un syst�me de caract�res cod�s sur un. Cet article fournit les instructions compl�tes pour r�duire le travail n�cessaire au port d'une application �crite pour un syst�me cod� sur un syst�me DBCS.

Plus d'informations

Dans un jeu de caract�res cod�s sur deux octets, certains caract�res n�cessitent deux d'octets, tandis que certaines n�cessitent uniquement un octet. Le pilote de langue pouvez distinguer ces deux types de caract�res en d�signant des caract�res sous forme de � octets avance �. Un octet en t�te sera suivie autre octet (un � octet Queue �) pour cr�er un Double-Byte Character (DBC). L'ensemble des octets de prospect est diff�rent pour chaque langue. Octets d�lai garantis sont toujours �tre des caract�res �tendus ; aucun caract�res ASCII 7 bits ne peuvent �tre responsable octets. L'octet Queue peut �tre n'importe quel octet sauf un octet NULL. La fin d'une cha�ne est toujours d�finie comme le premier octet NULL dans la cha�ne. Octets de prospect sont Queue juridique octets ; le seul moyen de savoir si un octet op�re comme un octet en t�te est � partir du contexte.

Le Windows Kit (SDK) version 3.0 inclut deux fonctions pour d�placer des cha�nes qui peuvent contenir DBCs : AnsiNext() et AnsiPrev() . La fonction AnsiPrev() est un appel co�teuse temps car il doit s'ex�cuter via la cha�ne � partir du d�but pour d�terminer o� commence le caract�re pr�c�dent. Il est pr�f�rable rechercher des caract�res � partir du d�but plut�t que la fin d'une cha�ne.

Le SDK Windows version 3.1 inclut la fonction IsDBCSLeadByte() , qui renvoie la valeur TRUE si et seulement si l'octet CAN BE un octet en t�te. Parce que cette fonction accepte un caract�re param�tre, il ne peut pas signaler si l'octet est un octet en t�te (pour cela serait n�cessitent contexte).

Pour rendre le code non DBCS ex�cut� aussi rapidement que possible, un fichier source peut utiliser � #ifdef DBCS � autour de code qui est uniquement pour les jeux de caract�res cod�s sur deux octets et compiler les deux versions du fichier objet (OBJ). Par exemple :

   #ifdef DBCS
     for (pszTemp = szString; *pszTemp; pszTemp = AnsiNext(pszTemp))
   #else
     for (pszTemp = szString; *pszTemp; ++pszTemp)
   #endif

   ...

rendre le code plus facile � lire, une application peut d�finir les macros pour les fonctions AnsiNext() et AnsiPrev() Si DBCS n'est pas d�fini :

   #ifndef DBCS

   #define AnsiNext(x) ((x)+1)
   #define AnsiPrev(y, x) ((x)-1)

   #ifdef WIN31

   #define IsDBCSLeadByte(x) (FALSE)

   #endif

   #endif

avec ces d�finitions en place, tout le code peuvent �tre �crits pour les jeux de caract�res cod�s sur deux octets. Notez que la fonction AnsiNext() ne d�passent pas la fin d'une cha�ne et la fonction AnsiPrev() ne d�passent pas d�but d'une cha�ne, tandis que les macros sont. En outre, car le param�tre � y � dans la macro AnsiPrev() est ignor�, du code vous donnera des r�sultats diff�rents lorsque compil� avec et sans DBCS d�fini. Le code suivant est un exemple de ce ph�nom�ne :

   pszEnd = AnsiPrev(++pszStart, pszEnd);

le code suivant montre comment rechercher le d�calage de nom de fichier dans un nom de chemin complet :

   LPSTR GetFilePtr(LPSTR lpszFullPath)
   {

    LPSTR lpszFileName;

    for (lpszFileName = lpszFullPath; *lpszFullPath;
               lpszFullPath = AnsiNext(lpszFullPath))
        if (*lpszFullPath == ':' || *lpszFullPath == '\\')
            lpszFileName = lpszFullPath + 1;

    return lpszFileName;

   }

Remarque que ': 'et' \\ � sont forc�ment ne pas octets du prospect. La recherche d�marr� � partir du d�but de la cha�ne plut�t que la fin pour �viter � l'aide de la fonction AnsiPrev() .

Le code suivant illustre une copie de cha�ne dans un tampon de taille limit�e. Notez que cela garantit que la cha�ne ne se termine pas par un octet en t�te.

   int StrCpyN(LPSTR lpszDst, LPSTR lpszSrc, unsigned int wLen)

   {

    LPSTR lpEnd;
    char cTemp;

    // account for the terminating NULL
    --wLen;

    for (lpEnd = lpszSrc; *lpEnd && (lpEnd - lpszSrc) < wLen;
               lpEnd = AnsiNext(lpEnd))
        ;  // scan to the end of string, or wLen bytes

    // The following can happen only if lpszSrc[wLen-1] is a lead
    // byte, in which case do not include the previous DBC in the copy.
    if (lpEnd - lpszSrc > wLen)
        lpEnd -= 2;

    // Terminate the source string and call lstrcpy.
    cTemp = *lpEnd;
    *lpEnd = '\0';
    lstrcpy(lpszDst, lpszSrc);
    *lpEnd = cTemp;

   }

Propri�t�s

Num�ro d'article: 75439 - Derni�re mise � jour: vendredi 11 f�vrier 2005 - Version: 1.1

Les informations contenues dans cet article s'appliquent au(x) produit(s) suivant(s):

Microsoft Windows Software Development Kit 3.1

kbmt kb16bitonly kbinfo KB75439 KbMtfr

Traduction automatique

IMPORTANT : Cet article est issu du syst�me de traduction automatique mis au point par Microsoft (http://support.microsoft.com/gp/mtdetails). Un certain nombre d?articles obtenus par traduction automatique sont en effet mis � votre disposition en compl�ment des articles traduits en langue fran�aise par des traducteurs professionnels. Cela vous permet d?avoir acc�s, dans votre propre langue, � l?ensemble des articles de la base de connaissances r�dig�s originellement en langue anglaise. Les articles traduits automatiquement ne sont pas toujours parfaits et peuvent comporter des erreurs de vocabulaire, de syntaxe ou de grammaire (probablement semblables aux erreurs que ferait une personne �trang�re s?exprimant dans votre langue !). N�anmoins, mis � part ces imperfections, ces articles devraient suffire � vous orienter et � vous aider � r�soudre votre probl�me. Microsoft s?efforce aussi continuellement de faire �voluer son syst�me de traduction automatique.

La version anglaise de cet article est la suivante: 75439

(http://support.microsoft.com/kb/75439/en-us/ )

L'INFORMATION CONTENUE DANS CE DOCUMENT EST FOURNIE PAR MICROSOFT SANS GARANTIE D'AUCUNE SORTE, EXPLICITE OU IMPLICITE. L'UTILISATEUR ASSUME LE RISQUE DE L'UTILISATION DU CONTENU DE CE DOCUMENT. CE DOCUMENT NE PEUT ETRE REVENDU OU CEDE EN ECHANGE D'UN QUELCONQUE PROFIT.

Exclusion de responsabilit� concernant les contenus obsol�tes dans la Base de connaissances

Cet article concerne des produits pour lesquels Microsoft n'offre plus de support. Il est par cons�quent fourni � en l'�tat � et ne sera plus mis � jour.