Package builtin

import "builtin"
Overview
Index

Overview ▾

内置的软件包为Go的预定义标识符提供了文档. 此处记录的项目实际上不是内置于软件包中的,但此处的描述使godoc可以提供有关语言特殊标识符的文档.

Constants

true和false是两个未类型化的布尔值.

const (
    true  = 0 == 0 // Untyped bool.
    false = 0 != 0 // Untyped bool.
)

iota是一个预先声明的标识符,表示(通常带括号的)const声明中当前const规范的无类型整数序号. 它是零索引的.

const iota = 0 // Untyped int.

Variables

nil是预先声明的标识符,表示指针,通道,函数,接口,映射或切片类型的零值.

var nil Type // Type must be a pointer, channel, func, interface, map, or slice type

func append

func append(slice []Type, elems ...Type) []Type

append内置函数将元素追加到切片的末尾. 如果有足够的容量,则将目标切片以容纳新元素. 如果没有,将分配一个新的基础数组. 追加返回更新的切片. 因此,有必要将append的结果存储在通常包含切片本身的变量中:

slice = append(slice, elem1, elem2)
slice = append(slice, anotherSlice...)

作为一种特殊情况,将字符串附加到字节片是合法的,如下所示:

slice = append([]byte("hello "), "world"...)

func cap

func cap(v Type) int

cap内置函数根据其类型返回v的容量:

Array: the number of elements in v (same as len(v)).
Pointer to array: the number of elements in *v (same as len(v)).
Slice: the maximum length the slice can reach when resliced;
if v is nil, cap(v) is zero.
Channel: the channel buffer capacity, in units of elements;
if v is nil, cap(v) is zero.

对于某些参数,例如简单的数组表达式,结果可以是常量. 有关详细信息,请参见Go语言规范的"长度和容量"部分.

func close

func close(c chan<- Type)

关闭内置函数关闭一个通道,该通道必须为双向或仅发送. 它只能由发送者执行,而不能由接收者执行,并且具有在接收到最后一个发送值后关闭通道的作用. 从关闭的通道c接收到最后一个值之后,从c进行的任何接收都将成功执行而不会阻塞,返回通道元素的零值. 表格

x, ok := <-c

对于关闭的频道,也会将ok设置为false.

func complex

func complex(r, i FloatType) ComplexType

The complex built-in function constructs a complex value from two floating-point values. The real and imaginary parts must be of the same size, either float32 or float64 (or assignable to them), and the return value will be the corresponding complex type (complex64 for float32, complex128 for float64).

func copy

func copy(dst, src []Type) int

内置复制功能将元素从源切片复制到目标切片. (作为特殊情况,它还会将字节从字符串复制到字节的一部分.)源和目标可能会重叠. 复制返回复制的元素数量,该数量将是len(src)和len(dst)的最小值.

func delete

func delete(m map[Type]Type1, key Type)

delete内置函数从地图中删除具有指定键(m [key])的元素. 如果m为nil或没有这样的元素,则delete为no-op.

func imag

func imag(c ComplexType) FloatType

imag内置函数返回复数c的虚部. 返回值将是对应于c类型的浮点类型.

func len

func len(v Type) int

len内置函数根据其类型返回v的长度:

Array: the number of elements in v.
Pointer to array: the number of elements in *v (even if v is nil).
Slice, or map: the number of elements in v; if v is nil, len(v) is zero.
String: the number of bytes in v.
Channel: the number of elements queued (unread) in the channel buffer;
         if v is nil, len(v) is zero.

对于某些参数,例如字符串文字或简单的数组表达式,结果可以是常量. 有关详细信息,请参见Go语言规范的"长度和容量"部分.

func make

func make(t Type, size ...IntegerType) Type

make内置函数分配和初始化slice,map或chan类型的对象(仅). 像new一样,第一个参数是类型,而不是值. 与new不同,make的返回类型与其参数的类型相同,而不是指向它的指针. 结果的规格取决于类型:

Slice: The size specifies the length. The capacity of the slice is
equal to its length. A second integer argument may be provided to
specify a different capacity; it must be no smaller than the
length. For example, make([]int, 0, 10) allocates an underlying array
of size 10 and returns a slice of length 0 and capacity 10 that is
backed by this underlying array.
Map: An empty map is allocated with enough space to hold the
specified number of elements. The size may be omitted, in which case
a small starting size is allocated.
Channel: The channel's buffer is initialized with the specified
buffer capacity. If zero, or the size is omitted, the channel is
unbuffered.

func new

func new(Type) *Type

新的内置函数分配内存. 第一个参数是类型,而不是值,返回的值是指向该类型新分配的零值的指针.

