Ubuntu Manpage: fopen, fdopen, freopen - Fonctions d'ouverture de flux

nom
synopsis
description
valeur renvoyée
erreurs
conformité
notes
bogues
voir aussi
colophon
traduction

Provided by: manpages-fr-dev_3.65d1p1-1_all

NOM

       fopen, fdopen, freopen - Fonctions d'ouverture de flux

SYNOPSIS

       #include <stdio.h>

       FILE *fopen(const char *path, const char *mode);

       FILE *fdopen(int fd, const char *mode);

       FILE *freopen(const char *path, const char *mode, FILE *stream);

   Exigences de macros de test de fonctionnalités pour la glibc (consultez feature_test_macros(7)) :

       fdopen() : _POSIX_C_SOURCE >= 1 || _XOPEN_SOURCE || _POSIX_SOURCE

DESCRIPTION

La fonction fopen() ouvre le fichier dont le nom est contenu dans la chaîne pointée par path et lui
associe un flux.

L'argument mode pointe vers une chaîne commençant par l'une des séquences suivantes (éventuellement
suivie par des caractères supplémentaires, conformément à la description ci-dessous).

r Ouvre le fichier en lecture. Le pointeur de flux est placé au début du fichier.

r+ Ouvre le fichier en lecture et écriture. Le pointeur de flux est placé au début du fichier.

w Tronque le fichier à son début ou ouvre le fichier en écriture. Le pointeur de flux est placé au
début du fichier.

w+ Ouvre le fichier en lecture et écriture. Le fichier est créé s'il n'existait pas. S'il existait
déjà, sa longueur est ramenée à 0. Le pointeur de flux est placé au début du fichier.

a Ouvre le fichier en ajout (écriture à la fin du fichier). Le fichier est créé s'il n'existait pas.
Le pointeur de flux est placé à la fin du fichier.

a+ Ouvre le fichier en lecture et ajout (écriture en fin de fichier). Le fichier est créé s'il
n'existait pas. La position initiale du fichier pour la lecture est en début de fichier, mais les
ajouts sont toujours placés à la fin du fichier.

La chaîne mode peut également inclure la lettre « b » comme dernier caractère, ou même entre les deux
caractères d'une des séquences à 2 caractères vues ci-dessus. Ce mode sert uniquement à assurer la
compatibilité avec C89 et n'a aucun effet. Le « b » est ignoré sur tous les systèmes compatibles POSIX, y
compris Linux (d'autres systèmes peuvent traiter les fichiers textes et les fichiers binaires
différemment, et l'ajout du « b » peut être une bonne idée si vous faites des entrées/sorties sur un
fichier binaire et que votre programme risque d'être porté sur un environnement non UNIX).

Consultez la section NOTES ci-dessous pour le détails des extensions de la glibc pour mode.

Les lectures et les écritures peuvent être mélangées sur les flux en lecture et écriture, dans un ordre
quelconque. Notez que AINSI C nécessite qu'une fonction de positionnement dans le fichier soit appelée
entre une lecture et une écriture, à moins que l'opération de lecture atteigne la fin du fichier(si cette
condition n'est pas rencontrée, alors une lecture est permise pour renvoyer le résultat d'une écriture
autre que la dernière). Une bonne habitude (souvent nécessaire sous Linux) consiste donc à intercaler un
fseek(3) ou fgetpos(3) entre les lectures et les écritures sur le même flux. Ces opérations peuvent être
visiblement sans effet comme fseek(..., 0L, SEEK_CUR) et ne servant que pour l'effet de bord de
synchronisation.

Ouvrir un fichier en mode ajout (a comme le premier caractère dans le mode) feront agir toutes les
opérations d'écriture à la fin du flux, comme si elles étaient précédées par l'appel :

fseek(stream, 0, SEEK_END);

