btowc

Autres langues

Langue: fr

Version: 25 juillet 1999 (fedora - 25/11/07)

Section: 3 (Bibliothèques de fonctions)

NOM

btowc - Convertir un octet en caractère large.

SYNOPSIS

 #include <wchar.h>
 
 wint_t btowc (int c);
 

DESCRIPTION

La fonction btowc() prend l'entier c, considéré comme une séquence multi-octets de longueur 1, en débutant dans l'état de décalage initial, le convertit en caractère large, puis le renvoie. Si c n'est pas EOF ou une séquence multi-octets valide de longueur 1, la fonction btowc() renvoie WEOF.

VALEUR RENVOYÉE

La fonction btowc() renvoie le caractère large converti à partir de l'octet c. Si c est EOF ou n'est pas une séquence multi-octets de longueur 1, elle renvoie WEOF.

CONFORMITÉ

C99, POSIX.1-2001.

VOIR AUSSI

mbtowc(3)

NOTES

Le comportement de la fonction btowc() dépend de la catégorie LC_CTYPE de la localisation.

Cette fonction ne devrait jamais être utilisée. Elle ne permet pas d'encoder des séquences ayant plusieurs états, et manipule inutilement les octets un par un dans une séquence multi-octets. Utilisez la fonction mbtowc() à la place.

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 28 août 2000 et révisée le 14 août 2006.

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 btowc ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.