WCTOMB

Section : Manuel du programmeur Linux (3)
Mise à jour de la version anglaise : 25 juillet 1999
Index Menu principal

NOM

wctomb - Convertir un caractère large en caractère multi-octet

SYNOPSIS

#include <stdlib.h>

int wctomb(char *s, wchar_t wchar);

DESCRIPTION

Si s n'est pas NULL, la fonction wctomb() convertit le caractère large wc dans sa représentation multi-octets et le stocke au début de la chaîne de caractères pointée par s. Elle met à jour l'état de décalage, variable statique anonyme connue uniquement de la fonction wctomb(), et renvoie la longueur de la représentation multi-octets, c'est-à-dire le nombre d'octets écrits dans s.

Le programmeur doit s'assurer qu'il y a assez de place pour au moins MB_CUR_MAX octets dans s.

Si s est NULL, la fonction wctomb() réinitialise l'état de décalage, connu seulement de cette fonction, à sa valeur initiale et renvoie une valeur non nulle si l'encodage a un état de décalage non trivial, ou zéro si l'encodage est sans état.

VALEUR RENVOYÉE

Si s n'est pas NULL, la fonction wctomb() renvoie le nombre d'octets qui ont été écrits dans la chaîne d'octet à l'adresse s. Si wc ne peut pas être représenté par une séquence multi-octets (d'après la localisation en cours), elle renvoie -1.

Si s est NULL, la fonction wctomb() renvoie une valeur non nulle si l'encodage a un état de décalage non trivial, ou zéro si l'encodage est sans état.

CONFORMITÉ

C99.

NOTES

Le comportement de wctomb() dépend de la catégorie LC_CTYPE des paramètres régionaux en vigueur.

Cette fonction ne doit pas être utilisée dans un environnement multithreads. La routine wcrtomb(3) fournit une meilleure interface pour la même fonctionnalité.

VOIR AUSSI

MB_CUR_MAX(3), wcrtomb(3), wcstombs(3)

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 11 décembre 1996 et révisée le 17 juillet 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 wctomb ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

Dernière mise à jour : 17 juillet 2008