logger

The logger class provides console output with color support and formatted printing capabilities for debugging and diagnostics.

Overview

This class extends generic_logger to provide:

Colored console output with multiple severity levels
Printf-style formatted printing with type safety
Output control for suppressing logs
Cross-platform terminal color support
Forced printing that bypasses output controls

Constructor & Destructor

logger()
~logger() override

On Windows, the constructor saves the current console code page and sets UTF-8 mode. The destructor restores the original code page.

Methods

print (string_view)

Prints a message with the specified color.

void print(color c, std::string_view message) override

color

The color to use for the output

std::string_view

The message to print

print (formatted)

Prints a formatted message with the specified color using printf-style formatting.

void print(color c, const char* message, ...) override

color

The color to use for the output

const char*

Printf-style format string

variadic

Arguments matching the format string

Note: This method respects the output disabled flag.

force_print

Prints a formatted message that bypasses the output disabled flag.

void force_print(color c, const char* message, ...)

color

The color to use for the output

const char*

Printf-style format string

variadic

Arguments matching the format string

Severity-Specific Methods

Convenience methods for common logging levels.

info

void info(const char* message, ...) const

Logs informational messages in cyan.

warn

void warn(const char* message, ...) const

Logs warning messages in yellow.

error

void error(const char* message, ...) const

Logs error messages in red.

success

void success(const char* message, ...) const

Logs success messages in green.

log

void log(const char* message, ...) const

Logs general messages in white.

Output Control

disable_output

void disable_output(const bool value)

Enables or disables console output.

bool

true to disable output, false to enable

Note: The force_print method bypasses this setting.

is_output_disabled

bool is_output_disabled() const

Returns: true if output is currently disabled, false otherwise.

Color Enum

Available colors for terminal output:

enum class color
{
    black,
    red,
    green,
    yellow,
    blue,
    cyan,
    pink,
    white,
    gray,
    dark_gray,
}

Usage Example

#include <windows-emulator/logger.hpp>

logger log;

// Basic colored output
log.print(color::green, "Emulator started\n");

// Formatted output
log.info("Loading module at 0x%llx", base_address);
log.warn("Syscall %d not fully implemented", syscall_number);
log.error("Failed to allocate %zu bytes", size);
log.success("Process initialized with PID %d", pid);

// Conditional logging
if (verbose_mode) {
    log.log("Thread %d entering syscall", thread_id);
}

// Disable output temporarily
log.disable_output(true);
log.info("This won't be printed");
log.force_print(color::red, "But this will be!");
log.disable_output(false);

// Check output state
if (!log.is_output_disabled()) {
    log.print(color::cyan, "Output is enabled\n");
}

Platform Notes

Windows: Automatically manages console code page for UTF-8 support
Unix/Linux: Uses ANSI escape codes for color output
Format string safety is enforced via compiler attributes on GCC/Clang

Core API

Components

Overview

Constructor & Destructor

Methods

print (string_view)

print (formatted)

force_print

Severity-Specific Methods

info

warn

error

success

log

Output Control

disable_output

is_output_disabled

Color Enum

Usage Example

Platform Notes

See Also

​Overview

​Constructor & Destructor

​Methods

​print (string_view)

​print (formatted)

​force_print

​Severity-Specific Methods

​info

​warn

​error

​success

​log

​Output Control

​disable_output

​is_output_disabled

​Color Enum

​Usage Example

​Platform Notes

​See Also

Overview

Constructor & Destructor

Methods

print (string_view)

print (formatted)

force_print

Severity-Specific Methods

info

warn

error

success

log

Output Control

disable_output

is_output_disabled

Color Enum

Usage Example

Platform Notes

See Also