Documentation de la biliothèque MED-fichier V2.3 : Guide d'utilisation - Module "MED_Fichier".


Sommaire de la page

Retour à la page de garde du guide d'utilisation


Introduction

Les routines disponibles permettent de :

Le détail de ces routines est précisé dans la rubrique du guide de référence du module "MED_Fichier".

Modèles de programmation

Mode d'accès à un fichier

La définition du mode d'accès à un fichier se fait lors de l'ouverture de ce fichier avec la routine MEDouvrir/efouvr. Les différents modes d'accès possibles sont :

Si on ouvre plusieurs fichiers MED en même temps, ces fichiers doivent être ouverts selon le même mode d'accès.

Créer, ouvrir, fermer un fichier

La création d'un nouveau fichier ou l'ouverture d'un fichier existant se fait par l'intermédiaire de la routine MEDouvrir/efouvr. Le mode d'accès est spécifié par la valeur du paramètre acces. Cette routine renvoie un identificateur entier (ID) qui sera utilisé par les autres routines de l'API pour accéder aux données internes du fichier.

La routine MEDfermer/efferm permet de fermer le fichier dont l'identificateur (ID) lui est passé en paramètre.

Ecrire, lire un en-tête de fichier

Lors de la création ou de l'ouverture d'un fichier selon un des différents modes d'écriture possibles, on peut écrire dans le fichier un en-tête qui comporte au plus MED_TAILLE_DESC (200) caractères. Cet en-tête est purement descriptif et est à la discrétion de l'utilisateur.

L'écriture d'un en-tête de fichier se fait par l'intermédiaire de la routine MEDfichDesEcr/effide. L'écriture d'un en-tête dans un fichier MED est optionnelle.

Pour lire un en-tête dans un fichier, on dispose de deux routines :

La lecture d'un en-tête d'un fichier MED est optionnelle.

Tester la conformité d'un fichier

Avant d'ouvrir un fichier existant, il est possible de tester sa conformité avec le format MED-fichier V2.3 :

De plus les deux fonctionnalités suivantes sont fournies par l'API :

Ces 2 routines seront à terme utiles si doivent coexister différentes releases de MED-fichier V2.2. Elles permettront de voir si le fichier lu a été créé ou non avec la même release.

Monter, démonter un fichier

Les données d'une étude peuvent être réparties dans des fichiers différents :

Le mécanisme de montage de fichier fourni par l'API de MED-fichier permet de monter dans un fichier MED (que l'on a au préalable ouvert) les données contenues dans un autre fichier. Le montage est sélectif : on monte soit les maillages, soit les champs.

Le mécanisme de montage dépend de 2 routines :

Remarques :

Exemples de programmation

Exemples d'accès à un fichier

Le programme suivant :

Accès aux sources :

Exemple de test de la conformité d'un fichier

Le programme suivant :

Accès aux sources :

Exemple de montage et démontage de fichier

Le programme suivant :

Accès aux sources :