Sous-routine wcswidth

Objectif

Détermine la largeur d'affichage des chaînes de caractères larges.

Bibliothèque

Bibliothèque C standard (libc.a)

Syntaxe

#include <string.h>

Descriptif

La sous-routine Wcswidth détermine le nombre de colonnes d'affichage à occuper par le nombre de caractères larges spécifié par le paramètre N dans la chaîne désignée par le paramètre Pwcs . La catégorie TYPE_LOGIQUE affecte le comportement de la sous-routine Wcswidth . Un nombre inférieur au nombre de caractères larges spécifié par le paramètre N est compté si un caractère nul est rencontré en premier.

Paramètres

Valeurs renvoyées

La sous-routine Wcswidth renvoie le nombre de colonnes d'affichage à occuper par le nombre de caractères larges (jusqu'à la valeur null de l'extrémité de fin) spécifié par le paramètre N (ou moins) dans la chaîne désignée par le paramètre Pwcs . Une valeur de zéro est renvoyée si le paramètre Pwcs est un pointeur vide de caractère large ou un pointeur vers un caractère large null (c'est-à-dire que Pwcs ou *Pwcs est null). Si le paramètre Pwcs pointe vers un code de caractère large inutilisable, -1 est renvoyé.

Exemples

Pour rechercher la largeur de la colonne d'affichage d'une chaîne de caractères larges, procédez comme suit:

#include <string.h>
#include <locale.h>
#include <stdlib.h>
 

main()
{
   wchar_t *pwcs;
   int     retval, n ;

   (void)setlocale(LC_ALL, "");
   /* Let pwcs point to a wide character null terminated 
   ** string. Let n be the number of wide characters whose 
   ** display column width is to be determined.
   */
   retval=  wcswidth( pwcs, n );
   if(retval == -1){
           /* Error handling. Invalid wide character code 
           ** encountered in the wide character string pwcs.
           */
   }
}