$ echo ABCDEFG | teip -c 1,3,5,7
[A]B[C]D[E]F[G]

$ echo ABCDEFG | teip -c 1,3,5,7 -- sed 's/./@/'
@B@D@F@

与 -f 相同，-c 的参数与 cut 的 列表 兼容。

处理定界文本，如 CSV、TSV

默认情况下，-f 选项识别与 awk 类似的定界字段。

连续的空白字符（由 Unicode 分类为各种空白形式）被解释为单个定界符。

$ printf "A       B \t\t\t\   C \t D" | teip -f 3 -- sed s/./@@@@/
A       B                       @@@@   C         D

这种行为可能不方便处理 CSV 和 TSV。

但是，可以与 -f 一起使用 -d 选项来指定定界符。现在您可以像这样处理 CSV 文件。

$ echo "100,200,300,400" | teip -f 3 -d , -- sed 's/./@/g'
100,200,@@@,400

为了处理 TSV，需要输入制表符。如果您使用 Bash，请输入 $'\t'，这是 ANSI-C 引用 之一。

$ printf "100\t200\t300\t400\n" | teip -f 3 -d $'\t' -- sed 's/./@/g'
100     200     @@@     400

teip 还提供了 -D 选项，可以指定扩展正则表达式作为定界符。当您想忽略连续的定界符或存在多种类型的定界符时，这很有用。

$ echo 'A,,,,,B,,,,C' | teip -f 2 -D ',+'
A,,,,,[B],,,,C

$ echo "1970-01-02 03:04:05" | teip -f 2-5 -D '[-: ]'
1970-[01]-[02] [03]:[04]:05

也可以使用 -D 选项指定制表符（\t）的正则表达式。

$ printf "100\t200\t300\t400\n" | teip -f 3 -D '\t' -- sed 's/./@/g'
100     200     @@@     400

有关正则表达式的可用表示法，请参阅 Rust 的正则表达式。

复杂的 CSV 处理

如果您想处理复杂的 CSV 文件，例如下面这样的文件，其中列被双引号包围，请同时使用 -f 和 --csv 选项。

Name,Address,zipcode
Sola Harewatar,"Doreami Road 123
Sorashido city",12877
Yui Nagomi,"Nagomi Street 456, Nagomitei, Oishina town",26930-0312
"Conectol Motimotit Hooklala Glycogen Comex II a.k.a ""Kome kome""","Cooking dam",513123

使用 --csv，teip 将输入解析为根据 RFC4180 的 CSV 文件。因此，您可以使用 -f 为结构复杂的 CSV 文件指定列号。

例如，前面提到的 CSV 将如下所示有“空隙”。

