| 1 |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
| 2 |
<HTML> |
| 3 |
<HEAD> |
| 4 |
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8"> |
| 5 |
<TITLE></TITLE> |
| 6 |
</HEAD> |
| 7 |
<BODY LANG="fr-FR" DIR="LTR"> |
| 8 |
<A NAME="____Créer/Ouvrir/Fermer un fichier MED____"> |
| 9 |
</A> |
| 10 |
<H1>Ouverture/Création d'un fichier MED</H1> |
| 11 |
<P>L'ouverture/création d'un fichier MED s'effectue avec la routine |
| 12 |
\ref MEDfileOpen (C) / \ref mfiope (F).</P> |
| 13 |
<P>Cette routine renvoie un identificateur ( \c fid ) utilisé par |
| 14 |
les autres routines de l'API pour accéder aux données du fichier. |
| 15 |
</P> |
| 16 |
<P>Les différents modes d'accès possibles sont : |
| 17 |
</P> |
| 18 |
<UL> |
| 19 |
<LI><P>Création (<EM>\ref MED_ACC_CREAT) </EM></P> |
| 20 |
<LI><P>Ouverture en lecture seule (<EM>\ref MED_ACC_RDONLY)</EM></P> |
| 21 |
<LI><P>Ouverture en lecture/écriture (<EM>\ref MED_ACC_RDWR)</EM></P> |
| 22 |
<LI><P>Ouverture en lecture/écriture avec ajout (<EM>\ref |
| 23 |
MED_ACC_RDEXT)</EM></P> |
| 24 |
</UL> |
| 25 |
<P>Dans ce dernier mode, l'écriture n'est possible que pour ajouter |
| 26 |
dans le fichier de nouvelles données (une erreur est générée si |
| 27 |
la donnée existe déjà).</P> |
| 28 |
<P>\dontinclude test1.c \skipline MEDfileOpen |
| 29 |
<small> |
| 30 |
\ref c/test1.c "Fichier d'exemple associé" |
| 31 |
</small> |
| 32 |
</P> |
| 33 |
<H1>Fermeture d'un fichier MED</H1> |
| 34 |
<P>La routine \ref MEDfileClose (C) / \ref mficlo (F) permet de |
| 35 |
fermer un fichier.</P> |
| 36 |
<P> |
| 37 |
\dontinclude test1.c \skipline MEDfileClose |
| 38 |
\until } |
| 39 |
<small> |
| 40 |
\ref c/test1.c "Fichier d'exemple associé" |
| 41 |
</small> |
| 42 |
</P> |
| 43 |
<H1>Entête de fichier</H1> |
| 44 |
<P>La routine \ref MEDfileCommentWr (C) / \ref mficow (F) permet |
| 45 |
l'écriture d'un en-tête de fichier, la routine \ref |
| 46 |
MEDfileCommentRd (C) / \ref mficor (F) la lecture. |
| 47 |
</P> |
| 48 |
<P>Cet en-tête à usage optionnel est purement descriptif. Il |
| 49 |
comporte au plus \ref MED_COMMENT_SIZE caractères. |
| 50 |
</P> |
| 51 |
<P> |
| 52 |
\dontinclude test1.c \skipline des[ |
| 53 |
\skipline MEDfileCommentWr |
| 54 |
\until } |
| 55 |
<small> |
| 56 |
\ref c/test1.c "Fichier d'exemple associé" |
| 57 |
</small> |
| 58 |
\dontinclude test2.c \skipline des[ |
| 59 |
\skipline MEDfileCommentRd |
| 60 |
<small> |
| 61 |
\ref c/test2.c "Fichier d'exemple associé" |
| 62 |
</small> |
| 63 |
</P> |
| 64 |
<H1>Compatibilité entre la version du fichier et la version de la |
| 65 |
bibliothèque</H1> |
| 66 |
<P>La routine \ref MEDfileCompatibility / \ref mficom permet de |
| 67 |
vérifier :</P> |
| 68 |
<UL> |
| 69 |
<LI><P>Si le fichier est au format HDF5 |
| 70 |
</P> |
| 71 |
<LI><P>S'il correspond à un fichier MED compatible avec la |
| 72 |
bibliothèque.</P> |
| 73 |
</UL> |
| 74 |
<P>L'appel à cette routine se fait généralement avant l'ouverture du fichier. |
| 75 |
</P> |
| 76 |
<P> |
| 77 |
\dontinclude test18.c \skipline hdfok |
| 78 |
\skipline MEDfileCompatibility |
| 79 |
\until } |
| 80 |
<small> |
| 81 |
\ref c/test18.c "Fichier d'exemple associé" |
| 82 |
</small> |
| 83 |
</P> |
| 84 |
<H1>Lecture de la version du fichier</H1> |
| 85 |
<P>Les routines \ref MEDfileNumVersionRd / \ref mfinvr et \ref |
| 86 |
MEDfileStrVersionRd / \ref mfisvr lisent la version de la |
| 87 |
bibliothèque MED utilisée à la création du fichier. |
| 88 |
</P> |
| 89 |
<UL> |
| 90 |
<LI><P>\ref MEDfileNumVersionRd / \ref mfinvr lit la version sous |
| 91 |
forme de trois scalaire majeur,mineur,release |
| 92 |
\dontinclude test18.c |
| 93 |
\skipline majeur |
| 94 |
\skipline MEDfileNumVersionRd |
| 95 |
\until } |
| 96 |
\skipline fprintf |
| 97 |
<small> |
| 98 |
\ref c/test18.c "Fichier d'exemple associé" |
| 99 |
</small> |
| 100 |
</P> |
| 101 |
<LI><P>\ref MEDfileStrVersionRd / \ref mfisvr lit la version sous |
| 102 |
forme de chaîne de caractère |
| 103 |
\dontinclude test18.c |
| 104 |
\skipline medversion |
| 105 |
\skipline MEDfileStrVersionRd |
| 106 |
\until } |
| 107 |
\skipline fprintf |
| 108 |
<small> |
| 109 |
\ref c/test18.c "Fichier d'exemple associé" |
| 110 |
</small> |
| 111 |
</P> |
| 112 |
</UL> |
| 113 |
<H1>Liens vers les fichiers exemples utilisés</H1> |
| 114 |
<UL> |
| 115 |
<LI><P>\ref c/test1.c "Fichier d'exemple test1.c" |
| 116 |
</P> |
| 117 |
<LI><P>\ref c/test2.c "Fichier d'exemple test2.c" |
| 118 |
</P> |
| 119 |
<LI><P>\ref c/test18.c "Fichier d'exemple test18.c" |
| 120 |
</P> |
| 121 |
</UL> |
| 122 |
</BODY> |
| 123 |
</HTML> |