Unicode.NfdQuickCheck (Unicode v2.2.0)

Copy Markdown View Source

Functions to introspect the Unicode NFD_Quick_Check property for binaries (Strings) and codepoints.

The NFD_Quick_Check property is used by the quick check algorithm of UAX #15 to determine whether a string is already in Normalization Form D. The value is :no; codepoints that are always allowed in NFD have the default value :yes.

The primary API is nfd_quick_check/1 which returns the value of a codepoint, or the list of values of a string.

Summary

Functions

aliases()

Returns a map of aliases for NFD_Quick_Check values.

count(value)

Returns the count of the codepoints with a given NFD_Quick_Check value.

fetch(value)

Returns the codepoint ranges for a given NFD_Quick_Check value.

get(value)

Returns the codepoint ranges for a given NFD_Quick_Check value.

known_nfd_quick_check()

Returns a list of known NFD_Quick_Check values.

nfd_quick_check()

Returns the map of NFD_Quick_Check values to codepoint ranges.

nfd_quick_check(string)

Returns the NFD_Quick_Check value of the given binary or codepoint.

Functions

aliases()

Returns a map of aliases for NFD_Quick_Check values.

Returns

  • A map where the alias string is the key and the value is the atom value.

Examples

iex> Unicode.NfdQuickCheck.aliases() |> Map.get("n")
:no

count(value)

Returns the count of the codepoints with a given NFD_Quick_Check value.

Aliases are resolved by this function.

Arguments

  • value is any value name or alias, as an atom or string.

Returns

  • A non-negative integer count of the codepoints with the value.

  • :error if the value is not known.

Examples

iex> is_integer(Unicode.NfdQuickCheck.count(:no))
true

fetch(value)

Returns the codepoint ranges for a given NFD_Quick_Check value.

Aliases are resolved by this function.

Arguments

  • value is any value name or alias, as an atom or string.

Returns

  • {:ok, range_list} where range_list is a list of codepoint ranges as 2-tuples.

  • :error if the value is not known.

Examples

iex> Unicode.NfdQuickCheck.fetch(:no) |> elem(0)
:ok

iex> Unicode.NfdQuickCheck.fetch(:invalid)
:error

get(value)

Returns the codepoint ranges for a given NFD_Quick_Check value.

Aliases are resolved by this function.

Arguments

  • value is any value name or alias, as an atom or string.

Returns

  • A list of codepoint ranges as 2-tuples.

  • nil if the value is not known.

Examples

iex> Unicode.NfdQuickCheck.get(:invalid)
nil

known_nfd_quick_check()

Returns a list of known NFD_Quick_Check values.

Returns

  • A list of atom values.

Examples

iex> :no in Unicode.NfdQuickCheck.known_nfd_quick_check()
true

nfd_quick_check()

Returns the map of NFD_Quick_Check values to codepoint ranges.

Returns

  • A map where the quick check value (:no) is the key and a list of codepoint ranges as 2-tuples is the value.

Examples

iex> Unicode.NfdQuickCheck.nfd_quick_check() |> Map.keys() |> Enum.sort()
[:no, :yes]

nfd_quick_check(string)

Returns the NFD_Quick_Check value of the given binary or codepoint.

Arguments

  • string_or_codepoint is either a binary (String) or a codepoint in the range 0..0x10FFFF.

Returns

  • For a codepoint, :no or the default :yes.

  • For a binary, a list of the distinct values of the codepoints in the binary is returned.

Examples

iex> Unicode.NfdQuickCheck.nfd_quick_check(?A)
:yes

iex> Unicode.NfdQuickCheck.nfd_quick_check(0x00C0)
:no