pydoc > unicodedata

man perldoc info pydoc3 ri search

📛 NAME

unicodedata

🚀 Quick Reference

Use Case	Command	Description
📛 Get character name	unicodedata.name('A')	Returns the official Unicode name (e.g., "LATIN CAPITAL LETTER A")
🏷️ Get category	unicodedata.category('A')	Returns the general category (e.g., "Lu" for uppercase letter)
🔢 Get numeric value	unicodedata.numeric('Ⅷ')	Returns the numeric value of a numeral (e.g., 8.0 for Roman eight)
🔣 Normalize string	unicodedata.normalize('NFC', s)	Returns the NFC normal form of the string
✅ Check normalization	unicodedata.is_normalized('NFC', s)	Returns True if the string is in NFC
🔗 Get combining class	unicodedata.combining('\u0308')	Returns the canonical combining class (e.g., 230 for diaeresis)
↔️ Bidirectional class	unicodedata.bidirectional('A')	Returns "L" (Left‑to‑Right) for normal Latin letters
🔢 Decimal digit	unicodedata.decimal('٣')	Returns decimal value 3 for Arabic‑Indic digit three
1️⃣ Digit value	unicodedata.digit('³')	Returns digit value 3 for superscript three
🌏 East Asian width	unicodedata.east_asian_width('あ')	Returns "W" (wide) for CJK characters
🪞 Mirror property	unicodedata.mirrored('(')	Returns 1 (mirrored) for parentheses
🌀 Decompose	unicodedata.decomposition('é')	Returns "0065 0301" (base + combining accent)
🔍 Lookup by name	unicodedata.lookup('EURO SIGN')	Returns the character '€'

📖 DESCRIPTION

This module provides access to the Unicode Character Database 📊 which defines character properties for all Unicode characters. The data in this database is based on the UnicodeData.txt file 📄 version 13.0.0 which is publicly available from ftp://ftp.unicode.org/.

The module uses the same names and symbols as defined by the UnicodeData File Format 13.0.0.

📦 CLASSES

🛠️ class UCD(builtins.object)

🔹 Methods defined here:

• __getattribute__(self, name, /) — Return getattr(self, name).
• bidirectional(self, chr, /) — Returns the bidirectional class assigned to the character chr as string. If no such value is defined, an empty string is returned.
• category(self, chr, /) — Returns the general category assigned to the character chr as string.
• combining(self, chr, /) — Returns the canonical combining class assigned to the character chr as integer. Returns 0 if no combining class is defined.
• decimal(...) — Converts a Unicode character into its equivalent decimal value. Returns the decimal value assigned to the character chr as integer. If no such value is defined, default is returned, or, if not given, ValueError is raised.
• decomposition(self, chr, /) — Returns the character decomposition mapping assigned to the character chr as string. An empty string is returned in case no such mapping is defined.
• digit(...) — Converts a Unicode character into its equivalent digit value. Returns the digit value assigned to the character chr as integer. If no such value is defined, default is returned, or, if not given, ValueError is raised.
• east_asian_width(self, chr, /) — Returns the east asian width assigned to the character chr as string.
• is_normalized(self, form, unistr, /) — Return whether the Unicode string unistr is in the normal form form. Valid values for form are 'NFC', 'NFKC', 'NFD', and 'NFKD'.
• lookup(self, name, /) — Look up character by name. If a character with the given name is found, return the corresponding character. If not found, KeyError is raised.
• mirrored(self, chr, /) — Returns the mirrored property assigned to the character chr as integer. Returns 1 if the character has been identified as a "mirrored" character in bidirectional text, 0 otherwise.
• name(...) — Returns the name assigned to the character chr as a string. If no name is defined, default is returned, or, if not given, ValueError is raised.
• normalize(self, form, unistr, /) — Return the normal form form for the Unicode string unistr. Valid values for form are 'NFC', 'NFKC', 'NFD', and 'NFKD'.
• numeric(...) — Converts a Unicode character into its equivalent numeric value. Returns the numeric value assigned to the character chr as float. If no such value is defined, default is returned, or, if not given, ValueError is raised.

🔹 Data descriptors defined here:

• unidata_version

⚙️ FUNCTIONS

• bidirectional(chr, /) — Returns the bidirectional class assigned to the character chr as string. If no such value is defined, an empty string is returned. 🌐
• category(chr, /) — Returns the general category assigned to the character chr as string. 🏷️
• combining(chr, /) — Returns the canonical combining class assigned to the character chr as integer. Returns 0 if no combining class is defined. 🔗
• decimal(...) — Converts a Unicode character into its equivalent decimal value. Returns the decimal value assigned to the character chr as integer. If no such value is defined, default is returned, or, if not given, ValueError is raised. 🔢
• decomposition(chr, /) — Returns the character decomposition mapping assigned to the character chr as string. An empty string is returned in case no such mapping is defined. 🌀
• digit(...) — Converts a Unicode character into its equivalent digit value. Returns the digit value assigned to the character chr as integer. If no such value is defined, default is returned, or, if not given, ValueError is raised. 1️⃣
• east_asian_width(chr, /) — Returns the east asian width assigned to the character chr as string. 🌏
• is_normalized(form, unistr, /) — Return whether the Unicode string unistr is in the normal form form. Valid values for form are 'NFC', 'NFKC', 'NFD', and 'NFKD'. ✅
• lookup(name, /) — Look up character by name. If a character with the given name is found, return the corresponding character. If not found, KeyError is raised. 🔍
• mirrored(chr, /) — Returns the mirrored property assigned to the character chr as integer. Returns 1 if the character has been identified as a "mirrored" character in bidirectional text, 0 otherwise. 🪞
• name(...) — Returns the name assigned to the character chr as a string. If no name is defined, default is returned, or, if not given, ValueError is raised. 📛
• normalize(form, unistr, /) — Return the normal form form for the Unicode string unistr. Valid values for form are 'NFC', 'NFKC', 'NFD', and 'NFKD'. 🔣
• numeric(...) — Converts a Unicode character into its equivalent numeric value. Returns the numeric value assigned to the character chr as float. If no such value is defined, default is returned, or, if not given, ValueError is raised. 🔢

🗄️ DATA

• ucd_3_2_0 = <unicodedata.UCD object>
• unidata_version = '13.0.0'

📄 FILE

(built-in)

📛 NAME 🚀 Quick Reference 📖 DESCRIPTION 📦 CLASSES ⚙️ FUNCTIONS 🗄️ DATA 📄 FILE