git-for-each-ref - 云端在线

程序：

您的姓名

git-for-each-ref - 每个 ref 的输出信息

概要

混帐 每个参考 [--计数= ] [--shell|--perl|--python|--tcl]
[(--排序= )...] [--格式= ] [ ...]
[--点在] [(--merged | --no-merged) [ ]]
[--包含 [ ]]

商品描述

迭代所有匹配的引用并根据给定的显示它们,
根据给定的集合对它们进行排序后. 如果给出，停止后
显示很多参考。 中的插值可以选择引用为
指定宿主语言中的字符串文字，允许在该语言中直接求值
语言。

配置

默认情况下，该命令显示所有匹配的引用. 此选项使其停止
在展示了那么多参考文献之后。


要排序的字段名称。 前缀 - 按值的降序排序。 什么时候
未指定，使用 refname。 您可以使用 --sort= 多次选择，在
在这种情况下，最后一个键成为主键。


从 ref 指向的对象插入 %(fieldname) 的字符串是
显示。 如果 fieldname 以星号 (*) 为前缀并且 ref 指向标记
对象，使用对象标记中字段的值引用。 未指定时，
默认为 %(objectname) SPC %(objecttype) TAB %(refname)。 它还将 %% 插入到
%, 和 %xx 其中 xx 是十六进制数字插入到具有十六进制代码 xx 的字符； 为了
例如 %00 插入到 \0 (NUL)，%09 插入到 \t (TAB) 和 %0a 插入到 \n (LF)。

...
如果给出了一个或多个模式，则只显示与至少一个匹配的参考
模式，要么使用 匹配(3) 或字面上，在后一种情况下完全匹配
或者从头到斜线。

--shell，--perl，--python，--tcl
如果给定，则替换 %(fieldname) 占位符的字符串被引用为字符串
适用于指定宿主语言的文字。 这是为了产生一个
可以直接进行“评估”的 scriptlet。

--指向
只列出指向给定对象的引用。

--合并 [ ]
仅列出可从指定提交访问其提示的引用（如果不是，则为 HEAD
指定的）。

--未合并 [ ]
仅列出无法从指定提交访问其提示的引用（如果不是，则为 HEAD
指定的）。

-- 包含 [ ]
仅列出包含指定提交的标签（如果未指定，则为 HEAD）。

领域 名字

引用对象中结构化字段的各种值可用于插值
到结果输出中，或作为排序键。

对于所有对象，可以使用以下名称：

参考名称
引用的名称（$GIT_DIR/ 之后的部分）。 对于一个明确的短名称
参考附加：短。 选项 core.warnAmbiguousRefs 用于选择严格的
缩写模式。 如果条带= 附加，条带斜线分隔的路径
refname 前面的组件（例如，%(refname:strip=2) 变成 refs/tags/foo
进入 foo. 必须是正整数。 如果显示的参考具有较少的组件
比，命令因错误而中止。

对象类型
对象的类型（blob、tree、commit、tag）。

对象大小
对象的大小（与 混帐 猫文件 -s 报告）。

对象名
对象名称（又名 SHA-1）。 对于对象名称的明确缩写
追加：简短。

上游
本地引用的名称，可以被认为是显示引用的“上游”。
尊重 :short 与上面的 refname 相同。 另外尊重 :track to show
"[ahead N, behind M]" 和 :trackshort 显示简洁版本：">" (ahead), "<"
（后面）、“<>”（前后）或“=”（同步）。 如果 ref 没有，则无效
有与之相关的跟踪信息。

推
本地 ref 的名称，表示显示的 ref 的 @{push} 位置。
像上游一样尊重 :short、:track 和 :trackshort 选项。 产生一个空
如果没有配置@{push} ref，则为字符串。

目
* 如果 HEAD 匹配当前 ref（检出的分支），则为 ' ' 否则。

颜色
更改输出颜色。 其次是 ： ，其中名称在
颜色.分支.*。

对齐
左、中或右对齐 %(align:...) 和 %(end) 之间的内容。 这
“对齐：”后跟和以逗号分隔的任何顺序，
哪里为左、右或中，默认为左和
是对齐的内容的总长度。 如果内容长度超过
宽度然后不执行对齐。 如果与 - 引用 两者之间的一切
%(align:...) 和 %(end) 被引用，但如果嵌套则只有最顶层执行
引用。

除了上述之外，对于提交和标记对象，头字段名称（树、
parent、object、type 和 tag）可用于指定标头字段中的值。

对于 commit 和 tag 对象，特殊的 creatordate 和 creator 字段将对应
来自提交者或标记者字段的适当日期或姓名-电子邮件-日期元组
取决于对象类型。 这些旨在处理带注释的和
轻量级标签。

具有名称-电子邮件-日期元组作为其值的字段（作者、提交者和标记者）可以是
以名称、电子邮件和日期为后缀以提取命名组件。

提交和标记对象中的完整消息是内容。 它的第一行是
内容：主题，其中主题是提交消息的所有行的串联
到第一个空行。 下一行是 内容：正文, 其中 body 是所有的线
在第一个空行之后。 可选的 GPG 签名是 contents:signature。 第一个 N
消息的行是使用 contents:lines=N 获得的。

出于排序目的，具有数值的字段按数字顺序排序（对象大小、
作者日期、提交者日期、创建者日期、标记日期）。 所有其他字段用于排序
它们的字节值顺序。

还有一个按版本排序的选项，这可以通过使用字段名来完成
version:refname 或其别名 v:refname。

在任何情况下，引用字段的字段名称不适用于所引用的对象
ref 不会导致错误。 它返回一个空字符串。

作为日期类型字段的特殊情况，您可以通过以下方式指定日期格式
添加：后跟日期格式名称（请参阅 --date 选项的值 :git-rev-
名单（1）采取）。

示例

直接生成格式化文本的示例。 显示最近的 3 个标记提交：

#!/ bin / sh的

git for-each-ref --count=3 --sort='-*authordate' \
--format='From: %(*authorname) %(*authoremail)
主题：%(*主题)
日期：%(*作者日期)
参考：%(*refname)

％（*身体）
''参考/标签'

一个简单的例子，展示了在输出上使用 shell eval，演示了使用
- 贝壳。 列出所有头的前缀：

#!/ bin / sh的

git for-each-ref --shell --format="ref=%(refname)" refs/heads | \
在阅读条目时
do
评估“$条目”
echo `目录名 $ref`
完成

关于标签的更详细的报告，证明格式可能是一个完整的
脚本：

#!/ bin / sh的

fmt=”
r=%(参考名称)
t=%(*对象类型)
T=${r#refs/tags/}

o=%(*对象名)
n=%(*作者姓名)
e=%(*作者邮箱)
s=%(*主题)
d=%(*作者日期)
b=%(*身体)

种类=标签
如果测试 "z$t" = z
然后
# 可以是轻量级标签
t=%(对象类型)
kind="轻量级标签"
o=%(对象名)
n=%(作者名)
e=%(作者邮箱)
s=%（主题）
d=%(作者日期)
b=%（体）
fi
echo "$kind $T 指向一个 $t 对象 $o"
如果测试 "z$t" = zcommit
然后
echo "提交的作者是 $n $e
在 $d，标题为

$s

它的消息是这样的：
"
回声 "$b" | sed -e "s/^/ /"
回音
fi
'

eval=`git for-each-ref --shell --format="$fmt" \
--sort='*对象类型' \
--排序=-标记日期\
参考/标签`
评估“$eval”

使用 onworks.net 服务在线使用 git-for-each-ref