<QtLogging> - Qt Logging Types

宏文档

qCritical(const char *format, ...)

将关键消息format 记录到中央消息处理程序中。format 中可以包含格式指定符，这些指定符将被附加参数中指定的值替换。

示例：

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

format 可以包含格式指定符，例如用于 UTF-8 字符串的%s ，或用于整数的%i 。这与 C 语言中 `printf() ` 函数的工作原理类似。有关格式的更多详细信息，请参阅QString::asprintf()。

为了更方便并支持更多类型，您还可以使用QDebug::qCritical()，它遵循流式处理范式（类似于std::cout 或std::cerr ）。

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

出于调试目的，有时让程序在遇到关键消息时终止会比较方便。这样可以检查内核转储，或连接调试器——另请参阅qFatal()。要启用此功能，请将环境变量QT_FATAL_CRITICALS 设置为一个数字n 。此时，程序将在收到第 n 条关键消息时终止。 也就是说，如果环境变量设置为 1，程序将在首次调用时终止；如果其值为 10，则将在第 10 次调用时退出。环境变量中的任何非数值均等同于 1。

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

另请参阅 QDebug::qCritical 、qCCritical()、qDebug()、qInfo()、qWarning()、qFatal()、qInstallMessageHandler() 以及《调试技术》。

qDebug(const char *format, ...)

将调试消息format 记录到中央消息处理程序中。format 中可以包含格式指定符，这些指定符将被附加参数中指定的值替换。

示例：

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

format 可以包含格式指定符，例如表示 UTF-8 字符串的%s ，或表示整数的%i 。这与 C 语言中 `printf() ` 函数的工作原理类似。有关格式化的更多详细信息，请参阅QString::asprintf()。

为了更方便且支持更多数据类型，您还可以使用QDebug::qDebug()，该函数遵循流式处理范式（类似于std::cout 或std::cerr ）。

如果编译时定义了QT_NO_DEBUG_OUTPUT ，则该函数不会执行任何操作。

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

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

另请参阅 QDebug::qDebug()、qCDebug()、qInfo()、qWarning()、qCritical()、qFatal()、qInstallMessageHandler(）以及《调试技术》。

qFatal(const char *format, ...)

将致命错误消息format 记录到中央消息处理程序中。format 中可以包含格式指定符，这些指定符将被附加参数中指定的值替换。

示例：

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

如果您使用的是默认消息处理程序，此函数将终止运行以生成核心转储。在 Windows 系统上，对于调试版本，此函数将报告一个 _CRT_ERROR，从而允许您将调试器连接到应用程序。

若要在运行时抑制该输出，请使用qInstallMessageHandler() 设置您自己的消息处理程序。

另请参阅 qCFatal()、qDebug()、qInfo()、qWarning()、qCritical()、qInstallMessageHandler() 以及《调试技术》。

qInfo(const char *format, ...)

将信息消息format 记录到中央消息处理程序中。format 中可以包含格式指定符，这些指定符将被附加参数中指定的值替换。

示例：

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

format 可以包含格式指定符，例如表示 UTF-8 字符串的 `%s `，或表示整数的 `%i `。这与 C 语言中 `printf() ` 函数的工作原理类似。有关格式的更多详细信息，请参阅 `QString::asprintf()`。

为了更方便且支持更多类型，您还可以使用QDebug::qInfo()，该函数遵循流式处理范式（类似于std::cout 或std::cerr ）。

如果编译时定义了 `QT_NO_INFO_OUTPUT `，则该函数不执行任何操作。

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

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

另请参阅 QDebug::qInfo()、qCInfo()、qDebug()、qWarning()、qCritical()、qFatal()、qInstallMessageHandler() 以及“调试技巧”。

qWarning(const char *format, ...)

将警告消息format 记录到中央消息处理程序中。format 中可以包含格式说明符，这些说明符将被附加参数中指定的值替换。

示例：

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

format 可以包含格式指定符，例如用于 UTF-8 字符串的%s ，或用于整数的%i 。这与 C 语言中printf() 函数的工作原理类似。有关格式化的更多详细信息，请参阅QString::asprintf()。

为了更方便并支持更多类型，您还可以使用QDebug::qWarning()，该函数遵循流式处理范式（类似于std::cout 或std::cerr ）。

如果编译时定义了QT_NO_WARNING_OUTPUT ，则该函数不会执行任何操作。若要在运行时抑制输出，您可以设置logging rules 或注册自定义的filter 。

出于调试目的，有时让程序因警告消息而中止会比较方便。这允许您检查核心转储，或附加调试器——另请参阅qFatal()。要启用此功能，请将环境变量QT_FATAL_WARNINGS 设置为一个数字n 。此时，程序将在第 n 个警告时终止。 也就是说，如果该环境变量被设置为 1，程序将在第一次调用时终止；如果其值为 10，则将在第 10 次调用时退出。环境变量中的任何非数值都等同于 1。

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

另请参阅 QDebug::qWarning(),qCWarning(),qDebug(),qInfo(),qCritical(),qFatal(),qInstallMessageHandler()，以及《调试技术》。