libSBML Python API
5.18.0
|
This class of objects is defined by libSBML only and has no direct equivalent in terms of SBML components. This class is not prescribed by the SBML specifications, although it is used to implement features defined in SBML.
The error log is a list. The XML layer of libSBML maintains an error log associated with a given XML document or data stream. When an operation results in an error, or when there is something wrong with the XML content, the problem is reported as an XMLError object stored in the XMLErrorLog list. Potential problems range from low-level issues (such as the inability to open a file) to XML syntax errors (such as mismatched tags or other problems).
A typical approach for using this error log is to first use getNumErrors() to inquire how many XMLError object instances it contains, and then to iterate over the list of objects one at a time using getError(long n) . Indexing in the list begins at 0.
In normal circumstances, programs using libSBML will actually obtain an SBMLErrorLog rather than an XMLErrorLog. The former is subclassed from XMLErrorLog and simply wraps commands for working with SBMLError objects rather than the low-level XMLError objects. Classes such as SBMLDocument use the higher-level SBMLErrorLog.
Public Member Functions | |
def | add (self, args) |
def | changeErrorSeverity (self, args) |
Changes the severity override for errors in the log that have a given severity. More... | |
def | clearLog (self) |
Deletes all errors from this log. More... | |
def | contains (self, errorId) |
Returns True if XMLErrorLog contains an errorId. More... | |
def | getError (self, n) |
Returns the nth XMLError object in this log. More... | |
def | getNumErrors (self) |
Returns the number of errors that have been logged. More... | |
def | getSeverityOverride (self) |
Returns the current override. More... | |
def | isSeverityOverridden (self) |
Returns a boolean indicating whether or not the severity has been overridden. More... | |
def | printErrors (self, args) |
This method has multiple variants; they differ in the arguments they accept. More... | |
def | setSeverityOverride (self, severity) |
Set the severity override. More... | |
def | toString (self) |
Writes all errors contained in this log to a string and returns it. More... | |
def | unsetSeverityOverride (self) |
Usets an existing override. More... | |
def libsbml.XMLErrorLog.add | ( | self, | |
args | |||
) |
add(XMLError error) add(std::vector< XMLError * > & errors)
def libsbml.XMLErrorLog.changeErrorSeverity | ( | self, | |
args | |||
) |
Changes the severity override for errors in the log that have a given severity.
changeErrorSeverity(long originalSeverity, long targetSeverity, string package) changeErrorSeverity(long originalSeverity, long targetSeverity)
This method searches through the list of errors in the log, comparing each one's severity to the value of originalSeverity
. For each error encountered with that severity logged by the named package
, the severity of the error is reset to targetSeverity
.
originalSeverity | the severity code to match. |
targetSeverity | the severity code to use as the new severity. |
package | a string, the name of an SBML Level 3 package extension to use to narrow the search for errors. A value of 'all' signifies to match against errors logged from any package; a value of a package nickname such as 'comp' signifies to limit consideration to errors from just that package. If no value is provided, 'all' is the default. |
parameter
= value
. This is not to be intepreted as a Python keyword argument; the use of a parameter name followed by an equals sign followed by a value is only meant to indicate a default value if the argument is not provided at all. It is not a keyword in the Python sense. def libsbml.XMLErrorLog.clearLog | ( | self | ) |
Deletes all errors from this log.
clearLog()
def libsbml.XMLErrorLog.contains | ( | self, | |
errorId | |||
) |
Returns True
if XMLErrorLog contains an errorId.
errorId | the error identifier of the error to be found. |
contains(long errorId) bool
def libsbml.XMLErrorLog.getError | ( | self, | |
n | |||
) |
Returns the nth XMLError object in this log.
getError(long n) XMLError
Index n
is counted from 0. Callers should first inquire about the number of items in the log by using the method getNumErrors(). Attempts to use an error index number that exceeds the actual number of errors in the log will result in a None
being returned.
n | the index number of the error to retrieve (with 0 being the first error). |
None
if n
is greater than or equal to getNumErrors().def libsbml.XMLErrorLog.getNumErrors | ( | self | ) |
Returns the number of errors that have been logged.
getNumErrors() long
To retrieve individual errors from the log, callers may use XMLErrorLog.getError() .
def libsbml.XMLErrorLog.getSeverityOverride | ( | self | ) |
Returns the current override.
getSeverityOverride() long
LIBSBML_OVERRIDE_
:
def libsbml.XMLErrorLog.isSeverityOverridden | ( | self | ) |
Returns a boolean indicating whether or not the severity has been overridden.
isSeverityOverridden() bool
True
if an error severity override has been set, False
otherwise.def libsbml.XMLErrorLog.printErrors | ( | self, | |
args | |||
) |
This method has multiple variants; they differ in the arguments they accept.
printErrors(ostream stream) printErrors() printErrors(ostream stream, long severity)
Each variant is described separately below.
printErrors(std::ostream stream, long severity)
Prints the errors or warnings with given severity stored in this error log.
This method prints the text to the stream given by the optional parameter stream
. If no stream is given, the method prints the output to the standard error stream.
The format of the output is:
N error(s): line NNN: (id) message
If no errors with that severity was found, then no output will be produced.
stream | the ostream or ostringstream object indicating where the output should be printed. |
severity | the severity of the errors sought. |
printErrors(std::ostream stream = std::cerr)
Prints all the errors or warnings stored in this error log.
This method prints the text to the stream given by the optional parameter stream
. If no stream is given, the method prints the output to the standard error stream.
The format of the output is:
N error(s): line NNN: (id) message
If no errors have occurred, i.e., getNumErrors() == 0
, then no output will be produced.
stream | the ostream or ostringstream object indicating where the output should be printed. |
parameter
= value
. This is not to be intepreted as a Python keyword argument; the use of a parameter name followed by an equals sign followed by a value is only meant to indicate a default value if the argument is not provided at all. It is not a keyword in the Python sense. def libsbml.XMLErrorLog.setSeverityOverride | ( | self, | |
severity | |||
) |
Set the severity override.
setSeverityOverride(long severity)
severity | an override code indicating what to do. If the value is LIBSBML_OVERRIDE_DISABLED (the default setting) all errors logged will be given the severity specified in their usual definition. If the value is LIBSBML_OVERRIDE_WARNING, then all errors will be logged as warnings. If the value is LIBSBML_OVERRIDE_DONT_LOG, no error will be logged, regardless of their severity. |
def libsbml.XMLErrorLog.toString | ( | self | ) |
Writes all errors contained in this log to a string and returns it.
toString() string
This method uses printErrors() to format the diagnostic messages. Please consult that method for information about the organization of the messages in the string returned by this method.
def libsbml.XMLErrorLog.unsetSeverityOverride | ( | self | ) |
Usets an existing override.
unsetSeverityOverride()