VC PlusPlus:MSBuild バッチ処理変数 - 版の履歴

Yo-net: /* 項目リストとバッチ処理 */

2024-02-11T14:51:51Z

項目リストとバッチ処理

← 古い版		2024年2月11日 (日) 23:51時点における版
415行目:		415行目:

	とこのように、ドットでタグを指定しないで、同じ行で対応するアイテムグループを@(ItemGroup)のような形式で指定することで出力機能が働くようになります。今回の場合はNumber:%(Number) TextItems1:@(TextItems1) TextItems2:@(TextItems2)のように指定しました。%(Number)だけを指定した出力はできないことに注意して下さい。		とこのように、ドットでタグを指定しないで、同じ行で対応するアイテムグループを@(ItemGroup)のような形式で指定することで出力機能が働くようになります。今回の場合はNumber:%(Number) TextItems1:@(TextItems1) TextItems2:@(TextItems2)のように指定しました。%(Number)だけを指定した出力はできないことに注意して下さい。



			=== '''バッチ処理によるグループ分け''' ===
			以下のようにするとグループ分けが出来ます。


			<syntaxhighlight lang="xml">
			<Project ...>
			<ItemGroup>
			<TextItems1 Include="A\a.txt"><Number>1</Number></TextItems1>
			<TextItems1 Include="A\a.txt"><Number>2</Number></TextItems1>
			<TextItems1 Include="A\c.txt"><Number>3</Number></TextItems1>
			</ItemGroup>
			<Target Name="Test1" AfterTargets="AfterResourceCompile">
			<Message Text="Number:@(TextItems1->'%(Identity) Number:%(Number)')" Condition="'%(Identity)' != ''" />
			</Target>
			</Project>
			</syntaxhighlight>

			出力結果
			<syntaxhighlight lang="text">
			Test1:
			Number:A\a.txt Number:1;A\a.txt Number:2
			Number:A\c.txt Number:3
			</syntaxhighlight>


			という感じで分けることが出来ます。こんな感じで%(Batch)のような形式のバッチ処理はドットで接続して使うか、@(ItemGroup)と合わせて使うか、@(ItemGroup->' %(Batch) ')のシングルクォーテーションの中で使うというような利用をするとしっくり使えると言えます。実際のコンパイル処理で活用できるようにまでなれれば、ややこしいバッチ処理も極めたと言えますね。



	[[VC PlusPlus:MSBuild#関連記事\|VC PlusPlus:MSBuild]]に戻る。		[[VC PlusPlus:MSBuild#関連記事\|VC PlusPlus:MSBuild]]に戻る。

Yo-net: /* 概要 */

2024-02-11T13:51:43Z

概要

差分を表示

Yo-net: /* バッチ処理の定義の基礎 */

2024-02-10T16:08:01Z

バッチ処理の定義の基礎

← 古い版		2024年2月11日 (日) 01:08時点における版
40行目:		40行目:


	しれっと、まだ学習していない@(ItemGroup)という形式のアイテムグループ変数というものを使いましたが、@()内に書かれた名称と同じ名称のタグが対になっていて、参照していると考えて下さい。今回の場合はBatchタグを参照しています。@(Batch->' ')として、シングルクォーテーションの中で使えるバッチ処理変数を記述すると有効に機能するということです。アイテムグループのその中で有効なバッチ処理変数という意味になります。シングルクォーテーションの中でのバッチはセミコロン区切りで一行の文字列として処理されます。単一の値を取り出すときは、%(Batch.Element)のように記載するとバッチ処理をしめすことができます。バッチ処理が保持する複数値の分だけ処理を繰り返されます。Messageタグの中でバッチ処理変数を%(Batch.Element)のように使うと複数行記述される感じの動きになります。Messageタグの中ではドットで接続されたバッチ処理変数名を記述して指定する必要があります。		しれっと、まだ学習していない@(ItemGroup)という形式のアイテムグループ変数というものを使いましたが、@()内に書かれた名称と同じ名称のタグが対になっていて、参照していると考えて下さい。今回の場合はBatchタグを参照しています。@(Batch->' ')として、シングルクォーテーションの中で使えるバッチ処理変数を記述すると有効に機能するということです。アイテムグループのその中で有効なバッチ処理変数という意味になります。シングルクォーテーションの中でのバッチはセミコロン区切りで一行の文字列として処理されます。単一の値を取り出すときは、%(Batch.Element)のように記載するとバッチ処理をしめすことができます。バッチ処理が保持する複数値の分だけ処理を繰り返されます。Messageタグの中でバッチ処理変数を%(Batch.Element)のように使うと複数行記述される感じの動きになります。Messageタグの中では1つの項目(今回の場合、Element要素の親タグはBatchしかない)でリストになっているバッチ処理はドットで接続されたバッチ処理変数名を記述して指定する必要があります。

Yo-net: /* バッチ処理の定義の基礎 */

2024-02-10T15:46:37Z

バッチ処理の定義の基礎

← 古い版		2024年2月11日 (日) 00:46時点における版
38行目:		38行目:

	この時、実は%(Element)だけではなく、%(Identity)というものもBatchの中設定されていてIncludeという要素の値に対応しています。%(Element)がen-USを示す内容のときだけConditionの中で示された比較が成立し、%(ConditionEnUSBatch)もBatchの中にできていて、以下のようにして出力することができます。		この時、実は%(Element)だけではなく、%(Identity)というものもBatchの中設定されていてIncludeという要素の値に対応しています。%(Element)がen-USを示す内容のときだけConditionの中で示された比較が成立し、%(ConditionEnUSBatch)もBatchの中にできていて、以下のようにして出力することができます。


			しれっと、まだ学習していない@(ItemGroup)という形式のアイテムグループ変数というものを使いましたが、@()内に書かれた名称と同じ名称のタグが対になっていて、参照していると考えて下さい。今回の場合はBatchタグを参照しています。@(Batch->' ')として、シングルクォーテーションの中で使えるバッチ処理変数を記述すると有効に機能するということです。アイテムグループのその中で有効なバッチ処理変数という意味になります。シングルクォーテーションの中でのバッチはセミコロン区切りで一行の文字列として処理されます。単一の値を取り出すときは、%(Batch.Element)のように記載するとバッチ処理をしめすことができます。バッチ処理が保持する複数値の分だけ処理を繰り返されます。Messageタグの中でバッチ処理変数を%(Batch.Element)のように使うと複数行記述される感じの動きになります。Messageタグの中ではドットで接続されたバッチ処理変数名を記述して指定する必要があります。

Yo-net: /* ターゲットバッチ処理とバッチ処理の違い */

2024-02-10T15:33:52Z

ターゲットバッチ処理とバッチ処理の違い

← 古い版		2024年2月11日 (日) 00:33時点における版
242行目:		242行目:
	B\		B\
	</syntaxhighlight>		</syntaxhighlight>


	のようになります。同じバッチを使っているので、Aフォルダを処理するTargetとBフォルダを処理するターゲットのように別れましたが、同じ意味を持つ%(TextFiles.RevursiveDir)をMessageタグで使うと2回のTESTが呼び出されますが、別のバッチとして内部でも2回処理しようとします。以下のようなことです。		のようになります。同じバッチを使っているので、Aフォルダを処理するTargetとBフォルダを処理するターゲットのように別れましたが、同じ意味を持つ%(TextFiles.RevursiveDir)をMessageタグで使うと2回のTESTが呼び出されますが、別のバッチとして内部でも2回処理しようとします。以下のようなことです。
267行目:		268行目:
	B\		B\
	</syntaxhighlight>		</syntaxhighlight>


			繰り返し処理のバッチ機能の中で同じバッチを記述したら、その選択されているバッチのみが処理されるということです。このようにバッチ処理というのは深い理解が必要になる複雑な機能であることに注意が必要です。$(Property)のように記述するプロパティ変数の方がシンプルな機能だと言えると思います。



	[[VC PlusPlus:MSBuild#関連記事\|VC PlusPlus:MSBuild]]に戻る。		[[VC PlusPlus:MSBuild#関連記事\|VC PlusPlus:MSBuild]]に戻る。

Yo-net: /* ターゲットバッチ処理とバッチ処理の違い */

2024-02-10T15:29:24Z

ターゲットバッチ処理とバッチ処理の違い

← 古い版		2024年2月11日 (日) 00:29時点における版
233行目:		233行目:
	</Target>		</Target>
	</Project>		</Project>
	</~~syntaxhighlihgt~~>		</syntaxhighlight>

	出力結果		出力結果
256行目:		256行目:
	</Target>		</Target>
	</Project>		</Project>
	</~~syntaxhighlihgt~~>		</syntaxhighlight>

	出力結果		出力結果

Yo-net: /* 概要 */

2024-02-10T15:27:45Z

概要

@@ 163行目: / 163行目: @@
    Batch->BatchPath=[a.txt;b.txt;c.txt]
 </syntaxhighlight>
@@ 189行目: / 188行目: @@
 :　ファイルのフルパスを取得します。
 :　例: @(Compile->'%(FullPath)') は、Compileアイテムのフルパスを取得します。
 [[VC PlusPlus:MSBuild#関連記事|VC PlusPlus:MSBuild]]に戻る。

Yo-net: /* バッチ処理の例外 */

2024-02-10T08:22:20Z

バッチ処理の例外

← 古い版		2024年2月10日 (土) 17:22時点における版
139行目:		139行目:
	BatchItem->BatchPath=[a.txt;b.txt;a.txt]		BatchItem->BatchPath=[a.txt;b.txt;a.txt]
	</syntaxhighlight>		</syntaxhighlight>


			だからといって絶対にTarget内部のItemGroupでバッチ機能を使ってはいけないというわけではなく、以下のように一か所に集約するような使い方をするとうまく動いたりもするので、そういう工夫がわかっている人にはできるというところが、またややこしい。


			<syntaxhighlight lang="xml">
			<Target Name="Test" AfterTargets="AfterResourceCompile">
			<ItemGroup>
			<preBatch Include='a/a.txt' />
			<preBatch Include='b/b.txt' />
			<preBatch Include='c/c.txt' />
			<Batch Include='@(preBatch)' BatchPath="%(Filename)%(Extension)" />
			</ItemGroup>
			<Message Text="Batch=[@(Batch)]" Importance='High' />
			<Message Text="Batch->BatchPath=[@(Batch->'%(BatchPath)')]" Importance='High' />
			</Target>
			</syntaxhighlight>

			出力結果

			<syntaxhighlight lang="text">
			Batch=[a/a.txt;b/b.txt;c/c.txt]
			Batch->BatchPath=[a.txt;b.txt;c.txt]
			</syntaxhighlight>

Yo-net: /* 概要 */

2024-02-10T07:54:43Z

概要

@@ 139行目: / 139行目: @@
    BatchItem->BatchPath=[a.txt;b.txt;a.txt]
 </syntaxhighlight>
 [[VC PlusPlus:MSBuild#関連記事|VC PlusPlus:MSBuild]]に戻る。

Yo-net: /* 概要 */

2024-02-10T07:36:45Z

概要

← 古い版		2024年2月10日 (土) 16:36時点における版
84行目:		84行目:

	このように、%(Batch.Element)とすると、バッチ処理の機能が働き、その要素の分だけメッセージ出力処理が繰り返されます。@(Batch->' ')の中にバッチがあった時はその中のメッセージが;区切りで繰り返される感じになります。		このように、%(Batch.Element)とすると、バッチ処理の機能が働き、その要素の分だけメッセージ出力処理が繰り返されます。@(Batch->' ')の中にバッチがあった時はその中のメッセージが;区切りで繰り返される感じになります。



			=== '''バッチ処理の例外''' ===
			以下のようにTarget内で定義したItemGroupでバッチを呼び出しても評価順序が正しくないため思い通りの結果は得られません。ちゅういして使いましょうとマイクロソフトのWebsiteに記載されていたので、そこは注意したいですね。


			<syntaxhighlight lang="xml">
			<Target Name="Test" AfterTargets="AfterResourceCompile">
			<ItemGroup>
			<BatchItem Include='a/a.txt' BatchPath='%(Filename)%(Extension)' />
			<BatchItem Include='a/b.txt' BatchPath='%(Filename)%(Extension)' />
			<BatchItem Include='b/a.txt' BatchPath='%(Filename)%(Extension)' />
			</ItemGroup>
			<Message Text="BatchItem=[@(i)]" Importance='High' />
			<Message Text="BatchItem->Include=[@(BatchItem->'%(Identity)')]" Importance='High' />
			<Message Text="BatchItem->BatchPath=[@(BatchItem->'%(BatchPath)')]" Importance='High' />
			</Target>
			</syntaxhighlight>

			実行結果

			<syntaxhighlight lang="text">
			BatchItem=[a/a.txt;a/b.txt;b/a.txt;b/a.txt]
			BatchItem->Include=[a/a.txt;a/b.txt;b/a.txt;b/a.txt]
			BatchItem->BatchPath=[;b.txt;a.txt;a.txt]
			</syntaxhighlight>


			%(Filename)や%(Extension)ように、定義しなくても使えるバッチというのもあります。が、上記のように、Targetの中でバッチを使うとまだ評価されていないだとかスコープだとかの都合で動作が保証されず思い通りの結果は得られません。


			以下のようにすると期待していたものに近い結果が得られます。


			<syntaxhighlight lang="xml">
			<ItemGroup>
			<BatchItem Include='a/a.txt' BatchPath='%(Filename)%(Extension)' />
			<BatchItem Include='a/b.txt' BatchPath='%(Filename)%(Extension)' />
			<BatchItem Include='b/a.txt' BatchPath='%(Filename)%(Extension)' />
			</ItemGroup>
			<Target Name="Test" AfterTargets="AfterResourceCompile">
			<Message Text="BatchItem=[@(BatchItem)]" Importance='High' />
			<Message Text="BatchItem->Include=[@(BatchItem->'%(Identity)')]" Importance='High' />
			<Message Text="BatchItem->BatchPath=[@(BatchItem->'%(BatchPath)')]" Importance='High' />
			</Target>
			</syntaxhighlight>

			実行結果

			<syntaxhighlight lang="text">
			BatchItem=[a/a.txt;a/b.txt;b/a.txt]
			BatchItem->Include=[a/a.txt;a/b.txt;b/a.txt]
			BatchItem->BatchPath=[a.txt;b.txt;a.txt]
			</syntaxhighlight>



	[[VC PlusPlus:MSBuild#関連記事\|VC PlusPlus:MSBuild]]に戻る。		[[VC PlusPlus:MSBuild#関連記事\|VC PlusPlus:MSBuild]]に戻る。