mirror of
https://github.com/toss/es-toolkit.git
synced 2024-11-24 11:45:26 +03:00
39 lines
840 B
Markdown
39 lines
840 B
Markdown
|
# tail
|
||
|
|
||
|
Returns a new array with all elements except for the first.
|
||
|
|
||
|
This function takes an array and returns a new array containing all the elements except for the first one. If the input array is empty or has only one element, an empty array is returned.
|
||
|
|
||
|
## Signature
|
||
|
|
||
|
```typescript
|
||
|
function tail<T>(arr: [T]): [];
|
||
|
function tail(arr: []): [];
|
||
|
function tail<T, U>(arr: [T, ...U[]]): U[];
|
||
|
function tail<T>(arr: T[]): T[];
|
||
|
```
|
||
|
|
||
|
### Parameters
|
||
|
|
||
|
- `arr` (`T[]`): The array to get the tail of.
|
||
|
|
||
|
### Returns
|
||
|
|
||
|
(`T[]`): A new array containing all elements of the input array except for the first one.
|
||
|
|
||
|
## Examples
|
||
|
|
||
|
```typescript
|
||
|
const arr1 = [1, 2, 3];
|
||
|
const result = tail(arr1);
|
||
|
// result will be [2, 3]
|
||
|
|
||
|
const arr2 = [1];
|
||
|
const result2 = tail(arr2);
|
||
|
// result2 will be []
|
||
|
|
||
|
const arr3 = [];
|
||
|
const result3 = tail(arr3);
|
||
|
// result3 will be []
|
||
|
```
|