linux 命令和教程补充

Linux/command/printf.md

@@ -0,0 +1,189 @@
+printf
+===
+
+格式化并输出结果。
+
+## 目录
+
+- [bash内建命令](#内建命令)
+- [GNU coreutils中的命令](#外部命令)
+
+## 内建命令
+
+#### 概要
+
+```shell
+printf [-v var] format [arguments]
+```
+
+#### 主要用途
+
+- 格式化参数并输出。
+
+#### 选项
+
+```shell
+-v var：将结果输出到变量var中而不是输出到标准输出。
+```
+
+#### 参数
+
+format：输出格式。
+
+arguments：一到多个参数。
+
+```shell
+转义序列：除了支持printf(1)和printf(3)的转义序列，内建printf还支持以下转义序列：
+
+%b       展开参数中的反斜杠转义字符。
+%q       将参数扩起以用作shell输入。
+%(fmt)T  根据strftime(3)中的转义字符来输出日期时间字符串。
+```
+
+#### 返回值
+
+返回状态为成功除非给出了非法选项、写错误、赋值错误。
+
+#### 例子
+
+```shell
+# %-5s 格式为左对齐且宽度为5的字符串代替（'-'表示左对齐），不使用则默认右对齐。
+# %-4.2f 格式为左对齐宽度为4，保留两位小数。
+
+printf "%-5s %-10s %-4s\n" NO Name Mark
+printf "%-5s %-10s %-4.2f\n" 01 Tom 90.3456
+printf "%-5s %-10s %-4.2f\n" 02 Jack 89.2345
+printf "%-5s %-10s %-4.2f\n" 03 Jeff 98.4323
+
+# 输出
+NO    Name       Mark
+01    Tom        90.35
+02    Jack       89.23
+03    Jeff       98.43
+
+
+# %b %q %(fmt)T 的例子。
+# see it again with a newline.
+printf "%s\n" 'hello world'
+# 展开换行符，和上面的结果一样。
+printf "%b" 'hello world\n'
+
+printf '%q\n' 'a b c'
+# 输出
+a\ b\ c
+
+# %z为时区，%n为换行符。
+printf "%(%F %T %z%n)T"
+# 输出
+2019-09-10 01:48:07 +0000
+```
+
+#### 注意
+
+1. 该命令是bash内建命令，相关的帮助信息请查看`help`命令。
+
+
+## 外部命令
+
+#### 概要
+
+```shell
+printf FORMAT [ARGUMENT]...
+printf OPTION
+```
+
+#### 主要用途
+
+- 格式化参数并输出。
+
+
+#### 选项
+
+```shell
+--help 显示帮助信息并退出。
+--version 显示版本信息并退出。
+```
+
+#### 参数
+
+format：输出格式。
+
+arguments：一到多个参数。
+
+```shell
+在这里忽略了（%b %q），如果你安装的coreutils版本支持它们，那么请参考上面的例子。
+支持的转义序列：
+
+\"          双引号
+\\          反斜杠
+\a          响铃
+\b          退格
+\c          截断输出
+\e          退出
+\f          翻页
+\n          换行
+\r          回车
+\t          水平制表符
+\v          竖直制表符
+\NNN        八进制数 (1到3位数字)
+\xHH        十六进制数 (1到2位数字)
+\uHHHH      Unicode字符附加4位十六进制数字
+\UHHHHHHHH  Unicode字符附加8位十六进制数字
+%%          百分号
+
+以及'diouxXfeEgGcs'中的一个结尾的C格式规范，将被转换为正确的类型并处理可变宽度。
+```
+
+#### 例子
+
+```shell
+# 使用 /usr/bin/printf 确保调用的不是内建命令。
+# 当然，在你关闭内建printf以及确认当前环境没有printf函数的情况下，可直接使用printf，详见末尾"注意"的链接。
+
+# 按行打印数组和关联数组的下标及值。
+
+# 声明数组可以不加'declare -a'或'local -a'（在函数内声明的局部变量）。
+arr=('line1' 'line2')
+/usr/bin/printf "%s\n" ${!arr[@]}
+# 输出下标
+0
+1
+/usr/bin/printf "%s\n" ${arr[@]}
+# 输出值
+line1
+line2
+
+#声明关联数组（也就是字典）必须加'declare -A'或'local -A'（在函数内声明的局部变量）。
+declare -A assoc_arr=(['key1']='value1' ['key2']='value2')
+/usr/bin/printf "%s\n" ${!assoc_arr[@]}
+# 输出键。
+key2
+key1
+/usr/bin/printf "%s\n" ${assoc_arr[@]}
+# 输出值。
+value2
+value1
+```
+
+#### 返回值
+
+返回状态为成功除非给出了非法选项等。
+
+#### 注意
+
+1. 该命令是`GNU coreutils`包中的命令，相关的帮助信息请查看`man -s 1 printf`或`info coreutils 'pwd invocation'`。
+
+2. 启动或关闭内建命令请查看`enable`命令，关于同名优先级的问题请查看`builtin`命令的例子部分的相关讨论。
+
+3. 我通过和`bug-bash@gnu.org`的交流，得到了关于这几个格式说明符`%b %q %(fmt)T`的解释：
+   > printf(1)中的%b格式说明符是printf(3)支持的格式之外增加的一个POSIX特性。
+   >
+   > %q和%T说明符是非标准的，并且不受所有独立实现的printf的支持。
+   
+   更多细节请参考链接：
+   - [POSIX printf](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/printf.html)
+   `APPLICATION USAGE`段落的第五节。
+   - [POSIX printf格式说明符](https://pubs.opengroup.org/onlinepubs/9699919799/functions/printf.html)
+   的`Description`段落。
+
+