Specifications

Error Handling
3-15
3
Example 3-2 Output for the Error Function Program (IPL_ErrModeParent)
IPL Library Error: Invalid argument in function libFuncB: order must be
less than or equal to 31
called from function appFuncA: compute using order2
called from function main: compute something
If the program runs with the IPL_ErrModeLeaf option instead of
IPL_ErrModeParent, only the first line of the above output is produced
before the program terminated.
If the program in Example 3-1 runs out of heap memory while using the
IPL_ErrModeParent option, then the output illustrated in Example 3-3 is
produced.
Example 3-3 Output for the Error Function Program (IPL_ErrModeParent)
IPL Library Error: Out of memory in function libFuncD: allocating a
vector of doubles
called from function libFuncB: compute using a
called from function appFuncA: compute using order1
called from function main[]: compute something
Again, if the program is run with the IPL_ErrModeLeaf option instead of
IPL_ErrModeParent, only the first line of the output is produced.
Adding Your Own Error Handler
The Image Processing Library allows you to define your own error handler.
User-defined error handlers are useful if you want your application to send
error messages to a destination other than the standard error output stream.
For example, you can choose to send error messages to a dialog box if your