Echo

説明

現在のロガーとリスナーにメッセージを出力しします。つまり System.out です(オーバーライドされない限り)。level を指定して、どのロギングレベルでフィルターするか制御できます。

タスクはファイルに出力することもできます。その場合、ファイルに追記するか上書きするかのオプションが利用可能で、level オプションは無視されます。

パラメーター

属性 説明 必須
message 出力するメッセージ。 いいえ。このエレメント内に文字セクションにテキストが含まれていない場合は、空白行
file メッセージを書き込むファイル。 いいえ。これらは 1 つのみ使用可能
output メッセージを書き込む リソースメモを参照してください)。Apache Ant 1.8 以降
append 既存のファイルに追加するか(新しいファイルを開くか既存のファイルをオーバーライド)しますか? いいえ。output がファイルシステム宛先を示す場合のみ考慮され、デフォルトは false
level このメッセージが報告されるレベルを制御します。errorwarninginfoverbosedebug(優先度の高い順)のいずれか いいえ。デフォルトは warning
encoding 使用するエンコーディング。Ant 1.7 以降 いいえ。デフォルトは JVM の既定の文字エンコーディング
force 読み取り専用宛先ファイルを上書きします。Ant 1.8.2 以降 いいえ。デフォルトは false

基本的な使用

<echo message="Hello, world"/>
<echo message="Embed a line break:${line.separator}"/>
<echo>Embed another:${line.separator}</echo>
<echo>This is a longer message stretching over
two lines.
</echo>

<echo> タグの直後に改行があると、それが出力に含まれます。エレメントのコンテンツ内にある文字データの改行は、XML パーサーでは破棄されません。
詳細については、W3C 推奨事項 2008 年 11 月 26 日 / 改行の処理 を参照してください。

<echo>
This is a longer message stretching over
three lines; the first line is a blank
</echo>

-debug モードでのみ表示されるメッセージ。

<echo message="Deleting drive C:" level="debug"/>

-quiet モードでも表示されるメッセージ。

<echo level="error">
Imminent failure in the antimatter containment facility.
Please withdraw to safe location at least 50km away.
</echo>

ファイルに出力してシェルスクリプトを生成します。変数展開時に Ant が単一の $ をフィルタリングしないようにするために、二重の $ 記号が使用されていることに注意してください。

<echo file="runner.csh" append="false">#\!/bin/tcsh
java-1.3.1 -mx1024m ${project.entrypoint} $$*
</echo>

Ant が実行されるログレベルに応じて、メッセージは出力されるか無視されます。

Ant コマンドライン -quiet-q スイッチなし -verbose-v -debug-d
<echo message="This is error message." level="error"/>
ok ok ok ok
<echo message="This is warning message."/>
ok ok ok ok
<echo message="This is warning message." level="warning"/>
ok ok ok ok
<echo message="This is info message." level="info"/>
ログに記録されない ok ok ok
<echo message="This is verbose message." level="verbose"/>
ログに記録されない ログに記録されない ok ok
<echo message="This is debug message." level="debug"/>
ログに記録されない ログに記録されない ログに記録されない ok