<QtLogging> - Qt 日志类型

宏文档

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;

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

要抑制运行时的输出，可以定义日志规则或注册自定义的过滤器。

对于调试目的，有时需要让程序在严重消息时终止，这样就可以检查核心转储或附加调试器 - 请参阅qFatal。要启用此功能，将环境变量QT_FATAL_CRITICALS设置为数字n。程序将在第n次严重消息时终止。也就是说，如果环境变量设置为1，则第一次调用时终止；如果包含值为10，则在第十次调用时退出。环境变量中的任何非数值值都相当于1。

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

参见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()安装您自己的消息处理程序。

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

另请参阅 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()安装您自己的消息处理程序。

另请参阅 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;

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

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

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

另请参阅 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，则此函数不执行任何操作。要在运行时抑制输出，您可以设置 记录规则 或注册自定义 过滤器。

出于调试目的，有时出于方便，程序会终止警告消息。这允许您检查核心转储或附加调试器 - 参见 qFatal。为了启用此功能，将环境变量 QT_FATAL_WARNINGS 设置为数字 n。然后程序会在第 n 次警告时终止。也就是说，如果环境变量设置为 1，则在第一次调用时终止；如果包含值 10，则在第十次调用时退出。环境变量中的任何非数字值都与 1 等效。

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

另请参阅 qDebug()、qInfo()、qCritical()、qFatal()、qInstallMessageHandler() 以及 调试技巧。