pydistsim.utils.helpers.first

first(iterable: Iterable[T], default: U | None = None) → T | U | None

Return the first item in an iterable, or a default value if the iterable is empty.

Parameters:

• iterable (Iterable[T]) – The iterable to get the first item from.

• default (U | None) – The default value to return if the iterable is empty.

Returns:

The first item in the iterable, or the default value if the iterable is empty.

Return type:

T | U | None