MED fichier

◆ MEDfieldEntityType()

med_err MEDfieldEntityType ( const med_idt  fid,
const char *const  fieldname,
const med_int  numdt,
const med_int  numit,
med_entity_type *const  entitytypes,
med_int *const  usedbyncs 
)

Cette fonction retourne la liste des types d'entité présents dans un champ (med_entity_type).

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).
entitytypesListe des types d'entité utilisés (med_entity_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 d'entité présents dans un champ (med_entity_type).

La liste des types d'entités (med_entity_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 des types d'entité pour toutes les étapes de calcul.
    Remarques
    • Pour les fichiers >= 4.1.0, cette fonction indique instantanément la liste des types d'entité utilisés (med_entity_type). Il n'est pas nécessaire d'itérer sur les différents types d'entité (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
    MEDfieldnEntityType
    MEDfieldGeometryType
    MEDfileNumVersionRd
    MEDfieldnValue
    MEDfieldnValueWithProfile
    MEDfieldnValueWithProfileByName

Définition à la ligne 44 du fichier MEDfieldEntityType.c.