garray

原文：https://pkg.go.dev/github.com/gogf/gf/v2@v2.6.4/container/garray

Package garray provides most commonly used array containers which also support concurrent-safe/unsafe switch feature.

​ 软件包 garray 提供最常用的阵列容器，这些容器还支持并发安全/不安全交换机功能。

常量

This section is empty.

变量

This section is empty.

函数

This section is empty.

类型

type Array

1
2
3

type Array struct {
	// contains filtered or unexported fields
}

Array is a golang array with rich features. It contains a concurrent-safe/unsafe switch, which should be set when its initialization and cannot be changed then.

​ Array 是一个功能丰富的 golang 阵列。它包含一个并发安全/不安全开关，应在初始化时设置该开关，然后无法更改。

func New

1

func New(safe ...bool) *Array

New creates and returns an empty array. The parameter safe is used to specify whether using array in concurrent-safety, which is false in default.

​ new 创建并返回一个空数组。该参数 safe 用于指定是否在 concurrent-safety 中使用数组，默认为 false。

Example New

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

package main

import (
	"fmt"

	"github.com/gogf/gf/v2/container/garray"
)

func main() {
	// A normal array.
	a := garray.New()

	// Adding items.
	for i := 0; i < 10; i++ {
		a.Append(i)
	}

	// Print the array length.
	fmt.Println(a.Len())

	// Print the array items.
	fmt.Println(a.Slice())

	// Retrieve item by index.
	fmt.Println(a.Get(6))

	// Check item existence.
	fmt.Println(a.Contains(6))
	fmt.Println(a.Contains(100))

	// Insert item before specified index.
	a.InsertAfter(9, 11)
	// Insert item after specified index.
	a.InsertBefore(10, 10)

	fmt.Println(a.Slice())

	// Modify item by index.
	a.Set(0, 100)
	fmt.Println(a.Slice())

	fmt.Println(a.At(0))

	// Search item and return its index.
	fmt.Println(a.Search(5))

	// Remove item by index.
	a.Remove(0)
	fmt.Println(a.Slice())

	// Empty the array, removes all items of it.
	fmt.Println(a.Slice())
	a.Clear()
	fmt.Println(a.Slice())

}
Output:

10
[0 1 2 3 4 5 6 7 8 9]
6 true
true
false
[0 1 2 3 4 5 6 7 8 9 10 11]
[100 1 2 3 4 5 6 7 8 9 10 11]
100
5
[1 2 3 4 5 6 7 8 9 10 11]
[1 2 3 4 5 6 7 8 9 10 11]
[]

func NewArray

1

func NewArray(safe ...bool) *Array

NewArray is alias of New, please see New.

​ NewArray 是 New 的别名，请参阅 New。

func NewArrayFrom

1

func NewArrayFrom(array []interface{}, safe ...bool) *Array

NewArrayFrom creates and returns an array with given slice array. The parameter safe is used to specify whether using array in concurrent-safety, which is false in default.

​ NewArrayFrom 创建并返回一个具有给定切片 array 的数组。该参数 safe 用于指定是否在 concurrent-safety 中使用数组，默认为 false。

func NewArrayFromCopy

1

func NewArrayFromCopy(array []interface{}, safe ...bool) *Array

NewArrayFromCopy creates and returns an array from a copy of given slice array. The parameter safe is used to specify whether using array in concurrent-safety, which is false in default.

​ NewArrayFromCopy 从给定切片 array 的副本创建并返回一个数组。该参数 safe 用于指定是否在 concurrent-safety 中使用数组，默认为 false。

func NewArrayRange

1

func NewArrayRange(start, end, step int, safe ...bool) *Array

NewArrayRange creates and returns an array by a range from start to end with step value step.

​ NewArrayRange 创建并返回一个范围 start 为 end to 的数组，其步骤值 step 为 。

func NewArraySize

1

func NewArraySize(size int, cap int, safe ...bool) *Array

NewArraySize create and returns an array with given size and cap. The parameter safe is used to specify whether using array in concurrent-safety, which is false in default.

​ NewArraySize 创建并返回一个具有给定大小和上限的数组。该参数 safe 用于指定是否在 concurrent-safety 中使用数组，默认为 false。

func NewFrom

1

func NewFrom(array []interface{}, safe ...bool) *Array

NewFrom is alias of NewArrayFrom. See NewArrayFrom.

​ NewFrom 是 NewArrayFrom 的别名。请参阅 NewArrayFrom。

func NewFromCopy

1

func NewFromCopy(array []interface{}, safe ...bool) *Array

NewFromCopy is alias of NewArrayFromCopy. See NewArrayFromCopy.

​ NewFromCopy 是 NewArrayFromCopy 的别名。请参阅 NewArrayFromCopy。

(*Array) Append

1

func (a *Array) Append(value ...interface{}) *Array

Append is alias of PushRight, please See PushRight.

​ Append 是 PushRight 的别名，请参见 PushRight。

(*Array) At

1

func (a *Array) At(index int) (value interface{})

At returns the value by the specified index. If the given index is out of range of the array, it returns nil.

​ at 返回指定索引的值。如果给定 index 的超出数组的范围，则返回 nil 。

(*Array) Chunk

1

func (a *Array) Chunk(size int) [][]interface{}

Chunk splits an array into multiple arrays, the size of each array is determined by size. The last chunk may contain less than size elements.

​ Chunk 将一个数组拆分为多个数组，每个数组的大小由 size 决定。最后一个块可能包含小于 size 的元素。

Example Chunk

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

package main

import (
	"fmt"

	"github.com/gogf/gf/v2/container/garray"
	"github.com/gogf/gf/v2/frame/g"
)

func main() {
	array := garray.NewFrom(g.Slice{1, 2, 3, 4, 5, 6, 7, 8, 9})

	// Chunk splits an array into multiple arrays,
	// the size of each array is determined by `size`.
	// The last chunk may contain less than size elements.
	fmt.Println(array.Chunk(2))

}
Output:

[[1 2] [3 4] [5 6] [7 8] [9]]

(*Array) Clear

1

func (a *Array) Clear() *Array

Clear deletes all items of current array.

​ 清除将删除当前数组的所有项目。

(*Array) Clone

1

func (a *Array) Clone() (newArray *Array)

Clone returns a new array, which is a copy of current array.

​ 克隆返回一个新数组，它是当前数组的副本。

(*Array) Contains

1

func (a *Array) Contains(value interface{}) bool

Contains checks whether a value exists in the array.

​ 包含检查数组中是否存在值。

Example Contains

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

package main

import (
	"fmt"

	"github.com/gogf/gf/v2/container/garray"
)

