ahxrlogger - Light C++ Logger Library

#include "ahxrlogger.h"

using namespace std;

char * s_file_name = "dummyfile.txt";

int main() {

	LOG("Creating dummy file '%s'", s_file_name );

	fstream
		fstr_test
	;
	fstr_test.open(s_file_name, ios::out);

	if (fstr_test.is_open()) {
		IMPORTANT("File stream created!");

		for (int i = 0; i < 10; i++) {
			fstr_test << i << endl;
			LOG("[COLOR:GREEN]%i was written in the dummy file", i);
		}
		LOG("Writing finished! Now closing!");
		fstr_test.close();
	}
	else ERROR("Couldn't open stream!");
	system("pause");
}

Install (Windows)

Simply copy the header files to your project's build directory.

---

Console Logging

ahxrlogger provides 4 logging levels. Each level provides a threaded and non-threaded variant.

• Error

ERROR( const char * format, ... );
ERROR_THREAD( const char * format, ... );

• Warning

WARNING( const char * format, ... );
WARNING_THREAD( const char * format, ... );

• Important

IMPORTANT( const char * format, ... );
IMPORTANT_THREAD( const char * format, ... );

• Generic

LOG( const char * format, ... );
LOG_THREAD( const char * format, ... );

As you can see from the example earlier, its a very simple concept. If these names conflict with your project, define AHXRLOGGER_DISABLE_QUICK_SHORTCUTS on top of your project. If you wish to define your own macros to call your logging functions, refer to your define to the following functions:

| Level | Function | Thread | | :---: | :---: | :----: | | Error | logger_e | No | | Error | logger_t_e | Yes | | Warning | logger_w | No | | Warning | logger_t_w | Yes | | Important | logger_i | No | | Important | logger_t_i | Yes | | General | logger | No | | General | logger_t | Yes |

By default, ahxrlogger will automatically create a new line whenever a log is printed. To remove this feature undefine AHXRLOGGER_CONSOLE_LINE after you've included ahxrlogger.h.

If you want to specify a console handle you want the logging to show up on, the following function is available:

ahxrlogger_handle( HANDLE consoleHandle )

Console Color Logging

If you wish to log something with a specific color scheme, place the following markdown anywhere in the string:

[COLOR:MYCOLOR]

Replace MYCOLOR with any of the colors listed below:

• BLACK
• BLUE
• GREEN
• CYAN
• RED
• MAGENTA
• BROWN
• LIGHTGRAY
• DARKGRAY
• LIGHTBLUE
• LIGHTGREEN
• LIGHTCYAN
• LIGHTRED
• LIGHTMAGENTA
• YELLOW
• WHITE

By default, the color will automatically reset itself back to BLACK & WHITE after the log is printed. To remove this feature, undefine AHXRLOGGER_CONSOLE_RESET_COLOR after including ahxrlogger.h

---

File Logging

File logging can be managed with the following functions. The macros are pretty self-explanatory:

ahxrlogger_error_logging( bool toggle );
ahxrlogger_warning_logging( bool toggle );
ahxrlogger_important_logging( bool toggle );
ahxrlogger_general_logging( bool toggle );
ahxrlogger_toggle_logging( bool toggle );

ahxrlogger_file_general( const char * filePath );
ahxrlogger_file_error( const char * filePath );
ahxrlogger_file_warning( const char * filePath );
ahxrlogger_file_important( const char * filePath );

As you can see, you can change the file path you want a certain level to log at. ahxrlogger_toggle_logging will toggle logs on/off for ALL levels.

Notable Macros

| Macro | Purpose | | :---: | :-----: | | AHXRLOGGER_DEFAULT_THREADS | Set to true or false. This controls where logs will automatically thread. This is false by default. | | AHXRLOGGER_LEVEL_PFX_ERROR | Contains the prefix of the error level | | AHXRLOGGER_LEVEL_PFX_WARNING | Contains the prefix of the warning level | | AHXRLOGGER_LEVEL_PFX_IMPORTANT | Contains the prefix of the important level | | COLOR_ERROR | Contains the color code for the error level | | COLOR_WARNING | Contains the color code for the error level | | COLOR_IMPORTANT | Contains the color code for the error level | | AHXRLOGGER_CONSOLE_REMOVE_COLOR_CODE | If you want the [COLOR:MYCOLOR] removed from your log. This is enabled by default! | | MAX_PREFIX_SIZE | Maximum Prefix size | | ahxrlogger_flush | Flushes the logging system |