TiGL
2.2.3
|
Functions | |
TIGL_COMMON_EXPORT TiglReturnCode | tiglLogSetFileEnding (const char *ending) |
Sets the file ending for logging files. Default is "log". More... | |
TIGL_COMMON_EXPORT TiglReturnCode | tiglLogSetTimeInFilenameEnabled (TiglBoolean enabled) |
Enables or disables appending a unique date/time identifier inside the log file name (behind the file prefix). By default, the time identifier is enabled. More... | |
TIGL_COMMON_EXPORT TiglReturnCode | tiglLogSetVerbosity (TiglLogLevel level) |
Set the console verbosity level. More... | |
TIGL_COMMON_EXPORT TiglReturnCode | tiglLogToFileDisabled () |
Disabled file logging. If a log file is currently opened by TiGL it will be closed. The log messages are printed to console. This is the default logging mechanism of TIGL. More... | |
TIGL_COMMON_EXPORT TiglReturnCode | tiglLogToFileEnabled (const char *filePrefix) |
Sets up the tigl logging mechanism to send all log messages into a file. More... | |
TIGL_COMMON_EXPORT TiglReturnCode | tiglLogToFileStreamEnabled (FILE *fp) |
Sets up the tigl logging mechanism to send all log messages into an already opened file. More... | |
The following functions are used to customize the behaviour how messages are handled by TiGL. By default, only error messages and warnings are printed to the console.
In addition, TiGL can be told to write message into a log file using the function tiglLogToFileEnabled and tiglLogToFileStreamEnabled. By enabling file logging, other log messages than errors and warnings can be inspected. File logging is disabled by default.
In order to change the verbosity of the TiGL messages printed on console, use tiglLogSetVerbosity.
TIGL_COMMON_EXPORT TiglReturnCode tiglLogSetFileEnding | ( | const char * | ending | ) |
Sets the file ending for logging files. Default is "log".
This function has to be called before tiglLogToFileEnabled to have the desired effect.
[in] | ending | File ending of the logging file. Default is "log". |
TIGL_COMMON_EXPORT TiglReturnCode tiglLogSetTimeInFilenameEnabled | ( | TiglBoolean | enabled | ) |
Enables or disables appending a unique date/time identifier inside the log file name (behind the file prefix). By default, the time identifier is enabled.
This function has to be called before tiglLogToFileEnabled to have the desired effect.
[in] | enabled | Set to true, if time identifier should be enabled. |
TIGL_COMMON_EXPORT TiglReturnCode tiglLogSetVerbosity | ( | TiglLogLevel | level | ) |
Set the console verbosity level.
This function shall be used change, what kind of logging information is displayed on the console. By default, only errors and warnings are printed on console.
[in] | level | Verbosity level for console messages. |
TIGL_COMMON_EXPORT TiglReturnCode tiglLogToFileDisabled | ( | ) |
Disabled file logging. If a log file is currently opened by TiGL it will be closed. The log messages are printed to console. This is the default logging mechanism of TIGL.
TIGL_COMMON_EXPORT TiglReturnCode tiglLogToFileEnabled | ( | const char * | filePrefix | ) |
Sets up the tigl logging mechanism to send all log messages into a file.
Typically this function has to be called before opening any cpacs configuration. The console logging mechanism remains untouched.
[in] | filePrefix | Prefix of the filename to be created. The filename consists of the prefix, a date and time string and the ending ".log". |
TIGL_COMMON_EXPORT TiglReturnCode tiglLogToFileStreamEnabled | ( | FILE * | fp | ) |
Sets up the tigl logging mechanism to send all log messages into an already opened file.
In contrast to tiglLogToFileEnabled, the messages are appended to an already opened file. This file might be an already opened logging file set up by another library or program. The console logging mechanism remains untouched.
Typically this function has to be called before opening any cpacs configuration.
[in] | fp | File pointer to an already opened file. |