為什么我覺得GoFrame的Garray比PHP的Array還好用？

作者：王中陽Go 2023-01-30 09:09:51

開發后端

gf框架有個特點，提供的組件基本都支持設置并發安全開關。顯然PHP是不支持并發安全開關的，PHP的數組是并發安全的。PHP-FPM是阻塞的單線程模型，PHP-FPM每個進程里只有一個線程，一個進程同時只能服務一個客戶端。

前言

寫過PHP的同學都知道 PHP的數組Array非常好用，特別靈活。

我在寫PHP之前使用Java做安卓開發，在接觸PHP的數組Array之后，直呼太香了！

而在學習Go基礎知識的時候了解到Go的數組和PHP的數組并不一樣；從一定程度上講，Go的slice切片類型和PHP的數組array比較像（不固定長度、引用類型、動態擴容等），但是在開發使用中遠遠不像PHP的array靈活。

初識GoFrame

最近在使用基于Go語言的GoFrame框架擼項目，發現GoFrame封裝的garray竟然比PHP的array還要好用。

garray特點簡介

garray支持int/string/interface{}三種常用的數據類型。
garray支持普通數組和排序數組，普通數組的結構體名稱定義為Array格式，排序數組的結構體名稱定義為SortedArray格式，如下：Array, intArray, StrArray，SortedArray, SortedIntArray, SortedStrArray
其中排序數組SortedArray，需要給定排序比較方法，在工具包gutil中也定義了很多ComparatorXXX的比較方法，用起來很方便。當然也支持自定義排序方式。

基本使用

package main

import (
   "fmt"
   "github.com/gogf/gf/container/garray"
)

func main() {
   //創建并發安全的int型數組
   a := garray.NewIntArray(true)
   //添加數組項
   for i := 0; i < 10; i++ {
      a.Append(i)
   }
   // 打印結果：
   fmt.Println(a) //"[0,1,2,3,4,5,6,7,8,9]"

   fmt.Println("數組長度：", a.Len())
   fmt.Println("數組的值：", a.Slice())
   fmt.Println((a.Get(5))) //根據索引取值 返回值和是否取到了值 5 true

   // 在指定索引前后插入值
   _ = a.InsertAfter(9, 10)
   _ = a.InsertBefore(0, -1)
   fmt.Println(a.Slice())

   // 搜索數據項，返回對應的索引
   fmt.Println("搜索值，返回對應索引：", a.Search(5))

   // 刪除
   a.Remove(0)
   fmt.Println(a.Slice())

   // 并發安全 寫鎖操作
   a.LockFunc(func(array []int) {
      //將最后一項的值改為100
      array[len(array)-1] = 100
   })
   fmt.Println(a) //"[0,1,2,3,4,5,6,7,8,9,100]"
   
   // 并發安全 讀鎖操作
   a.RLockFunc(func(array []int) {
      fmt.Println(array[len(array)-1]) //100
   })

   // 清空數組
   a.Clear()
   fmt.Println("清空數組之后：", a.Slice())
}

打印結果

數組出棧

數組出棧使用Pop*關鍵字
數組可以按順序出棧，而gf提供的另外一個數據類型gmap的pop*方法是隨機出棧 (關注我，會在后續的文章中更新說明)
garray中隨機出棧，我們可以使用rand()或者popRand()

package main

import (
   "fmt"
   "github.com/gogf/gf/container/garray"
   "github.com/gogf/gf/frame/g"
)

//數組出棧 pop 數組可以按順序出棧 map的pop是隨機出棧
func main() {
   a := garray.NewFrom([]interface{}{1, 2, 3, 4, 5, 6})
   fmt.Println(a.PopLeft())
   fmt.Println(a.PopLefts(2))
   fmt.Println(a.PopRight())
   fmt.Println(a.PopRights(2))
   fmt.Println(a) //全部出棧后 數組為空
   /**
   打印結果：
   1 true
   [2 3]
   6 true
   [4 5]
   []
   */

   // 有什么辦法能像map一樣隨機出棧呢？ 在garray中我們使用rand()或者popRand()
   a1 := garray.NewFrom(g.Slice{1, 2, 3, 4, 5, 6, 7})
   fmt.Println("----------")
   fmt.Println(a1.Rand())      //隨機取值
   fmt.Println(a1.PopRands(2)) //隨機出棧
   fmt.Println(a1)

}

