Nom

fwide - Fixer et déterminer les orientations d'un flux.

Résumé

.nf #include <wchar.h> int fwide (FILE * flux , int mode ); .fi

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

fprintf (3), fwprintf (3)

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.