Sous-routine wctrans ou wctrans_l

Objectif

Définissez le mappage de caractères.

Bibliothèque

Bibliothèque standard (libc.a)

Syntaxe

#include <wctype.h>

wctrans_t wctrans (const char * charclass);

wctrans_t wctrans_l (const char * charclass, locale_t Locale);

Descriptif

Les fonctions Wctrans et Wctrans_l sont définies pour les noms de mappage de caractères valides identifiés dans l'environnement local en cours. Classe de caractères est une chaîne identifiant un nom de mappage de caractères générique pour lequel des informations spécifiques au jeu de codes sont requises. Les noms de mappage de caractères suivants sont définis dans tous les environnements locaux "tolower" et "toupper".

La fonction renvoie une valeur de type Wctrans_t, qui peut être utilisée comme second argument pour les appels suivants de Trans-remorque et Suivi_l. Les fonctions Wctrans et Wctrans_l déterminent les valeurs de Wctrans_t en fonction des règles du jeu de caractères codés définies par les informations de mappage de caractères dans l'environnement local du programme (catégorie LC_CTYPE) ou dans l'environnement local représenté par Environnement local. Les valeurs renvoyées par Wctrans sont valides jusqu'à un appel à Setlocale qui modifie la catégorie LC_CTYPE.

Les valeurs renvoyées par la fonction Wctrans_l () sont valides uniquement dans les appels à la fonction Wctrans_l () avec un environnement local représenté par Environnement local avec la même valeur de catégorie LC_CTYPE.

Valeurs renvoyées

Les fonctions Wctrans et Wctrans_l renvoient 0 si le nom de mappage de caractères indiqué n'est pas valide pour l'environnement local en cours (catégorie LC_CTYPE), sinon il renvoie un objet différent de zéro de type Wctrans_t qui peut être utilisé dans les appels vers Trans-remorque et Suivi_l.

Codes d'erreur

La fonction Wctranset Wctrans_l peut échouer si: