Functions to introspect the Unicode script property for binaries (Strings) and codepoints.
The primary API is script/1 which returns the script of a codepoint, or the list of scripts of a string.
The functions fetch/1, get/1 and count/1 provide introspection of the codepoint ranges belonging to a script. scripts/0, known_scripts/0 and aliases/0 return the underlying script data.
Summary
Functions
Returns a map of aliases for Unicode scripts.
Returns the count of characters in a given script.
Returns the Unicode codepoint ranges for a given script.
Returns the Unicode codepoint ranges for a given script.
Returns a list of known Unicode script names.
Returns the script name(s) for the given binary or codepoint.
Returns the map of Unicode scripts.
Types
@type t() ::
:zanabazar_square
| :yi
| :yezidi
| :warang_citi
| :wancho
| :vithkuqi
| :vai
| :ugaritic
| :tulu_tigalari
| :toto
| :tolong_siki
| :todhri
| :tirhuta
| :tifinagh
| :tibetan
| :thai
| :thaana
| :telugu
| :tangut
| :tangsa
| :tamil
| :takri
| :tai_yo
| :tai_viet
| :tai_tham
| :tai_le
| :tagbanwa
| :tagalog
| :syriac
| :syloti_nagri
| :sunuwar
| :sundanese
| :soyombo
| :sora_sompeng
| :sogdian
| :sinhala
| :signwriting
| :sidetic
| :siddham
| :shavian
| :sharada
| :seal
| :saurashtra
| :samaritan
| :runic
| :rejang
| :psalter_pahlavi
| :proto_cuneiform
| :phoenician
| :phags_pa
| :pau_cin_hau
| :palmyrene
| :pahawh_hmong
| :osmanya
| :osage
| :oriya
| :old_uyghur
| :old_turkic
| :old_south_arabian
| :old_sogdian
| :old_persian
| :old_permic
| :old_north_arabian
| :old_italic
| :old_hungarian
| :ol_onal
| :ol_chiki
| :ogham
| :nyiakeng_puachue_hmong
| :nushu
| :nko
| :newa
| :new_tai_lue
| :nandinagari
| :nag_mundari
| :nabataean
| :myanmar
| :multani
| :mro
| :mongolian
| :modi
| :miao
| :meroitic_hieroglyphs
| :meroitic_cursive
| :mende_kikakui
| :meetei_mayek
| :medefaidrin
| :masaram_gondi
| :marchen
| :manichaean
| :mandaic
| :malayalam
| :makasar
| :mahajani
| :lydian
| :lycian
| :lisu
| :linear_b
| :linear_a
| :limbu
| :lepcha
| :latin
| :lao
| :kirat_rai
| :khudawadi
| :khojki
| :khmer
| :khitan_small_script
| :kharoshthi
| :kayah_li
| :kawi
| :katakana
| :kannada
| :kaithi
| :jurchen
| :javanese
| :inscriptional_parthian
| :inscriptional_pahlavi
| :inherited
| :imperial_aramaic
| :hiragana
| :hebrew
| :hatran
| :hanunoo
| :hanifi_rohingya
| :hangul
| :han
| :gurung_khema
| :gurmukhi
| :gunjala_gondi
| :gujarati
| :greek
| :grantha
| :gothic
| :glagolitic
| :georgian
| :garay
| :ethiopic
| :elymaic
| :elbasan
| :egyptian_hieroglyphs
| :duployan
| :dogra
| :dives_akuru
| :devanagari
| :deseret
| :cyrillic
| :cypro_minoan
| :cypriot
| :cuneiform
| :coptic
| :common
| :chorasmian
| :cherokee
| :cham
| :chakma
| :caucasian_albanian
| :carian
| :canadian_aboriginal
| :buhid
| :buginese
| :braille
| :brahmi
| :bopomofo
| :bhaiksuki
| :beria_erfe
| :bengali
| :batak
| :bassa_vah
| :bamum
| :balinese
| :avestan
| :armenian
| :arabic
| :anatolian_hieroglyphs
| :ahom
| :adlam
A Unicode script name.
Generated from the script data at compile time, so it tracks each Unicode release automatically rather than being hand-maintained.
Functions
Returns a map of aliases for Unicode scripts.
An alias is an alternative name for referring to a script. Aliases are resolved by the fetch/1 and get/1 functions.
Returns
- A map where the alias string is the key and the script name is the value.
Examples
iex> Unicode.Script.aliases() |> Map.get("ogam")
:oghamReturns the count of characters in a given script.
Aliases are resolved by this function.
Arguments
scriptis any script name or alias, as an atom or string.
Returns
A non-negative integer count of the codepoints in the script.
:errorif the script is not known.
Examples
iex> Unicode.Script.count("mongolian")
168Returns the Unicode codepoint ranges for a given script.
Aliases are resolved by this function.
Arguments
scriptis any script name or alias, as an atom or string.
Returns
{:ok, range_list}whererange_listis a list of codepoint ranges as 2-tuples.:errorif the script is not known.
Examples
iex> Unicode.Script.fetch(:ogham)
{:ok, [{5760, 5788}]}
iex> Unicode.Script.fetch(:invalid)
:errorReturns the Unicode codepoint ranges for a given script.
Aliases are resolved by this function.
Arguments
scriptis any script name or alias, as an atom or string.
Returns
A list of codepoint ranges as 2-tuples.
nilif the script is not known.
Examples
iex> Unicode.Script.get(:ogham)
[{5760, 5788}]
iex> Unicode.Script.get(:invalid)
nilReturns a list of known Unicode script names.
This function does not return the names of any script aliases.
Returns
- A list of atom script names.
Examples
iex> :latin in Unicode.Script.known_scripts()
trueReturns the script name(s) for the given binary or codepoint.
Arguments
string_or_codepointis either a binary (String) or a codepoint in the range0..0x10FFFF.
Returns
For a codepoint, a single script name is returned.
For a binary, a list of the distinct script names of the codepoints in the binary is returned.
Examples
iex> Unicode.Script.script(?A)
:latin
iex> Unicode.Script.script("abc")
[:latin]Returns the map of Unicode scripts.
Returns
- A map where the script name is the key and a list of codepoint ranges as 2-tuples is the value.
Examples
iex> Unicode.Script.scripts() |> Map.get(:ogham)
[{5760, 5788}]