MED fichier

◆ MEDfieldGeometryType()

med_err MEDfieldGeometryType ( const med_idt  fid,
const char *const  fieldname,
const med_int  numdt,
const med_int  numit,
const med_entity_type  entitytype,
med_geometry_type *const  geometrytypes,
med_int *const  usedbyncs 
)

Cette fonction retourne la liste des types géométrique présents dans un champ (med_geometry_type) pour le type d'entité entitytype.

Paramètres
fidIdentificateur du fichier.
fieldnameNom du champ, de longueur maximum MED_NAME_SIZE .
numdtNuméro de pas de temps de l'étape de calcul (MED_NO_DT si pas de numéro de pas de temps).
numitNuméro d'itération de l'étape de calcul (MED_NO_IT si pas de numéro d'itération).
entitytypeType d'entité (med_entity_type).
geometrytypesListe des types géométriques utilisés par des l'entités (med_geometry_type).
usedbyncsNombre d'étapes de calcul qui ont les mêmes types d'entités (à comparer au nombre total d'étapes).
Valeurs retournées
med_errretour négatif en cas d'erreur (MED_ERR_HOWTO), Zéro sinon.

Cette fonction retourne la liste des types géométrique présents dans un champ (med_geometry_type) pour le type d'entité entitytype.

La liste des types géométrique (med_geometry_type) renvoyé peut être pour :

  • toutes les étapes de calcul ( numdt == MED_ALL_DT , numit == MED_ALL_IT )
  • une étape de calcul ( numdt , numit ) en particulier



    En comparant le paramètre usedbyncs au nombre total d'étapes de calcul définies pour le champ, il est possible de statuer sur une utilisation homogène ou non de la liste des types géométrique d'un type d'entité pour toutes les étapes de calcul.
    Remarques
    • Pour les fichiers >= 4.1.0, cette fonction indique instantanément la liste des types géométrique utilisés (med_geometry_type). Il n'est pas nécessaire d'itérer sur les différents types géométrique (MEDfieldnValue).
    • Pour les fichiers < 4.1.0, cette fonction n'est pas utilisable (sauf à importer le fichier à la version courante de la bibliothèque grâce à medimport).


    Cette fonction permet un gain de performance important en comparaison au cas d'utilisation classique qui consiste à découvrir les types d'entités utilisés d'un champ en itérant successivement sur toutes les étapes de calcul pour tous les types d'entité.
    Voir également
    MEDfieldnGeometryType
    MEDfieldEntityType
    MEDfileNumVersionRd
    MEDfieldnValue
    MEDfieldnValueWithProfile
    MEDfieldnValueWithProfileByName

Définition à la ligne 45 du fichier MEDfieldGeometryType.c.