func panic

func panic(v interface{})

panic内置函数停止当前goroutine的正常执行. 当函数F调用紧急情况时,F的正常执行立即停止. F推迟执行的所有函数都以常规方式运行,然后F返回其调用方. 对调用者G而言,调用F的行为就像是对恐慌的调用,终止G的执行并运行任何延迟的函数. 这将继续执行,直到执行的goroutine中的所有功能以相反的顺序停止为止. 此时,程序将以非零退出代码终止. 此终止序列称为panicking,可以通过内置的功能restore控制.

func print

func print(args ...Type)

print内置函数以特定于实现的方式格式化其参数,并将结果写入标准错误. 打印对于引导和调试很有用; 不保证会保留该语言.

func println

func println(args ...Type)

内置函数println以特定于实现的方式格式化其参数,并将结果写入标准错误. 总是在参数之间添加空格,并添加换行符. Println对于引导和调试很有用; 不保证会保留该语言.

func real

func real(c ComplexType) FloatType

实数内置函数返回复数c的实数部分. 返回值将是对应于c类型的浮点类型.

func recover

func recover() interface{}

恢复内置功能允许程序管理恐慌性goroutine的行为. 在延迟函数(而不是由其调用的任何函数)中执行恢复调用将通过恢复正常执行来停止恐慌序列,并检索传递给panic调用的错误值. 如果在延迟函数之外调用了restore,它将不会停止恐慌序列. 在这种情况下,或者当goroutine没有惊慌,或者提供给panic的参数为nil时,recover返回nil. 因此,来自recovery的返回值将报告goroutine是否感到恐慌.

type ComplexType

ComplexType在此处仅用于文档目的. 它是复杂类型(complex64或complex128)的替代.

type ComplexType complex64

type FloatType

FloatType此处仅用于文档目的. 它是浮点类型的替代:float32或float64.

type FloatType float32

type IntegerType

IntegerType此处仅用于文档目的. 它是任何整数类型的替代者:int,uint,int8等.

type IntegerType int

type Type

类型仅在此处用于文档目的. 它是任何Go类型的替代,但是对于任何给定的函数调用都表示相同的类型.

type Type int

type Type1

Type1此处仅用于文档目的. 它是任何Go类型的替代,但是对于任何给定的函数调用都表示相同的类型.

type Type1 int

type bool

bool是布尔值(真和假)的集合.

type bool bool

type byte

byte是uint8的别名,在所有方面都等同于uint8. 按照惯例,它用于区分字节值和8位无符号整数值.

type byte = uint8

type complex128

complex128是具有float64实部和虚部的所有复数的集合.

type complex128 complex128

type complex64

complex64是所有带有float32实部和虚部的复数的集合.

type complex64 complex64

type error

错误内置接口类型是用于表示错误状态的常规接口,其中nil值表示没有错误.

type error interface {
    Error() string
}

type float32

float32是所有IEEE-754 32位浮点数的集合.

type float32 float32

type float64

float64是所有IEEE-754 64位浮点数的集合.

type float64 float64

type int

int是有符号整数类型,其大小至少为32位. 但是,它是一个独特的类型,而不是int32的别名.

type int int

type int16

int16是所有带符号的16位整数的集合. 范围:-32768至32767.

type int16 int16

type int32

int32是所有带符号的32位整数的集合. 范围:-2147483648至2147483647.

type int32 int32

type int64

int64是所有带符号的64位整数的集合. 范围:-9223372036854775808至9223372036854775807.

type int64 int64

type int8

int8是所有带符号的8位整数的集合. 范围:-128至127.

type int8 int8

type rune

符文是int32的别名,在所有方面都等同于int32. 按照惯例,它用于区分字符值和整数值.

type rune = int32

type string

字符串是8位字节的所有字符串的集合,按常规,但不一定表示UTF-8编码的文本. 字符串可以为空,但不能为nil. 字符串类型的值是不可变的.

type string string

type uint

uint是无符号整数类型,其大小至少为32位. 但是,它是一种独特的类型,而不是uint32的别名.

type uint uint

type uint16

uint16是所有无符号16位整数的集合. 范围:0到65535.

type uint16 uint16

type uint32

uint32是所有无符号32位整数的集合. 范围:0到4294967295.

type uint32 uint32

type uint64

uint64是所有无符号64位整数的集合. 范围:0至18446744073709551615.

type uint64 uint64

type uint8

uint8是所有无符号的8位整数的集合. 范围:0到255.

type uint8 uint8

type uintptr

uintptr是一个整数类型,其大小足以容纳任何指针的位模式.

type uintptr uintptr

by  ICOPY.SITE