$ cat tests/sample.csv | teip --csv -f2 
Name,[Address],zipcode
Sola Harewatar,["Doreami Road 123]
[Sorashido city"],12877
Yui Nagomi,["Nagomi Street 456, Nagomitei, Oishina town"],26930-0312
"Conectol Motimotit Hooklala Glycogen Comex II a.k.a ""Kome kome""",["Cooking dam"],513123

因为指定了 -f2，所以每行的第二列都有一个空隙。以下命令是重写第二列所有字符为 "@ " 的示例。

$ cat tests/sample.csv  | teip --csv -f2 -- sed 's/[^"]/@/g'
Name,@@@@@@@,zipcode
Sola Harewatar,"@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@",12877
Yui Nagomi,"@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@",26930-0312
"Conectol Motimotit Hooklala Glycogen Comex II a.k.a ""Kome kome""","@@@@@@@@@@@",513123

--csv 选项说明

• 字段周围的双引号（"）也包含在空隙中。
• 转义的双引号（""）按原样处理；两个双引号（""）被作为输入传递给目标命令。
• 包含换行符的字段将具有多个空隙，由换行符分隔，而不是单个空隙。
  • 但是，如果使用了 -s 或 -z 选项，它将被视为单个空隙，包括行中断。

与正则表达式匹配

您还可以使用 -g 选择匹配正则表达式的特定行作为空隙位置。

$ echo -e "ABC1\nEFG2\nHIJ3" | teip -g '[GJ]\d'
ABC1
[EFG2]
[HIJ3]

默认情况下，包含模式的整个行是空隙的范围。使用 -o 选项，空隙范围将仅限于匹配范围。

$ echo -e "ABC1\nEFG2\nHIJ3" | teip -og '[GJ]\d'
ABC1
EF[G2]
HI[J3]

请注意，-og 是一个有用的惯用表达式，在本文档中经常使用。

以下是一个使用 \d 匹配数字的例子。

$ echo ABC100EFG200 | teip -og '\d+'
ABC[100]EFG[200]

$ echo ABC100EFG200 | teip -og '\d+' -- sed 's/.*/@@@/g'
ABC@@@EFG@@@

这个功能非常灵活，可以用于处理没有固定格式的文件，例如日志、Markdown 等。

哪些命令是合适的？

teip 逐行绕过整个字符串，因此每个孔是一行输入。因此，目标命令必须遵循以下规则。

• 目标命令必须为每一行输入打印一行结果。

在最简单的例子中，cat 命令总是成功。因为 cat 打印与输入相同的行数。

$ echo ABCDEF | teip -og . -- cat
ABCDEF

如果上述规则不满足，结果将不一致。例如，grep 可能会失败。以下是一个例子。

$ echo ABCDEF | teip -og .
[A][B][C][D][E][F]

$ echo ABCDEF | teip -og . -- grep '[ABC]'
ABC
teip: Output of given command is exhausted

$ echo $?
1

teip 无法获取与 D、E 和 F 孔相对应的结果。这就是为什么上述示例失败的原因。

如果发生不一致，teip 将以错误消息退出。此外，退出状态将为 1。

要了解有关 teip 行为的更多信息，请参阅 Wiki > Chunking。

高级用法

固态模式（-s）

如果您想使用不满足条件（“目标命令必须为每一行输入打印一行结果”）的命令，请启用“固态模式”，该模式可以通过 -s 选项使用。

固态模式为每个孔启动目标命令并执行它。

$ echo ABCDEF | teip -s -og . -- grep '[ABC]'

在上面的例子中，了解以下命令是在 teip 的内部过程执行的。

$ echo A | grep '[ABC]' # => A
$ echo B | grep '[ABC]' # => B
$ echo C | grep '[ABC]' # => C
$ echo D | grep '[ABC]' # => Empty
$ echo E | grep '[ABC]' # => Empty
$ echo F | grep '[ABC]' # => Empty

空结果被替换为空字符串。因此，D、E 和 F 如预期的那样被替换为空。

$ echo ABCDEF | teip -s -og . -- grep '[ABC]'
ABC

$ echo $?
0

然而，由于其高处理开销，这个选项不适合处理大文件，这可能会显着降低性能。

带有 --chomp 的固态模式

如果 -s 选项没有按预期工作，--chomp 可能会有所帮助。

固态模式下的目标命令始终接受带有行字段（\x0A）的输入。这是因为 teip 假设使用命令，这些命令对单行输入返回单行结果。因此，即使孔中没有换行符，也会添加换行符，将其视为单行输入。

但是，有时这种行为不方便。例如，当使用其行为取决于行字段存在与否的命令时。

$ echo AAABBBCCC | teip -og BBB -s
AAA[BBB]CCC
$ echo AAABBBCCC | teip -og BBB -s -- tr '\n' '@'
AAABBB@CCC

以上是一个目标命令是“将行字段（\x0A）转换为 @”的“tr”命令的例子。“BBB”不包含换行符，但结果为“BBB@”，因为隐式添加的换行符已被处理。为了防止这种行为，请使用 --chomp 选项。此选项为目标命令提供不带换行符的纯输入。

$ echo AAABBBCCC | teip -og BBB -s --chomp -- tr '\n' '@'
AAABBBCCC

例如，当使用像 tr 这样的命令，将其解释和处理为二进制时，这很有用。以下是从包含换行符的 CSV 的第二列中删除换行符的例子。

$ cat tests/sample.csv
Name,Address,zipcode
Sola Harewatar,"Doreami Road 123
Sorashido city",12877

结果是。

$ cat tests/sample.csv | teip --csv -f 2 -s --chomp -- tr '\n' '@'
Name,Address,zipcode
Sola Harewatar,"Doreami Road 123@Sorashido city",12877

行号（-l）

您可以指定行号，并且仅在该行钻洞。

$ echo -e "ABC\nDEF\nGHI" | teip -l 2
ABC
[DEF]
GHI

$ echo -e "ABC\nDEF\nGHI" | teip -l 1,3
[ABC]
DEF
[GHI]

重叠 teip

任何命令都可以与 teip 一起使用，令人惊讶的是，甚至是 teip 本身。

$ echo "AAA@@@@@AAA@@@@@AAA" | teip -og '@.*@'
AAA[@@@@@AAA@@@@@]AAA

$ echo "AAA@@@@@AAA@@@@@AAA" | teip -og '@.*@' -- teip -og 'A+'
AAA@@@@@[AAA]@@@@@AAA

$ echo "AAA@@@@@AAA@@@@@AAA" | teip -og '@.*@' -- teip -og 'A+' -- tr A _
AAA@@@@@___@@@@@AAA

换句话说，通过将多个teip功能与AND条件连接，可以在更复杂的范围内打孔。此外，它以异步和多进程方式工作，类似于shell管道。除非机器面临并行性的极限，否则几乎不会降低性能。

Oniguruma正则表达式（-G）

如果同时给出了-G和-g选项，则正则表达式被解释为Oniguruma正则表达式。例如，可以使用“保留”和“前瞻”语法。

$ echo 'ABC123DEF456' | teip -G -og 'DEF\K\d+'
ABC123DEF[456]

$ echo 'ABC123DEF456' | teip -G -og '\d+(?=D)'
ABC[123]DEF456

空孔

当使用-f选项时，如果存在空白字段，则空白不会忽略并被视为一个空孔。

$ echo ',,,' | teip -d , -f 1-
[],[],[],[]

因此，以下命令可以正常工作（注意，*也匹配空值）。

$ echo ',,,' | teip -f 1- -d, sed 's/.*/@@@/'
@@@,@@@,@@@,@@@

$ echo 1 2 3 4 5 | teip -v -f 1,3,5 -- sed 's/./_/'
1 _ 3 _ 5

$ printf 'AAA\n123\nBBB\n' | teip -vg '\d+' -- sed 's/./@/g'
@@@
123
@@@

$ printf '111,\n222,33\n3\0\n444,55\n5,666\n' | teip -z -f3 -d,
111,
222,[33
3]
444,55
5,[666]

$ printf '111,\n222,33\n3\0\n444,55\n5,666\n' | teip -z -f3 -d, -- sed -z 's/.*/@@@/g'
111,
222,@@@
444,55
5,@@@

$ printf '111,\n222,33\n3\0\n444,55\n5,666\n' | teip -z -f3 -d, -- sed 's/.*/@@@/g'
111,
222,@@@
@@@
444,55
5,teip: Output of given command is exhausted

$ cat test.html | teip -z -og '<body>.*</body>'
<html>
<head>
  <title>AAA</title>
</head>
[<body>
  <div>AAA</div>
  <div>BBB</div>
  <div>CCC</div>
</body>]
</html>

$ cat test.html | teip -z -og '<body>.*</body>' -- grep -a BBB
<html>
<head>
  <title>AAA</title>
</head>
  <div>BBB</div>
</html>

$ echo -e 'AAA\nBBB\nCCC' | teip -e 'echo 3'
AAA
BBB
[CCC]

$ echo -e 'AAA\nBBB\nCCC' | teip -e 'echo " 3"'
AAA
BBB
[CCC]
$ echo -e 'AAA\nBBB\nCCC' | teip -e 'echo " 3:testtest"'
AAA
BBB
[CCC]

$ seq 1 2 10
1
3
5
7
9

$ echo -e 'AAA\nBBB\nCCC\nDDD\nEEE\nFFF' | teip -e 'seq 1 2 10' -- sed 's/. /@/g'
@@@
BBB
@@@
DDD
@@@
FFF

$ echo -e 'AAA\nBBB\nCCC\nDDD\nEEE\nFFF' | grep -n -A 2 CCC
3:CCC
4-DDD
5-EEE

$ echo -e 'AAA\nBBB\nCCC\nDDD\nEEE\nFFF' | teip -e 'grep -n -A 2 CCC'
AAA
BBB
[CCC]
[DDD]
[EEE]
FFF

$ echo -e 'AAA\nBBB\nCCC\nDDD\nEEE\nFFF' | teip -e 'sed -n "/BBB/,/EEE/="'
AAA
[BBB]
[CCC]
[DDD]
[EEE]
FFF

$ echo -e 'AAA\nBBB\nCCC\nDDD\nEEE\nFFF' | teip -e 'awk "/BBB/,/EEE/{print NR}"'

$ echo -e 'AAA\nBBB\nCCC\nDDD\nEEE\nFFF' | teip -e 'nl -ba | tail -n 3'
AAA
BBB
CCC
[DDD]
[EEE]
[FFF]

$ cat AtoG.txt | teip -g B -A 2
A
[B]
[C]
[D]
E
F
G

$ cat AtoG.txt | teip -g E -B 2
A
B
[C]
[D]
[E]
F
G

$ cat AtoG.txt | teip -g E -C 2
A
B
[C]
[D]
[E]
[F]
[G]

$ cat AtoG.txt | teip --sed '/B/,/E/'
A
[B]
[C]
[D]
[E]
F
G

$ cat AtoG.txt | teip --sed '1~3'
[A]
B
C
[D]
E
F
[G]

$ cat AtoG.txt | teip --awk '/B/,/E/'
A
[B]
[C]
[D]
[E]
F
G

$ cat AtoG.txt | teip --awk 'NR%3==0'
A
B
[C]
D
E
[F]
G

$ export TEIP_HIGHLIGHT="<<<{}>>>"
$ echo ABAB | teip -og A
<<<A>>>B<<<A>>>B

$ export TEIP_HIGHLIGHT=$'\x1b[01;31m{}\x1b[0m'
$ echo ABAB | teip -og A
ABAB  ### Same color as grep

$ export TEIP_GREP_PATH=/opt/homebrew/bin/ggrep
$ echo -e 'AAA\nBBB\nCCC\nDDD\nEEE\nFFF' | teip -g CCC -A 2
AAA
BBB
[CCC]
[DDD]
[EEE]
FFF