MEDfileCompatibility.c

Aller à la documentation de ce fichier.

/*  This file is part of MED.
 *
 *  COPYRIGHT (C) 1999 - 2025  EDF R&D, CEA/DEN
 *  MED is free software: you can redistribute it and/or modify
 *  it under the terms of the GNU Lesser General Public License as published by
 *  the Free Software Foundation, either version 3 of the License, or
 *  (at your option) any later version.
 *
 *  MED is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU Lesser General Public License for more details.
 *
 *  You should have received a copy of the GNU Lesser General Public License
 *  along with MED.  If not, see <http://www.gnu.org/licenses/>.
 */
 
 
#include <med.h>
#include <med_config.h>
#include <med_outils.h>
 
 
med_err
MEDfileCompatibility(const char* const filename,
                     med_bool* const hdfok,
                     med_bool* const medok)
{
  med_err _ret     = -1;
  med_idt _fid     =  0;
  med_idt _id      =  0;
  med_int _major   =  0;
  med_int _minor   =  0;
  med_int _release =  0;
  med_int _hmajeur=0, _hmineur=0, _hrelease=0;
  med_int _hversionMMR = 0;
  med_int _fversionMM  = 0;
 
 
  
  _MEDmodeErreurVerrouiller();
 
  *hdfok = MED_FALSE;
  *medok = MED_FALSE;
 
  /* Si le fichier n'est pas un fichier hdf retourne en indiquant hdfok=false et medok=false 
     mais pas de code d'erreur */
  if  ( H5Fis_hdf5(filename) <= 0 )  {goto SORTIE;};
 
  /* Si l'on ne peut pas déterminer la version de la bibliothèque med, renvoie une erreur */
  if (MEDlibraryHdfNumVersion(&_hmajeur, &_hmineur, &_hrelease) < 0) {
    MED_ERR_(_ret,MED_ERR_CALL,MED_ERR_API,"MEDlibraryNumVersion");
    goto ERROR;
  }
 
 
  /* Si la bibliothèque HDF n'est pas conforme à la version HDF de référence 
     de cette version de la bibliothèque MED renvoie hdfok=false et medok=false */
  /* Il se peut tout de même que cette version d'HDF soit partiellement utilisable par la bibliothèque 
     ... on test aussi la version du modèle med */
  
  _hversionMMR=10000*_hmajeur+100*_hmineur+_hrelease;
  /* ISCRUTE(_hversionMMR); */
  /* ISCRUTE(HDF_VERSION_NUM_REF); */
  if ( (_hversionMMR >= HDF_VERSION_NUM_REF) &&
       (_hmajeur == HDF_VERSION_MAJOR_REF  )  && 
       (_hmineur == HDF_VERSION_MINOR_REF  ) ) *hdfok = MED_TRUE;
 
  /* TODO : Vérifier si la version mineure HDF du fichier est supérieure
     à la version mineure de la bibliothèque HDF utilisée :
     -  Je n'ai pas trouvé de mécanisme HDF pour trouver 
        les versions minimale et maximale des objets HDF du fichier 
  */
 
  /* On appelle _MEDfileOpen et non MEDfileOpen car l'accessibilité du fichier 
     peut-être testée au préalable par l'utilisateur via 
     MEDfileExist (le fichier est supposé accessible).
     Si le fichier ne s'ouvre pas, il n'est pas conforme, on n'affiche pas de message d'erreur car l'information est renvoyée par medok 
  */
  if ((_fid = _MEDfileOpen((char *)filename,MED_ACC_RDONLY)) < 0) {
    /* MED_ERR_(_ret,MED_ERR_OPEN,MED_ERR_FILE,filename); */
    /* _ret = MED_ERR_OPEN MED_ERR_FILE; */
    /* SSCRUTE(filename); */
    /* goto ERROR; */
    goto SORTIE;
  }
 
 
  if ( MEDfileNumVersionRd(_fid,&_major,&_minor,&_release) < 0) {
    MED_ERR_(_ret,MED_ERR_CALL,MED_ERR_API,"MEDfileNumVersionRd");
    goto ERROR;
  }
 
  _fversionMM = 100*_major+10*_minor;
 
  *medok= MED_TRUE;
  /* if ( (_major > 2) || ((_major == 2) && (_minor > 1)) ) *medok = MED_TRUE; */
  if ( _fversionMM <  220 ) *medok = MED_FALSE;
  /* Si le mineur du fichier est plus récent que celui de la bibliothèque, 
     la bibliothèque n'est pas capable de relire le modèle.*/
  /* Les versions 3.y.z des fichiers med sont compatibles avec la bibliothèque 4.
     La bibliothèque 4 autorise la création de fichiers 3.y.z et sait les gérer.
     Celà est dû au fait que l'on a figé le modèle interne hdf à la version 1.8
  */
  if ( _fversionMM > 100*MED_NUM_MAJEUR+10*MED_NUM_MINEUR ) *medok = MED_FALSE;
 
#if MED_NUM_MAJEUR != 4
#error "Don't forget to update the test version here when you change the major version of the library !"
#endif
#if H5_VERS_MINOR > 10
#error "Don't forget to check the compatibility version of the library, depending on the internal hdf model choice !"
#error "Cf. _MEDfileCreate ..."
#endif
 
 SORTIE:
  _ret = 0;
 ERROR:
 
  if (_id > 0)
    if (_MEDdatagroupFermer(_id) < 0) {
      MED_ERR_(_ret,MED_ERR_CLOSE,MED_ERR_DATAGROUP,MED_INFOS);
      _ret = -1;
    }
  
  if (_fid > 0)
    if (MEDfileClose(_fid) < 0) {
      MED_ERR_(_ret,MED_ERR_CLOSE,MED_ERR_FILE,filename);
      _ret = -1;
    }
 
  return _ret;
}