Function: average()

average(iterable: IterableResolvable<NumberResolvable>): null | number

Defined in: projects/utilities/packages/iterator-utilities/src/lib/average.ts:24

Consumes the iterable and returns the average value of all the elements. If the iterable is empty, it returns null.

Parameters

Parameter	Type	Description
iterable	IterableResolvable<NumberResolvable>	The iterator to calculate the average of.

Returns

null | number

The average of the sequence of numbers, or null if the sequence is empty or contains only non-number values.

Example

import { average } from '@sapphire/iterator-utilities';

const iterable = [1, 2, 3, 4, 5];
console.log(average(iterable));
// Output: 3

Remarks

This function consumes the entire iterator.