Gestion des différents formats de stockage des graphes et des supports. More...

#include "cogitant/iohandler.h"

Public Types
enum	RdfsCgTranslation { TRIPLES, CGSPIRIT, USER1 }
	Types de traductions RDF(S)/GC. More...

typedef unsigned int	Format
	Format d'E/S. More...

Public Member Functions
Constructeurs - destructeur.
	IOHandler (Environment *env)
	Constructeur à vide. More...

	IOHandler (IOHandler const &c, Environment *env=NULL)
	Constructeur par recopie. More...

virtual	~IOHandler ()
	Destructeur. More...

Modifications.
Format	addFormat (std::string const &name, std::vector< std::string > const &exts)
	Ajout d'un format. More...

Format	addFormat (std::string const &name, std::string const &ext)
	Ajout d'un format. More...

void	addInputHandler (Format f, OperationInput *ope)
	Ajout d'un gestionnaire de lecture. More...

void	addOutputHandler (Format f, OperationOutput *ope)
	Ajout d'un gestionnaire d'écriture. More...

void	addRdfsToCgTranslation (RdfsCgTranslation tt, OperationRdfsToCgTranslation *ope)
	Ajout d'un gestionnaire de traductions RDF(S) vers GC. More...

void	addCgToRdfsTranslation (RdfsCgTranslation tt, OperationCgToRdfsTranslation *ope)
	Ajout d'un gestionnaire de traductions GC vers RDF(S). More...

void	removeInputHandler (OperationInput *o)
	Suppression d'un gestionnaire de lecture. More...

void	removeOutputHandler (OperationOutput *o)
	Suppression d'un gestionnaire d'écriture. More...

void	removeRdfsToCgTranslation (OperationRdfsToCgTranslation *o)
	Suppression d'un gestionnaire de traductions RDF(S) vers GC. More...

void	removeCgToRdfsTranslation (OperationCgToRdfsTranslation *o)
	Suppression d'un gestionnaire de traductions GC vers RDF(S). More...

void	selectRdfsToCgTranslation (RdfsCgTranslation tt)
	Sélection d'un gestionnaire de traductions RDF(S) vers GC. More...

void	selectRdfsToCgTranslation (OperationRdfsToCgTranslation *op)
	Sélection d'un gestionnaire de traductions RDF(S) vers GC. More...

void	selectCgToRdfsTranslation (RdfsCgTranslation tt)
	Sélection d'un gestionnaire de traductions GC vers RDF(S). More...

void	selectCgToRdfsTranslation (OperationCgToRdfsTranslation *op)
	Sélection d'un gestionnaire de traductions GC vers RDF(S). More...

void	convertCgtInterface (bool c=true)
	Conversion des propriétés graphiques lues dans des fichiers générés par cgtinterface/CoGui. More...

void	graphObjectIdentifiers (bool c=true)
	Conservation des identificateurs lus dans le fichier dans la propriété Property::IDENTIFIER des GraphObject lus. More...

void	autoCreateTypes (bool c=true)
	Création automatique des types inconnus lors du chargement d'un graphe. More...

void	autoCreateIndividuals (bool c=true)
	Création automatique des marqueurs individuels inconnus lors du chargement d'un graphe. More...

void	ignoreRedeclarationIndividuals (bool r=true)
	Ignore silencieusement les marqueurs individuels déclarés plusieurs fois lors du chargement d'un support. More...

void	forceDestinationGraph (iSet dg=ISET_NULL)
	Force l'objet Graph recevant les connaissances (de type graphe) lues dans le flux. More...

void	filterPropertiesModel (bool f=true)
	Filtre les propriétés lues afin de conserver uniquement les propriétés ayant un sens pour le modèle. More...

void	filterProperties (PropertySet::Filter *f)
	Utilise le filtre passé en paramètre pour filtrer les propriétés lues. More...

void	baseIds (std::string const &b)
	Fixe la base des identificateurs relatifs. More...

void	autoWriteSupportIndividuals (bool aci=true)
	Sortie automatique du support contenant les marqueurs individuels lors de l'écriture d'un graphe. More...

