Interface du gestionnaire de variables. Plus de détails...

#include <arcane/core/IVariableMng.h>

Graphe de collaboration de Arcane::IVariableMng:

Fonctions membres publiques
virtual	~IVariableMng ()=default
	Libère les ressources.

virtual ISubDomain *	subDomain ()=0
	Gestionnaire du sous-domaine.

virtual IParallelMng *	parallelMng () const =0
	Gestionnaire de parallélisme associé

virtual ITraceMng *	traceMng ()=0
	Gestionnaire de messages.

virtual IVariable *	checkVariable (const VariableInfo &infos)=0
	Vérifie une variable.

virtual String	generateTemporaryVariableName ()=0
	Génère un nom pour une variable temporaire.

virtual void	dumpList (std::ostream &, IModule *)=0
	Affiche la liste des variables du gestionnaire lié à un module.

virtual void	dumpList (std::ostream &)=0
	Affiche la liste de toutes les variables du gestionnaire.

virtual Real	exportSize (const VariableCollection &vars)=0
	Taille estimé pour exporter des variables.

virtual IObservable *	writeObservable ()=0
	Observable pour les variables en écriture.

virtual IObservable *	readObservable ()=0
	Observable pour les variables en lecture.

virtual void	writeVariables (IDataWriter writer, IVariableFilter filter=0)=0
	Ecrit les variables.

virtual void	writeVariables (IDataWriter *writer, const VariableCollection &vars)=0
	Exporte les variables.

virtual void	writeCheckpoint (ICheckpointWriter *writer)=0

virtual void	writePostProcessing (IPostProcessorWriter *writer)=0
	Ecrit les variables pour un post-traitement.

virtual void	readVariables (IDataReader reader, IVariableFilter filter=0)=0
	Relit toutes les variables.

virtual void	readCheckpoint (ICheckpointReader *reader)=0

virtual void	readCheckpoint (const CheckpointReadInfo &infos)=0

virtual void	variables (VariableRefCollection v, IModule *i)=0
	Donne l'ensemble des variables du module i.

virtual VariableCollection	variables ()=0
	Liste des variables.

virtual VariableCollection	usedVariables ()=0
	Liste des variables utilisées.

virtual void	notifyUsedVariableChanged ()=0
	Notifie au gestionnaire que l'état d'une variable a changé

virtual IVariable *	findVariable (const String &name)=0
	Retourne la variable de nom name ou 0 si aucune de se nom existe.

virtual IVariable *	findMeshVariable (IMesh *mesh, const String &name)=0
	Retourne la variable du maillage de nom name ou 0 si aucune de se nom existe.

virtual IVariable *	findVariableFullyQualified (const String &name)=0
	Retourne la variable de nom complet name ou 0 si aucune de se nom existe.

virtual void	dumpStats (std::ostream &ostr, bool is_verbose)=0
	Ecrit les statistiques sur les variables sur le flot ostr.

virtual void	dumpStatsJSON (JSONWriter &writer)=0
	Ecrit les statistiques avec l'écrivain writer.

virtual IVariableUtilities *	utilities () const =0
	Interface des fonctions utilitaires associées.

virtual IVariableSynchronizerMng *	synchronizerMng () const =0
	Interface du gestionnaire de synchronisation des variables.

Evènements
virtual EventObservable< const VariableStatusChangedEventArgs & > &	onVariableAdded ()=0
	Evènement envoyé lorsqu'une variable est créée.

virtual EventObservable< const VariableStatusChangedEventArgs & > &	onVariableRemoved ()=0
	Evènement envoyé lorsqu'une variable est détruite.

virtual void	build ()=0
	Construit les membres de l'instance.

virtual void	initialize ()=0
	Initialise l'instance. L'instance n'est pas utilisable tant que cette méthode n'a pas été appelée.

virtual void	removeAllVariables ()=0
	Supprime et détruit les variables gérées par ce gestionnaire.

