## 標準庫 `cmp` 原文在[這裡](https://pkg.go.dev/cmp) go 1.21 新增 `cmp` 包提供了與有序變臉比較相關的類型和函數。 ### Ordered 定義如下： ```go type Ordered interface { ~int | ~int8 | ~in ...
標準庫 cmp
原文在這裡
go 1.21 新增 cmp 包提供了與有序變臉比較相關的類型和函數。
Ordered
定義如下：
type Ordered interface {
~int | ~int8 | ~int16 | ~int32 | ~int64 |
~uint | ~uint8 | ~uint16 | ~uint32 | ~uint64 | ~uintptr |
~float32 | ~float64 |
~string
}
Ordered 是一個約束，它允許任何有序類型：任何支持 <、<=、>=、> 運算符的類型。如果 Go 的未來版本添加了新的有序類型，這個約束將被修改以包含它們。
請註意，浮點類型可能包含 NaN（"非數字"）值。當使用如 == 或 < 的運算符比較 NaN 值和任何其他值（無論是否為 NaN）時，總是會返回 false。請參閱 Compare 函數，以獲取一種一致的方式來比較 NaN 值。
Compare
函數定義如下：
func Compare[T Ordered](x, y T) int
Compare返回值如下：
- -1，\(x\) 小於 \(y\)
- 0，\(x\) 與 \(y\) 相等
- 1，\(x\) 大於 \(y\)
對於浮點類型，NaN小於任何非NaN，-0.0等於0.0。
Less
函數定義如下：
func Less[T Ordered](x, y T) bool
Less返回x是否小於y。對於浮點類型，NaN小於任何非NaN，-0.0等於0.0。
github.com/google/go-cmp/cmp
github.com/google/go-cmp/cmp 是一個 Go 語言中用於比較任意兩個值是否相等的庫。它提供了靈活的比較選項，能夠處理複雜的數據結構，是 Go 生態系統中用於編寫測試代碼或其他需要比較值的場景的強大工具。
以下是對 github.com/google/go-cmp/cmp 的詳細介紹：
安裝
你可以使用 Go Modules 進行安裝，無需額外的安裝步驟：
go get github.com/google/go-cmp/cmp
主要特點
github.com/google/go-cmp/cmp 具有以下主要特點：
-
深度比較：
cmp可以比較複雜的數據結構，包括嵌套的結構體、切片、映射等。它會遞歸地比較結構體的欄位，確保所有的值都相等。 -
自定義比較選項：你可以使用
cmp.Options結構來自定義比較的行為。這包括忽略特定欄位、指定自定義比較函數、配置忽略類型的選項等。這使得你可以精確控制比較的方式。 -
友好的錯誤報告：當比較失敗時，
cmp生成清晰和有用的錯誤報告，幫助你理解為什麼兩個值不相等。這有助於快速識別和修複問題。 -
支持自定義比較函數：你可以編寫自定義比較函數，以處理特定類型的值的比較。這允許你在比較複雜的數據結構時定義自己的比較邏輯。
使用示例
以下是一個使用 github.com/google/go-cmp/cmp 進行比較的示例：
package main
import (
"fmt"
"github.com/google/go-cmp/cmp"
)
type Person struct {
Name string
Age int
}
func main() {
// 創建兩個 Person 結構體實例
person1 := Person{Name: "Alice", Age: 30}
person2 := Person{Name: "Bob", Age: 25}
// 使用 cmp.Equal 檢查兩個結構體是否相等
equal := cmp.Equal(person1, person2)
if equal {
fmt.Println("The two people are equal.")
} else {
fmt.Println("The two people are not equal.")
}
}
在此示例中，我們導入了 github.com/google/go-cmp/cmp 包，並使用 cmp.Equal 函數比較了兩個 Person 結構體實例。由於它們的欄位不同，所以 equal 變數的值為 false。
更高級的用法
除了基本的比較功能，github.com/google/go-cmp/cmp 還支持更高級的用法，包括自定義比較選項和自定義比較函數。以下是一些示例：
使用自定義比較選項
opts := cmp.Options{
cmp.IgnoreFields(Person{}, "Age"), // 忽略 Person 結構體的 Age 欄位
}
equal := cmp.Equal(person1, person2, opts)
使用自定義比較函數
type MyType struct {
Value int
}
// 自定義比較函數，當 Value 為偶數時認為相等
func customComparator(x, y MyType) bool {
return x.Value%2 == 0 && y.Value%2 == 0
}
opts := cmp.Options{
cmp.Comparer(customComparator),
}
equal := cmp.Equal(MyType{Value: 2}, MyType{Value: 4}, opts) // true
聲明：本作品採用署名-非商業性使用-相同方式共用 4.0 國際 (CC BY-NC-SA 4.0)進行許可，使用時請註明出處。
Author: mengbin
blog: mengbin
Github: mengbin92
cnblogs: 戀水無意