Accesseurs.
unsigned int	size () const
	Nombre de formats. More...

std::string const &	name (Format f) const
	Nom du format. More...

std::vector< std::string > const &	extensions (Format f) const
	Extensions du format. More...

OperationInput *	operationInput (Format f) const
	Opération de lecture correspondant au format. More...

OperationOutput *	operationOutput (Format f) const
	Opération d'écriture correspondant au format. More...

OperationRdfsToCgTranslation *	rdfsToCgTranslation (RdfsCgTranslation tt) const
	Accès aux opérations de traduction RDF(S) vers GC. More...

OperationCgToRdfsTranslation *	cgToRdfsTranslation (RdfsCgTranslation tt) const
	Accès aux opérations de traduction GC vers RDF(S). More...

OperationRdfsToCgTranslation *	activeRdfsToCgTranslation () const
	Opération actuelle de traduction RDF(S) vers GC. More...

OperationCgToRdfsTranslation *	activeCgToRdfsTranslation () const
	Opération actuelle de traduction GC vers RDF(S). More...

Format	suffixToFormat (std::string const &suffix, bool read) const
	Format correspondant à un suffixe de fichier. More...

Format	extensionToFormat (std::string const &filename, bool read) const
	Format correspondant à un fichier. More...

Opérations de lecture/écriture.
iSet	read (std::istream stream, std::string const &streamname, bool allowsupport=true, bool allowobjects=true, Format format=BCGCT, unsigned int formatversion=0, std::vector< iSet > graphs=NULL, Set< EnvironmentObject > graphsout=NULL, GaugeUpdater *upd=NULL) const
	Lecture à partir d'un flux. More...

iSet	read (std::string const &file, bool allowsupport=true, bool allowobjects=true, Format format=AUTO, unsigned int formatversion=0, std::vector< iSet > graphs=NULL, Set< EnvironmentObject > graphsout=NULL, GaugeUpdater upd=NULL) const
	Lecture à partir d'un fichier. More...

void	write (std::ostream stream, std::string const &streamname, OperationOutput::SupportOutput writesupport=OperationOutput::SO_NONE, bool writegraphs=true, Format format=BCGCT, unsigned int formatversion=0, std::vector< iSet > const graphs=NULL, GaugeUpdater *upd=NULL) const
	Écriture sur un flux. More...

void	write (std::string const &file, OperationOutput::SupportOutput writesupport=OperationOutput::SO_NONE, bool writegraphs=true, Format format=AUTO, unsigned int formatversion=0, std::vector< iSet > const graphs=NULL, GaugeUpdater upd=NULL) const
	Écriture sur un flux. More...

Static Public Attributes
static const Format	AUTO
	Détermination automatique du format.

static const Format	BCGCT
	Format BCGCT. More...

static const Format	LINEARFORM
	Format linéaire. More...

static const Format	CGIF
	Format CGIF. More...

static const Format	COGXML
	Format CoGXML. More...

static const Format	FIG
	Format FIG. More...

static const Format	COGXML2
	Format CoGXML2. More...

static const Format	RDFXML
	Format RDFXML. More...

static const Format	RDFN3
	Format RDF-Notation 3. More...

static const Format	XMLSPECIAL
	Pseudo format XML. More...

Detailed Description

Gestion des différents formats de stockage des graphes et des supports.

Member Typedef Documentation

◆ Format

typedef unsigned int cogitant::IOHandler::Format

Format d'E/S.

La valeur 0 est réservée.

Member Enumeration Documentation

◆ RdfsCgTranslation

enum cogitant::IOHandler::RdfsCgTranslation

Types de traductions RDF(S)/GC.

Enumerator

TRIPLES

Traduction des triplets comme des relations ternaires.

See also: OperationRdfsToCgTranslationTriples.

CGSPIRIT

Traduction utilisant les points communs entre RDF(S) et les graphes conceptuels.

See also: OperationRdfsToCgTranslationCGSpirit.

USER1

Traduction fournie par l'utilisateur (non implémentée dans Cogitant).

Constructor & Destructor Documentation

◆ IOHandler() [1/2]

