package builtin · Go 标准库中文参考

# package builtin `import "builtin"` builtin 包为Go的预声明标识符提供了文档。此处列出的条目其实并不在[builtin](https://godoc.org/builtin) 包中，对它们的描述只是为了让 godoc 给该语言的特殊标识符提供文档。 ## Index * [Constants](#pkg-constants) * [type bool](#bool) * [type byte](#byte) * [type rune](#rune) * [type int](#int) * [type int8](#int8) * [type int16](#int16) * [type int32](#int32) * [type int64](#int64) * [type uint](#uint) * [type uint8](#uint8) * [type uint16](#uint16) * [type uint32](#uint32) * [type uint64](#uint64) * [type float32](#float32) * [type float64](#float64) * [type complex64](#complex64) * [type complex128](#complex128) * [type uintptr](#uintptr) * [type string](#string) * [type error](#error) * [type Type](#Type) * [type Type1](#Type1) * [type IntegerType](#IntegerType) * [type FloatType](#FloatType) * [type ComplexType](#ComplexType) * [func real(c ComplexType) FloatType](#real) * [func imag(c ComplexType) FloatType](#imag) * [func complex(r, i FloatType) ComplexType](#complex) * [func new(Type) \*Type](#new) * [func make(Type, size IntegerType) Type](#make) * [func cap(v Type) int](#cap) * [func len(v Type) int](#len) * [func append(slice []Type, elems ...Type) []Type](#append) * [func copy(dst, src []Type) int](#copy) * [func delete(m map[Type]Type1, key Type)](#delete) * [func close(c chan<- Type)](#close) * [func panic(v interface{})](#panic) * [func recover() interface{}](#recover) * [func print(args ...Type)](#print) * [func println(args ...Type)](#println) ## Constants ``` const ( true = 0 == 0 // 无类型布尔值 false = 0 != 0 // 无类型布尔值 ) ``` true 和false是两个无类型布尔值。 ``` const iota = 0 // 无类型整数值 ``` iota是一个预定义的标识符，代表顺序按行增加的无符号整数，每个const声明单元（被括号括起来）相互独立，分别从0开始。 ## type [bool](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L14 "View Source") ``` type bool bool ``` 布尔类型。 ## type [byte](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L88 "View Source") ``` type byte byte ``` 8位无符号整型，是uint8的别名，二者视为同一类型。 ## type [rune](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L92 "View Source") ``` type rune rune ``` 32位有符号整形，int32的别名，二者视为同一类型。 ## type [int](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L75 "View Source") ``` type int int ``` 至少32位的有符号整形，但和int32/rune并非同一类型。 ## type [int8](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L40 "View Source") ``` type int8 int8 ``` 8位有符号整形，范围[-128, 127]。 ## type [int16](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L44 "View Source") ``` type int16 int16 ``` 16位有符号整形，范围[-32768, 32767]。 ## type [int32](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L48 "View Source") ``` type int32 int32 ``` 32位有符号整形，范围[-2147483648, 2147483647]。 ## type [int64](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L52 "View Source") ``` type int64 int64 ``` 64位有符号整形，范围[-9223372036854775808, 9223372036854775807]。 ## type [uint](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L79 "View Source") ``` type uint uint ``` 至少32位的无符号整形，但和uint32不是同一类型。 ## type [uint8](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L24 "View Source") ``` type uint8 uint8 ``` 8位无符号整型，范围[0, 255]。 ## type [uint16](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L28 "View Source") ``` type uint16 uint16 ``` 16位无符号整型，范围[0, 65535]。 ## type [uint32](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L32 "View Source") ``` type uint32 uint32 ``` 32位无符号整型，范围[0, 4294967295]。 ## type [uint64](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L36 "View Source") ``` type uint64 uint64 ``` 64位无符号整型，范围[0, 18446744073709551615]。 ## type [float32](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L55 "View Source") ``` type float32 float32 ``` 所有IEEE-754 32位浮点数的集合，12位有效数字。 ## type [float64](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L58 "View Source") ``` type float64 float64 ``` 所有IEEE-754 64位浮点数的集合，16位有效数字。 ## type [complex64](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L62 "View Source") ``` type complex64 complex64 ``` 具有float32 类型实部和虚部的复数类型。 ## type [complex128](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L66 "View Source") ``` type complex128 complex128 ``` 具有float64 类型实部和虚部的复数类型。 ## type [uintptr](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L83 "View Source") ``` type uintptr uintptr ``` 可以保存任意指针的位模式的整数类型。 ## type [string](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L71 "View Source") ``` type string string ``` 8位byte序列构成的字符串，约定但不必须是utf-8编码的文本。字符串可以为空但不能是nil，其值不可变。 ## type [error](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L254 "View Source") ``` type error interface { Error() string } ``` 内建error接口类型是约定用于表示错误信息，nil值表示无错误。 ## type [Type](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L106 "View Source") ``` type Type int ``` 在本文档中代表任意一个类型，但同一个声明里只代表同一个类型。 ``` var nil Type // Type必须是指针、通道、函数、接口、映射或切片 ``` nil是预定义的标识符，代表指针、通道、函数、接口、映射或切片的零值。 ## type [Type1](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L111 "View Source") ``` type Type1 int ``` 在本文档中代表任意一个类型，但同一个声明里只代表同一个类型，用于代表和Type不同的另一类型。 ## type [IntegerType](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L115 "View Source") ``` type IntegerType int ``` 在本文档中代表一个有符号或无符号的整数类型。 ## type [FloatType](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L119 "View Source") ``` type FloatType float32 ``` 在本文档中代表一个浮点数类型。 ## type [ComplexType](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L123 "View Source") ``` type ComplexType complex64 ``` 在本文档中代表一个复数类型。 ## func [real](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L198 "View Source") ``` func real(c ComplexType) FloatType ``` 返回复数c的实部。 ## func [imag](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L203 "View Source") ``` func imag(c ComplexType) FloatType ``` 返回复数c的虚部。 ## func [complex](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L194 "View Source") ``` func complex(r, i FloatType) ComplexType ``` 使用实部r和虚部i生成一个复数。 ## func [new](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L187 "View Source") ``` func new(Type) *Type ``` 内建函数new分配内存。其第一个实参为类型，而非值。其返回值为指向该类型的新分配的零值的指针。 ## func [make](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L182 "View Source") ``` func make(Type, size IntegerType) Type ``` 内建函数make分配并初始化一个类型为切片、映射、或通道的对象。其第一个实参为类型，而非值。make的返回类型与其参数相同，而非指向它的指针。其具体结果取决于具体的类型： ``` 切片：size指定了其长度。该切片的容量等于其长度。切片支持第二个整数实参可用来指定不同的容量；它必须不小于其长度，因此 make([]int, 0, 10) 会分配一个长度为0，容量为10的切片。映射：初始分配的创建取决于size，但产生的映射长度为0。size可以省略，这种情况下就会分配一个小的起始大小。通道：通道的缓存根据指定的缓存容量初始化。若 size为零或被省略，该信道即为无缓存的。 ``` ## func [cap](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L164 "View Source") ``` func cap(v Type) int ``` 内建函数cap返回 v 的容量，这取决于具体类型： ``` 数组：v中元素的数量，与 len(v) 相同数组指针：*v中元素的数量，与len(v) 相同切片：切片的容量（底层数组的长度）；若 v为nil，cap(v) 即为零信道：按照元素的单元，相应信道缓存的容量；若v为nil，cap(v)即为零 ``` ## func [len](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L155 "View Source") ``` func len(v Type) int ``` 内建函数len返回 v 的长度，这取决于具体类型： ``` 数组：v中元素的数量数组指针：*v中元素的数量（v为nil时panic）切片、映射：v中元素的数量；若v为nil，len(v)即为零字符串：v中字节的数量通道：通道缓存中队列（未读取）元素的数量；若v为 nil，len(v)即为零 ``` ## func [append](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L134 "View Source") ``` func append(slice []Type, elems ...Type) []Type ``` 内建函数append将元素追加到切片的末尾。若它有足够的容量，其目标就会重新切片以容纳新的元素。否则，就会分配一个新的基本数组。append返回更新后的切片，因此必须存储追加后的结果。 ``` slice = append(slice, elem1, elem2) slice = append(slice, anotherSlice...) ``` 作为特例，可以向一个字节切片append字符串，如下： ``` slice = append([]byte("hello "), "world"...) ``` ## func [copy](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L141 "View Source") ``` func copy(dst, src []Type) int ``` 内建函数copy将元素从来源切片复制到目标切片中，也能将字节从字符串复制到字节切片中。copy返回被复制的元素数量，它会是 len(src) 和 len(dst) 中较小的那个。来源和目标的底层内存可以重叠。 ## func [delete](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L146 "View Source") ``` func delete(m map[Type]Type1, key Type) ``` 内建函数delete按照指定的键将元素从映射中删除。若m为nil或无此元素，delete不进行操作。 ## func [close](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L213 "View Source") ``` func close(c chan<- Type) ``` 内建函数close关闭信道，该通道必须为双向的或只发送的。它应当只由发送者执行，而不应由接收者执行，其效果是在最后发送的值被接收后停止该通道。在最后的值从已关闭的信道中被接收后，任何对其的接收操作都会无阻塞的成功。对于已关闭的信道，语句： ``` x, ok := <-c ``` 还会将ok置为false。 ## func [panic](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L226 "View Source") ``` func panic(v interface{}) ``` 内建函数panic停止当前Go程的正常执行。当函数F调用panic时，F的正常执行就会立刻停止。F中defer的所有函数先入后出执行后，F返回给其调用者G。G如同F一样行动，层层返回，直到该Go程中所有函数都按相反的顺序停止执行。之后，程序被终止，而错误情况会被报告，包括引发该恐慌的实参值，此终止序列称为恐慌过程。 ## func [recover](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L237 "View Source") ``` func recover() interface{} ``` 内建函数recover允许程序管理恐慌过程中的Go程。在defer的函数中，执行recover调用会取回传至panic调用的错误值，恢复正常执行，停止恐慌过程。若recover在defer的函数之外被调用，它将不会停止恐慌过程序列。在此情况下，或当该Go程不在恐慌过程中时，或提供给panic的实参为nil时，recover就会返回nil。 ## func [print](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L243 "View Source") ``` func print(args ...Type) ``` 内建函数print以特有的方法格式化参数并将结果写入标准错误，用于自举和调试。 ## func [println](https://github.com/golang/go/blob/master/src/builtin/builtin.go#L250 "View Source") ``` func println(args ...Type) ``` println类似print，但会在参数输出之间添加空格，输出结束后换行。