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, POSIX.1-2001.

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().

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