func main() {
	var array garray.StrArray
	array.Append("a")
	fmt.Println(array.Contains("a"))
	fmt.Println(array.Contains("A"))
	fmt.Println(array.ContainsI("A"))

}
Output:

true
false
true

(*Array) CountValues

1

func (a *Array) CountValues() map[interface{}]int

CountValues counts the number of occurrences of all values in the array.

​ CountValues 计算数组中所有值的出现次数。

(*Array) DeepCopy

1

func (a *Array) DeepCopy() interface{}

DeepCopy implements interface for deep copy of current type.

​ DeepCopy实现了当前类型的深度拷贝接口。

(*Array) Fill

1

func (a *Array) Fill(startIndex int, num int, value interface{}) error

Fill fills an array with num entries of the value value, keys starting at the startIndex parameter.

​ Fill 使用值 value 的 num 个条目填充数组，键从 startIndex 参数开始。

(*Array) Filter

1

func (a *Array) Filter(filter func(index int, value interface{}) bool) *Array

Filter iterates array and filters elements using custom callback function. It removes the element from array if callback function filter returns true, it or else does nothing and continues iterating.

​ Filter 使用自定义回调函数迭代数组和筛选元素。如果回调函数 filter 返回 true，它会从数组中删除该元素，否则它不执行任何操作并继续迭代。

Example Filter

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

package main

import (
	"fmt"

	"github.com/gogf/gf/v2/internal/empty"

	"github.com/gogf/gf/v2/container/garray"
	"github.com/gogf/gf/v2/frame/g"
)

func main() {
	array1 := garray.NewFrom(g.Slice{0, 1, 2, nil, "", g.Slice{}, "john"})
	array2 := garray.NewFrom(g.Slice{0, 1, 2, nil, "", g.Slice{}, "john"})
	fmt.Printf("%#v\n", array1.Filter(func(index int, value interface{}) bool {
		return empty.IsNil(value)
	}).Slice())
	fmt.Printf("%#v\n", array2.Filter(func(index int, value interface{}) bool {
		return empty.IsEmpty(value)
	}).Slice())

}
Output:

[]interface {}{0, 1, 2, "", []interface {}{}, "john"}
[]interface {}{1, 2, "john"}

(*Array) FilterEmpty

1

func (a *Array) FilterEmpty() *Array

FilterEmpty removes all empty value of the array. Values like: 0, nil, false, “”, len(slice/map/chan) == 0 are considered empty.

​ FilterEmpty 删除数组的所有空值。像 0， nil， false， “”， len（slice/map/chan） == 0 这样的值被视为空。

Example FilterEmpty

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

package main

import (
	"fmt"

	"github.com/gogf/gf/v2/container/garray"
	"github.com/gogf/gf/v2/frame/g"
)

func main() {
	array1 := garray.NewFrom(g.Slice{0, 1, 2, nil, "", g.Slice{}, "john"})
	array2 := garray.NewFrom(g.Slice{0, 1, 2, nil, "", g.Slice{}, "john"})
	fmt.Printf("%#v\n", array1.FilterNil().Slice())
	fmt.Printf("%#v\n", array2.FilterEmpty().Slice())

}
Output:

[]interface {}{0, 1, 2, "", []interface {}{}, "john"}
[]interface {}{1, 2, "john"}

(*Array) FilterNil

1

func (a *Array) FilterNil() *Array

FilterNil removes all nil value of the array.

​ FilterNil 删除数组的所有 nil 值。

Example FilterNil

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

package main

import (
	"fmt"

	"github.com/gogf/gf/v2/container/garray"
	"github.com/gogf/gf/v2/frame/g"
)

func main() {
	array1 := garray.NewFrom(g.Slice{0, 1, 2, nil, "", g.Slice{}, "john"})
	array2 := garray.NewFrom(g.Slice{0, 1, 2, nil, "", g.Slice{}, "john"})
	fmt.Printf("%#v\n", array1.FilterNil().Slice())
	fmt.Printf("%#v\n", array2.FilterEmpty().Slice())

}
Output:

[]interface {}{0, 1, 2, "", []interface {}{}, "john"}
[]interface {}{1, 2, "john"}

(*Array) Get

1

func (a *Array) Get(index int) (value interface{}, found bool)

Get returns the value by the specified index. If the given index is out of range of the array, the found is false.

​ Get 按指定索引返回值。如果给定 index 的超出数组的范围，则为 found false。

(*Array) InsertAfter

1

func (a *Array) InsertAfter(index int, values ...interface{}) error

InsertAfter inserts the values to the back of index.

​ InsertAfter 将 插入 values 到 index 的后面。

(*Array) InsertBefore

1

func (a *Array) InsertBefore(index int, values ...interface{}) error

InsertBefore inserts the values to the front of index.

​ InsertBefore 将 插入 values 到 index 的前面。

(*Array) Interfaces

1

func (a *Array) Interfaces() []interface{}

Interfaces returns current array as []interface{}.

​ Interfaces 以 []interface{} 的形式返回当前数组。

(*Array) IsEmpty

1

func (a *Array) IsEmpty() bool

IsEmpty checks whether the array is empty.

​ IsEmpty 检查数组是否为空。

(*Array) Iterator

1

func (a *Array) Iterator(f func(k int, v interface{}) bool)

Iterator is alias of IteratorAsc.

​ Iterator 是 IteratorAsc 的别名。

Example Iterator

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

package main

import (
	"fmt"

	"github.com/gogf/gf/v2/container/garray"
	"github.com/gogf/gf/v2/frame/g"
)

func main() {
	array := garray.NewArrayFrom(g.Slice{"a", "b", "c"})
	// Iterator is alias of IteratorAsc, which iterates the array readonly in ascending order
	//  with given callback function `f`.
	// If `f` returns true, then it continues iterating; or false to stop.
	array.Iterator(func(k int, v interface{}) bool {
		fmt.Println(k, v)
		return true
	})
	// IteratorDesc iterates the array readonly in descending order with given callback function `f`.
	// If `f` returns true, then it continues iterating; or false to stop.
	array.IteratorDesc(func(k int, v interface{}) bool {
		fmt.Println(k, v)
		return true
	})

}
Output:

0 a
1 b
2 c
2 c
1 b
0 a

(*Array) IteratorAsc

1

func (a *Array) IteratorAsc(f func(k int, v interface{}) bool)

IteratorAsc iterates the array readonly in ascending order with given callback function f. If f returns true, then it continues iterating; or false to stop.

​ IteratorAsc 使用给定的回调函数 f 按升序只读方式迭代数组。如果 f 返回 true，则继续迭代;或 false 停止。

