1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
|
// Copyright (C) 2025 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only WITH Qt-GPL-exception-1.0
#region Task TaskName="Join"
#region Using
using System;
using System.Collections.Generic;
using System.Linq;
using Microsoft.Build.Framework;
using Microsoft.Build.Utilities;
#endregion
#region Comment
/////////////////////////////////////////////////////////////////////////////////////////////////
/// TASK Join
/////////////////////////////////////////////////////////////////////////////////////////////////
// Combines two lists of items into a single list containing items with common metadata values.
// Example:
// INPUT:
// Left = <LeftItem><X>foo</X><Y>42</Y></LeftItem>
// <LeftItem><X>sna</X><Y>99</Y></LeftItem>
// <LeftItem><X>bar</X><Y>3.14159</Y></LeftItem>
// Right = <RightItem><Z>foo</Z><Y>99</Y></RightItem>
// <RightItem><Z>sna</Z><Y>2.71828</Y></RightItem>
// <RightItem><Z>bar</Z><Y>42</Y></RightItem>
// <RightItem><Z>bar</Z><Y>99</Y></RightItem>
// OUTPUT:
// Result = <Item><X>foo</X><Y>42</Y><Z>bar</Z></Item>
// <Item><X>sna</X><Y>99</Y><Z>foo</Z></Item>
// <Item><X>sna</X><Y>99</Y><Z>bar</Z></Item>
// Parameters:
// in ITaskItem[] LeftItems: first list of items to join
// in ITaskItem[] RightItems: second list of items to join
// out ITaskItem[] Result: resulting list of items with common metadata
// optional in string[] On: join criteria, list of names of metadata to match in both
// input lists; all metadata in the criteria must be matched;
// by default, %(Identity) will be used as criteria; the
// special value 'ROW_NUMBER' will match the position of items
// (i.e. items with the same index in each input list).
#endregion
namespace QtVsTools.QtMsBuild.Tasks
{
public static class Join
{
public static bool Execute(
#region Parameters
Microsoft.Build.Framework.ITaskItem[] LeftItems,
Microsoft.Build.Framework.ITaskItem[] RightItems,
out Microsoft.Build.Framework.ITaskItem[] Result,
System.String[] On = null)
#endregion
{
#region Code
Result = new ITaskItem[] { };
var resultItems = new List<ITaskItem>();
List<string> matchFields = null;
if (On != null)
matchFields = new List<string>(On);
if (matchFields == null || !matchFields.Any())
matchFields = new List<string> { "Identity" };
var reserved = new HashSet<string>
{
"AccessedTime", "CreatedTime", "DefiningProjectDirectory",
"DefiningProjectExtension", "DefiningProjectFullPath", "DefiningProjectName",
"Directory", "Extension", "Filename", "FullPath", "Identity", "ModifiedTime",
"RecursiveDir", "RelativeDir", "RootDir"
};
for (int leftRowNum = 0; leftRowNum < LeftItems.Length; leftRowNum++) {
for (int rightRowNum = 0; rightRowNum < RightItems.Length; rightRowNum++) {
var leftItem = LeftItems[leftRowNum];
var rightItem = RightItems[rightRowNum];
bool match = true;
foreach (string field in matchFields) {
if (string.Equals(field, "ROW_NUMBER", StringComparison.OrdinalIgnoreCase)) {
match = leftRowNum == rightRowNum;
} else {
string leftField = leftItem.GetMetadata(field);
string rightField = rightItem.GetMetadata(field);
match = string.Equals(leftField, rightField, StringComparison.OrdinalIgnoreCase);
}
if (!match)
break;
}
if (match) {
var resultItem = new TaskItem(leftItem.ItemSpec);
foreach (string rightMetadata in rightItem.MetadataNames) {
if (!reserved.Contains(rightMetadata)) {
var metadataValue = rightItem.GetMetadata(rightMetadata);
if (!string.IsNullOrEmpty(metadataValue))
resultItem.SetMetadata(rightMetadata, metadataValue);
}
}
foreach (string leftMetadata in leftItem.MetadataNames) {
if (!reserved.Contains(leftMetadata)) {
var metadataValue = leftItem.GetMetadata(leftMetadata);
if (!string.IsNullOrEmpty(metadataValue))
resultItem.SetMetadata(leftMetadata, metadataValue);
}
}
resultItems.Add(resultItem);
}
}
}
Result = resultItems.ToArray();
#endregion
return true;
}
}
}
#endregion
|