GXUNC class¶
-
class
GXUNC
(handle=0)[source]¶ GXUNC class.
This library is not a class. Use the
GXUNC
library functions to work with Unicode characters and strings. Since version 6.2 all strings are represented internally in the the GX engine as UTF-8. The character set concept was discarded as a way to work with characters that does not fall within the normal ASCII range 0x01-0x7F. The utilities here aids with any new functionality that is now possible (e.g. an expanded symbol range with TrueType fonts).-
is_null
()[source]¶ Check if this is a null (undefined) instance
- Returns
True if this is a null (undefined) instance, False otherwise.
- Return type
bool
-
classmethod
is_valid_utf16_char
(ch)[source]¶ Check if the UTF-16 value is a valid Unicode character code point.
- Parameters
ch (int) – UTF-16 value (32-bit int, lower 16 bits used, upper bits reserved for future use)
- Return type
bool
New in version 6.2.
License: Geosoft Open License
-
classmethod
utf16_val_to_str
(ch, str_val)[source]¶ Convert a UTF-16 value to a UTF-8 encoded string.
- Parameters
ch (int) – UTF-16 value (32-bit int, lower 16 bits used, upper bits reserved for future use)
str_val (str_ref) – Converted string
New in version 6.2.
License: Geosoft Open License
Note: An empty string will be returned for invalid symbols
-
classmethod
valid_symbol
(face, geofont, number)[source]¶ See if a Symbol number is valid in a particular font.
- Parameters
face (str) – Face name (undecorated)
geofont (bool) – Geosoft font?
number (int) – Symbol number
- Return type
bool
New in version 6.2.
License: Geosoft Open License
-
UTF8 constants¶
UTF-8 Defines
-
UTF8_MAX_CHAR
¶ Maximum width of a single Unicode code point as a UTF8 constants string, including terminator (5)
-
gxapi.
UTF8_MAX_CHAR
= 5¶
-