<QtLogging> - Qt Logging Types

宏文档

qCritical(const char *message, ...)

调用包含关键信息message 的消息处理程序。如果未安装消息处理程序，则将消息打印到 stderr。在 Windows 环境下，消息将发送到调试器。在 QNX 系统中，消息将发送到 slogger2。

该函数接收格式字符串和参数列表，类似于 C 语言的 printf()函数。格式应为拉丁字母 1 字符串。

举例说明

void load(const QString &fileName)
{
    QFile file(fileName);
    if (!file.exists())
        qCritical("File '%s' does not exist!", qUtf8Printable(fileName));
}

如果包含 <QtDebug>，还可以使用更方便的语法：

qCritical() << "Brush:" << myQBrush << "Other value:" << i;

在项目之间插入空格，并在末尾添加换行符。

要在运行时抑制输出，可以定义logging rules 或注册一个自定义的filter 。

出于调试目的，有时让程序终止处理关键信息也很方便。这样就可以检查核心转储，或附加调试器--另请参阅qFatal() 。要启用此功能，可将环境变量QT_FATAL_CRITICALS 设为n 。这样，程序就会在出现第 n 条关键信息时终止。也就是说，如果环境变量设置为 1，程序将在第一次调用时终止；如果环境变量的值为 10，程序将在第 10 次调用时退出。环境变量中的任何非数值都等同于 1。

注意：该宏是线程安全的。

另请参阅 qCCritical(),qDebug(),qInfo(),qWarning(),qFatal(),qInstallMessageHandler() 和调试技巧。

qDebug(const char *message, ...)

调用带有调试信息message 的消息处理程序。如果没有安装消息处理程序，则会将消息打印到 stderr。在 Windows 下，如果是控制台应用程序，消息将被发送到控制台；否则，消息将被发送到调试器。在 QNX 系统中，信息将发送到 slogger2。如果在编译过程中定义了QT_NO_DEBUG_OUTPUT ，则该函数不会执行任何操作。

如果向该函数传递格式字符串和参数列表，其工作方式与 C 的 printf() 函数类似。格式应为拉丁字母 1 的字符串。

例如

qDebug("Items in list: %d", myList.size());

如果包含<QtDebug> ，还可以使用更方便的语法：

qDebug() << "Brush:" << myQBrush << "Other value:" << i;

使用这种语法，函数将返回一个QDebug 对象，该对象已配置为使用QtDebugMsg 消息类型。它会自动在每个项目之间加上一个空格，并在结尾输出换行符。它支持许多 C++ 和 Qt 类型。

要在运行时抑制输出，可使用qInstallMessageHandler() 安装自己的消息处理程序。

注意：该宏是线程安全的。

另请参阅 qCDebug(),qInfo(),qWarning(),qCritical(),qFatal(),qInstallMessageHandler() 和调试技巧。

qFatal(const char *message, ...)

调用带有致命消息message 的消息处理程序。如果未安装消息处理程序，则将消息打印到 stderr。在 Windows 环境下，该信息会发送到调试器。在 QNX 系统中，消息将发送到 slogger2。

如果使用的是默认消息处理程序，该函数将终止以创建核心转储。在 Windows 系统中，对于调试程序，该函数将报告 _CRT_ERROR，以便将调试器连接到应用程序。

该函数接收格式字符串和参数列表，类似于 C 语言的 printf() 函数。

示例

int divide(int a, int b)
{
    if (b == 0)                                // program error
        qFatal("divide: cannot divide by zero");
    return a / b;
}

要在运行时抑制输出，请使用qInstallMessageHandler() 安装自己的消息处理程序。

另请参阅 qCFatal(),qDebug(),qInfo(),qWarning(),qCritical(),qInstallMessageHandler() 和调试技巧。

qInfo(const char *message, ...)

调用带有信息消息message 的消息处理程序。如果没有安装消息处理程序，则会将消息打印到 stderr。在 Windows 下，如果是控制台应用程序，消息会发送到控制台；否则，会发送到调试器。在 QNX 系统中，信息将发送到 slogger2。如果在编译过程中定义了QT_NO_INFO_OUTPUT ，则该函数不会执行任何操作。

如果向该函数传递格式字符串和参数列表，其工作方式与 C 的 printf() 函数类似。格式应为拉丁字母 1 的字符串。

例如

qInfo("Items in list: %d", myList.size());

如果包含<QtDebug> ，还可以使用更方便的语法：

qInfo() << "Brush:" << myQBrush << "Other value:" << i;

使用这种语法，函数将返回一个QDebug 对象，该对象已配置为使用QtInfoMsg 消息类型。它会自动在每个项目之间加上一个空格，并在结尾输出换行符。它支持许多 C++ 和 Qt 类型。

要在运行时抑制输出，可使用qInstallMessageHandler() 安装自己的消息处理程序。

注意：该宏是线程安全的。

另请参阅 qCInfo(),qDebug(),qWarning(),qCritical(),qFatal(),qInstallMessageHandler() 和调试技巧。

qWarning(const char *message, ...)

调用带有警告信息的消息处理程序message 。如果未安装消息处理程序，则会将消息打印到 stderr。在 Windows 环境下，消息会发送到调试器。在 QNX 系统中，消息将发送到 slogger2。

该函数接收格式字符串和参数列表，类似于 C 语言的 printf()函数。格式应为拉丁字母 1 字符串。

举例说明

void f(int c)
{
    if (c > 200)
        qWarning("f: bad argument, c == %d", c);
}

如果包含 <QtDebug>，还可以使用更方便的语法：

qWarning() << "Brush:" << myQBrush << "Other value:" << i;

该语法在每个项目之间插入一个空格，并在末尾添加一个换行符。

如果在编译过程中定义了QT_NO_WARNING_OUTPUT ，则此函数不起任何作用。要在运行时抑制输出，可以设置logging rules 或注册一个自定义的filter 。

出于调试目的，有时让程序终止运行以获取警告信息也很方便。这样就可以检查核心转储，或附加调试器--另请参阅qFatal() 。要启用此功能，可将环境变量QT_FATAL_WARNINGS 设为一个数字n 。这样，程序就会在出现第 n 次警告时终止。也就是说，如果环境变量设置为 1，程序将在第一次调用时终止；如果环境变量的值为 10，程序将在第 10 次调用时退出。环境变量中的任何非数值都等同于 1。

注意：该宏是线程安全的。

另请参阅 qCWarning(),qDebug(),qInfo(),qCritical(),qFatal(),qInstallMessageHandler() 和调试技巧。