<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()、および「デバッグ手法」。