cogitant::IOHandler::IOHandler ( Environment * env )

Constructeur à vide.

◆ IOHandler() [2/2]

cogitant::IOHandler::IOHandler	(	IOHandler const &	c,
		Environment *	env = `NULL`
	)

Constructeur par recopie.

Parameters

c	objet à copier.
env	environnement sur lequel l'objet créé est défini. Si env = `NULL` l'objet copié est associé au même environnement que l'objet modèle.

◆ ~IOHandler()

virtual cogitant::IOHandler::~IOHandler ( )

virtual

Destructeur.

Member Function Documentation

◆ activeCgToRdfsTranslation()

OperationCgToRdfsTranslation* cogitant::IOHandler::activeCgToRdfsTranslation ( ) const

Opération actuelle de traduction GC vers RDF(S).

◆ activeRdfsToCgTranslation()

OperationRdfsToCgTranslation* cogitant::IOHandler::activeRdfsToCgTranslation ( ) const

Opération actuelle de traduction RDF(S) vers GC.

Examples:: converter.cpp.

◆ addCgToRdfsTranslation()

void cogitant::IOHandler::addCgToRdfsTranslation	(	RdfsCgTranslation	tt,
		OperationCgToRdfsTranslation *	ope
	)

Ajout d'un gestionnaire de traductions GC vers RDF(S).

Parameters

tt	type de traduction.
ope	le gestionnaire de traductions à rajouter.

◆ addFormat() [1/2]

Format cogitant::IOHandler::addFormat	(	std::string const &	name,
		std::vector< std::string > const &	exts
	)

Ajout d'un format.

Parameters

name	nom du format à ajouter
exts	extensions du format à ajouter. La première extension correspond à l'extension par défaut. Une copie de exts est mémorisée.

Returns: l'identificateur du format créé.

◆ addFormat() [2/2]

Format cogitant::IOHandler::addFormat	(	std::string const &	name,
		std::string const &	ext
	)

Ajout d'un format.

Parameters

name	nom du format à ajouter
ext	extension du format à ajouter.

Returns: l'identificateur du format créé.

◆ addInputHandler()

void cogitant::IOHandler::addInputHandler	(	Format	f,
		OperationInput *	ope
	)

Ajout d'un gestionnaire de lecture.

Dans le cas où il existe plusieurs gestionnaires de lecture pour le même format, c'est celui qui a été ajouté en dernier qui est pris en compte lors d'une opération de lecture.

Parameters

f	identificateur du format pour lequel un gestionnaire de lecture est ajouté.
ope	gestionnaire de lecture à associer au format.

Warning: Ce n'est PAS une copie de ope qui est mémorisée mais un pointeur sur ope. ope sera automatiquement détruit à la destruction du IOHandler.

◆ addOutputHandler()

void cogitant::IOHandler::addOutputHandler	(	Format	f,
		OperationOutput *	ope
	)

Ajout d'un gestionnaire d'écriture.

Dans le cas où il existe plusieurs gestionnaires d'écriture pour le même format, c'est celui qui a été ajouté en dernier qui est pris en compte lors d'une opération d'écriture.

Parameters

f	identificateur du format pour lequel un gestionnaire d'écriture est ajouté.
ope	gestionnaire d'écriture à associer au format.

Warning: Ce n'est PAS une copie de ope qui est mémorisée mais un pointeur sur ope. ope sera automatiquement détruit à la destruction du IOHandler.

◆ addRdfsToCgTranslation()

void cogitant::IOHandler::addRdfsToCgTranslation	(	RdfsCgTranslation	tt,
		OperationRdfsToCgTranslation *	ope
	)

Ajout d'un gestionnaire de traductions RDF(S) vers GC.

Parameters

tt	type de traduction.
ope	le gestionnaire de traductions à rajouter.

◆ autoCreateIndividuals()

void cogitant::IOHandler::autoCreateIndividuals ( bool c = true )

Création automatique des marqueurs individuels inconnus lors du chargement d'un graphe.

Examples:: converter.cpp.

◆ autoCreateTypes()

void cogitant::IOHandler::autoCreateTypes ( bool c = true )