(*Array) IteratorDesc

1

func (a *Array) IteratorDesc(f func(k int, v interface{}) bool)

IteratorDesc iterates the array readonly in descending order with given callback function f. If f returns true, then it continues iterating; or false to stop.

​ IteratorDesc 使用给定的回调函数 f 按降序迭代数组只读。如果 f 返回 true，则继续迭代;或 false 停止。

(*Array) Join

1

func (a *Array) Join(glue string) string

Join joins array elements with a string glue.

​ Join 使用字符串 glue 连接数组元素。

Example Join

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

package main

import (
	"fmt"

	"github.com/gogf/gf/v2/container/garray"
	"github.com/gogf/gf/v2/frame/g"
)

func main() {
	array := garray.NewFrom(g.Slice{"a", "b", "c", "d"})
	fmt.Println(array.Join(","))

}
Output:

a,b,c,d

(*Array) Len

1

func (a *Array) Len() int

Len returns the length of array.

​ Len 返回数组的长度。

(*Array) LockFunc

1

func (a *Array) LockFunc(f func(array []interface{})) *Array

LockFunc locks writing by callback function f.

​ LockFunc 通过回调函数 f 锁定写入。

(Array) MarshalJSON

1

func (a Array) MarshalJSON() ([]byte, error)

MarshalJSON implements the interface MarshalJSON for json.Marshal. Note that do not use pointer as its receiver here.

​ MarshalJSON 实现 json 的接口 MarshalJSON。元帅。请注意，此处不要使用指针作为其接收器。

(*Array) Merge

1

func (a *Array) Merge(array interface{}) *Array

Merge merges array into current array. The parameter array can be any garray or slice type. The difference between Merge and Append is Append supports only specified slice type, but Merge supports more parameter types.

​ 合并 array 合并到当前数组中。该参数 array 可以是任何 garray 或 slice 类型。Merge 和 Append 的区别在于 Append 仅支持指定的切片类型，但 Merge 支持更多参数类型。

Example Merge

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

package main

import (
	"fmt"

	"github.com/gogf/gf/v2/container/garray"
	"github.com/gogf/gf/v2/frame/g"
)

func main() {
	array1 := garray.NewFrom(g.Slice{1, 2})
	array2 := garray.NewFrom(g.Slice{3, 4})
	slice1 := g.Slice{5, 6}
	slice2 := []int{7, 8}
	slice3 := []string{"9", "0"}
	fmt.Println(array1.Slice())
	array1.Merge(array1)
	array1.Merge(array2)
	array1.Merge(slice1)
	array1.Merge(slice2)
	array1.Merge(slice3)
	fmt.Println(array1.Slice())

}
Output:

[1 2]
[1 2 1 2 3 4 5 6 7 8 9 0]

(*Array) Pad

1

func (a *Array) Pad(size int, val interface{}) *Array

Pad pads array to the specified length with value. If size is positive then the array is padded on the right, or negative on the left. If the absolute value of size is less than or equal to the length of the array then no padding takes place.

​ 焊盘垫数组设置为指定 value 长度。如果大小为正数，则数组在右侧填充，或在左侧填充为负数。如果 的 size 绝对值小于或等于数组的长度，则不会进行填充。

(*Array) PopLeft

1

func (a *Array) PopLeft() (value interface{}, found bool)

PopLeft pops and returns an item from the beginning of array. Note that if the array is empty, the found is false.

​ PopLeft 弹出并返回数组开头的项。请注意，如果数组为空，则为 found false。

Example

(*Array) PopLefts

1

func (a *Array) PopLefts(size int) []interface{}

PopLefts pops and returns size items from the beginning of array.

​ PopLefts 弹出并返回 size 数组开头的项。

Example

(*Array) PopRand

1

func (a *Array) PopRand() (value interface{}, found bool)

PopRand randomly pops and return an item out of array. Note that if the array is empty, the found is false.

​ PopRand 随机弹出并返回数组外的项目。请注意，如果数组为空，则为 found false。

Example

(*Array) PopRands

1

func (a *Array) PopRands(size int) []interface{}

PopRands randomly pops and returns size items out of array.

​ PopRands 随机弹出并返回 size 数组外的项目。

(*Array) PopRight

1

func (a *Array) PopRight() (value interface{}, found bool)

PopRight pops and returns an item from the end of array. Note that if the array is empty, the found is false.

​ PopRight 弹出并返回数组末尾的项。请注意，如果数组为空，则为 found false。

Example

(*Array) PopRights

1

func (a *Array) PopRights(size int) []interface{}

PopRights pops and returns size items from the end of array.

​ PopRights 弹出并返回 size 数组末尾的项。

Example

(*Array) PushLeft

1

func (a *Array) PushLeft(value ...interface{}) *Array

PushLeft pushes one or multiple items to the beginning of array.

​ PushLeft 将一个或多个项推送到数组的开头。

(*Array) PushRight

1

func (a *Array) PushRight(value ...interface{}) *Array

PushRight pushes one or multiple items to the end of array. It equals to Append.

​ PushRight 将一个或多个项推送到数组的末尾。它等于追加。

(*Array) RLockFunc

1

func (a *Array) RLockFunc(f func(array []interface{})) *Array

RLockFunc locks reading by callback function f.

​ RLockFunc 通过回调函数 f 锁定读取。

(*Array) Rand

1

func (a *Array) Rand() (value interface{}, found bool)

Rand randomly returns one item from array(no deleting).

​ Rand 从数组中随机返回一个项目（不删除）。

(*Array) Rands

1

func (a *Array) Rands(size int) []interface{}

Rands randomly returns size items from array(no deleting).

​ Rands 从数组中随机返回 size 项目（不删除）。

Example

(*Array) Range

1

func (a *Array) Range(start int, end ...int) []interface{}

Range picks and returns items by range, like array[start:end]. Notice, if in concurrent-safe usage, it returns a copy of slice; else a pointer to the underlying data.

​ 范围按范围选取和返回项目，如 array[start：end]。请注意，如果在并发安全使用中，它会返回 slice 的副本;else 指向基础数据的指针。

If end is negative, then the offset will start from the end of array. If end is omitted, then the sequence will have everything from start up until the end of the array.

​ 如果 end 为负数，则偏移量将从数组末尾开始。如果 end 省略，则序列将包含从数组开始到结束的所有内容。

(*Array) Remove

1

func (a *Array) Remove(index int) (value interface{}, found bool)

Remove removes an item by index. If the given index is out of range of the array, the found is false.

​ “删除”（Remove） 按索引删除项目。如果给定 index 的超出数组的范围，则为 found false。

(*Array) RemoveValue

1

