equal

Documentation

Overview

Package equal provides a deep equivalence relation for arbitrary values.

Example (Equal)

fmt.Println(Equal([]int{1, 2, 3}, []int{1, 2, 3}))        // "true"
fmt.Println(Equal([]string{"foo"}, []string{"bar"}))      // "false"
fmt.Println(Equal([]string(nil), []string{}))             // "true"
fmt.Println(Equal(map[string]int(nil), map[string]int{})) // "true"

Output:

true
false
true
true

Example (EqualCycle)

// Circular linked lists a -> b -> a and c -> c.
type link struct {
	value string
	tail  *link
}
a, b, c := &link{value: "a"}, &link{value: "b"}, &link{value: "c"}
a.tail, b.tail, c.tail = b, a, c
fmt.Println(Equal(a, a)) // "true"
fmt.Println(Equal(b, b)) // "true"
fmt.Println(Equal(c, c)) // "true"
fmt.Println(Equal(a, b)) // "false"
fmt.Println(Equal(a, c)) // "false"

Output:

true
true
true
false
false

Index

• func Equal(x, y interface{}) bool

Examples

• Package (Equal)
• Package (EqualCycle)

Functions

func Equal

func Equal(x, y interface{}) bool

Equal reports whether x and y deeply equal. Map keys are always compared with ==, not deeply. (This matter for keys containing pointers or interfaces.)