fwide − Fixer et déterminer les orientations d’un flux.

#include <wchar.h>

int fwide (FILE * flux, int mode);

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.

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.

ISO/ANSI C, UNIX98

fprintf(3), fwprintf(3)

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.

Christophe Blaess, 2000.