Ergo.NumericParsers (ergo v0.3.0)
The Parsers module exists to house utility parsers that while they are terminals in the sense that they are not parameterised, they internally make use of parsers from the Combinators module.
Parsers
uint
decimal
digits
Link to this section Summary
Functions
Examples
iex> alias Ergo.{Context, Parser}
iex> import Ergo.NumericParsers
iex> context = Context.new("234.56")
iex> parser = decimal()
iex> assert %Context{status: :ok, ast: 234.56} = Parser.call(parser, context)
The digits
parser matches a series of at least one digit and returns an enumeration
of the digits.
The number
parser matches both integer and decimal string and converts them into their
appropriate Elixir integer or float values.
The unit
parser matches a series of at least one digit and returns the
integer value of the digits.
Link to this section Functions
decimal(opts \\ [])
Examples
iex> alias Ergo.{Context, Parser}
iex> import Ergo.NumericParsers
iex> context = Context.new("234.56")
iex> parser = decimal()
iex> assert %Context{status: :ok, ast: 234.56} = Parser.call(parser, context)
digits(opts \\ [])
The digits
parser matches a series of at least one digit and returns an enumeration
of the digits.
Examples
iex> alias Ergo.{Context, Parser}
iex> import Ergo.NumericParsers
iex> context = Context.new("2345")
iex> parser = digits()
iex> assert %Context{status: :ok, ast: [2, 3, 4, 5]} = Parser.call(parser, context)
number(opts \\ [])
The number
parser matches both integer and decimal string and converts them into their
appropriate Elixir integer or float values.
Examples
iex> import Ergo.NumericParsers
iex> assert %{status: :ok, ast: 42} = Ergo.parse(number(), "42")
iex> import Ergo.NumericParsers
iex> assert %{status: :ok, ast: -42} = Ergo.parse(number(), "-42")
iex> import Ergo.NumericParsers
iex> assert %{status: :ok, ast: 42.0} = Ergo.parse(number(), "42.0")
iex> import Ergo.NumericParsers
iex> assert %{status: :ok, ast: -42.0} = Ergo.parse(number(), "-42.0")
iex> import Ergo.NumericParsers
iex> assert %{status: :ok, ast: 0} = Ergo.parse(number(), "0")
iex> import Ergo.NumericParsers
iex> assert %{status: :ok, ast: 0} = Ergo.parse(number(), "0000")
iex> import Ergo.NumericParsers
iex> assert %{status: {:error, _}} = Ergo.parse(number(), "Fourty Two")
iex> import Ergo.NumericParsers
iex> assert %{status: :ok, ast: 42} = Ergo.parse(number(), "42Fourty Two")
uint(opts \\ [])
The unit
parser matches a series of at least one digit and returns the
integer value of the digits.
Examples
iex> alias Ergo.{Context, Parser}
iex> import Ergo.NumericParsers
iex> context = Context.new("2345")
iex> parser = uint()
iex> Parser.call(parser, context)
%Context{status: :ok, ast: 2345, char: ?5, index: 4, col: 5}