Документация библиотеки логирования

Назначение

Библиотека предназначена для записи текстовых сообщений в журнал с учетом уровня важности. В качестве журнала используется текстовый файл.

Возможности

запись сообщений в текстовый файл;
три уровня важности сообщений;
фильтрация сообщений по минимальному уровню важности;
изменение минимального уровня после инициализации;
автоматическое сохранение времени получения сообщения.

Интерфейс

Инициализация

При создании объекта библиотеки необходимо указать:

имя файла журнала;
минимальный уровень важности сообщений.

Запись сообщения

При записи сообщения библиотека:

проверяет уровень важности;
получает текущее время;
добавляет запись в журнал.

Изменение уровня важности

Минимальный уровень важности может быть изменен в любой момент после инициализации.

Формат записи

YYYY-MM-DD HH:MM:SS [LEVEL] Сообщение

Пример:

2026-07-17 18:42:31 [INFO] Application started
2026-07-17 18:42:37 [WARNING] Low memory
2026-07-17 18:42:41 [ERROR] Failed to open file

Уровни важности

Уровень	Описание
INFO	Информационные сообщения
WARNING	Предупреждения
ERROR	Ошибки

Ошибки

Ситуация	Поведение библиотеки
Не удалось открыть файл	Генерируется std::runtime_error
Ошибка записи	Генерируется std::runtime_error
Некорректное имя файла	Инициализация завершается с ошибкой

Ограничения

Библиотека не является потокобезопасной. Для корректной работы запись должна выполняться последовательно из одного потока или синхронизироваться внешними средствами.

2.8 KiB Raw Blame History