格式化用法示例

本主题中的例子未与特定命令绑定。

数据描述示例中用作输出的对象和特性。在下面的示例中,数据分为四列:displaynametask_synopsisownerrelease

101  Fix defect M#1234                  fred   1.0
102  Implement sorting                  joe    1.0
900  Fix defect M#12345                 susan  1.0
901  Implement date formatting          john   1.0_patch
1000 Fix defect M#1357                  fred   1.1
1001 Fix defect M#6523                  fred   1.1
1002 Implement new property formats     susan  2.0
1003 Add grouping and extending sorting joe    2.0
1004 Fix defect J#1234                  susan  1.1
1005 Extend grouping feature            john   2.0
在下面的示例中,数据未进行编号 (-u) 和排序 (-nosort),因此,输出按照数据原始顺序显示。-format 值将数据分为四列:displaynametask_synopsisownerrelease。 由于未使用 -noformat,所以列进行对齐。
-u -nosort -format "%displayname %task_synopsis %owner %release"

101  Fix defect M#1234                  fred   1.0
102  Implement sorting                  joe    1.0
900  Fix defect M#12345                 susan  1.0
901  Implement date formatting          john   1.0_patch
1000 Fix defect M#1357                  fred   1.1
1001 Fix defect M#6523                  fred   1.1
1002 Implement new property formats     susan  2.0
1003 Add grouping and extending sorting joe    2.0
1004 Fix defect J#1234                  susan  1.1
1005 Extend grouping feature            john   2.0
下面的示例显示缺省情况下输出编号。 该示例还显示以下信息:
  • 格式字符串定义两个列:displaynametask_synopsis
  • 分组使用引用 owner 特性的格式。
  • release 值升序排列。release 值不显示在输出中,但仅用于排序。排列顺序将 owner 作为升序主键使用(分组优先),而将 release 作为升序辅键使用。
  • 将包含相同所有者值的对象分在同一分组集标题下。
  • 将显示列标题。
-format "%displayname %task_synopsis" -groupby "Owner: %owner" -sortby +release -column_headers

Owner: fred 
1) 101   Fix defect M#1234 
2) 1000  Fix defect M#1357 
3) 1001  Fix defect M#6523

Owner: joe 
4) 102   Implement sorting
5) 1003  Add grouping and extending sorting

Owner: john 
6) 901   Implement date formatting
7) 1005  Extend grouping feature

Owner: susan
8) 900   Fix defect M#12345
9) 1004  Fix defect J#1234
10)1002  Implement new property formats
下面的示例显示缺省情况下输出编号。 格式字符串定义三个列:displaynametask_synopsisreleasetask_synopsis 值在 20 个字符后截断。按照 owner(这是一个不显示的特性)升序排序,然后按照 release 排序。
-format "%displayname %{task_synopsis[truncate=20]} %release"
-sortby +owner+release

1) 101   Fix defect M#1234     1.0
2) 1000  Fix defect M#1357     1.1
3) 1001  Fix defect M#6523     1.1 
4) 102   Implement sorting     1.0 
5) 1003  Add grouping and ...  2.0 
6) 901   Implement date fo...  1.0_patch 
7) 1005  Extend grouping f...  2.0 
8) 900   Fix defect M#12345    1.0 
9) 1004  Fix defect J#1234     1.1 
10)1002  Implement new pro...  2.0
如果想要在 20 个字符后将文本换行而不是截断,您可以将 wrap=20 替换为 truncate=20,输出将如以下输出中所示:
1) 101   Fix defect M#1234        1.0
2) 1000  Fix defect M#1357        1.1 
3) 1001  Fix defect M#6523        1.1 
4) 102   Implement sorting        1.0 
5) 1003  Add grouping and ext     2.0 
         ending sorting
6) 901   Implement date forma     1.0_patch
         tting 
7) 1005  Extend grouping feat     2.0 
         ure
8) 900   Fix defect M#12345       1.0 
9) 1004  Fix defect J#1234        1.1 
10)1002  Implement new proper     2.0
         ty formats

反馈