目录

描述

命令格式

使用示例

查看文件开头

指定显示文件的开头行数

指定显示字符数量

---

描述

与tail命令的作用相反，head命令会显示文件开头部分的内容。默认情况下，它会显示文件前10行的文本内容。

命令格式

head [-n <lines>] [-c <character_count>] <file>

参数（option & argument）	说明 (description)
-n <lines>	可选的参数，指定显示的行数
-c <character_count>	可选的参数，指定要显示的字符数量
file	要显示的文件

使用示例

查看文件开头

默认情况下，head命令显示文件前10行的文本内容。

$ head doc/api.md 
# API
This section describes the gotable APIs.

[Return to the home page](../README.md)

## github.com/liushuochen/gotable
### Create table
```go
func Create(columns ...string) (*table.Table, error)
```

指定显示文件的开头行数

通过可选的-n选项来指定显示的行数。例如要查看文件开头5行的内容：

$ head -n 5 doc/api.md 
# API
This section describes the gotable APIs.

[Return to the home page](../README.md)

指定显示字符数量

通过可选的-c选项来指定显示的字符数量。结果的"%"表示指定的字符数小于文件的字符数（即head没有读完整个文件）：

$ head -c 6 project/gotable/README.md
# gota% 

若指定的字符数大于文件本身包含的字符数量，则结尾不会显示"%"：

$ head -c 230 test/fun.txt
fun
This is a test document for head command.

空格符、换行符、制表符也被当作是一个字符：

$ head -c 6 test/fun.txt
fun
Th%  

-c选项只能接收一个正整数作为参数。否则返回head: illegal byte count报错，并返回退出状态码1:

$ head -c -4 test/fun.txt
head: illegal byte count -- -4
$ 
$ head -c e test/fun.txt 
head: illegal byte count -- e
$ 
$ head -c 0  test/fun.txt
head: illegal byte count -- 0
$ 
$ echo $?
$ 1