<QtLogging> - Qt Logging Types

マクロ・ドキュメント

qCritical(const char *message, ...)

クリティカル・メッセージmessage を持つメッセージ・ハンドラを呼び出します。メッセージ・ハンドラがインストールされていない場合、メッセージは標準エラー出力に出力される。Windows では、メッセージはデバッガに送信されます。QNX では、メッセージは slogger2 に送信されます。

この関数は、Cのprintf()関数と同様に、フォーマット文字列と引数のリストを受け取ります。フォーマットは Latin-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 を持つメッセージ・ハンドラを呼び出します。メッセージ・ハンドラがインストールされていない場合、メッセージは標準エラー出力に出力される。Windows では、コンソール・アプリケーションの場合、メッセージはコンソールに送信されます。QNX では、メッセージは slogger2 に送信されます。コンパイル時にQT_NO_DEBUG_OUTPUT が定義されている場合、この関数は何も行いません。

この関数にフォーマット文字列と引数のリストを渡すと、Cのprintf()関数と同じように動作します。書式はLatin-1文字列でなければならない。

例

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

<QtDebug> を含めると、より便利な構文も利用できる：

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

この構文では、関数はQtDebugMsg メッセージ・タイプを使うように設定されたQDebug オブジェクトを返します。この構文では、 メッセージ・タイプを使用するように設定された オブジェクトを返します。各項目の間には自動的にスペースが 1 つ入り、最後には改行が出力されます。多くのC++とQtの型をサポートしています。

実行時に出力を抑制するには、qInstallMessageHandler() を使用して独自のメッセージ・ハンドラをインストールしてください。

注：このマクロはスレッドセーフです。

qCDebug(),qInfo(),qWarning(),qCritical(),qFatal(),qInstallMessageHandler(),デバッグ技法も参照 。

qFatal(const char *message, ...)

message という致命的なメッセージを持つメッセージ・ハンドラを呼び出します。メッセージ・ハンドラがインストールされていない場合、メッセージは標準エラー出力に出力される。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 。メッセージ・ハンドラがインストー ルされていない場合、メッセージは標準エラー出力に出力される。Windows では、コンソール・アプリケーションの場合、メッセージはコンソールに送信されます。QNX では、メッセージは slogger2 に送信されます。コンパイル時にQT_NO_INFO_OUTPUT が定義されている場合、この関数は何も行いません。

この関数にフォーマット文字列と引数のリストを渡すと、Cのprintf()関数と同じように動作します。書式はLatin-1文字列でなければならない。

例

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

<QtDebug> を含めると、より便利な構文も利用できる：

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

この構文では、関数はQtInfoMsg メッセージ・タイプを使うように設定されたQDebug オブジェクトを返します。この構文では、 メッセージ・タイプを使用するように設定された オブジェクトを返します。各項目の間には自動的にスペースが 1 つ入り、最後には改行が出力されます。多くのC++とQtの型をサポートしています。

実行時に出力を抑制するには、qInstallMessageHandler() を使用して独自のメッセージ・ハンドラをインストールしてください。

注：このマクロはスレッドセーフです。

qCInfo(),qDebug(),qWarning(),qCritical(),qFatal(),qInstallMessageHandler(),デバッグ技法も参照 。

qWarning(const char *message, ...)

警告メッセージmessage を持つメッセージ・ハンドラを呼び出します。メッセージ・ハンドラがインストールされていない場合、メッセージは標準エラー出力に出力される。Windows では、メッセージはデバッガに送信されます。QNX では、メッセージは slogger2 に送信されます。

この関数は、Cのprintf()関数と同様に、フォーマット文字列と引数のリストを受け取ります。フォーマットは Latin-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(),デバッグテクニックも参照してください 。