libSBML C++ API
5.18.0
|
Writes an SBML Document to file or in-memory string. More...
Classes | |
class | SBMLWriter |
File and text-string SBML writer. More... | |
Functions | |
int | writeSBML (const SBMLDocument_t *d, const char *filename) |
Writes the given SBML document d to the file named by filename . More... | |
int | writeSBMLToFile (const SBMLDocument_t *d, const char *filename) |
Writes the given SBML document d to the file filename . More... | |
char * | writeSBMLToString (const SBMLDocument_t *d) |
Writes the given SBML document d to an in-memory string and returns a pointer to it. More... | |
Writes an SBML Document to file or in-memory string.
int writeSBML | ( | const SBMLDocument_t * | d, |
const char * | filename | ||
) |
Writes the given SBML document d
to the file named by filename
.
This convenience function is functionally equivalent to:
SBMLWriter_writeSBML(SBMLWriter_create(), d, filename);
If the given filename ends with the suffix".gz"
(for example, "myfile.xml.gz"
), libSBML assumes the
caller wants the file to be written compressed in gzip format.
Similarly, if the given filename ends with ".zip"
or
".bz2"
, libSBML assumes the caller wants the file to
be compressed in zip or bzip2 format (respectively).
Files whose names lack these suffixes will be written uncompressed.
Special considerations for the zip format: If the given filename
ends with ".zip"
, the file placed in the zip archive
will have the suffix ".xml"
or
".sbml"
. For example, the file in the zip archive
will be named "test.xml"
if the given filename is
"test.xml.zip"
or "test.zip"
.
Similarly, the filename in the archive will be
"test.sbml"
if the given filename is
"test.sbml.zip"
.
d | the SBMLDocument object to be written out in XML format. |
filename | a string giving the path to a file where the XML content is to be written. |
1
(true) on success and 0
(false) if filename
could not be written. Some possible reasons for failure include (a) being unable to open the file, and (b) using a filename that indicates a compressed SBML file (i.e., a filename ending in ".zip"
or similar) when the compression functionality has not been enabled in the underlying copy of libSBML.int writeSBMLToFile | ( | const SBMLDocument_t * | d, |
const char * | filename | ||
) |
Writes the given SBML document d
to the file filename
.
This convenience function is functionally equivalent to:
SBMLWriter_writeSBMLToFile(SBMLWriter_create(), d, filename);
but that does not require the caller to create an SBMLWriter object first.
If the given filename ends with the suffix".gz"
(for example, "myfile.xml.gz"
), libSBML assumes the
caller wants the file to be written compressed in gzip format.
Similarly, if the given filename ends with ".zip"
or
".bz2"
, libSBML assumes the caller wants the file to
be compressed in zip or bzip2 format (respectively).
Files whose names lack these suffixes will be written uncompressed.
Special considerations for the zip format: If the given filename
ends with ".zip"
, the file placed in the zip archive
will have the suffix ".xml"
or
".sbml"
. For example, the file in the zip archive
will be named "test.xml"
if the given filename is
"test.xml.zip"
or "test.zip"
.
Similarly, the filename in the archive will be
"test.sbml"
if the given filename is
"test.sbml.zip"
.
d | an SBMLDocument object to be written out in XML format. |
filename | a string giving the path to a file where the XML content is to be written. |
1
(true) on success and 0
(false) if filename
could not be written. Some possible reasons for failure include (a) being unable to open the file, and (b) using a filename that indicates a compressed SBML file (i.e., a filename ending in ".zip"
or similar) when the compression functionality has not been enabled in the underlying copy of libSBML.free()
C++ function) after it is no longer needed.char* writeSBMLToString | ( | const SBMLDocument_t * | d | ) |
Writes the given SBML document d
to an in-memory string and returns a pointer to it.
The string is owned by the caller and should be freed (with free()) when no longer needed. This convenience function is functionally equivalent to:
SBMLWriter_writeSBMLToString(SBMLWriter_create(), d);
but does not require the caller to create an SBMLWriter object first.
d | an SBMLDocument object to be written out in XML format. |
NULL
if one of the underlying parser components fail.