func (a *Array) RemoveValue(value interface{}) bool

RemoveValue removes an item by value. It returns true if value is found in the array, or else false if not found.

​ RemoveValue 按值删除项目。如果在数组中找到值，则返回 true，如果未找到，则返回 false。

(*Array) RemoveValues

1

func (a *Array) RemoveValues(values ...interface{})

RemoveValues removes multiple items by values.

​ RemoveValues 按 values 删除多个项目。

(*Array) Replace

1

func (a *Array) Replace(array []interface{}) *Array

Replace replaces the array items by given array from the beginning of array.

​ Replace 将数组项替换为从数组开头开始给定 array 的数组项。

(*Array) Reverse

1

func (a *Array) Reverse() *Array

Reverse makes array with elements in reverse order.

​ Reverse 使数组具有相反顺序的元素。

Example

(*Array) Search

1

func (a *Array) Search(value interface{}) int

Search searches array by value, returns the index of value, or returns -1 if not exists.

​ 搜索 搜索数 value 组 by 返回 的 value 索引，如果不存在，则返回 -1。

(*Array) Set

1

func (a *Array) Set(index int, value interface{}) error

Set sets value to specified index.

​ 将设置值设置为指定索引。

(*Array) SetArray

1

func (a *Array) SetArray(array []interface{}) *Array

SetArray sets the underlying slice array with the given array.

​ SetArray 使用给定 array 的 .

(*Array) Shuffle

1

func (a *Array) Shuffle() *Array

Shuffle randomly shuffles the array.

​ 随机洗牌数组。

Example

(*Array) Slice

1

func (a *Array) Slice() []interface{}

Slice returns the underlying data of array. Note that, if it’s in concurrent-safe usage, it returns a copy of underlying data, or else a pointer to the underlying data.

​ Slice 返回数组的基础数据。请注意，如果它处于并发安全使用状态，它将返回基础数据的副本，或者返回指向基础数据的指针。

(*Array) SortFunc

1

func (a *Array) SortFunc(less func(v1, v2 interface{}) bool) *Array

SortFunc sorts the array by custom function less.

​ SortFunc 按自定义函数 less 对数组进行排序。

(*Array) String

1

func (a *Array) String() string

String returns current array as a string, which implements like json.Marshal does.

​ String 以字符串形式返回当前数组，其实现方式类似于 json。元帅做到了。

(*Array) SubSlice

1

func (a *Array) SubSlice(offset int, length ...int) []interface{}

SubSlice returns a slice of elements from the array as specified by the offset and size parameters. If in concurrent safe usage, it returns a copy of the slice; else a pointer.

​ SubSlice 从 offset 数组中返回由 and size 参数指定的元素切片。如果处于并发安全使用状态，则返回切片的副本;else 指针。

If offset is non-negative, the sequence will start at that offset in the array. If offset is negative, the sequence will start that far from the end of the array.

​ 如果偏移量为非负数，则序列将从数组中的该偏移量开始。如果偏移量为负数，则序列将从数组末尾开始。

If length is given and is positive, then the sequence will have up to that many elements in it. If the array is shorter than the length, then only the available array elements will be present. If length is given and is negative then the sequence will stop that many elements from the end of the array. If it is omitted, then the sequence will have everything from offset up until the end of the array.

​ 如果给定长度并且是正数，则序列中将包含多达那么多元素。如果数组短于长度，则仅存在可用的数组元素。如果给定长度并且是负数，则序列将从数组末尾停止该许多元素。如果省略它，则序列将包含从偏移量到数组末尾的所有内容。

Any possibility crossing the left border of array, it will fail.

​ 任何越过数组左边界的可能性，都会失败。

(*Array) Sum

1

func (a *Array) Sum() (sum int)

Sum returns the sum of values in an array.

​ Sum 返回数组中值的总和。

(*Array) Unique

1

func (a *Array) Unique() *Array

Unique uniques the array, clear repeated items. Example: [1,1,2,3,2] -> [1,2,3]

​ 唯一唯一数组，清除重复项。示例：[1,1,2,3,2] -> [1,2,3]

(*Array) UnmarshalJSON

1

func (a *Array) UnmarshalJSON(b []byte) error

UnmarshalJSON implements the interface UnmarshalJSON for json.Unmarshal.

​ UnmarshalJSON 实现 json 的接口 UnmarshalJSON。元帅。

(*Array) UnmarshalValue

1

func (a *Array) UnmarshalValue(value interface{}) error

UnmarshalValue is an interface implement which sets any type of value for array.

​ UnmarshalValue 是一个接口实现，用于为数组设置任何类型的值。

(*Array) Walk

1

func (a *Array) Walk(f func(value interface{}) interface{}) *Array

Walk applies a user supplied function f to every item of array.

​ Walk 将用户提供的函数 f 应用于数组的每个项。

type IntArray

1
2
3

type IntArray struct {
	// contains filtered or unexported fields
}

IntArray is a golang int array with rich features. It contains a concurrent-safe/unsafe switch, which should be set when its initialization and cannot be changed then.

​ IntArray 是一个功能丰富的 golang int 数组。它包含一个并发安全/不安全开关，应在初始化时设置该开关，然后无法更改。

func NewIntArray

1

func NewIntArray(safe ...bool) *IntArray

NewIntArray creates and returns an empty array. The parameter safe is used to specify whether using array in concurrent-safety, which is false in default.

​ NewIntArray 创建并返回一个空数组。该参数 safe 用于指定是否在 concurrent-safety 中使用数组，默认为 false。

Example

func NewIntArrayFrom

1

func NewIntArrayFrom(array []int, safe ...bool) *IntArray

NewIntArrayFrom creates and returns an array with given slice array. The parameter safe is used to specify whether using array in concurrent-safety, which is false in default.

​ NewIntArrayFrom 创建并返回一个具有给定切片 array 的数组。该参数 safe 用于指定是否在 concurrent-safety 中使用数组，默认为 false。

Example

func NewIntArrayFromCopy

1

func NewIntArrayFromCopy(array []int, safe ...bool) *IntArray

NewIntArrayFromCopy creates and returns an array from a copy of given slice array. The parameter safe is used to specify whether using array in concurrent-safety, which is false in default.

​ NewIntArrayFromCopy 从给定切片 array 的副本创建并返回数组。该参数 safe 用于指定是否在 concurrent-safety 中使用数组，默认为 false。

Example

func NewIntArrayRange

1

func NewIntArrayRange(start, end, step int, safe ...bool) *IntArray

NewIntArrayRange creates and returns an array by a range from start to end with step value step.

​ NewIntArrayRange 创建并返回一个范围 start 为 end to 的数组，其步骤值 step 为 。

