fputwc, putwc - Écrire un caractère large dans un flux FILE
Bibliothèque C standard (
libc,
-lc)
#include <stdio.h>
#include <wchar.h>
wint_t fputwc(wchar_t wc, FILE *stream);
wint_t putwc(wchar_t wc, FILE *stream);
La fonction
fputwc() est l'équivalent pour les caractères
larges de la fonction
fputc(3). Elle écrit le caractère
large
wc dans le flux
stream. Si
ferror(stream) devient
vrai,
WEOF est renvoyé. Si une erreur de conversion du
caractère large se produit,
errno est défini à
EILSEQ et
WEOF est renvoyé. Sinon,
wc est
renvoyé.
La fonction ou la macro
putwc() est identique à
fputwc().
Elle peut être implémentée comme une macro et donc
évaluer plusieurs fois son argument. Il n'y a pas de raison de
l'utiliser.
Pour des versions de ces fonctions ignorant les verrouillages, voir
unlocked_stdio(3).
En cas de succès,
fputwc() renvoie
wc. Autrement, elle
renvoie
WEOF et
errno est défini pour préciser
l'erreur.
En plus des erreurs habituelles, il y a :
- EILSEQ
- La conversion de wc vers l'encodage du flux a
échoué.
Pour une explication des termes utilisés dans cette section, consulter
attributes(7).
Interface |
Attribut |
Valeur |
fputwc(), putwc() |
Sécurité des threads |
MT-Safe |
POSIX.1-2001, POSIX.1-2008, C99.
Le comportement de
fputwc() dépend de la valeur
LC_CTYPE de
la localisation utilisée.
En l'absence d'informations supplémentaires passées à
l'appel
fopen(3), il est raisonnable de penser que
fputwc()
écrira en fait la séquence multioctet correspondant au
caractère large
wc.
fgetwc(3),
fputws(3),
unlocked_stdio(3)
La traduction française de cette page de manuel a été
créée par Christophe Blaess
<
https://www.blaess.fr/christophe/>, Stéphan Rafin
<
[email protected]>, Thierry Vignaud
<
[email protected]>, François Micaux, Alain Portal
<
[email protected]>, Jean-Philippe Guérard
<
[email protected]>, Jean-Luc Coulon (f5ibh)
<
[email protected]>, Julien Cristau
<
[email protected]>, Thomas Huriaux <
[email protected]>,
Nicolas François <
[email protected]>, Florentin
Duneau <
[email protected]>, Simon Paillard
<
[email protected]>, Denis Barbier
<
[email protected]>, David Prévot <
[email protected]> et
Frédéric Hantrais <
[email protected]>
Cette traduction est une documentation libre ; veuillez vous reporter
à la
GNU
General Public License version 3 concernant les conditions de copie
et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message à
[email protected]