Unicode v1.1.0 Unicode View Source
Functions to introspect the Unicode character database and to provide fast codepoint lookups for scripts, blocks, categories and properties.
Link to this section Summary
Functions
Returns true
if a single Unicode codepoint (or all characters in the
given string) adhere to the Derived Core Property Alphabetic
otherwise returns false
.
Returns true
if a single Unicode codepoint (or all characters
in the given string) are either alphabetic?/1
or
numeric?/1
otherwise returns false
.
Returns the block name of a codepoint or the list of block names for each codepoint in a string.
Returns either true
if the codepoint has the :cased
property
or false
.
Returns the Unicode category for a codepoint or a list of categories for a string.
Returns true
if a single Unicode codepoint (or all characters
in the given string) adhere to Unicode category :Nd
otherwise returns false
.
Returns true
if a single Unicode codepoint (or all characters
in the given string) are emoji
otherwise returns false
.
Returns true
if a single Unicode codepoint (or all characters
in the given string) the category :Ll
otherwise returns false
.
Returns true
if a single Unicode codepoint (or all characters
in the given string) the category :Sm
otherwise returns false
.
Returns true
if a single Unicode codepoint (or all characters
in the given string) adhere to Unicode categories :Nd
,
:Nl
and :No
otherwise returns false
.
Returns the list of properties of each codepoint in a given string or the list of properties for a given string.
Returns a map of aliases mapping property names to a module that serves that property
Returns a list of tuples representing the valid ranges of Unicode code points.
Returns the script name of a codepoint or the list of block names for each codepoint in a string.
Removes accents (diacritical marks) from a string.
Returns true
if a single Unicode codepoint (or all characters
in the given string) the category :Lu
otherwise returns false
.
Returns the version of Unicode in use.
Link to this section Types
Link to this section Functions
alphabetic?(codepoint_or_string)
View Sourcealphabetic?(codepoint_or_string()) :: boolean()
Returns true
if a single Unicode codepoint (or all characters in the
given string) adhere to the Derived Core Property Alphabetic
otherwise returns false
.
These are all characters that are usually used as representations of letters/syllabes/ in words/sentences.
Arguments
codepoint_or_string
is a single integer codepoint or aString.t
.
Returns
true
orfalse
For the string-version, the result will be true only if all codepoints in the string adhere to the property.
Examples
iex> Unicode.alphabetic?(?a)
true
iex> Unicode.alphabetic?("A")
true
iex> Unicode.alphabetic?("Elixir")
true
iex> Unicode.alphabetic?("الإكسير")
true
iex> Unicode.alphabetic?("foo, bar") # comma and whitespace
false
iex> Unicode.alphabetic?("42")
false
iex> Unicode.alphabetic?("龍王")
true
iex> Unicode.alphabetic?("∑") # Summation, ∑
false
iex> Unicode.alphabetic?("Σ") # Greek capital letter sigma, Σ
true
alphanumeric?(codepoint_or_string)
View Sourcealphanumeric?(codepoint_or_string()) :: boolean()
Returns true
if a single Unicode codepoint (or all characters
in the given string) are either alphabetic?/1
or
numeric?/1
otherwise returns false
.
Arguments
codepoint_or_string
is a single integer codepoint or aString.t
.
Returns
true
orfalse
For the string-version, the result will be true only if all codepoints in the string adhere to the property.
Examples
iex> Unicode.alphanumeric? "1234"
true
iex> Unicode.alphanumeric? "KeyserSöze1995"
true
iex> Unicode.alphanumeric? "3段"
true
iex> Unicode.alphanumeric? "dragon@example.com"
false
block(codepoint_or_string)
View Sourceblock(codepoint_or_string()) :: atom() | [atom(), ...]
Returns the block name of a codepoint or the list of block names for each codepoint in a string.
Arguments
codepoint_or_string
is a single integer codepoint or aString.t
.
Returns
in the case of a single codepoint, an atom block name
in the case of a string, a list of atom block names for each codepoint in the
codepoint_or_string
Exmaples
iex> Unicode.block ?ä
:latin_1_supplement
iex> Unicode.block ?A
:basic_latin
iex> Unicode.block "äA"
[:latin_1_supplement, :basic_latin]
cased?(codepoint_or_string)
View Sourcecased?(codepoint_or_string()) :: boolean()
Returns either true
if the codepoint has the :cased
property
or false
.
The :cased
property means that this character has at least
an upper and lower representation and possibly a titlecase
representation too.
Arguments
codepoint_or_string
is a single integer codepoint or aString.t
.
Returns
true
orfalse
For the string-version, the result will be true only if all codepoints in the string adhere to the property.
Examples
iex> Unicode.cased? ?ယ
false
iex> Unicode.cased? ?A
true
category(codepoint_or_string)
View Sourcecategory(codepoint_or_string()) :: atom() | [atom(), ...]
category(codepoint_or_string()) :: atom() | [atom(), ...]
Returns the Unicode category for a codepoint or a list of categories for a string.
Argument
codepoint_or_string
is a single integer codepoint or aString.t
.
Returns
in the case of a single codepoint, an atom representing one of the categories listed below
in the case of a string, a list representing the category for each codepoint in the string
Notes
THese categories match the names of the Unicode character classes used in various regular expression engines and in Unicode Sets. The full list of categories is:
Category | Matches |
---|---|
:C | Other |
:Cc | Control |
:Cf | Format |
:Cn | Unassigned |
:Co | Private use |
:Cs | Surrogate |
:L | Letter |
:Ll | Lower case letter |
:Lm | Modifier letter |
:Lo | Other letter |
:Lt | Title case letter |
:Lu | Upper case letter |
:M | Mark |
:Mc | Spacing mark |
:Me | Enclosing mark |
:Mn | Non-spacing mark |
:N | Number |
:Nd | Decimal number |
:Nl | Letter number |
:No | Other number |
:P | Punctuation |
:Pc | Connector punctuation |
:Pd | Dash punctuation |
:Pe | Close punctuation |
:Pf | Final punctuation |
:Pi | Initial punctuation |
:Po | Other punctuation |
:Ps | Open punctuation |
:S | Symbol |
:Sc | Currency symbol |
:Sk | Modifier symbol |
:Sm | Mathematical symbol |
:So | Other symbol |
:Z | Separator |
:Zl | Line separator |
:Zp | Paragraph separator |
:Zs | Space separator |
Note too that the group level categories like :L
,
:M
, :S
and so on are not assigned to any codepoint.
They can only be identified by combining the results
for each of the subsidiary categories.
Examples
iex> Unicode.category ?ä
:Ll
iex> Unicode.category ?A
:Lu
iex> Unicode.category ?🧐
:So
iex> Unicode.category ?+
:Sm
iex> Unicode.category ?1
:Nd
iex> Unicode.category "äA"
[:Ll, :Lu]
digits?(codepoint_or_string)
View Sourcedigits?(codepoint_or_string()) :: boolean()
Returns true
if a single Unicode codepoint (or all characters
in the given string) adhere to Unicode category :Nd
otherwise returns false
.
This group of characters represents the decimal digits zero through nine (0..9) and the equivalents in non-Latin scripts.
Arguments
codepoint_or_string
is a single integer codepoint or aString.t
.
Returns
true
orfalse
For the string-version, the result will be true only if all codepoints in the string adhere to the property.
For the string-version, the result will be true only if all codepoints in the string adhere to the property.
Examples
emoji?(codepoint_or_string)
View Sourceemoji?(codepoint_or_string()) :: boolean()
Returns true
if a single Unicode codepoint (or all characters
in the given string) are emoji
otherwise returns false
.
Arguments
codepoint_or_string
is a single integer codepoint or aString.t
.
Returns
true
orfalse
For the string-version, the result will be true only if all codepoints in the string adhere to the property.
Examples
iex> Unicode.emoji? "🧐🤓🤩🤩️🤯"
true
lowercase?(codepoint_or_string)
View Sourcelowercase?(codepoint_or_string()) :: boolean()
Returns true
if a single Unicode codepoint (or all characters
in the given string) the category :Ll
otherwise returns false
.
Notice that there are many languages that do not have a distinction between cases. Their characters are not included in this group.
Arguments
codepoint_or_string
is a single integer codepoint or aString.t
.
Returns
true
orfalse
For the string-version, the result will be true only if all codepoints in the string adhere to the property.
Examples
iex> Unicode.lowercase?(?a)
true
iex> Unicode.lowercase?("A")
false
iex> Unicode.lowercase?("Elixir")
false
iex> Unicode.lowercase?("léon")
true
iex> Unicode.lowercase?("foo, bar")
false
iex> Unicode.lowercase?("42")
false
iex> Unicode.lowercase?("Σ")
false
iex> Unicode.lowercase?("σ")
true
math?(codepoint_or_string)
View Sourcemath?(codepoint_or_string()) :: boolean()
Returns true
if a single Unicode codepoint (or all characters
in the given string) the category :Sm
otherwise returns false
.
These are all characters whose primary usage is in mathematical concepts (and not in alphabets). Notice that the numerical digits are not part of this group.
Arguments
codepoint_or_string
is a single integer codepoint or aString.t
.
Returns
true
orfalse
For the string-version, the result will be true only if all codepoints in the string adhere to the property.
Examples
iex> Unicode.math?(?=)
true
iex> Unicode.math?("=")
true
iex> Unicode.math?("1+1=2") # Digits do not have the `:math` property.
false
iex> Unicode.math?("परिस")
false
iex> Unicode.math?("∑") # Summation, \u2211
true
iex> Unicode.math?("Σ") # Greek capital letter sigma, \u03a3
false
numeric?(codepoint_or_string)
View Sourcenumeric?(codepoint_or_string()) :: boolean()
Returns true
if a single Unicode codepoint (or all characters
in the given string) adhere to Unicode categories :Nd
,
:Nl
and :No
otherwise returns false
.
This group of characters represents the decimal digits zero through nine (0..9) and the equivalents in non-Latin scripts.
Arguments
codepoint_or_string
is a single integer codepoint or aString.t
.
Returns
true
orfalse
For the string-version, the result will be true only if all codepoints in the string adhere to the property.
Examples
iex> Unicode.numeric?("65535")
true
iex> Unicode.numeric?("42")
true
iex> Unicode.numeric?("lapis philosophorum")
false
properties(codepoint_or_string)
View Sourceproperties(codepoint_or_string()) :: [atom(), ...] | [[atom(), ...], ...]
Returns the list of properties of each codepoint in a given string or the list of properties for a given string.
Arguments
codepoint_or_string
is a single integer codepoint or aString.t
.
Returns
in the case of a single codepoint, an atom list of properties
in the case of a string, a list of atom lisr for each codepoint in the
codepoint_or_string
Exmaples
iex> Unicode.properties 0x1bf0
[:alphabetic, :case_ignorable]
iex> Unicode.properties ?A
[:alphabetic, :uppercase, :cased]
iex> Unicode.properties ?+
[:math]
iex> Unicode.properties "a1+"
[[:alphabetic, :lowercase, :cased], [:numeric, :emoji], [:math]]
Returns a map of aliases mapping property names to a module that serves that property
Returns a list of tuples representing the valid ranges of Unicode code points.
This information is derived from the block
ranges as defined by Unicode.Block.blocks/0
.
script(codepoint_or_string)
View Sourcescript(codepoint_or_string()) :: String.t() | [String.t(), ...]
Returns the script name of a codepoint or the list of block names for each codepoint in a string.
Arguments
codepoint_or_string
is a single integer codepoint or aString.t
.
Returns
in the case of a single codepoint, a string script name
in the case of a string, a list of string script names for each codepoint in the
codepoint_or_string
Exmaples
iex> Unicode.script ?ä
"latin"
iex> Unicode.script ?خ
"arabic"
iex> Unicode.script ?अ
"devanagari"
iex> Unicode.script ?א
"hebrew"
iex> Unicode.script ?Ж
"cyrillic"
iex> Unicode.script ?δ
"greek"
iex> Unicode.script ?ก
"thai"
iex> Unicode.script ?ယ
"myanmar"
Removes accents (diacritical marks) from a string.
Arguments
string
is anyString.t
Returns
- A string with all diacritical marks removed
Notes
The string is first normalised to :nfd
form
and then all characters in the block
:comnbining_diacritical_marks
is removed
from the string
Example
iex> Unicode.unaccent("Et Ça sera sa moitié.")
"Et Ca sera sa moitie."
uppercase?(codepoint_or_string)
View Sourceuppercase?(codepoint_or_string()) :: boolean()
Returns true
if a single Unicode codepoint (or all characters
in the given string) the category :Lu
otherwise returns false
.
Notice that there are many languages that do not have a distinction between cases. Their characters are not included in this group.
Arguments
codepoint_or_string
is a single integer codepoint or aString.t
.
Returns
true
orfalse
For the string-version, the result will be true only if all codepoints in the string adhere to the property.
Examples
iex> Unicode.uppercase?(?a)
false
iex> Unicode.uppercase?("A")
true
iex> Unicode.uppercase?("Elixir")
false
iex> Unicode.uppercase?("CAMEMBERT")
true
iex> Unicode.uppercase?("foo, bar")
false
iex> Unicode.uppercase?("42")
false
iex> Unicode.uppercase?("Σ")
true
iex> Unicode.uppercase?("σ")
false
Returns the version of Unicode in use.