abc::messages, abc::errorReturn, abc::consCode, abc::extrSymb, abc::extrSeverity — error messages and message manipulation functions
abc::errorReturn retArrayName symbol [par...]
abc::consCode symbol [par...]
abc::extrSymb errorcode
abc::extrSeverity errorcode
An ABCTcl error code is structured as
symbol explanation.
The symbol has the form
ABC_S_XXX,
where S is a letter indicating severity,
and XXX determines the error.
explanation is a human-readable text.
abc::messages An associative array. For each error symbol used by ABCTcl,
it contains a human-readable explanation that can be used
by Tcl format.
Set up when the abctcl.tcl file is sourced.
retArrayName
symbol
[par...]
When called from a procedure, it causes that procedure to return
with error. The Tcl variable ::errorCode is constructed from the
provided symbol and the explanation from abc::messages,
using pars when required by the explanation. The value
is also stored in retArray(errorCode)::errorInfo is derived from the constructed
error code.
Returns empty string. Used internally by all ABCTcl procedures.
symbol
[par...]
Returns an error code constructed from the
provided symbol and the explanation from abc::messages,
using pars when required by the explanation.
Used internally by abc::errorReturn.
errorcode
Returns the error symbol contained in errorcode.
errorcode
Returns the letter specifying severity from an error code or an error symbol in errorcode.