?
このドキュメントでは、 php中國(guó)語(yǔ)ネットマニュアル リリース
import "unsafe"
概觀
索引
概觀
軟件打包不安全包含圍繞 Go 程序類(lèi)型安全的操作。
導(dǎo)入不安全的程序包可能不可移植，并且不受 Go 1 兼容性準(zhǔn)則的保護(hù)。
索引
func Alignof(x ArbitraryType) uintptr
func Offsetof(x ArbitraryType) uintptr
func Sizeof(x ArbitraryType) uintptr
type ArbitraryType
type Pointer
打包文件
unsafe.go
func Alignof
func Alignof(x ArbitraryType) uintptr
Alignof 接受任何類(lèi)型的表達(dá)式 x 并返回假設(shè)變量 v所需的對(duì)齊，就像 v 通過(guò) var v = x 聲明一樣。它是最大的值 m，使得 v 的地址總是為零mod m。它與 reflect.TypeOf（x）.Align（） 返回的值相同。作為一種特殊情況，如果變量s是結(jié)構(gòu)類(lèi)型，并且 f 是該結(jié)構(gòu)中的字段，那么 Alignof(s.f) 將返回結(jié)構(gòu)中該類(lèi)型字段所需的對(duì)齊。這種情況與 reflect.TypeOf(s.f).FieldAlign() 返回的值相同。
func Offsetof
func Offsetof(x ArbitraryType) uintptr
Offsetof 返回由 x 表示的字段結(jié)構(gòu)中的偏移量，它必須是 structValue.field 的形式。換句話說(shuō)，它返回結(jié)構(gòu)開(kāi)始和字段開(kāi)始之間的字節(jié)數(shù)。
func Sizeof
func Sizeof(x ArbitraryType) uintptr
Sizeof 采用任何類(lèi)型的表達(dá)式x并返回假設(shè)變量 v 的字節(jié)大小，就像 v 通過(guò) var v = x 聲明一樣。該大小不包括可能由 x 引用的任何內(nèi)存。例如，如果 x 是切片，則 Sizeof 返回切片描述符的大小，而不是切片引用的內(nèi)存大小。
type ArbitraryType
ArbitraryType 僅用于文檔目的，實(shí)際上并不是不安全軟件包的一部分。它表示任意 Go 表達(dá)式的類(lèi)型。
type ArbitraryType int
type Pointer
指針表示指向任意類(lèi)型的指針。類(lèi)型指針有四種可用于其他類(lèi)型的特殊操作：
- A pointer value of any type can be converted to a Pointer.- A Pointer can be converted to a pointer value of any type.- A uintptr can be converted to a Pointer.- A Pointer can be converted to a uintptr.
指針因此允許程序打敗類(lèi)型系統(tǒng)并讀寫(xiě)任意內(nèi)存。應(yīng)該非常小心地使用它。
涉及指針的以下模式是有效的。不使用這些模式的代碼今天可能無(wú)效，或在將來(lái)變得無(wú)效。即使下面的有效模式也有重要的注意事項(xiàng)。
運(yùn)行“go vet”可以幫助找到不符合這些模式的指針的使用，但是從“go vet”沉默并不能保證代碼有效。
（1）將 * T1 轉(zhuǎn)換為 * T2 的指針。
假設(shè) T2 不大于 T1 并且兩者共享相同的存儲(chǔ)器布局，則該轉(zhuǎn)換允許將一種類(lèi)型的數(shù)據(jù)重新解釋為另一種類(lèi)型的數(shù)據(jù)。一個(gè)例子是 math.Float64bits 的實(shí)現(xiàn)：
func Float64bits(f float64) uint64 {return *(*uint64)(unsafe.Pointer(&f))}（2）將指針轉(zhuǎn)換為 uintptr（但不返回到指針）。
將指針轉(zhuǎn)換為 uintptr 會(huì)以整數(shù)形式生成指向的內(nèi)存地址。這種 uintptr 通常用于打印它。
將 uintptr 轉(zhuǎn)換回指針通常無(wú)效。
uintptr 是一個(gè)整數(shù)，而不是引用。將指針轉(zhuǎn)換為 uintptr 將創(chuàng)建不帶指針語(yǔ)義的整數(shù)值。即使 uintptr 持有某個(gè)對(duì)象的地址，如果對(duì)象移動(dòng)，垃圾收集器也不會(huì)更新該 uintptr 的值，uintptr 也不會(huì)使該對(duì)象不被回收。
其余模式枚舉從 uintptr 到指針的唯一有效轉(zhuǎn)換。
（3）用算術(shù)將指針轉(zhuǎn)換為 uintptr 并返回。
如果 p 指向已分配的對(duì)象，則可以通過(guò)轉(zhuǎn)換為 uintptr，添加偏移量以及轉(zhuǎn)換回指針來(lái)將對(duì)象前進(jìn)。
p = unsafe.Pointer(uintptr(p) + offset)
這種模式最常見(jiàn)的用途是訪問(wèn)結(jié)構(gòu)中的字段或數(shù)組中的元素：
// equivalent to f := unsafe.Pointer(&s.f)f := unsafe.Pointer(uintptr(unsafe.Pointer(&s)) + unsafe.Offsetof(s.f))// equivalent to e := unsafe.Pointer(&x[i])e := unsafe.Pointer(uintptr(unsafe.Pointer(&x[0])) + i*unsafe.Sizeof(x[0]))
以這種方式添加和減去指針上的偏移量是有效的。使用 ＆^ 來(lái)循環(huán)指針也是有效的，通常用于對(duì)齊。在所有情況下，結(jié)果必須繼續(xù)指向原始分配的對(duì)象。
與 C 中不同的是，僅僅在它的原始分配結(jié)束時(shí)超前一個(gè)指針是無(wú)效的：
// INVALID: end points outside allocated space.var s thing end = unsafe.Pointer(uintptr(unsafe.Pointer(&s)) + unsafe.Sizeof(s))// INVALID: end points outside allocated space.b := make([]byte, n)end = unsafe.Pointer(uintptr(unsafe.Pointer(&b[0])) + uintptr(n))
請(qǐng)注意，這兩個(gè)轉(zhuǎn)換必須出現(xiàn)在相同的表達(dá)式中，只有它們之間的中間算術(shù)：
// INVALID: uintptr cannot be stored in variable// before conversion back to Pointer.u := uintptr(p)p = unsafe.Pointer(u + offset)
（4）在調(diào)用 syscall.Syscall 時(shí)將指針轉(zhuǎn)換為 uintptr。
系統(tǒng)調(diào)用包中的 Syscall 函數(shù)直接將它們的 uintptr 參數(shù)傳遞給操作系統(tǒng)，然后根據(jù)調(diào)用的細(xì)節(jié)，將其中的一些重新解釋為指針。也就是說(shuō)，系統(tǒng)調(diào)用實(shí)現(xiàn)隱式地將某些參數(shù)從 uintptr 轉(zhuǎn)換回指針。
如果必須將指針參數(shù)轉(zhuǎn)換為 uintptr 以用作參數(shù)，則該轉(zhuǎn)換必須出現(xiàn)在調(diào)用表達(dá)式本身中：
syscall.Syscall(SYS_READ, uintptr(fd), uintptr(unsafe.Pointer(p)), uintptr(n))
編譯器處理一個(gè)轉(zhuǎn)換為 uintptr 的指針，轉(zhuǎn)換為在匯編中實(shí)現(xiàn)的函數(shù)的調(diào)用的參數(shù)列表中，通過(guò)安排被引用的已分配對(duì)象（如果有的話）被保留，直到調(diào)用完成時(shí)才移動(dòng)，即使僅從類(lèi)型在通話過(guò)程中將顯示該對(duì)象不再需要。
為了讓編譯器識(shí)別這種模式，轉(zhuǎn)換必須出現(xiàn)在參數(shù)列表中：
// INVALID: uintptr cannot be stored in variable// before implicit conversion back to Pointer during system call.u := uintptr(unsafe.Pointer(p))syscall.Syscall(SYS_READ, uintptr(fd), u, uintptr(n))
（5）將 reflect.Value.Pointer 或 reflect.Value.UnsafeAddr 的結(jié)果從 uintptr 轉(zhuǎn)換為指針。
Package 反射的 Value 方法名為 Pointer 和 UnsafeAddr，返回類(lèi)型為 uintptr 而不是 unsafe.Pointer，以防止調(diào)用者將結(jié)果更改為任意類(lèi)型，而不首先導(dǎo)入“unsafe”。但是，這意味著結(jié)果很脆弱，必須在調(diào)用后立即轉(zhuǎn)換為指針，并使用相同的表達(dá)式：
p := (*int)(unsafe.Pointer(reflect.ValueOf(new(int)).Pointer()))
與上述情況一樣，在轉(zhuǎn)換之前存儲(chǔ)結(jié)果無(wú)效：
// INVALID: uintptr cannot be stored in variable// before conversion back to Pointer.u := reflect.ValueOf(new(int)).Pointer()p := (*int)(unsafe.Pointer(u))
（6）將 Reflection.SliceHeader 或 reflect.StringHeader 數(shù)據(jù)字段轉(zhuǎn)換為指針或從指針轉(zhuǎn)換而來(lái)。
與前面的情況一樣，反射數(shù)據(jù)結(jié)構(gòu) SliceHeader 和 StringHeader 將字段 Data 聲明為 uintptr，以防止調(diào)用者在不首先導(dǎo)入“不安全”的情況下將結(jié)果更改為任意類(lèi)型。但是，這意味著 SliceHeader 和 StringHeader 僅在解釋實(shí)際切片或字符串值的內(nèi)容時(shí)有效。
var s string hdr := (*reflect.StringHeader)(unsafe.Pointer(&s)) // case 1hdr.Data = uintptr(unsafe.Pointer(p)) // case 6 (this case)hdr.Len = n
在這種用法中，hdr.Data 實(shí)際上是一種替代方法來(lái)引用片頭中的基礎(chǔ)指針，而不是 uintptr 變量本身。
一般來(lái)說(shuō)，reflect.SliceHeader 和 reflect.StringHeader 只能用作 * reflect.SliceHeader 和 * reflect.StringHeader 指向?qū)嶋H的切片或字符串，而不能用作普通結(jié)構(gòu)。程序不應(yīng)該聲明或分配這些結(jié)構(gòu)類(lèi)型的變量。
// INVALID: a directly-declared header will not hold Data as a reference.var hdr reflect.StringHeader hdr.Data = uintptr(unsafe.Pointer(p))hdr.Len = n s := *(*string)(unsafe.Pointer(&hdr)) // p possibly already lost
type Pointer *ArbitraryType