error()

error() prints to one or more default or designated Printer instances.

Error can have a function or equality argument that is evaluated after printing completes.

There are four reference data types available during printing:

• variables

• headers

• metadata

• csvpath

The latter is the runtime metrics and config for the presently running csvpath. See csvpath.org, the CsvPath Framework GitHub repo docs, or the Runtime Print Fields section of the FlightPath help tabs for more details. The run_table() function also gives a good view of the available fields.

Errors are also handled in the same way as built-in errors. They are collected to errors.json, printed with metadata, etc.

Data signatures
error( print this: $${\color{green}str}$$ ǁ '', [print to specific Printer stream: $${\color{green}str}$$ ǁ ''] )
error( print this: $${\color{green}str}$$ ǁ '', [eval after: $${\color{green}None}$$ ǁ $${\color{green}Any}$$] )

Call signatures
error( print this: Term, [print to specific Printer stream: Term] )
error( print this: Term, [eval after: Function ǁ Equality] )

Purpose	Value
Main focus	error() is a side-effect

Context	Qualifier
Match qualifiers	onmatch, once, onchange
Value qualifiers	onmatch

[Back to index]