包含判斷

注意：Contains()是區分大小寫
空值過濾使用：FilterEmpty
nil過濾使用：FilterNil

package main

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

//包含 contains 區分大小寫
func main() {
   var a garray.Array
   a.Append("a")
   g.Dump(a.Contains("a")) //true
   g.Dump(a.Contains("A")) //false

   // 空值過濾
   a1 := garray.NewFrom([]interface{}{0, 1, "2", nil, false, g.Slice{}, "王中陽"})
   a2 := garray.NewFrom([]interface{}{0, 1, "2", nil, false, g.Slice{}, "王中陽"})
   g.Dump("empty過濾：", a1.FilterEmpty()) //empty過濾："[1,2,"王中陽"]"
   g.Dump("nil過濾：", a2.FilterNil())     //nil過濾："[0,1,2,"false","[]","王中陽"]"

   a3 := garray.NewFrom([]interface{}{1, 2, 3, 4, 5, 6, 7})

   g.Dump("數組翻轉：", a3.Reverse())

   g.Dump("數組隨機排序：", a3.Shuffle())
}

打印結果

排序數組

我們可以自定義NewSortedArray的排序規則，以實現是升序數組還是降序數組；
排序數組還有唯一性校驗的功能：garray.SetUnique(true)
gf框架的gutil工具包定義好了常用的排序規則

package main

import (
   "github.com/gogf/gf/container/garray"
   "github.com/gogf/gf/frame/g"
   "github.com/gogf/gf/util/gutil"
)

//我們可以自定義NewSortedArray的排序規則，以實現是升序數組還是降序數組；排序數組還有唯一性校驗的功能
func main() {
   //自定義排序數組：降序排列
   a := garray.NewSortedArray(func(a, b interface{}) int {
      if a.(int) < b.(int) {
         return 1
      }
      if a.(int) > b.(int) {
         return -1
      }
      return 0
   })
   // 排序規格可以使用gutil中定義好的
   a.Add(2) //數組的賦值用add map的賦值用set
   a.Add(1)
   a.Add(3)
   g.Dump("a:", a) //打印結果："[3,2,1]"

   //升序數組
   a2 := garray.NewSortedArray(gutil.ComparatorInt)
   a2.Add(2)
   a2.Add(1)
   a2.Add(3)
   g.Dump("a2:", a2)
   // 添加重復元素
   a2.Add(2)
   g.Dump("a2添加重復元素后：", a2)
   a2.SetUnique(true) //設置不允許重復元素
   g.Dump("a2設置不允許重復元素之后：", a2)
}

打印結果

join、chunk、merge

數據項串聯是相當常用的場景，比如多個id以逗號分隔入庫存儲，我們使用join關鍵字即可
garray支持將一個數組拆分成指定數量的二維數組，使用chunk關鍵字
garray支持使用merge關鍵字合并數組

package main

import (
   "fmt"
   "github.com/gogf/gf/container/garray"
   "github.com/gogf/gf/frame/g"
)

func main() {
   //join 串聯 常用于逗號分割
   a := garray.NewFrom(g.Slice{1, 2, 3, 4, 5})
   fmt.Println("串聯結果：", a.Join("_")) //1_2_3_4_5

   //數組拆分 chunk
   fmt.Println("數組拆分：", a.Chunk(2)) //[[1 2] [3 4] [5]]

   // 數組合并 可以合并數組 也可以合并slice（原生切片和g.Slice都支持）
   a1 := garray.NewFrom(g.Slice{1, 2})
   a2 := garray.NewFrom(g.Slice{3, 4})
   s1 := g.Slice{5, 6}
   s2 := []string{"7", "8"}
   s3 := []int{9, 0}
   a1.Merge(a2)
   a1.Merge(s1)
   a1.Merge(s2)
   a1.Merge(s3)
   fmt.Println("合并結果：", a1) // [1,2,3,4,5,6,7,8,9,0]
}

