General messages¶
message( "message text" ...)
指定したメッセージテキストをログに記録します。
オプションの<mode>キーワードはメッセージのタイプを決定し、メッセージの処理方法に影響を与えます:
FATAL_ERROR
CMakeエラー、処理と生成を停止します。
SEND_ERROR
CMake Error, 処理を継続するが、生成をスキップします。
WARNING
CMake Warning, 処理を継続します。
AUTHOR_WARNING
CMake Warning (dev), 処理を継続します。
DEPRECATION
CMake Deprecation Error or Warning if variableCMAKE_ERROR_DEPRECATED or CMAKE_WARN_DEPRECATED is enabled, respectively, else no message.
(none) or NOTICE
ユーザーの注意を引くために stderr に重要なメッセージが出力されました。
STATUS
プロジェクト・ユーザが興味を持ちそうな主なメッセージ。理想的には、これらは1行以下の簡潔なものであるべきですが、それでも情報的です。
VERBOSE
プロジェクト・ユーザ向けの詳細な情報メッセージ。
DEBUG
プロジェクトを構築したいだけのユーザーではなく、プロジェクト自体に取り組んでいる開発者を対象とした詳細な情報メッセージ。 これらのメッセージは、通常、プロジェクトを構築している他のユーザーの興味を引くことはなく、多くの場合、内部実装の詳細に密接に関連します。
TRACE
非常に低レベルの実装の詳細を含む詳細なメッセージ。 このログレベルを使用するメッセージは、通常、一時的なもので、プロジェクトをリリースし、ファイルをパッケージ化する前に削除されることが期待されます。 その他のメッセージタイプは標準エラー出力に送られ、ハイフンは付きません。 curses interface は STATUS から TRACE までのメッセージを一度にステータス行に表示し、その他のメッセージは対話式のポップアップ・ボックスに表示します。 これらのツールのそれぞれに対する --log-level コマンドライン オプションは、どのメッセージが表示されるかを制御するために使用できます。
3.17 版での新機能: CMake の実行間でログレベルを持続させるために、代わりに CMAKE_MESSAGE_LOG_LEVEL 変数を設定することが可能です。
New in version 3.16: ログレベル NOTICE 以下のメッセージは、各行の前に CMAKE_MESSAGE_INDENT 変数の内容 (リストアイテムを連結することにより単一の文字列に変換) を持つようになりました。
New in version 3.17: ログレベルNOTICE以下のメッセージは、各行の前にのようなコンテキストを持つことができます。 角括弧の間の内容は、CMAKE_MESSAGE_CONTEXTlist 変数をドットで区切られた文字列に変換することで得られます。 メッセージコンテキストは、常にインデントされたコンテンツの前に表示され、自動的に追加されたリーディングハイフンの後に表示されます。 デフォルトでは、メッセージコンテクストは表示されず、 cmake --log-context コマンドラインオプションを与えるか、 CMAKE_MESSAGE_CONTEXT_SHOW 変数を true に設定することにより、明示的に有効にする必要がある。
CMake の警告およびエラー メッセージのテキストは、シンプルなマークアップ言語を使って表示されます。 インデントされていないテキストは、改行で区切られた行でラップされた段落で書式設定されます。 インデントされたテキストは、あらかじめフォーマットされているとみなされます。