Février 2002 (Release 6)

Cette commande ouvre un fichier de telle sorte que vous pouvez le lire et/ou écrire dedans. Si vous spécifiez le paramètre methode avec une valeur autre que "I", la commande OPEN crée le fichier s’il n’existait pas déjà.

Les paramètres sont interprétés comme suit :

• methode

Spécifiez l’une des lettres suivantes :

I	"Input". Ouverture en entrée (lecture) seule. Le fichier doit exister. D'autres processus peuvent lire le fichier (mais ne peuvent écrire dedans) pendant qu'il est ouvert avec cette méthode.
O	"Output". Ouverture en sortie (écriture) seule. Si le fichier est déjà existant, son contenu sera détruit. Vous avez un accès exclusif au fichier (aucun autre processus ne peut ni lire, ni écrire dedans) pendant qu'il est ouvert avec cette méthode.
R	"Random access". Ouverture "à accès aléatoire". Vous pouvez soit lire ou écrire dans le fichier. Le marqueur de fichier (qui indique où la prochaine opération de lecture ou d'écriture aura lieu) est placé initialement en début de fichier. Si vous écrivez dans le fichier, vous ne remplacez que les octets que vous êtes en train d'écrire; le reste du fichier n'est pas affecté. Vous avez un accès exclusif au fichier.
A	"Append". Ouverture pour "ajouter". Cette méthode est comme la méthode "R", à la différence que le marqueur de fichier est placé initialement à la fin du fichier. Cette méthode est normalement utilisée lorsque vous voulez ajouter des données à la fin d'un fichier existant.
N	"Non-exclusive random access". Ouverture à accès aléatoire non exclusif. Cette méthode est similaire à la méthode "R", à la différence que d'autres processus peuvent lire le fichier tandis qu'il est ouvert par votre programme. Tous les programmes voulant accéder au fichier doivent l'ouvrir avec la même méthode OPEN "N".

• partie

Spécifiez l’une des lettres suivantes :

D

"Data fork". Ouvre la "partie données". C'est la valeur par défaut..

R

"Resource fork". Ouvre la "partie ressource". Vous devez spécifier cette valeur si vous devez copier toute la "partie ressource" d'un fichier vers un autre, ou pour examiner la structure interne de la "partie ressource". Vous ne devez pas utiliser la commande OPEN quand vous voulez lire ou écrire des ressources individuelles; dans ce cas, utilisez, à la place, une des fonctions de la Toolbox telle que HOpenResFile. N'utilisez pas la commande OPEN pour créer une nouvelle "partie ressource", utilisez, à la place, une fonction de la Toolbox comme HCreateResFile..

• fichierID

Spécifie un nombre dans l’intervalle 1 à 255 qui n’est utilisé par aucun autre fichier ouvert. Vous pouvez utiliser ce nombre pour identifier le fichier ouvert dans les commandes et les fonctions telles que READ#, WRITE#, EOF, LOF, etc. Le numéro fichierID est associé au fichier jusqu’à ce qu’il soit fermé.

• chemin$, numRef%, dirID&

Ces trois valeurs indiquent le nom et l’emplacement du fichier à ouvrir. Voir Annexe A : Spécification des Fichiers et Répertoires, pour savoir comment ces paramètres sont utilisés.

ou

• @FSSpec

Un record File Spec. peut remplacer le paramètre chemin$. Si un tel record est utilisé, les paramètres numRef% et dirID& sont inutiles, car ils font déjà partie de la structure FSSpec. Voyez les nouveaux paramètres de la commande FILES$ pour la manière d’obtenir un record File Spec. Voyez également l’Annexe H pour plus d’informations sur les records File Spec.

• longueurRec

Cette valeur indique la taille d’un enregistrement dans le fichier; naturellement, cette valeur est le plus utile lorsque le fichier est constitué d’enregistrements de taille fixe. La valeur que vous spécifiez est utilisée quand vous exécutez des commandes et des fonctions telles que RECORD, REC, LOC et LOF. Si vous omettez ce paramètre, 256 est utilisé comme valeur par défaut. Si le fichier n’est pas constitué d’enregistrements de taille fixe, il est alors souvent plus pratique d’assigner à longueurRec la valeur 1.