View Source Cldr.Unit.Range (Cldr Units v3.16.1)
Implements a unit range type, similar to Date.Range.
A unit range but be comprise first and last units that
have the same base unit. The last unit will be converted
to the unit type of the first unit.
Unit ranges are useful in at least the following cases:
- To be able to enumerate a unit range.
- To be able to format a unit range in a localised manner using
Cldr.Number.to_range_string/2.
Link to this section Summary
Types
A unit range consists of two units where the last unit can be converted to the same unit type as the first unit.
Link to this section Types
@type t() :: %{first: Cldr.Unit.t(), last: Cldr.Unit.t()}
A unit range consists of two units where the last unit can be converted to the same unit type as the first unit.
Link to this section Functions
@spec new(Cldr.Unit.t(), Cldr.Unit.t()) :: {:ok, t()} | {:error, {module(), String.t()}}
Returns a new Cldr.Unit.Range.
arguments
Arguments
firstis anyCldr.Unit.t/0returned byCldr.Unit.new/2.lastis anyCldr.Unit.t/0returned byCldr.Unit.new/2that is convertible to the same unit asfirstand where its converted value is greater than or equal to the value offirst.
returns
Returns
{:ok, unit_range}or{:error, {exception, reason}}.
examples
Examples
iex> Cldr.Unit.Range.new Cldr.Unit.new!(:gram, 1), Cldr.Unit.new!(:gram, 4)
{:ok, Cldr.Unit.Range.new!(Cldr.Unit.new!(:gram, 1), Cldr.Unit.new!(:gram, 4))}
iex> Cldr.Unit.Range.new Cldr.Unit.new!(:gram, 1), Cldr.Unit.new!(:liter, 4)
{:error,
{Cldr.Unit.InvalidRangeError,
"Unit ranges require that the last unit can be converted to the first unit. " <>
"Found Cldr.Unit.new!(:gram, 1) and Cldr.Unit.new!(:liter, 4)"}}
iex> Cldr.Unit.Range.new Cldr.Unit.new!(:gram, 5), Cldr.Unit.new!(:gram, 4)
{:error,
{Cldr.Unit.InvalidRangeError,
"Unit ranges require that the first unit be less than or equal to the last. " <>
"Found Cldr.Unit.new!(:gram, 5) and Cldr.Unit.new!(:gram, 4)"}}@spec new!(Cldr.Unit.t(), Cldr.Unit.t()) :: t() | no_return()
Returns a new Cldr.Unit.Range or raises an exception.
arguments
Arguments
firstis anyCldr.Unit.t/0returned byCldr.Unit.new/2.lastis anyCldr.Unit.t/0returned byCldr.Unit.new/2that is convertible to the same unit asfirstand where its converted value is greater than or equal to the value offirst.
returns
Returns
unit_rangeorraises an exception.
example
Example
iex> Cldr.Unit.Range.new! Cldr.Unit.new!(:gram, 1), Cldr.Unit.new!(:gram, 4)
Cldr.Unit.Range.new!(Cldr.Unit.new!(:gram, 1), Cldr.Unit.new!(:gram, 4))