Add two function EqualPtr and ComparePtr

README.md

@@ -322,6 +322,8 @@ Type manipulation helpers:
 - [ToSlicePtr](#tosliceptr)
 - [FromSlicePtr](#fromsliceptr)
 - [FromSlicePtrOr](#fromsliceptror)
+- [EqualPtr](#equalptr)
+- [ComparePtr](#compareptr)
 - [ToAnySlice](#toanyslice)
 - [FromAnySlice](#fromanyslice)
 - [Empty](#empty)
@@ -3689,6 +3691,67 @@ ptr := lo.FromSlicePtrOr([]*string{&str1, nil, &str2}, "fallback value")
 
 [[play](https://go.dev/play/p/CuXGVzo9G65)]
 
+### EqualPtr
+
+Checks equality of two pointers by their dereferenced values, handling nil cases.
+
+```go
+ptr42 := lo.ToPtr(42)
+ptr42_2 := lo.ToPtr(42)
+ptr100 := lo.ToPtr(100)
+ptrNil := (*int)(nil)
+
+equal1 := lo.EqualPtr(ptr42, ptr42_2)
+// equal1: true (both point to 42)
+
+equal2 := lo.EqualPtr(ptr42, ptr100)
+// equal2: false (42 != 100)
+
+equal3 := lo.EqualPtr(ptr42, ptrNil)
+// equal3: false (one is nil)
+
+equal4 := lo.EqualPtr(ptrNil, ptrNil)
+// equal4: true (both are nil)
+```
+
+[[play](https://go.dev/play/p/qMzVWWBMbNX)]
+
+### ComparePtr
+
+ComparePtr compares two pointers and returns:
+- 0 if both are nil or *a == *b
+- -1 if a is nil (and b is not) or *a < *b
+- 1 if b is nil (and a is not) or *a > *b
+
+Nil is treated as less than any non-nil value.
+
+```go
+ptr42 := lo.ToPtr(42)
+ptr42_2 := lo.ToPtr(42)
+ptr100 := lo.ToPtr(100)
+ptrNil := (*int)(nil)
+
+equal1 := lo.ComparePtr(ptr42, ptr42_2)
+// equal1: 0 (42 == 42)
+
+equal2 := lo.ComparePtr(ptr42, ptr100)
+// equal2: -1 (42 < 100)
+
+equal3 := lo.ComparePtr(ptr100, ptr42)
+// equal3: 1 (100 > 42)
+
+equal4 := lo.ComparePtr(ptr42, ptrNil)
+// equal4: 1 (42 > nil)
+
+equal5 := lo.ComparePtr(ptrNil, ptr42)
+// equal5: -1 (nil < 42)
+
+equal6 := lo.ComparePtr(ptrNil, ptrNil)
+// equal6: 0 (nil == nil)
+```
+
+[[play](https://go.dev/play/p/-VYPXhng6lB)]
+
 ### ToAnySlice
 
 Returns a slice with all elements mapped to `any` type.

docs/data/core-coalesce.md

@@ -1,7 +1,7 @@
 ---
 name: Coalesce
 slug: coalesce
-sourceRef: type_manipulation.go#L153
+sourceRef: type_manipulation.go#L156
 category: core
 subCategory: type
 signatures:

docs/data/core-coalescemap.md

@@ -1,7 +1,7 @@
 ---
 name: CoalesceMap
 slug: coalescemap
-sourceRef: type_manipulation.go#L196
+sourceRef: type_manipulation.go#L199
 category: core
 subCategory: type
 signatures:

docs/data/core-coalescemaporempty.md

@@ -1,7 +1,7 @@
 ---
 name: CoalesceMapOrEmpty
 slug: coalescemaporempty
-sourceRef: type_manipulation.go#L207
+sourceRef: type_manipulation.go#L210
 category: core
 subCategory: type
 signatures:

docs/data/core-coalesceorempty.md

@@ -1,7 +1,7 @@
 ---
 name: CoalesceOrEmpty
 slug: coalesceorempty
-sourceRef: type_manipulation.go#L167
+sourceRef: type_manipulation.go#L170
 category: core
 subCategory: type
 signatures:

docs/data/core-coalesceslice.md

@@ -1,7 +1,7 @@
 ---
 name: CoalesceSlice
 slug: coalesceslice
-sourceRef: type_manipulation.go#L174
+sourceRef: type_manipulation.go#L177
 category: core
 subCategory: type
 signatures:

docs/data/core-coalescesliceorempty.md

@@ -1,7 +1,7 @@
 ---
 name: CoalesceSliceOrEmpty
 slug: coalescesliceorempty
-sourceRef: type_manipulation.go#L185
+sourceRef: type_manipulation.go#L188
 category: core
 subCategory: type
 signatures:

docs/data/core-compareptr.md

@@ -0,0 +1,48 @@
+---
+name: ComparePtr
+slug: compareptr
+sourceRef: type_manipulation.go#L228
+category: core
+subCategory: type
+signatures:
+  - "func ComparePtr[T cmp.Ordered](a, b *T) bool"
+variantHelpers:
+  - core#type#compareptr
+similarHelpers:
+  - core#type#equalptr
+  - core#type#fromptr
+  - core#type#toptr
+position: 110
+---
+
+ComparePtr compares two pointers and returns:                                                                                                                                             
+- 0 if both are nil or *a == *b                                                                                                                                                         
+- -1 if a is nil (and b is not) or *a < *b                                                                                                                                              
+- 1 if b is nil (and a is not) or *a > *b                                                                                                                                               
+
+Nil is treated as less than any non-nil value.
+
+```go
+ptr42 := lo.ToPtr(42)
+ptr42_2 := lo.ToPtr(42)
+ptr100 := lo.ToPtr(100)
+ptrNil := (*int)(nil)
+
+equal1 := lo.ComparePtr(ptr42, ptr42_2)
+// equal1: 0 (42 == 42)
+
+equal2 := lo.ComparePtr(ptr42, ptr100)
+// equal2: -1 (42 < 100)
+
+equal3 := lo.ComparePtr(ptr100, ptr42)
+// equal3: 1 (100 > 42)
+
+equal4 := lo.ComparePtr(ptr42, ptrNil)
+// equal4: 1 (42 > nil)
+
+equal5 := lo.ComparePtr(ptrNil, ptr42)
+// equal5: -1 (nil < 42)
+
+equal6 := lo.ComparePtr(ptrNil, ptrNil)
+// equal6: 0 (nil == nil)
+```

docs/data/core-empty.md

@@ -1,7 +1,7 @@
 ---
 name: Empty
 slug: empty
-sourceRef: type_manipulation.go#L132
+sourceRef: type_manipulation.go#L135
 category: core
 subCategory: type
 signatures:

docs/data/core-emptyabletoptr.md

@@ -1,7 +1,7 @@
 ---
 name: EmptyableToPtr
 slug: emptyabletoptr
-sourceRef: type_manipulation.go#L41
+sourceRef: type_manipulation.go#L44
 category: core
 subCategory: type
 signatures:

docs/data/core-equalptr.md

@@ -0,0 +1,37 @@
+---
+name: EqualPtr
+slug: equalptr
+sourceRef: type_manipulation.go#L219
+category: core
+subCategory: type
+signatures:
+  - "func EqualPtr[T comparable](a, b *T) bool"
+variantHelpers:
+  - core#type#equalptr
+similarHelpers:
+  - core#type#compareptr
+  - core#type#fromptr
+  - core#type#toptr
+position: 100
+---
+
+Compares two pointers: returns true if both are nil or both point to equal values, false if only one is nil or values differ.
+
+```go
+ptr42 := lo.ToPtr(42)
+ptr42_2 := lo.ToPtr(42)
+ptr100 := lo.ToPtr(100)
+ptrNil := (*int)(nil)
+
+equal1 := lo.EqualPtr(ptr42, ptr42_2)
+// equal1: true (both point to 42)
+
+equal2 := lo.EqualPtr(ptr42, ptr100)
+// equal2: false (42 != 100)
+
+equal3 := lo.EqualPtr(ptr42, ptrNil)
+// equal3: false (one is nil)
+
+equal4 := lo.EqualPtr(ptrNil, ptrNil)
+// equal4: true (both are nil)
+```

docs/data/core-fromanyslice.md

@@ -1,7 +1,7 @@
 ---
 name: FromAnySlice
 slug: fromanyslice
-sourceRef: type_manipulation.go#L118
+sourceRef: type_manipulation.go#L121
 category: core
 subCategory: type
 signatures:

docs/data/core-fromptr.md

@@ -1,7 +1,7 @@
 ---
 name: FromPtr
 slug: fromptr
-sourceRef: type_manipulation.go#L53
+sourceRef: type_manipulation.go#L56
 category: core
 subCategory: type
 signatures:

docs/data/core-fromptror.md

@@ -1,7 +1,7 @@
 ---
 name: FromPtrOr
 slug: fromptror
-sourceRef: type_manipulation.go#L63
+sourceRef: type_manipulation.go#L66
 category: core
 subCategory: type
 signatures:

docs/data/core-fromsliceptr.md

@@ -1,7 +1,7 @@
 ---
 name: FromSlicePtr
 slug: fromsliceptr
-sourceRef: type_manipulation.go#L85
+sourceRef: type_manipulation.go#L88
 category: core
 subCategory: type
 signatures:

docs/data/core-isempty.md

@@ -1,7 +1,7 @@
 ---
 name: IsEmpty
 slug: isempty
-sourceRef: type_manipulation.go#L139
+sourceRef: type_manipulation.go#L142
 category: core
 subCategory: type
 signatures:

docs/data/core-isnil.md

@@ -1,7 +1,7 @@
 ---
 name: IsNil
 slug: isnil
-sourceRef: type_manipulation.go#L7
+sourceRef: type_manipulation.go#L10
 category: core
 subCategory: type
 signatures:

docs/data/core-isnotempty.md

@@ -1,7 +1,7 @@
 ---
 name: IsNotEmpty
 slug: isnotempty
-sourceRef: type_manipulation.go#L146
+sourceRef: type_manipulation.go#L149
 category: core
 subCategory: type
 signatures:

docs/data/core-isnotnil.md

@@ -1,7 +1,7 @@
 ---
 name: IsNotNil
 slug: isnil
-sourceRef: type_manipulation.go#L22
+sourceRef: type_manipulation.go#L25
 category: core
 subCategory: type
 signatures:

docs/data/core-nil.md

@@ -1,7 +1,7 @@
 ---
 name: Nil
 slug: nil
-sourceRef: type_manipulation.go#L34
+sourceRef: type_manipulation.go#L37
 category: core
 subCategory: type
 playUrl: https://go.dev/play/p/P2sD0PMXw4F

docs/data/core-toanyslice.md

@@ -1,7 +1,7 @@
 ---
 name: ToAnySlice
 slug: toanyslice
-sourceRef: type_manipulation.go#L107
+sourceRef: type_manipulation.go#L110
 category: core
 subCategory: type
 signatures:

docs/data/core-toptr.md

@@ -1,7 +1,7 @@
 ---
 name: ToPtr
 slug: toptr
-sourceRef: type_manipulation.go#L28
+sourceRef: type_manipulation.go#L31
 category: core
 subCategory: type
 signatures:

docs/data/core-tosliceptr.md

@@ -1,7 +1,7 @@
 ---
 name: ToSlicePtr
 slug: tosliceptr
-sourceRef: type_manipulation.go#L73
+sourceRef: type_manipulation.go#L76
 category: core
 subCategory: type
 signatures:

docs/static/llms.txt

@@ -305,6 +305,8 @@ Lo is built on a foundation of pragmatic engineering principles that balance pow
 - ToSlicePtr: Convert slice to slice of pointers
 - FromSlicePtr: Convert slice of pointers to slice
 - FromSlicePtrOr: Convert slice of pointers to slice or fallback
+- EqualPtr: Check two pointers to equal values
+- ComparePtr: Compare two `cmp.Ordered` pointer values
 - ToAnySlice: Convert slice to []any
 - FromAnySlice: Convert []any to typed slice
 - Empty: Get zero value of type

type_manipulation.go

@@ -1,6 +1,9 @@
 package lo
 
-import "reflect"
+import (
+	"cmp"
+	"reflect"
+)
 
 // IsNil checks if a value is nil or if it's a reference type with a nil underlying value.
 // Play: https://go.dev/play/p/P2sD0PMXw4F
@@ -212,3 +215,33 @@ func CoalesceMapOrEmpty[K comparable, V any](v ...map[K]V) map[K]V {
 	}
 	return map[K]V{}
 }
+
+// EqualPtr checks equality of two pointers by their dereferenced values, handling nil cases.
+// Play: https://go.dev/play/p/qMzVWWBMbNX
+func EqualPtr[T comparable](a, b *T) bool {
+	if a == nil || b == nil {
+		return a == b
+	}
+	return *a == *b
+}
+
+// ComparePtr compares two pointers by their dereferenced values, handling nil cases.
+// Play: https://go.dev/play/p/-VYPXhng6lB
+func ComparePtr[T cmp.Ordered](a, b *T) int {
+	if a == nil && b == nil {
+		return 0
+	}
+	if a == nil {
+		return -1
+	}
+	if b == nil {
+		return 1
+	}
+	if *a < *b {
+		return -1
+	}
+	if *a > *b {
+		return 1
+	}
+	return 0
+}