Skip to content

Commit 3d5f7de

Browse files
authored
Update builtin.md
补充注意事项,修正格式。 可能随着enable的格式调整继续调整内容。 之前更新的文档有不符合当前格式的会逐步修改。
1 parent 1f27138 commit 3d5f7de

1 file changed

Lines changed: 30 additions & 34 deletions

File tree

‎command/builtin.md‎

Lines changed: 30 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -3,62 +3,54 @@ builtin
33

44
执行bash内建命令。
55

6-
## 补充说明
7-
8-
**builtin命令** 用于执行指定的bash内建命令,并返回内部命令的返回值。builtin命令在使用时,Linux中同名的外部命令及同名的shell函数失效。
9-
10-
### 语法
6+
## 概要
117

128
```shell
13-
builtin(bash内建命令)(参数)
9+
builtin [shell-builtin [arg ...]]
1410
```
1511
16-
### 参数
12+
## 主要用途
13+
14+
- 用于执行指定的bash内建命令。
15+
- `builtin`命令调用的bash内建命令优先于同名的外部命令及同名的shell函数。
16+
17+
## 参数
1718
18-
bash内建命令:指定需要执行的bash内建命令。
19+
shell-builtin(可选):要调用的bash内建命令。
1920
20-
(可选)参数:传递给bash内建命令的参数。
21+
arg(可选):传递给bash内建命令的一到多个参数。
2122
22-
### 提示
23+
## 返回值
2324
24-
**同名情况下的优先级顺序**
25+
返回该内建命令执行的返回值,除非传递的不是bash内建命令或该内建命令被禁用。
26+
27+
## 例子
28+
29+
同名情况下的优先级顺序:
2530
2631
builtin 内建命令 > 函数 > 内建命令 > 外部命令
2732
2833
```shell
29-
#!/bin/bash
30-
#此时内建命令优先使用
34+
# 关于外部命令优先级最高的情况请参考enable命令。
35+
# 此时内建命令优先使用
3136
echo "the Great Wall"
32-
#调用内建命令type,显示命令的类型
37+
# 调用内建命令type,返回命令的类型(builtin)
3338
type -t echo
34-
#定义 echo 函数
39+
# 定义 echo 函数
3540
echo(){
3641
printf "123\n"
3742
}
38-
#此时同名函数优先使用
43+
# 此时同名函数优先使用,显示(123)
3944
echo
45+
# 调用内建命令type,返回命令的类型(function)
4046
type -t echo
41-
#此时内建命令优先使用
47+
# 此时内建命令优先使用
4248
builtin echo -e "backslash \\"
4349
```
4450
4551
```shell
46-
#输出结果
47-
the Great Wall
48-
builtin
49-
123
50-
function
51-
backslash \
52-
```
53-
54-
内建命令的帮助信息请参考 'help' 命令
55-
56-
### 实例
57-
58-
使用builtin命令执行bash内建命令alias:
59-
60-
```shell
61-
builtin alias # 执行shell内部指令
52+
# 执行shell内部指令,输出当前系统下的命令别名
53+
builtin alias
6254
alias cp='cp -i'
6355
alias l.='ls -d .* --color=tty'
6456
alias ll='ls -l --color=tty'
@@ -68,7 +60,11 @@ alias rm='rm -i'
6860
alias which='alias | /usr/bin/which --tty-only --read-alias --show-dot --show-tilde'
6961
```
7062
71-
上面的命令执行后,将输出当前系统下的命令别名。
63+
### 注意
64+
65+
1. 该命令是bash内建命令,相关的帮助信息请查看`help`命令。
66+
67+
2. 如果要调用的内建命令被禁用了(包括`builtin`),那么执行会报错;关于禁用和启用内建命令请参考`enable`命令。
7268
7369
7470
<!-- Linux命令行搜索引擎:https://jaywcjlove.github.io/linux-command/ -->

0 commit comments

Comments
 (0)