Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] fopen, fdopen, freopen - Fonctions d'ouverture de flux. [size=18] [b]Résumé[/b] [/size] [b]#include <stdio.h>[/b] [b][i]FILE fopen (const char path , const char * mode );[/i][/b] [b][/b] [b][i]FILE fdopen (int fildes , const char mode );[/i][/b] [b][/b] [b][i]FILE freopen (const char path , const char * mode , FILE * stream );[/i][/b] [size=18] [b]Description[/b] [/size] La fonction [b]fopen[/b] ouvre le fichier dont le nom est contenu dans la chaine pointée par [i]path[/i] et lui associe un flux. L'argument [i]mode[/i] pointe vers une chaîne commençant par l'une des séquences suivantes (d'autres caractères peuvent suivre la séquence) : [b]r[/b] [table][row][col]    [/col][col]Ouvre le fichier en lecture. Le pointeur de flux est placé au début du fichier.[/col][/row][/table] [b]r+[/b] [table][row][col]    [/col][col]Ouvre le fichier en lecture et écriture. Le pointeur de flux est placé au début du fichier.[/col][/row][/table] [b]w[/b] [table][row][col]    [/col][col]Ouvre le fichier en é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.[/col][/row][/table] [b]w+[/b] [table][row][col]    [/col][col]Ouvre le fichier en lecture et écriture. Le fichier est créé s'il n'existait pas. S'il existait deja, sa longueur est ramenée à 0. Le pointeur de flux est placé au début du fichier.[/col][/row][/table] [b]a[/b] [table][row][col]    [/col][col]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.[/col][/row][/table] [b]a+[/b] [table][row][col]    [/col][col]Ouvre le fichier en lecture et ajout (écriture en fin de fichier). Le fichier est créé s'il n'existait pas. Le pointeur de flux est placé à la fin du fichier.[/col][/row][/table] La chaîne [i]mode[/i] peut également inclure la lettre ``b'' comme 3ème caractere, ou même entre les deux caractères d'une des séquences à 2 lettres vues ci-dessus. Ce mode sert uniquement à assurer la compatibilité avec ANSI X3.159-1989 (``ANSI C'') 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 de texte et les fichiers binaires différement, et l'ajout du ``b'' peut être une bonne idée si vous faites des entrées-sorties binaires et que votre programme risque d'être porté sur un environnement non-Unix). Tout fichier créé aura le mode [b]S_IRUSR &\| S_IWUSR &\| S_IRGRP &\| S_IWGRP &\| S_IROTH &\| S_IWOTH[/b] (0666), qui sera ensuite modifié par la valeur d'umask du processus. Voir [b]umask (2).[/b] Les lectures et les écritures peuvent être mélangées sur les flux en lecture et écriture, dans un ordre quelconque, et sans besoin de positionnement entre les entrées et les sorties, à moins qu'une lecture atteigne la fin du fichier. (Sinon sur certains systèmes la lecture peut renvoyer les données provenant d'une écriture autre que la dernière). Une bonne habitude consiste donc à intercaler un [b]fseek[/b] ou [b]fgetpos[/b] 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 ([b]a[/b] en premier caractère dans le [b]mode )[/b] feront agir toutes les opérations d'écriture à la fin du flux, comme si elles étaient précédées par un appel[table][row][col]    [/col][col] fseek(stream,0,SEEK_END);[/col][/row][/table] systèmatique. La fonction [b]fdopen[/b] associe un flux avec un descripteur de fichier [i]fildes[/i] existant. Le [i]mode[/i] du flux ("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 [b]fildes ,[/b] 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é par [b]dup[/b](2), et sera refermé lorsque le flux créé par [b]fdopen[/b] sera refermé. L'appel de [b]fdopen[/b] sur un objet en mémoire partagée est indéfini. La fonction [b]freopen[/b] ouvre le fichier dont le nom se trouve dans la chaîne de caractères pointée par [i]path[/i] et lui associe le flux pointé par [b]stream .[/b] Le flux original, s'il existe, est fermé. L'argument [i]mode[/i] est utilisé exactement comme avec [b]fopen .[/b] La principale utilisation de [b]freopen[/b] est de modifier le fichier associé avec les flux standards de texte [b] ( stderr , stdin , ou stdout ).[/b] [size=18] [b]Valeur renvoyée[/b] [/size] S'il réussissent intégralement [b]fopen ,[/b] [b]fdopen[/b] et [b]freopen[/b] renvoient un pointeur sur un fichier, de type [b]FILE .[/b] Sinon, ils renvoient [b]NULL[/b] et [i]errno[/i] contient le code d'erreur. [size=18] [b]Erreurs[/b] [/size] [b]EINVAL[/b] [table][row][col]    [/col][col]Le [i]mode[/i] fourni à [b]fopen ,[/b] [b]fdopen ,[/b] ou [b]freopen[/b] était invalide.[/col][/row][/table] Les fonctions [b]fopen ,[/b] [b]fdopen[/b] et [b]freopen[/b] peuvent également échouer et positionner dans [i]errno[/i] une des erreurs susceptibles de se produire avec [b]malloc (3).[/b] La fonction [b]fopen[/b] peut aussi échouer et positionner dans [i]errno[/i] une des erreurs susceptibles de se produire avec [b]open (2).[/b] La fonction [b]fdopen[/b] peut aussi échouer et positionner dans [i]errno[/i] une des erreurs susceptibles de se produire avec [b]fcntl (2).[/b] La fonction [b]freopen[/b] peut aussi échouer et positionner dans [i]errno[/i] une des erreurs susceptibles de se produire avec [b]open (2),[/b] [b]fclose (3)[/b] et [b]fflush (3).[/b] [size=18] [b]Conformité[/b] [/size] Les fonctions [b]fopen[/b] et [b]freopen[/b] sont conformes à ANSI X3.159-1989 (``ANSI C''). La fonction [b]fdopen[/b] est conforme à IEEE Std1003.1-1988 (``POSIX.1''). [size=18] [b]Voir aussi[/b] [/size] [b]open (2),[/b] [b]fclose (3),[/b] [b]fileno (3).[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier