atomic.SwapPointer() Function in Golang With Examples
Last Updated :
01 Apr, 2020
In Go language, atomic packages supply lower-level atomic memory that is helpful is implementing synchronization algorithms. The SwapPointer() function in Go language is used to atomically store new value into *addr and returns the previous *addr value. This function is defined under the atomic package. Here, you need to import “sync/atomic” package in order to use these functions.
Syntax:
func SwapPointer(addr *unsafe.Pointer, new unsafe.Pointer) (old unsafe.Pointer)
Here, addr indicates address. And new is the new unsafe.Pointer value and old is the older unsafe.Pointer value.
Note: (*unsafe.Pointer) is the pointer to a unsafe.Pointer value. And unsafe.Pointer type is helpful in enabling transitions between arbitrary types and builtin uintptr type. Moreover, unsafe is a package that is helpful in type safety of Go programs.
Return Value: It stores the new unsafe.Pointer value into the *addr and returns the previous *addr value.
Example 1:
package main
import (
"fmt"
"sync/atomic"
"unsafe"
)
type L struct { x, y, z int }
var PL *L
func main() {
var unsafepL = (*unsafe.Pointer)(unsafe.Pointer(&PL))
var px, py L
atomic.StorePointer(
unsafepL, unsafe.Pointer(&px))
px1 := atomic.SwapPointer(unsafepL,
unsafe.Pointer(&py))
fmt.Println((*L)(px1) == &px)
fmt.Println(px1)
}
|
Output:
true
0xc0000c2000 // Can be different at different run times
Here, the StorePointer method adds value to the *addr, then SwapPointer method atomically store new value into *addr and returns the old value. And, here swapping is accomplished hence, true is returned and the value of unsafe.Pointer returned here can be different at different run times.
Example 2:
package main
import (
"fmt"
"sync/atomic"
"unsafe"
)
type L struct { x, y, z int }
var PL *L
func main() {
var unsafepL = (*unsafe.Pointer)(unsafe.Pointer(&PL))
var px, py L
px1 := atomic.SwapPointer(unsafepL,
unsafe.Pointer(&py))
fmt.Println((*L)(px1) == &px)
fmt.Println(&px1)
}
|
Output:
false
0xc00000e028 // Can be different at different run times
Here, false is returned as here the unsafe.pointer is not stored before so, SwapPointer() method was not able to swap the stated value. Moreover, the address value returned here is the address of px1 and the value of px1 will be nil as swapping is not performed.
Like Article
Suggest improvement
Share your thoughts in the comments
Please Login to comment...