打印結果：

遍歷

garray天然支持升序遍歷和降序遍歷
函數Iterator()是IteratorAsc()的別名

package main

import (
   "fmt"
   "github.com/gogf/gf/container/garray"
   "github.com/gogf/gf/frame/g"
)

//數組遍歷 iterate
func main() {
   a := garray.NewFrom(g.Slice{"a", "b", "c"})
   fmt.Println("升序遍歷結果")
   a.Iterator(func(k int, v interface{}) bool {
      fmt.Printf("%v,%v \n", k, v)
      return true
   })

   // 數組倒序遍歷
   fmt.Println("倒序遍歷結果：")
   a.IteratorDesc(func(k int, v interface{}) bool {
      fmt.Printf("%v,%v \n", k, v)
      return true
   })
}

打印結果

遍歷修改 walk函數

非常好用！！！

看到這個方法，更堅信了我一個觀點：GF的作者一定寫了幾年PHP。

package main

import (
   "github.com/gogf/gf/container/garray"
   "github.com/gogf/gf/frame/g"
   "github.com/gogf/gf/util/gconv"
)

//walk遍歷修改 修改數組的值
func main() {
   var a garray.Array
   tables := g.Slice{"user", "user_detail"}
   a.Append(tables...)
   prefix := "gf_"
   a.Walk(func(value interface{}) interface{} {
      return prefix + gconv.String(value)
   })
   g.Dump(a)
}

打印結果

序列化和反序列化

這里重點提一下：gf container容器包下的對象都實現對原生json包的支持，都支持序列化和反序列化。
gf非常重視對序列化的支持，Go學習專欄[2] 文章中介紹了gmap、glist、gqueue、gset、gtree...等gf組件，都是支持序列化和反序列化的。

package main

import (
   "encoding/json"
   "fmt"
   "github.com/gogf/gf/container/garray"
   "github.com/gogf/gf/frame/g"
)

//gf container容器包下的對象都實現對原生json包的支持，即都支持序列化和反序列化
func main() {
   //序列化
   type student struct {
      Name   string
      Age    int
      Scores *garray.IntArray
   }
   s := student{
      Name:   "王中陽",
      Age:    28,
      Scores: garray.NewIntArrayFrom([]int{100, 98}),
   }

   bytes, _ := json.Marshal(s)
   g.Dump(bytes) //{"Name":"王中陽","Age":28,"Scores":[100,98]}

   //反序列化
   data := []byte(`{"Name":"王中陽","Age":28,"Scores":[100,98]}`)
   s2 := student{}
   _ = json.Unmarshal(data, &s2)
   fmt.Println(s2) //{王中陽 28 [100,98]}
}

打印結果

總結

綜上我們了解到：

garray支持設置并發安全開關
支持排序數組
支持數組出棧、包含判斷、join、chunk、merge等常用的工具方法
天然支持升序遍歷、遍歷修改
天然支持序列化和反序列化

大家是不是明顯感覺到GoFrame的garray比PHP的array還要好用。

更加堅信GoFrame的作者是寫過PHP的??.

參考資料

[1]Go語言學習專欄: https://juejin.cn/column/7064777730532835336

[2]Go學習專欄: https://juejin.cn/column/7064777730532835336

[3]Go語言學習路線圖: http://github.com/wangzhongyang007/Go

本文轉載自微信公眾號「程序員升級打怪之旅」，作者「王中陽Go」，可以通過以下二維碼關注。

轉載本文請聯系「程序員升級打怪之旅」公眾號。

責任編輯：武曉燕來源：程序員升職加薪之旅