Présentation	Documentation				L'équipe	Sérialisation
	Programmes	Objets	Libs Utilitaires	Libs Internes
	Editeur	Syntaxes	Windows	Versions

SCR/AL1 - TOME III. Les librairies utilitaires

26. Le groupe s_isc

26.26 ISC_fopen (file s_dbcgnl.c:957)

Syntax

FILE *ISC_fopen(char *filename, char *mode)

Description

ISC_fopen() ouvre le fichier filename et lui associe un flux, exactement comme fopen()

Si filename est préfixé par un nom d'hôte suivi d'une porte, suivi du séparateur ! en DOS, @@ en Unix, l'opération est effectuée via le serveur s4issrv (scr4_iss en Linux) tournant sur l'hôte. On reçoit alors un numéro de flux virtuel qui a son correspondant sur le process serveur.

Par exemple :

        192.168.2.1:6000!c:\usr\myfile

pour opérer sur le fichier distant sur la machine 192.168.2.1 sur laquelle s4issrv est lancé sur la porte 6000.

S'il n'y a pas de nom de machine, l'opération a lieu sur la machine locale.

L'argument mode pointe vers une chaîne commençant par l'une des séquences suivantes (d'autres caractères peuvent suivre la séquence) :

• 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 : 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.
• w+ :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.
• a : Ouvre le fichier en écriture. 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 écriture. Le fichier est créé s'il n'existait pas. Le pointeur de flux est placé à la fin du fichier.

La chaîne mode 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 DOS/Windows.

Valeur retournée

• 0 : erreur : la variable SCR_ISC_ERRNO contient le code de l'erreur
• -2 : trop de fichiers ouverts sur le serveur
• -3 : fichier non trouvé
• -100 : accès rejeté
• valeur positive : pointeur (fichier local) ou pseudo-pointeur (fichier distant) vers le flux associé au fichier

Voir également

ISC_fopen(), ISC_fflush(), ISC_fclose(), ISC_fread(), ISC_getc(), ISC_putc(), ISC_ftell(), ISC_fseek()