La fonction fdopen() associe un flux avec un descripteur de fichier fd existant. Le mode du flux (une des
valeurs, « r », « "r+ », « w », « w+ », « a », ou « a+ ») doit être compatible avec celui du descripteur
de fichier. L'indicateur de position du nouveau flux prend la même valeur que celui de fd, et les
indicateurs d'erreur et de fin de fichier sont effacés. Les modes « w » et « w+ » ne tronquent pas le
fichier. Le descripteur n'est pas dupliqué, et sera fermé lorsque le flux créé par fdopen() sera fermé.
L'appel de fdopen() sur un objet en mémoire partagée est indéfini.

La fonction freopen() ouvre le fichier dont le nom se trouve dans la chaîne de caractères pointée par
path et lui associe le flux pointé par stream. Le flux original, s'il existe, est fermé. L'argument mode
est utilisé exactement comme avec fopen(). La principale utilisation de freopen() est de modifier le
fichier associé aux flux standard de texte (stderr, stdin, ou stdout).

VALEUR RENVOYÉE

       Si elles réussissent intégralement, fopen(), fdopen() et freopen() renvoient un pointeur  de  type  FILE.
       Sinon, elles renvoient NULL et errno contient le code d'erreur.

ERREURS

       EINVAL Le mode fourni à fopen(), fdopen(), ou freopen() était invalide.

       Les  fonctions  fopen(),  fdopen()  et  freopen() peuvent également échouer et définir dans errno une des
       erreurs spécifiées par malloc(3).

       La fonction fopen() peut aussi échouer et définir dans errno une des erreurs spécifiées par open(2).

       La fonction fdopen() peut aussi échouer et définir dans errno une des erreurs spécifiées par fcntl(2).

       La fonction freopen() peut aussi échouer et définir dans errno une des erreurs  spécifiées  par  open(2),
       fclose(3) et fflush(3).

CONFORMITÉ

       Les  fonctions  fopen()  et  freopen()  sont  conformes  à  C89.  La  fonction  fdopen()  est  conforme à
       POSIX.1-1990.

NOTES

   Notes sur la glibc
       La bibliothèque GNU C permet les extensions suivantes pour la chaîne spécifiée par mode :

       c (depuis la glibc 2.3.3)
              Ne pas faire de l'opération d'ouverture, ou des opérations de lectures et  écritures  ultérieures,
              des points d'annulation de thread. Cet attribut est ignoré pour fdopen().

       e (depuis la glibc 2.7)
              Ouvrir le fichier avec l'attribut O_CLOEXEC. Consultez open(2) pour de plus amples renseignements.
              Cet attribut est ignoré pour fdopen().

       m (depuis la glibc 2.3)
              Essayer d'accéder au fichier avec mmap(2), au lieu des appels système d'entrées/sorties  (read(2),
              write(2)).  Actuellement,  l'utilisation  de  mmap(2)  n'est  seulement tentée que pour un fichier
              ouvert en lecture.

       x      Ouvrir le fichier de manière exclusive (comme avec l'attribut O_EXCL de open(2)).  Si  le  fichier
              existe déjà, fopen() échoue et errno est définie à EEXIST. Cet attribut est ignoré par fdopen().

       En plus des caractères supplémentaires, fopen() et freopen() acceptent la syntaxe suivante dans mode :

        ,ccs=chaîne

       La  chaîne  donnée est considérée comme le nom d'un jeu de caractères codés et le flux est marqué orienté
       caractères larges. Ensuite, les fonctions internes de conversion convertissent les E/S depuis et vers  le
       jeu  de  caractères chaîne. Si la syntaxe  ,ccs=chaîne n'est pas indiquée, alors l'orientation caractères
       larges du flux est déterminée par le premier  fichier  de  l'opération.  S'il  s'agit  une  opération  de
       caractères  larges,  le flux est marqué orienté caractères larges et les fonctions pour convertir vers le
       jeu de caractères codés sont chargées.

BOGUES

       Lors de l'analyse des caractères d'attribut individuels dans mode (c'est-à-dire les caractères  précédant
       l'indication  « ccs »),  l'implémentation  glibc  de  fopen() et freopen() limite le nombre de caractères
       examinés dans mode à 7 (ou, dans les versions de la glibc antérieures à 2.14, à 6,  ce  qui  n'était  pas
       suffisant  pour  inclure  d'éventuelles  spécifications  comme « rb+cmxe »). L'implémentation actuelle de
       fdopen() analyse au plus 5 caractères de mode.

VOIR AUSSI

       open(2), fclose(3), fileno(3), fmemopen(3), fopencookie(3)

COLOPHON

       Cette page fait partie de la publication 3.65 du projet man-pages Linux. Une description du projet et des
       instructions     pour     signaler     des     anomalies    peuvent    être    trouvées    à    l'adresse
       http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par
       l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

       Christophe       Blaess       <http://www.blaess.fr/christophe/>      (1996-2003),      Alain      Portal
       <http://manpagesfr.free.fr/> (2003-2006). Florentin Duneau  et  l'équipe  francophone  de  traduction  de
       Debian (2006-2009).

       Veuillez  signaler  toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org> ou par
       un rapport de bogue sur le paquet manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C
       <section> <page_de_man> ».