The QMessageLogger class generates log messages. 更多...
| 头： | #include <QMessageLogger> |
| CMake: |
find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| 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 (QMessageLogger::CategoryFunction catFunc , const char * msg , ...) const |
| QDebug | critical () const |
| QDebug | critical (const QLoggingCategory & cat ) const |
| QDebug | critical (QMessageLogger::CategoryFunction catFunc ) const |
| void | debug (const char * msg , ...) const |
| void | debug (const QLoggingCategory & cat , const char * msg , ...) const |
| void | debug (QMessageLogger::CategoryFunction catFunc , const char * msg , ...) const |
| QDebug | debug () const |
| QDebug | debug (const QLoggingCategory & cat ) const |
| QDebug | debug (QMessageLogger::CategoryFunction catFunc ) const |
| void | fatal (const char * msg , ...) const |
(从 6.5 起)
void
|
fatal (const QLoggingCategory & cat , const char * msg , ...) const |
(从 6.5 起)
void
|
fatal (QMessageLogger::CategoryFunction catFunc , const char * msg , ...) const |
(从 6.5 起)
QDebug
|
fatal () const |
(从 6.5 起)
QDebug
|
fatal (const QLoggingCategory & cat ) const |
(从 6.5 起)
QDebug
|
fatal (QMessageLogger::CategoryFunction catFunc ) const |
| void | info (const char * msg , ...) const |
| void | info (const QLoggingCategory & cat , const char * msg , ...) const |
| void | info (QMessageLogger::CategoryFunction catFunc , const char * msg , ...) const |
| QDebug | info () const |
| QDebug | info (const QLoggingCategory & cat ) const |
| QDebug | info (QMessageLogger::CategoryFunction catFunc ) const |
| void | warning (const char * msg , ...) const |
| void | warning (const QLoggingCategory & cat , const char * msg , ...) const |
| void | warning (QMessageLogger::CategoryFunction catFunc , const char * msg , ...) const |
| QDebug | warning () const |
| QDebug | warning (const QLoggingCategory & cat ) const |
| QDebug | warning (QMessageLogger::CategoryFunction catFunc ) const |
QMessageLogger is used to generate messages for the Qt logging framework. Usually one uses it through qDebug (), qInfo (), qWarning (), qCritical ，或 qFatal () functions, which are actually macros: For example qDebug () expands to QMessageLogger(__FILE__, __LINE__, Q_FUNC_INFO ). debug () for debug builds, and QMessageLogger(0, 0, 0). debug () for release builds.
One example of direct use is to forward errors that stem from a scripting language, e.g. QML:
void statusChanged(QQmlComponent::Status status) {
if (status == QQmlComponent::Error) {
for (const QQmlError &error: std::as_const(component->errors())) {
const QByteArray file = error.url().toEncoded();
QMessageLogger(file.constData(), error.line(), 0).debug() << error.description();
}
}
}
另请参阅 QMessageLogContext , qDebug (), qInfo (), qWarning (), qCritical ()，和 qFatal ().
这是采用以下签名的函数指针的 typedef：
const QLoggingCategory &category();
The
Q_DECLARE_LOGGING_CATEGORY
macro generates a function declaration with this signature, and
Q_LOGGING_CATEGORY
generates its definition.
[constexpr]
QMessageLogger::
QMessageLogger
()
Constructs a default QMessageLogger. See the other constructors to specify context information.
[constexpr]
QMessageLogger::
QMessageLogger
(const
char
*
file
,
int
line
, const
char
*
function
)
Constructs a QMessageLogger to record log messages for file at line in function . The is equivalent to QMessageLogger(file, line, function, "default")
[constexpr]
QMessageLogger::
QMessageLogger
(const
char
*
file
,
int
line
, const
char
*
function
, const
char
*
category
)
Constructs a QMessageLogger to record category messages for file at line in function .
Logs a critical message specified with format msg . Additional parameters, specified by msg , may be used.
另请参阅 qCritical ().
Logs a critical message specified with format msg for the context cat . Additional parameters, specified by msg , may be used.
另请参阅 qCCritical ().
Logs a critical message specified with format msg for the context returned by catFunc . Additional parameters, specified by msg , may be used.
另请参阅 qCCritical ().
Logs a critical message using a QDebug stream
Logs a critical message into category cat 使用 QDebug stream.
另请参阅 qCCritical () 和 QDebug .
Logs a critical message into category returned by catFunc 使用 QDebug stream.
另请参阅 qCCritical () 和 QDebug .
Logs a debug message specified with format msg . Additional parameters, specified by msg , may be used.
另请参阅 qDebug ().
Logs a debug message specified with format msg for the context cat . Additional parameters, specified by msg , may be used.
另请参阅 qCDebug ().
Logs a debug message specified with format msg for the context returned by catFunc . Additional parameters, specified by msg , may be used.
另请参阅 qCDebug ().
Logs a debug message using a QDebug stream
Logs a debug message into category cat 使用 QDebug stream.
Logs a debug message into category returned by catFunc 使用 QDebug stream.
[noexcept]
void
QMessageLogger::
fatal
(const
char
*
msg
, ...) const
Logs a fatal message specified with format msg . Additional parameters, specified by msg , may be used.
另请参阅 qFatal ().
[noexcept, since 6.5]
void
QMessageLogger::
fatal
(const
QLoggingCategory
&
cat
, const
char
*
msg
, ...) const
Logs a fatal message specified with format msg for the context cat . Additional parameters, specified by msg , may be used.
该函数在 Qt 6.5 引入。
另请参阅 qCFatal ().
[noexcept, since 6.5]
void
QMessageLogger::
fatal
(
QMessageLogger::CategoryFunction
catFunc
, const
char
*
msg
, ...) const
Logs a fatal message specified with format msg for the context returned by catFunc . Additional parameters, specified by msg , may be used.
该函数在 Qt 6.5 引入。
另请参阅 qCFatal ().
[since 6.5]
QDebug
QMessageLogger::
fatal
() const
Logs a fatal message using a QDebug stream.
该函数在 Qt 6.5 引入。
[since 6.5]
QDebug
QMessageLogger::
fatal
(const
QLoggingCategory
&
cat
) const
Logs a fatal message into category cat 使用 QDebug stream.
该函数在 Qt 6.5 引入。
[since 6.5]
QDebug
QMessageLogger::
fatal
(
QMessageLogger::CategoryFunction
catFunc
) const
Logs a fatal message into category returned by catFunc 使用 QDebug stream.
该函数在 Qt 6.5 引入。
Logs an informational message specified with format msg . Additional parameters, specified by msg , may be used.
另请参阅 qInfo ().
Logs an informational message specified with format msg for the context cat . Additional parameters, specified by msg , may be used.
另请参阅 qCInfo ().
Logs an informational message specified with format msg for the context returned by catFunc . Additional parameters, specified by msg , may be used.
另请参阅 qCInfo ().
Logs an informational message using a QDebug stream.
Logs an informational message into the category cat 使用 QDebug stream.
Logs an informational message into category returned by catFunc 使用 QDebug stream.
Logs a warning message specified with format msg . Additional parameters, specified by msg , may be used.
另请参阅 qWarning ().
Logs a warning message specified with format msg for the context cat . Additional parameters, specified by msg , may be used.
另请参阅 qCWarning ().
Logs a warning message specified with format msg for the context returned by catFunc . Additional parameters, specified by msg , may be used.
另请参阅 qCWarning ().
Logs a warning message using a QDebug stream
Logs a warning message into category cat 使用 QDebug stream.
Logs a warning message into category returned by catFunc 使用 QDebug stream.