2024-07-03 04:43:50 +03:00
|
|
|
# forEachRight
|
|
|
|
|
|
|
|
Iterates over elements of `arr` from right to left and invokes `callback` for each element.
|
|
|
|
|
|
|
|
## Signature
|
|
|
|
|
|
|
|
```ts
|
|
|
|
function forEachRight<T>(arr: T[], callback: (value: T, index: number, arr: T[]) => void): void;
|
|
|
|
```
|
|
|
|
|
|
|
|
### Parameters
|
|
|
|
|
|
|
|
- `arr` (`T[]`): The array to iterate over.
|
|
|
|
- `callback` (`(value: T, index: number, arr: T[])`): The function invoked per iteration.
|
2024-08-11 04:54:13 +03:00
|
|
|
- `value`: The current element being processed in the array.
|
|
|
|
- `index`: The index of the current element being processed in the array.
|
|
|
|
- `arr`: The array `forEachRight` was called upon.
|
2024-07-03 04:43:50 +03:00
|
|
|
|
|
|
|
### Returns
|
|
|
|
|
|
|
|
`void`
|
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
```ts
|
|
|
|
import { forEachRight } from 'es-toolkit/forEachRight';
|
|
|
|
|
|
|
|
const array = [1, 2, 3];
|
|
|
|
const result: number[] = [];
|
|
|
|
|
|
|
|
// Use the forEachRight function to iterate through the array and add each element to the result array.
|
2024-08-11 04:54:13 +03:00
|
|
|
forEachRight(array, value => {
|
2024-07-03 04:43:50 +03:00
|
|
|
result.push(value);
|
|
|
|
});
|
|
|
|
|
2024-08-11 04:54:13 +03:00
|
|
|
console.log(result); // Output: [3, 2, 1];
|
|
|
|
```
|