man fwide (Fonctions bibliothèques) - Fixer et déterminer les orientations d'un flux.
NOM
fwide - Fixer et déterminer les orientations d'un flux.
SYNOPSIS
#include <wchar.h> int fwide (FILE * flux, int mode);
DESCRIPTION
Lorsque le mode vaut zéro, la fonction fwide détermine l'orientation du flux. Elle renvoie une valeur positive si le flux est orienté caractères-larges. Elle renvoie une valeur négative si le flux est orienté octets, c'est à dire si les entrées/sorties par caractères sont autorisées, mais pas celles par caractères larges. Elle renvoie zéro si le flux n'a pas encore d'orientation. Dans ce cas, l'opération d'entrée/sortie suivante peut changer son orientation (octets s'il s'agit d'une opération normale, caractères-larges si c'est une opération avec des caractères larges).
une fois qu'un flux a une orientation, elle ne peut pas être changée, et persistera jusqu'à sa fermeture.
Quand le mode est non-nul, la fonction fwide essaye d'abord de fixer l'orientation correspondante pour le flux (caractères-larges si le mode est positif, octets s'il est négatif). Puis elle renvoie une valeur correspondant à l'orientation réelle, comme précédemment.
VALEUR RENVOYÉE
La fonction fwide renvoie l'orientation du flux, après l'avoir éventuellement modifiée. Une valeur supérieure à zéro représente une orientation caractères-larges, une valeur inférieure à zéro une orientation octets, une valeur nulle représentant une orientation non-décidée.
CONFORMITÉ
ISO/ANSI C, UNIX98
VOIR AUSSI
NOTES
Une sortie de caractères larges dans un flux orienté octets peut être réalisée avec la fonction fprintf en utilisant les directives %lc et %ls.
Les sorties de caractères dans un flux orienté caractères-larges sont possibles en utilisant les directives %c et %s de la fonction fwprintf.
TRADUCTION
Christophe Blaess, 2000-2003.