Example

func NewIntArraySize

1

func NewIntArraySize(size int, cap int, safe ...bool) *IntArray

NewIntArraySize create and returns an array with given size and cap. The parameter safe is used to specify whether using array in concurrent-safety, which is false in default.

​ NewIntArraySize 创建并返回具有给定大小和上限的数组。该参数 safe 用于指定是否在 concurrent-safety 中使用数组，默认为 false。

Example

(*IntArray) Append

1

func (a *IntArray) Append(value ...int) *IntArray

Append is alias of PushRight,please See PushRight.

​ Append 是 PushRight 的别名，请参见 PushRight。

Example

(*IntArray) At

1

func (a *IntArray) At(index int) (value int)

At returns the value by the specified index. If the given index is out of range of the array, it returns 0.

​ at 返回指定索引的值。如果给定 index 的超出数组的范围，则返回 0 。

Example

(*IntArray) Chunk

1

func (a *IntArray) Chunk(size int) [][]int

Chunk splits an array into multiple arrays, the size of each array is determined by size. The last chunk may contain less than size elements.

​ Chunk 将一个数组拆分为多个数组，每个数组的大小由 size 决定。最后一个块可能包含小于 size 的元素。

Example

(*IntArray) Clear

1

func (a *IntArray) Clear() *IntArray

Clear deletes all items of current array.

​ 清除将删除当前数组的所有项目。

Example

(*IntArray) Clone

1

func (a *IntArray) Clone() (newArray *IntArray)

Clone returns a new array, which is a copy of current array.

​ 克隆返回一个新数组，它是当前数组的副本。

Example

(*IntArray) Contains

1

func (a *IntArray) Contains(value int) bool

Contains checks whether a value exists in the array.

​ 包含检查数组中是否存在值。

Example

(*IntArray) CountValues

1

func (a *IntArray) CountValues() map[int]int

CountValues counts the number of occurrences of all values in the array.

​ CountValues 计算数组中所有值的出现次数。

Example

(*IntArray) DeepCopy

1

func (a *IntArray) DeepCopy() interface{}

DeepCopy implements interface for deep copy of current type.

​ DeepCopy实现了当前类型的深度拷贝接口。

(*IntArray) Fill

1

func (a *IntArray) Fill(startIndex int, num int, value int) error

Fill fills an array with num entries of the value value, keys starting at the startIndex parameter.

​ Fill 使用值 value 的 num 个条目填充数组，键从 startIndex 参数开始。

Example

(*IntArray) Filter

1

func (a *IntArray) Filter(filter func(index int, value int) bool) *IntArray

Filter iterates array and filters elements using custom callback function. It removes the element from array if callback function filter returns true, it or else does nothing and continues iterating.

​ Filter 使用自定义回调函数迭代数组和筛选元素。如果回调函数 filter 返回 true，它会从数组中删除该元素，否则它不执行任何操作并继续迭代。

Example

(*IntArray) FilterEmpty

1

func (a *IntArray) FilterEmpty() *IntArray

FilterEmpty removes all zero value of the array.

​ FilterEmpty 删除数组的所有零值。

Example

(*IntArray) Get

1

func (a *IntArray) Get(index int) (value int, found bool)

Get returns the value by the specified index. If the given index is out of range of the array, the found is false.

​ Get 按指定索引返回值。如果给定 index 的超出数组的范围，则为 found false。

Example

(*IntArray) InsertAfter

1

func (a *IntArray) InsertAfter(index int, values ...int) error

InsertAfter inserts the value to the back of index.

​ InsertAfter 将 插入 value 到 index 的后面。

Example

(*IntArray) InsertBefore

1

func (a *IntArray) InsertBefore(index int, values ...int) error

InsertBefore inserts the values to the front of index.

​ InsertBefore 将 插入 values 到 index 的前面。

Example

(*IntArray) Interfaces

1

func (a *IntArray) Interfaces() []interface{}

Interfaces returns current array as []interface{}.

​ Interfaces 以 []interface{} 的形式返回当前数组。

Example

(*IntArray) IsEmpty

1

func (a *IntArray) IsEmpty() bool

IsEmpty checks whether the array is empty.

​ IsEmpty 检查数组是否为空。

Example

(*IntArray) Iterator

1

func (a *IntArray) Iterator(f func(k int, v int) bool)

Iterator is alias of IteratorAsc.

​ Iterator 是 IteratorAsc 的别名。

Example

(*IntArray) IteratorAsc

1

func (a *IntArray) IteratorAsc(f func(k int, v int) bool)

IteratorAsc iterates the array readonly in ascending order with given callback function f. If f returns true, then it continues iterating; or false to stop.

​ IteratorAsc 使用给定的回调函数 f 按升序只读方式迭代数组。如果 f 返回 true，则继续迭代;或 false 停止。

Example

(*IntArray) IteratorDesc

1

func (a *IntArray) IteratorDesc(f func(k int, v int) bool)

IteratorDesc iterates the array readonly in descending order with given callback function f. If f returns true, then it continues iterating; or false to stop.

​ IteratorDesc 使用给定的回调函数 f 按降序迭代数组只读。如果 f 返回 true，则继续迭代;或 false 停止。

Example

(*IntArray) Join

1

func (a *IntArray) Join(glue string) string

Join joins array elements with a string glue.

​ Join 使用字符串 glue 连接数组元素。

Example

(*IntArray) Len

1

func (a *IntArray) Len() int

Len returns the length of array.

​ Len 返回数组的长度。

Example

(*IntArray) LockFunc

1

func (a *IntArray) LockFunc(f func(array []int)) *IntArray

LockFunc locks writing by callback function f.

​ LockFunc 通过回调函数 f 锁定写入。

Example

(IntArray) MarshalJSON

1

func (a IntArray) MarshalJSON() ([]byte, error)

MarshalJSON implements the interface MarshalJSON for json.Marshal. Note that do not use pointer as its receiver here.

​ MarshalJSON 实现 json 的接口 MarshalJSON。元帅。请注意，此处不要使用指针作为其接收器。

Example

(*IntArray) Merge

1

func (a *IntArray) Merge(array interface{}) *IntArray

Merge merges array into current array. The parameter array can be any garray or slice type. The difference between Merge and Append is Append supports only specified slice type, but Merge supports more parameter types.

​ 合并 array 合并到当前数组中。该参数 array 可以是任何 garray 或 slice 类型。Merge 和 Append 的区别在于 Append 仅支持指定的切片类型，但 Merge 支持更多参数类型。

Example

(*IntArray) Pad

1

func (a *IntArray) Pad(size int, value int) *IntArray