virtual void	detachMeshVariables (IMesh *mesh)=0
	Détache les variables associées au maillage mesh.

virtual void	addVariableRef (VariableRef *var)=0
	Ajoute une référence à une variable.

virtual void	removeVariableRef (VariableRef *var)=0
	Supprime une référence à une variable.

virtual void	addVariable (IVariable *var)=0
	Ajoute une variable.

virtual void	removeVariable (IVariable *var)=0
	Supprime une variable.

virtual void	initializeVariables (bool is_continue)=0
	Initialise les variables.

virtual ISubDomain *	_internalSubDomain () const =0

virtual IVariableMngInternal *	_internalApi ()=0
	API interne à Arcane.

Description détaillée

Interface du gestionnaire de variables.

Ce gestionnaire contient la liste des variables déclarées dans le sous-domaine associé subDomain(). Il maintient la liste des variables et permet de les lire ou de les écrire.

Définition à la ligne 56 du fichier IVariableMng.h.

Documentation des fonctions membres

◆ addVariable()

virtual void Arcane::IVariableMng::addVariable ( IVariable * var )

pure virtual

Ajoute une variable.

Ajoute la variable var.

La validité de la variable n'est pas effectuée (void checkVariable()).

Précondition: var != 0; var ne doit pas déjà être référencée.

Renvoie: l'implémentation associée à var.

◆ addVariableRef()

virtual void Arcane::IVariableMng::addVariableRef ( VariableRef * var )

pure virtual

Ajoute une référence à une variable.

Ajoute la référence var au gestionnaire.

Précondition: var != 0; var ne doit pas déjà être référencée.

Renvoie: l'implémentation associée à var.

◆ build()

virtual void Arcane::IVariableMng::build ( )

pure virtual

Construit les membres de l'instance.

L'instance n'est pas utilisable tant que cette méthode n'a pas été appelée. Cette méthode doit être appelée avant initialize().

Avertissement: Cette méthode ne doit être appelée qu'une seule fois.

◆ checkVariable()

virtual IVariable * Arcane::IVariableMng::checkVariable ( const VariableInfo & infos )

pure virtual

Vérifie une variable.

Vérifie que la variable de nom name caractérisée par infos est valide C'est le cas si et seulement si:

aucune variable de nom infos.name() n'existe déjà.
une variable de nom infos.name() existe et son type et son genre correspondent infos.

Si la variable n'est pas valide, une exception est lancée.

Cette opération est utilisée lorsqu'on souhaite créer une nouvelle référence à une variable et permet de s'assurer qu'elle sera valide.

Exceptions

ExBadVariableKindType si la variable de nom infos.name() existe et que son type et le genre ne correspondent pas à ceux de infos.

Renvoie: la variable de infos.name() si elle existe, 0 sinon

◆ exportSize()

virtual Real Arcane::IVariableMng::exportSize ( const VariableCollection & vars )

pure virtual

Taille estimé pour exporter des variables.

Cette opération estime le nombre de méga octets que va générer l'exportation des variables vars. Si vars est vide, l'estimation porte sur toutes les variables référencées.

L'estimation tient compte uniquement de la quantité mémoire utilisée par les variables et pas de l'écrivain utilisé.

L'estimation est locale au sous-domaine. Pour obtenir la taille totale d'une exportation, il faut effectuer déterminer la taille par sous-domaine et faire la somme.

Cette méthode est collective

◆ generateTemporaryVariableName()

virtual String Arcane::IVariableMng::generateTemporaryVariableName ( )

pure virtual

Génère un nom pour une variable temporaire.

Pour assurer la cohérence de ce nom, il faut que tous les sous-domaines appellent cette fonction.

◆ initialize()

virtual void Arcane::IVariableMng::initialize ( )

pure virtual

Initialise l'instance. L'instance n'est pas utilisable tant que cette méthode n'a pas été appelée.

Avertissement: Cette méthode ne doit être appelée qu'une seule fois.

◆ initializeVariables()