Création automatique des types inconnus lors du chargement d'un graphe.

Examples:: converter.cpp.

◆ autoWriteSupportIndividuals()

void cogitant::IOHandler::autoWriteSupportIndividuals ( bool aci = true )

Sortie automatique du support contenant les marqueurs individuels lors de l'écriture d'un graphe.

Par défaut, quand un graphe est sorti dans un flux, seul le graphe est sorti, car on suppose que le support sur lequel est défini ce graphe est enregistré par ailleurs. Si cette méthode a été appelée avec true alors toute écriture de graphe sera précédée de la sortie d'un support contenant les déclarations des marqueurs individuels utilisés dans ce graphe.

◆ baseIds()

void cogitant::IOHandler::baseIds ( std::string const & b )

Fixe la base des identificateurs relatifs.

Lors de la lecture d'un ficher contenant des identificateurs relatifs (typiquement des URIs relatives lors de la lecture RDF/XML ou N3), ces URIs relatives peuvent être transformées en URIs absolues à l'aide de cette base (une simple concaténation est effectuée).

Examples:: converter.cpp.

◆ cgToRdfsTranslation()

OperationCgToRdfsTranslation* cogitant::IOHandler::cgToRdfsTranslation ( RdfsCgTranslation tt ) const

Accès aux opérations de traduction GC vers RDF(S).

◆ convertCgtInterface()

void cogitant::IOHandler::convertCgtInterface ( bool c = true )

Conversion des propriétés graphiques lues dans des fichiers générés par cgtinterface/CoGui.

◆ extensions()

std::vector<std::string> const& cogitant::IOHandler::extensions ( Format f ) const

Extensions du format.

Examples:: converter.cpp.

◆ extensionToFormat()

Format cogitant::IOHandler::extensionToFormat	(	std::string const &	filename,
		bool	read
	)		const

Format correspondant à un fichier.

Parameters

filename	nom du fichier. Ce qui doit être passé est un nom de fichier, qui doit donc contenir un "." qui sépare le nom de l'extension.
read	la recherche du format s'effectue pour lire dans le fichier si read vaut true, et pour écrire si read vaut false. Dans le cas où l'extension correspond à plusieurs formats, retourne le premier format disposant d'une opération de lecture (ou d'écriture, selon la valeur de read) gérant l'extension.

Returns: le format correspondant au fichier. La réponse n'est fondée que sur l'extension du fichier. Retourne AUTO si l'extension ne correspond à aucune extension connue, ou si aucune opération de lecture (ou écriture, selon la valeur de read) n'est trouvée pour le format.

◆ filterProperties()

void cogitant::IOHandler::filterProperties ( PropertySet::Filter * f )

Utilise le filtre passé en paramètre pour filtrer les propriétés lues.

Le filtre passé en paramètre est ensuite géré par le IOHandler, qui se chargera de le détruire.

◆ filterPropertiesModel()

void cogitant::IOHandler::filterPropertiesModel ( bool f = true )

Filtre les propriétés lues afin de conserver uniquement les propriétés ayant un sens pour le modèle.

See also: PropertySet::FilterModel.

Examples:: converter.cpp.

◆ forceDestinationGraph()

void cogitant::IOHandler::forceDestinationGraph ( iSet dg = ISET_NULL )

Force l'objet Graph recevant les connaissances (de type graphe) lues dans le flux.

Parameters

dg Par défaut, ISET_NULL, les graphes lus sont stockés dans de nouveaux objets Graph ajoutés à l'environnement. Si différent d'ISET_NULL, les connaissances lues (correspondant à des graphes) sont rajoutées au graphe dont l'iSet est contenu dans cet attribut. Toutes les opérations de lecture ne gèrent pas forcément ce paramètre. Ce paramètre permet par exemple de lire plusieurs fichiers RDF et de rajouter automatiquement toutes les connaissances lues dans le même graphe, plutôt que de créer un graphe par fichier lu.

◆ graphObjectIdentifiers()

void cogitant::IOHandler::graphObjectIdentifiers ( bool c = true )