Pad pads array to the specified length with value. If size is positive then the array is padded on the right, or negative on the left. If the absolute value of size is less than or equal to the length of the array then no padding takes place.

​ 焊盘垫数组设置为指定 value 长度。如果大小为正数，则数组在右侧填充，或在左侧填充为负数。如果 的 size 绝对值小于或等于数组的长度，则不会进行填充。

Example

(*IntArray) PopLeft

1

func (a *IntArray) PopLeft() (value int, found bool)

PopLeft pops and returns an item from the beginning of array. Note that if the array is empty, the found is false.

​ PopLeft 弹出并返回数组开头的项。请注意，如果数组为空，则为 found false。

Example

(*IntArray) PopLefts

1

func (a *IntArray) PopLefts(size int) []int

PopLefts pops and returns size items from the beginning of array. If the given size is greater than size of the array, it returns all elements of the array. Note that if given size <= 0 or the array is empty, it returns nil.

​ PopLefts 弹出并返回 size 数组开头的项。如果给定 size 的大小大于数组的大小，则返回数组的所有元素。请注意，如果给定 size <= 0 或数组为空，则返回 nil。

Example

(*IntArray) PopRand

1

func (a *IntArray) PopRand() (value int, found bool)

PopRand randomly pops and return an item out of array. Note that if the array is empty, the found is false.

​ PopRand 随机弹出并返回数组外的项目。请注意，如果数组为空，则为 found false。

Example

(*IntArray) PopRands

1

func (a *IntArray) PopRands(size int) []int

PopRands randomly pops and returns size items out of array. If the given size is greater than size of the array, it returns all elements of the array. Note that if given size <= 0 or the array is empty, it returns nil.

​ PopRands 随机弹出并返回 size 数组外的项目。如果给定 size 的大小大于数组的大小，则返回数组的所有元素。请注意，如果给定 size <= 0 或数组为空，则返回 nil。

Example

(*IntArray) PopRight

1

func (a *IntArray) PopRight() (value int, found bool)

PopRight pops and returns an item from the end of array. Note that if the array is empty, the found is false.

​ PopRight 弹出并返回数组末尾的项。请注意，如果数组为空，则为 found false。

Example

(*IntArray) PopRights

1

func (a *IntArray) PopRights(size int) []int

PopRights pops and returns size items from the end of array. If the given size is greater than size of the array, it returns all elements of the array. Note that if given size <= 0 or the array is empty, it returns nil.

​ PopRights 弹出并返回 size 数组末尾的项。如果给定 size 的大小大于数组的大小，则返回数组的所有元素。请注意，如果给定 size <= 0 或数组为空，则返回 nil。

Example

(*IntArray) PushLeft

1

func (a *IntArray) PushLeft(value ...int) *IntArray

PushLeft pushes one or multiple items to the beginning of array.

​ PushLeft 将一个或多个项推送到数组的开头。

Example

(*IntArray) PushRight

1

func (a *IntArray) PushRight(value ...int) *IntArray

PushRight pushes one or multiple items to the end of array. It equals to Append.

​ PushRight 将一个或多个项推送到数组的末尾。它等于追加。

Example

(*IntArray) RLockFunc

1

func (a *IntArray) RLockFunc(f func(array []int)) *IntArray

RLockFunc locks reading by callback function f.

​ RLockFunc 通过回调函数 f 锁定读取。

Example

(*IntArray) Rand

1

func (a *IntArray) Rand() (value int, found bool)

Rand randomly returns one item from array(no deleting).

​ Rand 从数组中随机返回一个项目（不删除）。

Example

(*IntArray) Rands

1

func (a *IntArray) Rands(size int) []int

Rands randomly returns size items from array(no deleting).

​ Rands 从数组中随机返回 size 项目（不删除）。

Example

(*IntArray) Range

1

func (a *IntArray) Range(start int, end ...int) []int

Range picks and returns items by range, like array[start:end]. Notice, if in concurrent-safe usage, it returns a copy of slice; else a pointer to the underlying data.

​ 范围按范围选取和返回项目，如 array[start：end]。请注意，如果在并发安全使用中，它会返回 slice 的副本;else 指向基础数据的指针。

If end is negative, then the offset will start from the end of array. If end is omitted, then the sequence will have everything from start up until the end of the array.

​ 如果 end 为负数，则偏移量将从数组末尾开始。如果 end 省略，则序列将包含从数组开始到结束的所有内容。

Example

(*IntArray) Remove

1

func (a *IntArray) Remove(index int) (value int, found bool)

Remove removes an item by index. If the given index is out of range of the array, the found is false.

​ “删除”（Remove） 按索引删除项目。如果给定 index 的超出数组的范围，则为 found false。

Example

(*IntArray) RemoveValue

1

func (a *IntArray) RemoveValue(value int) bool

RemoveValue removes an item by value. It returns true if value is found in the array, or else false if not found.

​ RemoveValue 按值删除项目。如果在数组中找到值，则返回 true，如果未找到，则返回 false。

Example

(*IntArray) RemoveValues

1

func (a *IntArray) RemoveValues(values ...int)

RemoveValues removes multiple items by values.

​ RemoveValues 按 values 删除多个项目。

(*IntArray) Replace

1

func (a *IntArray) Replace(array []int) *IntArray

Replace replaces the array items by given array from the beginning of array.

​ Replace 将数组项替换为从数组开头开始给定 array 的数组项。

Example

(*IntArray) Reverse

1

func (a *IntArray) Reverse() *IntArray

Reverse makes array with elements in reverse order.

​ Reverse 使数组具有相反顺序的元素。

Example

(*IntArray) Search

1

func (a *IntArray) Search(value int) int

Search searches array by value, returns the index of value, or returns -1 if not exists.

​ 搜索 搜索数 value 组 by 返回 的 value 索引，如果不存在，则返回 -1。

Example

(*IntArray) Set

1

func (a *IntArray) Set(index int, value int) error

Set sets value to specified index.

​ 将设置值设置为指定索引。

Example

(*IntArray) SetArray

1

func (a *IntArray) SetArray(array []int) *IntArray

SetArray sets the underlying slice array with the given array.

​ SetArray 使用给定 array 的 .

Example

(*IntArray) Shuffle

1

func (a *IntArray) Shuffle() *IntArray

Shuffle randomly shuffles the array.

​ 随机洗牌数组。

Example

(*IntArray) Slice

1

func (a *IntArray) Slice() []int

Slice returns the underlying data of array. Note that, if it’s in concurrent-safe usage, it returns a copy of underlying data, or else a pointer to the underlying data.

