|
| Function | Prepare a file for printing error messages into it |
|
| Syntax C/C++ | #include <VecLib.h>
void V_setErrorEventFile(
char *filename, unsigned ScreenAndFile ); |
| Pascal/Delphi | uses VecLib;
procedure V_setErrorEventFile( filename:PChar; ScreenAndFile:IntBool ); |
|
| Description | This function determines where to print messages notifying math errors that occur within VectorLib routines. filename is the desired name of the event file (often called "log-file"). ScreenAndFile decides if you wish to have error messages printed simultaneously into the file and onto the screen (ScreenAndFile = TRUE (non-zero)) or exclusively into the file (ScreenAndFile = FALSE (0)).
The default, i.e., printing error messages to the screen, is restored by V_closeErrorEventFile.
This function will not be included in versions of OptiVec for compilers which offer the possibility of printing error messages simultaneously to the screen and into an event file.
If a user-defined _matherr function (C/C++) or any other custom error handler (both C/C++ and Pascal/Delphi) calls V_noteError, also errors occurring outside OptiVec routines w ill lead to a message printed into the event file (see chapter 5.5). |
|
| Error handling | If the desired event file cannot be opened or created, the program is aborted with a message "Cannot open error event file". |
|
|
|