feat(arrays): add first()

thi-ng · Sep 12, 2020 · 3f5f722 · 3f5f722
1 parent 72a3200
commit 3f5f722
Showing 1 changed file with 7 additions and 0 deletions.
diff --git a/packages/arrays/src/peek.ts b/packages/arrays/src/peek.ts
@@ -1,3 +1,10 @@
+/**
+ * Returns first element of given array or `undefined` if array is empty.
+ *
+ * @param buf - array
+ */
+export const first = <T>(buf: ArrayLike<T>) => buf[0];
+
 /**
  * Returns last element of given array or `undefined` if array is empty.
  *