fwide

Autres langues

Langue: fr

Version: 17 novembre 1999 (mandriva - 01/05/08)

Section: 3 (Bibliothèques de fonctions)

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É

C99, POSIX.1-2001.

NOTES

Une sortie de caractères larges dans un flux orienté octets peut être réalisée avec la fonction fprintf(3) 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(3).

VOIR AUSSI

fprintf(3), fwprintf(3)

TRADUCTION

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 19 novembre 2007.

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.