Conservation des identificateurs lus dans le fichier dans la propriété Property::IDENTIFIER des GraphObject lus.

Les identificateurs ne sont jamais conservés dans le cas de règles (car cela n'aurait aucun sens : plusieurs applications de la règle ajouteraient plusieurs sommets avec le même identificateur, celui des sommets du graphe conclusion de la règle).

◆ ignoreRedeclarationIndividuals()

void cogitant::IOHandler::ignoreRedeclarationIndividuals ( bool r = true )

Ignore silencieusement les marqueurs individuels déclarés plusieurs fois lors du chargement d'un support.

See also: OperationInput::setParamIgnoreRedeclarationIndividuals().

◆ name()

std::string const& cogitant::IOHandler::name ( Format f ) const

Nom du format.

Examples:: converter.cpp.

◆ operationInput()

OperationInput* cogitant::IOHandler::operationInput ( Format f ) const

Opération de lecture correspondant au format.

Returns: un pointeur sur l'opération de lecture du format f ou NULL si aucune opération ne correspond à f.

Examples:: converter.cpp.

◆ operationOutput()

OperationOutput* cogitant::IOHandler::operationOutput ( Format f ) const

Opération d'écriture correspondant au format.

Returns: un pointeur sur l'opération d'écriture du format f ou NULL si aucune opération ne correspond à f.

Examples:: converter.cpp.

◆ rdfsToCgTranslation()

OperationRdfsToCgTranslation* cogitant::IOHandler::rdfsToCgTranslation ( RdfsCgTranslation tt ) const

Accès aux opérations de traduction RDF(S) vers GC.

◆ read() [1/2]

iSet cogitant::IOHandler::read	(	std::istream *	stream,
		std::string const &	streamname,
		bool	allowsupport = `true`,
		bool	allowobjects = `true`,
		Format	format = `BCGCT`,
		unsigned int	formatversion = `0`,
		std::vector< iSet > *	graphs = `NULL`,
		Set< EnvironmentObject >	graphsout = `NULL`,
		GaugeUpdater *	upd = `NULL`
	)		const

Lecture à partir d'un flux.

Parameters

stream	flux de lecture.
streamname	nom du flux de lecture.
allowsupport	autorisation de lecture du support.
allowobjects	autorisation de lecture de graphes/règles.
format	format de lecture.
formatversion	version du format (si différent de `0`, la propriété Property::FILE_VERSION de l'opération est fixée à la valeur passée.
graphs	(R) si des graphes sont lus, leurs identificateurs dans l'environnement sont stockés dans ce tableau (si différent de `NULL`).
graphsout	si différent de `NULL` les graphes et règles lus ne sont pas stockés dans l'environnement, mais à l'extérieur de l'environnement. Ils sont repérés, après l'appel à cette méthode, par les pointeurs contenus dans l'ensemble graphsout. Attention, dans ce cas, il est nécessaire de détruire les objets après usage, car n'étant pas stockés dans l'environnement, ils ne sont pas automatiquement détruits par le destructeur d'environnement. Notons que Set est une classe abstraite, et qu'il est donc nécessaire de passer à cette méthode un pointeur sur une sous-classe concrète de Set, par exemple Set_Simple.
upd	visualisation de l'avancement de la lecture par un GaugeUpdater créé au préalable.

Returns: l'identifiant du premier graphe lu, ou ISET_NULL si aucun graphe n'a été lu (ou si les graphes lus ont été stockés dans graphsout).

Exceptions

ExceptionIO.

◆ read() [2/2]

iSet cogitant::IOHandler::read	(	std::string const &	file,
		bool	allowsupport = `true`,
		bool	allowobjects = `true`,
		Format	format = `AUTO`,
		unsigned int	formatversion = `0`,
		std::vector< iSet > *	graphs = `NULL`,
		Set< EnvironmentObject >	graphsout = `NULL`,
		GaugeUpdater *	upd = `NULL`
	)		const

Lecture à partir d'un fichier.

Parameters

file	nom du fichier à lire.
allowsupport	autorisation de lecture du support.
allowobjects	autorisation de lecture de graphes/règles.
format	format de lecture. Si format == AUTO, le format de lecture est déterminé à partir de l'extension du fichier, sinon le format est forcé à la valeur de format quelle que soit l'extension de file.
formatversion	version du format (si différent de `0`, la propriété Property::FILE_VERSION de l'opération est fixée à la valeur passée.
graphs	(R) si des graphes sont lus, leurs identificateurs dans l'environnement sont stockés dans ce tableau (si différent de `NULL`).
graphsout	si différent de `NULL` les graphes et règles lus ne sont pas stockés dans l'environnement, mais à l'extérieur de l'environnement. Ils sont repérés, après l'appel à cette méthode, par les pointeurs contenus dans l'ensemble graphsout. Attention, dans ce cas, il est nécessaire de détruire les objets après usage, car n'étant pas stockés dans l'environnement, ils ne sont pas automatiquement détruits par le destructeur d'environnement. Notons que Set est une classe abstraite, et qu'il est donc nécessaire de passer à cette méthode un pointeur sur une sous-classe concrète de Set, par exemple Set_Simple.
upd	visualisation de l'avancement de la lecture par un GaugeUpdater créé au préalable.

Returns: l'identifiant du premier graphe lu, ou ISET_NULL si aucun graphe n'a été lu (ou si les graphes lus ont été stockés dans graphsout).

Exceptions

ExceptionIO

◆ removeCgToRdfsTranslation()

void cogitant::IOHandler::removeCgToRdfsTranslation ( OperationCgToRdfsTranslation * o )

Suppression d'un gestionnaire de traductions GC vers RDF(S).

Parameters

o	opération à supprimer.

◆ removeInputHandler()

void cogitant::IOHandler::removeInputHandler ( OperationInput * o )

Suppression d'un gestionnaire de lecture.

Parameters

o	opération à supprimer.

◆ removeOutputHandler()

void cogitant::IOHandler::removeOutputHandler ( OperationOutput * o )

Suppression d'un gestionnaire d'écriture.

Parameters

o	opération à supprimer.

◆ removeRdfsToCgTranslation()

void cogitant::IOHandler::removeRdfsToCgTranslation ( OperationRdfsToCgTranslation * o )

Suppression d'un gestionnaire de traductions RDF(S) vers GC.

Parameters

o	opération à supprimer.

◆ selectCgToRdfsTranslation() [1/2]

void cogitant::IOHandler::selectCgToRdfsTranslation ( RdfsCgTranslation tt )

Sélection d'un gestionnaire de traductions GC vers RDF(S).

Parameters

tt	Type de traduction à utiliser lors de l'export vers un fichier RDF(S). L'opération de traduction est cherchée parmi les opérations de traduction connues du IOHandler.

◆ selectCgToRdfsTranslation() [2/2]

void cogitant::IOHandler::selectCgToRdfsTranslation ( OperationCgToRdfsTranslation * op )

Sélection d'un gestionnaire de traductions GC vers RDF(S).

Parameters

op	opération de traduction à utiliser.

◆ selectRdfsToCgTranslation() [1/2]

void cogitant::IOHandler::selectRdfsToCgTranslation ( RdfsCgTranslation tt )

Sélection d'un gestionnaire de traductions RDF(S) vers GC.

Parameters

tt	Type de traduction à utiliser lors du chargement d'un fichier RDF(S). L'opération de traduction est cherchée parmi les opérations de traduction connues du IOHandler.

◆ selectRdfsToCgTranslation() [2/2]

void cogitant::IOHandler::selectRdfsToCgTranslation ( OperationRdfsToCgTranslation * op )

Sélection d'un gestionnaire de traductions RDF(S) vers GC.

Parameters

op	opération de traduction à utiliser.

◆ size()

unsigned int cogitant::IOHandler::size ( ) const

Nombre de formats.

Examples:: converter.cpp.

◆ suffixToFormat()

Format cogitant::IOHandler::suffixToFormat	(	std::string const &	suffix,
		bool	read
	)		const

Format correspondant à un suffixe de fichier.

Parameters

suffix	extension.
read	la recherche du format s'effectue pour lire dans le fichier si read vaut true, et pour écrire si read vaut false. Dans le cas où l'extension correspond à plusieurs formats, retourne le premier format disposant d'une opération de lecture (ou d'écriture, selon la valeur de read) gérant l'extension.

Returns: le format correspondant à l'extension. Retourne AUTO si l'extension ne correspond à aucune extension connue.

◆ write() [1/2]

void cogitant::IOHandler::write	(	std::ostream *	stream,
		std::string const &	streamname,
		OperationOutput::SupportOutput	writesupport = `OperationOutput::SO_NONE`,
		bool	writegraphs = `true`,
		Format	format = `BCGCT`,
		unsigned int	formatversion = `0`,
		std::vector< iSet > const *	graphs = `NULL`,
		GaugeUpdater *	upd = `NULL`
	)		const

Écriture sur un flux.

Parameters

stream	flux d'écriture.
streamname	nom du flux d'écriture
writesupport	écriture du support sous la forme d'une combinaison de symboles de type OperationOutput::SupportOutput. Habituellement OperationOutput::SO_NONE ou OperationOutput::SO_ALL.
writegraphs	écriture de graphes.
format	format d'écriture.
formatversion	version du format (si différent de `0`, la propriété Property::FILE_VERSION de l'opération est fixée à la valeur passée.
graphs	(D) si writegraphs vaut `true`, ce vector doit contenir en entrée les identificateurs dans l'environnement des graphes à écrire. Si graphs vaut `NULL` aucun graphe n'est écrit.
upd	visualisation de l'avancement de l'écriture par un GaugeUpdater créé au préalable.

Exceptions

ExceptionIO

Examples:: converter.cpp.

◆ write() [2/2]

void cogitant::IOHandler::write	(	std::string const &	file,
		OperationOutput::SupportOutput	writesupport = `OperationOutput::SO_NONE`,
		bool	writegraphs = `true`,
		Format	format = `AUTO`,
		unsigned int	formatversion = `0`,
		std::vector< iSet > const *	graphs = `NULL`,
		GaugeUpdater *	upd = `NULL`
	)		const

Écriture sur un flux.

Parameters

file	nom du fichier à écrire. Si un fichier de ce nom existe déjà, il est écrasé.
writesupport	écriture du support sous la forme d'une combinaison de symboles de type OperationOutput::SupportOutput. Habituellement OperationOutput::SO_NONE ou OperationOutput::SO_ALL.
writegraphs	écriture de graphes.
format	format d'écriture. Si format == AUTO, le format d'écriture est déterminé à partir de l'extension du fichier, sinon le format est forcé à la valeur de format quelle que soit l'extension de file.
formatversion	version du format (si différent de `0`, la propriété Property::FILE_VERSION de l'opération est fixée à la valeur passée.
graphs	(D) si writegraphs vaut `true`, ce vector doit contenir en entrée les identificateurs dans l'environnement des graphes à écrire. Si graphs vaut `NULL` aucun graphe n'est écrit.
upd	visualisation de l'avancement de l'écriture par un GaugeUpdater créé au préalable.

Exceptions

ExceptionIO

Member Data Documentation

◆ BCGCT

const Format cogitant::IOHandler::BCGCT

static

Format BCGCT.

Le format "natif" de Cogitant, celui qu'il est conseillé d'utiliser car il permet de représenter toutes les caractéristiques des objets manipulés (graphes, règles, supports, signatures, propriétés, etc.).

See also: OperationBCGCTOutput, OperationBCGCTInput.

Referenced by cogitant::Environment::extensionFactory().

◆ CGIF

const Format cogitant::IOHandler::CGIF

static

Format CGIF.

Seule l'opération de sortie est définie pour ce format. Lors d'une sortie à ce format, un grand nombre d'informations manipulées par Cogitant sont perdues car elles ne peuvent pas être représentées en CGIF (signatures, propriétés, règles, intitulés contenant des espaces ou autres caractères spéciaux). La sauvegarde à ce format ne doit donc être utilisée qu'à des fins d'interopérabilité avec d'autres outils manipulant des graphes conceptuels.

See also: OperationCGIFOutput, OperationCGIFInput.

◆ COGXML

const Format cogitant::IOHandler::COGXML

static

Format CoGXML.

See also: OperationCoGXMLOutput, OperationCoGXMLInput.

Examples:: converter.cpp.

◆ COGXML2

const Format cogitant::IOHandler::COGXML2

static

Format CoGXML2.

◆ FIG

const Format cogitant::IOHandler::FIG

static

Format FIG.

Ce format est utile pour exporter des objets vers xfig afin de les convertir (entre autres) en eps pour inclusion dans des documents LaTEX. Par défaut, les classes de l'espace de nom cogitant ne sont pas capables d'exporter dans ce format. Cependant, si la bibliothèque est compilée en utilisant les fonctions de dessin (cogitantdisplay), il est possible d'ajouter de nouvelles fonctions de sauvegarde à un IOHandler. Pour cela, la méthode cogitantdisplay::DisplayHandler::addFormats() doit être utilisée.

See also: cogitantdisplay::DisplayHandler, cogitantdisplay::OutputFig, cogitantdisplay::OperationFIGOutput.

◆ LINEARFORM

const Format cogitant::IOHandler::LINEARFORM

static

Format linéaire.

Seule l'opération de sortie est définie par défaut pour ce format.

See also: OperationLinearOutput.

Examples:: converter.cpp.

Referenced by cogitant::Environment::extensionFactory().

◆ RDFN3

const Format cogitant::IOHandler::RDFN3

static

Format RDF-Notation 3.

Examples:: converter.cpp.

◆ RDFXML

const Format cogitant::IOHandler::RDFXML

static

Format RDFXML.

See also: OperationRdfsXmlInput.

◆ XMLSPECIAL

const Format cogitant::IOHandler::XMLSPECIAL

static

Pseudo format XML.

Cette constante définit un format qui permet une détection automatique d'un document XML chargé. A ce format est associée une opération de lecture qui commence à lire le document, détecte son type (COGXML, COGXML2, RDFXML) et passe la suite du document à l'opération chargée de gérer le format en question.

Public Types

Public Member Functions

Static Public Attributes

Detailed Description

Member Typedef Documentation

◆ Format

Member Enumeration Documentation

◆ RdfsCgTranslation

Constructor & Destructor Documentation

◆ IOHandler() [1/2]

◆ IOHandler() [2/2]

◆ ~IOHandler()

Member Function Documentation

◆ activeCgToRdfsTranslation()

◆ activeRdfsToCgTranslation()

◆ addCgToRdfsTranslation()

◆ addFormat() [1/2]

◆ addFormat() [2/2]

◆ addInputHandler()

◆ addOutputHandler()

◆ addRdfsToCgTranslation()

◆ autoCreateIndividuals()

◆ autoCreateTypes()

◆ autoWriteSupportIndividuals()

◆ baseIds()

◆ cgToRdfsTranslation()

◆ convertCgtInterface()

◆ extensions()

◆ extensionToFormat()

◆ filterProperties()

◆ filterPropertiesModel()

◆ forceDestinationGraph()

◆ graphObjectIdentifiers()

◆ ignoreRedeclarationIndividuals()

◆ name()

◆ operationInput()

◆ operationOutput()

◆ rdfsToCgTranslation()

◆ read() [1/2]

◆ read() [2/2]

◆ removeCgToRdfsTranslation()

◆ removeInputHandler()

◆ removeOutputHandler()

◆ removeRdfsToCgTranslation()

◆ selectCgToRdfsTranslation() [1/2]

◆ selectCgToRdfsTranslation() [2/2]

◆ selectRdfsToCgTranslation() [1/2]

◆ selectRdfsToCgTranslation() [2/2]

◆ size()

◆ suffixToFormat()

◆ write() [1/2]

◆ write() [2/2]

Member Data Documentation

◆ BCGCT

◆ CGIF

◆ COGXML

◆ COGXML2

◆ FIG

◆ LINEARFORM

◆ RDFN3

◆ RDFXML

◆ XMLSPECIAL