abfError()

Changes the ABF file header to reflect that an error occurred in translation (making the file unreadable) and imbeds a message in the file which is displayed in the message log.

Syntax

void abfError(const char *mess);

Inputs

mess: The error to be displayed.

Example

abfError("Unrecoverable errors occurred during translation.");

Comments

If the translator is not invoked as an external reader, the message is output to stderr. Otherwise, the program will stop trying other readers under the assumption that this reader correctly claimed ownership of the file, but found it impossible to translate properly.

Calling abfError() terminates the translator. The ABF library quits via exit().