virtual void Arcane::IVariableMng::initializeVariables ( bool is_continue )

pure virtual

Initialise les variables.

Parcours la liste des variables et les initialisent. Seules les variables d'un module utilisé sont initialisées.

Paramètres

is_continue true vrai si on est en reprise.

◆ readObservable()

virtual IObservable * Arcane::IVariableMng::readObservable ( )

pure virtual

Observable pour les variables en lecture.

Les observateurs enregistrés dans cet observable sont appelés après avoir lu les variables (opération readVariables() ou readCheckpoint()).

◆ readVariables()

virtual void Arcane::IVariableMng::readVariables	(	IDataReader *	reader,
		IVariableFilter *	filter = `0`
	)

pure virtual

Relit toutes les variables.

Parcours l'ensemble des variables du gestionnaire et leur applique le lecteur reader. Si filter est non nul, il est appliqué à chaque variable et une variable n'est lue que si le filtre est vrai pour cette variable. Les variables qui ne sont pas lues ne sont pas modifiées par cette opération.

Obsolète:: Utiliser readVariable(IDataReader*)

Cette méthode est collective.

◆ removeVariable()

virtual void Arcane::IVariableMng::removeVariable ( IVariable * var )

pure virtual

Supprime une variable.

Supprime la variable var.

Après appel à cette méthode, la variable ne doit plus être utilisée.

Précondition: var != 0; var doit avoir une seule référence.

◆ removeVariableRef()

virtual void Arcane::IVariableMng::removeVariableRef ( VariableRef * var )

pure virtual

Supprime une référence à une variable.

Supprime la référence var du gestionnaire.

Si var n'est pas référencée par le gestionnaire, rien n'est effectué.

Précondition: var != 0

◆ writeObservable()

virtual IObservable * Arcane::IVariableMng::writeObservable ( )

pure virtual

Observable pour les variables en écriture.

Les observateurs enregistrés dans cet observable sont appelés avant d'écrire les variables (opération writeCheckpoint(), writeVariables() ou writePostProcessing()).

◆ writePostProcessing()

virtual void Arcane::IVariableMng::writePostProcessing ( IPostProcessorWriter * writer )

pure virtual

Ecrit les variables pour un post-traitement.

Utilise le service de post-traitement writer pour écrire les variables. L'appelant doit avoir positionner les champs de writer avant cet appel, notamment la liste des variables à post-traiter. Cette méthode appelle IPostProcessorWriter::notifyBeginWrite() avant l'écriture et IPostProcessorWriter::notifyEndWriter() en fin.

Cette méthode est collective.

◆ writeVariables() [1/2]

virtual void Arcane::IVariableMng::writeVariables	(	IDataWriter *	writer,
		const VariableCollection &	vars
	)

pure virtual

Exporte les variables.

Exporte les variables de la liste vars. Si vars est vide, exporte toutes les variables de la base qui sont utilisées.

◆ writeVariables() [2/2]

virtual void Arcane::IVariableMng::writeVariables	(	IDataWriter *	writer,
		IVariableFilter *	filter = `0`
	)

pure virtual

Ecrit les variables.

Parcours l'ensemble des variables du gestionnaire et leur applique l'écrivain writer. Si filter est non nul, il est appliqué à chaque variable et une variable n'est écrite que si le filtre est vrai pour cette variable.

Cette méthode est collective

La documentation de cette classe a été générée à partir du fichier suivant :

IVariableMng.h

Fonctions membres publiques

Description détaillée

Documentation des fonctions membres

◆ addVariable()

◆ addVariableRef()

◆ build()

◆ checkVariable()

◆ exportSize()

◆ generateTemporaryVariableName()

◆ initialize()

◆ initializeVariables()

◆ readObservable()

◆ readVariables()

◆ removeVariable()

◆ removeVariableRef()

◆ writeObservable()

◆ writePostProcessing()

◆ writeVariables() [1/2]

◆ writeVariables() [2/2]