Класс QMessageLogger
Класс QMessageLogger генерирует сообщения об ошибках. Подробнее...
| Заголовок: | #include <QMessageLogger> |
| qmake: | QT += core |
| С момента: | Qt 5.0 |
Типы публичного доступа
| typedef | CategoryFunction |
Функции публичного доступа
| QMessageLogger() | |
| QMessageLogger(const char *file, int line, const char *function) | |
| QMessageLogger(const char *file, int line, const char *function, const char *category) | |
| void | critical(const char *msg, ...) const |
| void | critical(const QLoggingCategory &cat, const char *msg, ...) const |
| void | critical(CategoryFunction catFunc, const char *msg, ...) const |
| QDebug | critical() const |
| QDebug | critical(const QLoggingCategory &cat) const |
| QDebug | critical(CategoryFunction catFunc) const |
| void | debug(const char *msg, ...) const |
Подробное описание
Класс QMessageLogger генерирует сообщения об ошибках.
QMessageLogger используется для генерации сообщений для фреймворка протоколирования Qt. Обычно он используется через функции qDebug(), qInfo(), qWarning(), qCritical или qFatal() , которые фактически являются макросами: например, qDebug() расширяется до QMessageLogger(__FILE__, __LINE__, Q_FUNC_INFO).debug() для отладочных сборок и QMessageLogger(0, 0, 0).debug() для релизных сборок.
Один из примеров прямого использования — передача ошибок, возникающих в языке сценариев, например, QML:
void statusChanged(QDeclarativeComponent::Status status) {
if (status == QDeclarativeComponent::Error) {
foreach (const QDeclarativeError &error, component->errors()) {
const QByteArray file = error.url().toEncoded();
QMessageLogger(file.constData(), error.line(), 0).debug() << error.description();
}
}
} См. также QMessageLogContext, qDebug(), qInfo(), qWarning(), qCritical() и qFatal().
Документация типов членов
typedef QMessageLogger::CategoryFunction
Это typedef для указателя на функцию со следующей сигнатурой:
const QLoggingCategory &category();
Функция, сигнатура которой генерируется с помощью Q_DECLARE_LOGGING_CATEGORY, Q_LOGGING_CATEGORY.
Этот typedef был представлен в Qt 5.3.
Документация функций членов
QMessageLogger::QMessageLogger()
Создаёт стандартный QMessageLogger. Используйте другие конструкторы для указания контекстной информации.
QMessageLogger::QMessageLogger(const char *file, int line, const char *function)
Создаёт QMessageLogger для записи сообщений журнала для file в строке line в функции function. Это эквивалентно QMessageLogger(file, line, function, "default")
QMessageLogger::QMessageLogger(const char *file, int line, const char *function, const char *category)
Создаёт QMessageLogger для записи сообщений категории category для file в строке line в функции function.
void QMessageLogger::critical(const char *msg, ...) const
Записывает критическое сообщение, заданное форматом msg. Дополнительные параметры, указанные в msg, могут быть использованы.
См. также qCritical().
void QMessageLogger::critical(const QLoggingCategory &cat, const char *msg, ...) const
Записывает критическое сообщение, заданное форматом msg для контекста cat. Дополнительные параметры, указанные в msg, могут быть использованы.
Эта функция была добавлена в Qt 5.3.
См. также qCCritical().
void QMessageLogger::critical(CategoryFunction catFunc, const char *msg, ...) const
Записывает критическое сообщение, заданное форматом msg для контекста, возвращаемого catFunc. Дополнительные параметры, указанные в msg, могут быть использованы.
Эта функция была добавлена в Qt 5.3.
См. также qCCritical().
QDebug QMessageLogger::critical() const
Записывает критическое сообщение, используя поток QDebug.
См. также qCritical() и QDebug.
QDebug QMessageLogger::critical(const QLoggingCategory &cat) const
Записывает критическое сообщение в категорию cat, используя поток QDebug.
Эта функция была добавлена в Qt 5.3.
См. также qCCritical() и QDebug.
QDebug QMessageLogger::critical(CategoryFunction catFunc) const
Записывает критическое сообщение в категорию, возвращаемую catFunc, используя поток QDebug.
Эта функция была добавлена в Qt 5.3.
См. также qCCritical() и QDebug.
void QMessageLogger::debug(const char *msg, ...) const
Записывает отладочное сообщение, заданное форматом msg. Дополнительные параметры, заданные msg, могут быть использованы.
См. также qDebug().
void QMessageLogger::debug(const QLoggingCategory &cat, const char *msg, ...) const
Записывает отладочное сообщение, заданное форматом msg, для контекста cat. Дополнительные параметры, заданные msg, могут быть использованы.
Эта функция была добавлена в Qt 5.3.
См. также qCDebug().
void QMessageLogger::debug(CategoryFunction catFunc, const char *msg, ...) const
Записывает отладочное сообщение, заданное форматом msg, для контекста, возвращаемого catFunc. Дополнительные параметры, заданные msg, могут быть использованы.
Эта функция была добавлена в Qt 5.3.
См. также qCDebug().
QDebug QMessageLogger::debug() const
Записывает отладочное сообщение, используя поток QDebug.
QDebug QMessageLogger::debug(const QLoggingCategory &cat) const
Записывает отладочное сообщение в категорию cat, используя поток QDebug.
Эта функция была добавлена в Qt 5.3.
QDebug QMessageLogger::debug(CategoryFunction catFunc) const
Записывает отладочное сообщение в категорию, возвращаемую catFunc, используя поток QDebug.
Эта функция была добавлена в Qt 5.3.
void QMessageLogger::fatal(const char *msg, ...) const
Записывает сообщение об ошибке, заданное форматом msg. Дополнительные параметры, заданные msg, могут быть использованы.
См. также qFatal().
void QMessageLogger::info(const char *msg, ...) const
Записывает информационное сообщение, заданное форматом msg. Дополнительные параметры, заданные msg, могут быть использованы.
Эта функция была добавлена в Qt 5.5.
См. также qInfo().
void QMessageLogger::info(const QLoggingCategory &cat, const char *msg, ...) const
Записывает информационное сообщение, заданное форматом msg, для контекста cat. Дополнительные параметры, заданные msg, могут быть использованы.
Эта функция была добавлена в Qt 5.5.
См. также qCInfo().
void QMessageLogger::info(CategoryFunction catFunc, const char *msg, ...) const
Записывает информационное сообщение, заданное форматом msg, для контекста, возвращаемого catFunc. Дополнительные параметры, заданные msg, могут быть использованы.
Эта функция была добавлена в Qt 5.5.
См. также qCInfo().
QDebug QMessageLogger::info() const
Записывает информационное сообщение, используя поток QDebug.
Эта функция была добавлена в Qt 5.5.
QDebug QMessageLogger::info(const QLoggingCategory &cat) const
Записывает информационное сообщение в категорию cat, используя поток QDebug.
Эта функция была добавлена в Qt 5.5.
QDebug QMessageLogger::info(CategoryFunction catFunc) const
Записывает информационное сообщение в категорию, возвращаемую catFunc, используя поток QDebug.
Эта функция была добавлена в Qt 5.5.
void QMessageLogger::warning(const char *msg, ...) const
Записывает предупреждающее сообщение, заданное форматом msg. Дополнительные параметры, заданные msg, могут быть использованы.
См. также qWarning().
void QMessageLogger::warning(const QLoggingCategory &cat, const char *msg, ...) const
Записывает предупреждающее сообщение, заданное форматом msg, для контекста cat. Дополнительные параметры, заданные msg, могут быть использованы.
Эта функция была добавлена в Qt 5.3.
См. также qCWarning().
void QMessageLogger::warning(CategoryFunction catFunc, const char *msg, ...) const
Записывает предупреждающее сообщение, заданное форматом msg, для контекста, возвращаемого catFunc. Дополнительные параметры, заданные msg, могут быть использованы.
Эта функция была добавлена в Qt 5.3.
См. также qCWarning().
QDebug QMessageLogger::warning() const
Записывает предупреждающее сообщение, используя поток QDebug
См. также qWarning() и QDebug.
QDebug QMessageLogger::warning(const QLoggingCategory &cat) const
Записывает предупреждающее сообщение в категорию cat, используя поток QDebug.
См. также qCWarning() и QDebug.
QDebug QMessageLogger::warning(CategoryFunction catFunc) const
Записывает предупреждающее сообщение в категорию, возвращаемую catFunc, используя поток QDebug.
Эта функция была добавлена в Qt 5.3.
См. также qCWarning() и QDebug.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qmessagelogger.html