​ Slice 返回数组的基础数据。请注意，如果它处于并发安全使用状态，它将返回基础数据的副本，或者返回指向基础数据的指针。

Example

(*IntArray) Sort

1

func (a *IntArray) Sort(reverse ...bool) *IntArray

Sort sorts the array in increasing order. The parameter reverse controls whether sort in increasing order(default) or decreasing order.

​ 排序按升序对数组进行排序。该参数 reverse 控制是按递增顺序（默认）排序还是按递减顺序排序。

Example

(*IntArray) SortFunc

1

func (a *IntArray) SortFunc(less func(v1, v2 int) bool) *IntArray

SortFunc sorts the array by custom function less.

​ SortFunc 按自定义函数 less 对数组进行排序。

Example

(*IntArray) String

1

func (a *IntArray) String() string

String returns current array as a string, which implements like json.Marshal does.

​ String 以字符串形式返回当前数组，其实现方式类似于 json。元帅做到了。

Example

(*IntArray) SubSlice

1

func (a *IntArray) SubSlice(offset int, length ...int) []int

SubSlice returns a slice of elements from the array as specified by the offset and size parameters. If in concurrent safe usage, it returns a copy of the slice; else a pointer.

​ SubSlice 从 offset 数组中返回由 and size 参数指定的元素切片。如果处于并发安全使用状态，则返回切片的副本;else 指针。

If offset is non-negative, the sequence will start at that offset in the array. If offset is negative, the sequence will start that far from the end of the array.

​ 如果偏移量为非负数，则序列将从数组中的该偏移量开始。如果偏移量为负数，则序列将从数组末尾开始。

If length is given and is positive, then the sequence will have up to that many elements in it. If the array is shorter than the length, then only the available array elements will be present. If length is given and is negative then the sequence will stop that many elements from the end of the array. If it is omitted, then the sequence will have everything from offset up until the end of the array.

​ 如果给定长度并且是正数，则序列中将包含多达那么多元素。如果数组短于长度，则仅存在可用的数组元素。如果给定长度并且是负数，则序列将从数组末尾停止该许多元素。如果省略它，则序列将包含从偏移量到数组末尾的所有内容。

Any possibility crossing the left border of array, it will fail.

​ 任何越过数组左边界的可能性，都会失败。

Example

(*IntArray) Sum

1

func (a *IntArray) Sum() (sum int)

Sum returns the sum of values in an array.

​ Sum 返回数组中值的总和。

Example

(*IntArray) Unique

1

func (a *IntArray) Unique() *IntArray

Unique uniques the array, clear repeated items. Example: [1,1,2,3,2] -> [1,2,3]

​ 唯一唯一数组，清除重复项。示例：[1,1,2,3,2] -> [1,2,3]

Example

(*IntArray) UnmarshalJSON

1

func (a *IntArray) UnmarshalJSON(b []byte) error

UnmarshalJSON implements the interface UnmarshalJSON for json.Unmarshal.

​ UnmarshalJSON 实现 json 的接口 UnmarshalJSON。元帅。

Example

(*IntArray) UnmarshalValue

1

func (a *IntArray) UnmarshalValue(value interface{}) error

UnmarshalValue is an interface implement which sets any type of value for array.

​ UnmarshalValue 是一个接口实现，用于为数组设置任何类型的值。

Example

(*IntArray) Walk

1

func (a *IntArray) Walk(f func(value int) int) *IntArray

Walk applies a user supplied function f to every item of array.

​ Walk 将用户提供的函数 f 应用于数组的每个项。

Example

type SortedArray

1
2
3

type SortedArray struct {
	// contains filtered or unexported fields
}

SortedArray is a golang sorted array with rich features. It is using increasing order in default, which can be changed by setting it a custom comparator. It contains a concurrent-safe/unsafe switch, which should be set when its initialization and cannot be changed then.

​ SortedArray 是一个功能丰富的 golang 排序数组。默认情况下，它使用递增顺序，可以通过将其设置为自定义比较器来更改。它包含一个并发安全/不安全开关，应在初始化时设置该开关，然后无法更改。

func NewSortedArray

1

func NewSortedArray(comparator func(a, b interface{}) int, safe ...bool) *SortedArray

NewSortedArray creates and returns an empty sorted array. The parameter safe is used to specify whether using array in concurrent-safety, which is false in default. The parameter comparator used to compare values to sort in array, if it returns value < 0, means a < b; the a will be inserted before b; if it returns value = 0, means a = b; the a will be replaced by b; if it returns value > 0, means a > b; the a will be inserted after b;

​ NewSortedArray 创建并返回一个空的排序数组。该参数 safe 用于指定是否在 concurrent-safety 中使用数组，默认为 false。 comparator 用于比较值以在数组中排序的参数，如果它返回值 < 0，则表示 a < b ;将 a 插入之前 b ;如果它返回值 = 0，则意味着 a = b ;将 a 替换为 b ;如果它返回值 > 0，则表示 a > b ;将 a 插入后 b ;

func NewSortedArrayFrom

1

func NewSortedArrayFrom(array []interface{}, comparator func(a, b interface{}) int, safe ...bool) *SortedArray

NewSortedArrayFrom creates and returns an sorted array with given slice array. The parameter safe is used to specify whether using array in concurrent-safety, which is false in default.

​ NewSortedArrayFrom 创建并返回具有给定切片 array 的排序数组。该参数 safe 用于指定是否在 concurrent-safety 中使用数组，默认为 false。

func NewSortedArrayFromCopy

1

func NewSortedArrayFromCopy(array []interface{}, comparator func(a, b interface{}) int, safe ...bool) *SortedArray

NewSortedArrayFromCopy creates and returns an sorted array from a copy of given slice array. The parameter safe is used to specify whether using array in concurrent-safety, which is false in default.

​ NewSortedArrayFromCopy 从给定切片 array 的副本创建并返回一个排序数组。该参数 safe 用于指定是否在 concurrent-safety 中使用数组，默认为 false。

func NewSortedArrayRange

1

func NewSortedArrayRange(start, end, step int, comparator func(a, b interface{}) int, safe ...bool) *SortedArray

NewSortedArrayRange creates and returns an array by a range from start to end with step value step.

​ NewSortedArrayRange 创建并返回一个数组，其范围为 从 start 到 end 的步长值 step 。

func NewSortedArraySize

1

func NewSortedArraySize(cap int, comparator func(a, b interface{}) int, safe ...bool) *SortedArray

NewSortedArraySize create and returns an sorted array with given size and cap. The parameter safe is used to specify whether using array in concurrent-safety, which is false in default.

​ NewSortedArraySize 创建并返回具有给定大小和上限的排序数组。该参数 safe 用于指定是否在 concurrent-safety 中使用数组，默认为 false。

