WCTOMB(3)

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.