Quick links: Tutorial - Examples - Files - Symbols.
Classes: Hierarchy - Index - List - Members.
Namespaces: Index - base - cs - display.

Public Types | Static Public Attributes | List of all members
cogitant::IOHandler Class Reference

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...
 
OperationInputoperationInput (Format f) const
 Opération de lecture correspondant au format. More...
 
OperationOutputoperationOutput (Format f) const
 Opération d'écriture correspondant au format. More...
 
OperationRdfsToCgTranslationrdfsToCgTranslation (RdfsCgTranslation tt) const
 Accès aux opérations de traduction RDF(S) vers GC. More...
 
OperationCgToRdfsTranslationcgToRdfsTranslation (RdfsCgTranslation tt) const
 Accès aux opérations de traduction GC vers RDF(S). More...
 
OperationRdfsToCgTranslationactiveRdfsToCgTranslation () const
 Opération actuelle de traduction RDF(S) vers GC. More...
 
OperationCgToRdfsTranslationactiveCgToRdfsTranslation () 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

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
cobjet à copier.
envenvironnement 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
tttype de traduction.
opele 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
namenom du format à ajouter
extsextensions 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
namenom du format à ajouter
extextension 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
fidentificateur du format pour lequel un gestionnaire de lecture est ajouté.
opegestionnaire 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
fidentificateur du format pour lequel un gestionnaire d'écriture est ajouté.
opegestionnaire 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
tttype de traduction.
opele 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
filenamenom 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.
readla 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
dgPar 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
streamflux de lecture.
streamnamenom du flux de lecture.
allowsupportautorisation de lecture du support.
allowobjectsautorisation de lecture de graphes/règles.
formatformat de lecture.
formatversionversion 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).
graphsoutsi 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.
updvisualisation 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
filenom du fichier à lire.
allowsupportautorisation de lecture du support.
allowobjectsautorisation de lecture de graphes/règles.
formatformat 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.
formatversionversion 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).
graphsoutsi 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.
updvisualisation 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
oopération à supprimer.

◆ removeInputHandler()

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

Suppression d'un gestionnaire de lecture.

Parameters
oopération à supprimer.

◆ removeOutputHandler()

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

Suppression d'un gestionnaire d'écriture.

Parameters
oopération à supprimer.

◆ removeRdfsToCgTranslation()

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

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

Parameters
oopération à supprimer.

◆ selectCgToRdfsTranslation() [1/2]

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

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

Parameters
ttType 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
opopé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
ttType 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
opopé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
suffixextension.
readla 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
streamflux d'écriture.
streamnamenom 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.
formatformat d'écriture.
formatversionversion 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.
updvisualisation 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
filenom 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.
formatformat 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.
formatversionversion 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.
updvisualisation 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.