fctlog

C++ Function Entry/Exit Logger

Intro

This tool provide logging of class member function entry, exit and throw. This tool is very helpfull if it isn't possible to use a debuger.

How-to

No need to modify the original class. A child class for logging purpose must be created. Macros are provided for easy use. Macros defined for method with up to 8 arguments (more macros can be define). Example:

class DemoWithLog : public Demo {
    FCTLOG_METHOD0(void, fctName);
    FCTLOG_METHOD1(int, fctName, (int val = 0), val);
};

The logger child class must be instantiated instead of the original class (like using a mock). The function logging can be disabled on compile time by using the original class. See 'samples' for more details.

Per default the logging messages will be displayed on the standard output. An output stream can be set to log the messages in a specific logging system.

Logging messages

• Function entry with argument values.
• Function exit with return value.
• Function throw with exception type and message.

Restrictions

• Only virtual functions can be logged (workaround: make function to log virtual).
• Member function templates cannot be virtual and cannot be logged (a regular member function of a class template can be virtual and logged).
• Private functions cannot be logged (workaround: change accessibility to protected or make the logger class friend).
• Constructor and destructor cannot be logged (functions called inside constructor or destructor can be logged).
• Output stream operator required for all arguments and return values.
• Currently, function with not copiable argument cannot be logged (see TODO)