(*SortedArray) Add

1

func (a *SortedArray) Add(values ...interface{}) *SortedArray

Add adds one or multiple values to sorted array, the array always keeps sorted. It’s alias of function Append, see Append.

​ Add 将一个或多个值添加到排序数组中，该数组始终保持排序状态。它是函数 Append 的别名，请参阅 Append。

(*SortedArray) Append

1

func (a *SortedArray) Append(values ...interface{}) *SortedArray

Append adds one or multiple values to sorted array, the array always keeps sorted.

​ Append 将一个或多个值添加到排序数组，该数组始终保持排序状态。

(*SortedArray) At

1

func (a *SortedArray) At(index int) (value interface{})

At returns the value by the specified index. If the given index is out of range of the array, it returns nil.

​ at 返回指定索引的值。如果给定 index 的超出数组的范围，则返回 nil 。

(*SortedArray) Chunk

1

func (a *SortedArray) Chunk(size int) [][]interface{}

Chunk splits an array into multiple arrays, the size of each array is determined by size. The last chunk may contain less than size elements.

​ Chunk 将一个数组拆分为多个数组，每个数组的大小由 size 决定。最后一个块可能包含小于 size 的元素。

(*SortedArray) Clear

1

func (a *SortedArray) Clear() *SortedArray

Clear deletes all items of current array.

​ 清除将删除当前数组的所有项目。

(*SortedArray) Clone

1

func (a *SortedArray) Clone() (newArray *SortedArray)

Clone returns a new array, which is a copy of current array.

​ 克隆返回一个新数组，它是当前数组的副本。

(*SortedArray) Contains

1

func (a *SortedArray) Contains(value interface{}) bool

Contains checks whether a value exists in the array.

​ 包含检查数组中是否存在值。

(*SortedArray) CountValues

1

func (a *SortedArray) CountValues() map[interface{}]int

CountValues counts the number of occurrences of all values in the array.

​ CountValues 计算数组中所有值的出现次数。

(*SortedArray) DeepCopy

1

func (a *SortedArray) DeepCopy() interface{}

DeepCopy implements interface for deep copy of current type.

​ DeepCopy实现了当前类型的深度拷贝接口。

(*SortedArray) Filter

1

func (a *SortedArray) Filter(filter func(index int, value interface{}) bool) *SortedArray

Filter iterates array and filters elements using custom callback function. It removes the element from array if callback function filter returns true, it or else does nothing and continues iterating.

​ Filter 使用自定义回调函数迭代数组和筛选元素。如果回调函数 filter 返回 true，它会从数组中删除该元素，否则它不执行任何操作并继续迭代。

(*SortedArray) FilterEmpty

1

func (a *SortedArray) FilterEmpty() *SortedArray

FilterEmpty removes all empty value of the array. Values like: 0, nil, false, “”, len(slice/map/chan) == 0 are considered empty.

​ FilterEmpty 删除数组的所有空值。像 0， nil， false， “”， len（slice/map/chan） == 0 这样的值被视为空。

(*SortedArray) FilterNil

1

func (a *SortedArray) FilterNil() *SortedArray

FilterNil removes all nil value of the array.

​ FilterNil 删除数组的所有 nil 值。

(*SortedArray) Get

1

func (a *SortedArray) Get(index int) (value interface{}, found bool)

Get returns the value by the specified index. If the given index is out of range of the array, the found is false.

​ Get 按指定索引返回值。如果给定 index 的超出数组的范围，则为 found false。

(*SortedArray) Interfaces

1

func (a *SortedArray) Interfaces() []interface{}

Interfaces returns current array as []interface{}.

​ Interfaces 以 []interface{} 的形式返回当前数组。

(*SortedArray) IsEmpty

1

func (a *SortedArray) IsEmpty() bool

IsEmpty checks whether the array is empty.

​ IsEmpty 检查数组是否为空。

(*SortedArray) Iterator

1

func (a *SortedArray) Iterator(f func(k int, v interface{}) bool)

Iterator is alias of IteratorAsc.

​ Iterator 是 IteratorAsc 的别名。

(*SortedArray) IteratorAsc

1

func (a *SortedArray) IteratorAsc(f func(k int, v interface{}) bool)

IteratorAsc iterates the array readonly in ascending order with given callback function f. If f returns true, then it continues iterating; or false to stop.

​ IteratorAsc 使用给定的回调函数 f 按升序只读方式迭代数组。如果 f 返回 true，则继续迭代;或 false 停止。

(*SortedArray) IteratorDesc

1

func (a *SortedArray) IteratorDesc(f func(k int, v interface{}) bool)

IteratorDesc iterates the array readonly in descending order with given callback function f. If f returns true, then it continues iterating; or false to stop.

​ IteratorDesc 使用给定的回调函数 f 按降序迭代数组只读。如果 f 返回 true，则继续迭代;或 false 停止。

(*SortedArray) Join

1

func (a *SortedArray) Join(glue string) string

Join joins array elements with a string glue.

​ Join 使用字符串 glue 连接数组元素。

(*SortedArray) Len

1

func (a *SortedArray) Len() int

Len returns the length of array.

​ Len 返回数组的长度。

(*SortedArray) LockFunc

1

func (a *SortedArray) LockFunc(f func(array []interface{})) *SortedArray

LockFunc locks writing by callback function f.

​ LockFunc 通过回调函数 f 锁定写入。

(SortedArray) MarshalJSON

1

func (a SortedArray) MarshalJSON() ([]byte, error)

MarshalJSON implements the interface MarshalJSON for json.Marshal. Note that do not use pointer as its receiver here.

​ MarshalJSON 实现 json 的接口 MarshalJSON。元帅。请注意，此处不要使用指针作为其接收器。

(*SortedArray) Merge

1

func (a *SortedArray) Merge(array interface{}) *SortedArray

Merge merges array into current array. The parameter array can be any garray or slice type. The difference between Merge and Append is Append supports only specified slice type, but Merge supports more parameter types.

​ 合并 array 合并到当前数组中。该参数 array 可以是任何 garray 或 slice 类型。Merge 和 Append 的区别在于 Append 仅支持指定的切片类型，但 Merge 支持更多参数类型。

(*SortedArray) PopLeft

1

func (a *SortedArray) PopLeft() (value interface{}, found bool)

PopLeft pops and returns an item from the beginning of array. Note that if the array is empty, the found is false.

​ PopLeft 弹出并返回数组开头的项。请注意，如果数组为空，则为 found false。

(*SortedArray) PopLefts

1

func (a *SortedArray) PopLefts(size int) []interface{}