Add At func

README.md

@@ -269,6 +269,19 @@ jslice.Unshift(&s, 1)
 // s == []int{1,2,3,4,5}
 ```
 
+## At
+
+At takes an integer value and returns the item at that index, allowing for **positive** _and_ **negative** integers. Negative integers
+count back from the last item in the array. 
+
+**NOTE**: If the provided index is negative, and it's absolute value is greater than the length of the array, we return the first item (index 0) in the array.
+
+```go
+s := []int{1,2,3,4,5}
+r := jslice.At(s, -3)
+// r == 3
+```
+
 
 
 

at.go

@@ -0,0 +1,22 @@
+package jslice
+
+import "math"
+
+// At takes an integer value and returns the item at that index,
+// allowing for positive and negative integers. Negative integers
+// count back from the last item in the array.
+//
+// If the provided index is negative but it's absolute value
+// is greater than the length of the array, we return the first
+// item (index 0) in the array.
+func At[T any](s []T, index int) T {
+	size := len(s)
+	if index < 0 {
+		if int(math.Abs(float64(index))) > size {
+			index = 0
+		} else {
+			index = size + index
+		}
+	}
+	return s[index]
+}

jslice_test.go

@@ -465,6 +465,26 @@ func TestUnshift(t *testing.T) {
 	t.Log(s)
 }
 
+func TestAt_NegativeIndex(t *testing.T) {
+	EXPECT_VAL := 5
+	s := []int{1, 2, 3, 4, 5}
+	r := jslice.At(s, -1)
+	if r != EXPECT_VAL {
+		t.Fatalf("Expected=%d | Got=%d\n", EXPECT_VAL, r)
+	}
+	t.Log(r)
+}
+
+func TestAt_PositiveIndex(t *testing.T) {
+	EXPECT_VAL := 2
+	s := []int{1, 2, 3, 4, 5}
+	r := jslice.At(s, 1)
+	if r != EXPECT_VAL {
+		t.Fatalf("Expected=%d | Got=%d\n", EXPECT_VAL, r)
+	}
+	t.Log(r)
+}
+
 // **************************************************************
 
 func TestTest(t *testing.T) {