gucharmap-unicode-info: gucharmap Reference Manual

## gucharmap-unicode-info gucharmap-unicode-info |

## Functions

const gchar * | gucharmap_get_unicode_name ()
const gchar * | gucharmap_get_unicode_data_name ()
gint | gucharmap_get_unicode_data_name_count ()
GucharmapUnicodeVersion | gucharmap_get_unicode_version ()
const gchar * | gucharmap_get_unicode_category_name ()
gint | gucharmap_get_unihan_count ()
const gchar * | gucharmap_get_unicode_kDefinition ()
const gchar * | gucharmap_get_unicode_kCantonese ()
const gchar * | gucharmap_get_unicode_kMandarin ()
const gchar * | gucharmap_get_unicode_kTang ()
const gchar * | gucharmap_get_unicode_kKorean ()
const gchar * | gucharmap_get_unicode_kJapaneseKun ()
const gchar * | gucharmap_get_unicode_kJapaneseOn ()
const gchar * | gucharmap_get_unicode_kHangul ()
const gchar * | gucharmap_get_unicode_kVietnamese ()
const gchar ** | gucharmap_get_nameslist_stars ()
const gchar ** | gucharmap_get_nameslist_equals ()
gunichar * | gucharmap_get_nameslist_exes ()
const gchar ** | gucharmap_get_nameslist_pounds ()
const gchar ** | gucharmap_get_nameslist_colons ()
gboolean | gucharmap_unichar_validate ()
gint | gucharmap_unichar_to_printable_utf8 ()
GUnicodeType | gucharmap_unichar_type ()
gboolean | gucharmap_unichar_isdefined ()
gboolean | gucharmap_unichar_isgraph ()
const gchar ** | gucharmap_unicode_list_scripts ()
const gchar * | gucharmap_unicode_get_script_for_char ()
const gchar * | gucharmap_unicode_version_to_string ()
gunichar | gucharmap_unicode_get_locale_character ()

## Types and Values

enum | GucharmapUnicodeVersion

## Description

## Functions

### gucharmap_get_unicode_name ()

    const gchar *
    gucharmap_get_unicode_name (gunichar uc);

### gucharmap_get_unicode_data_name ()

    const gchar *
    gucharmap_get_unicode_data_name (gunichar uc);

### gucharmap_get_unicode_data_name_count ()

    gint
    gucharmap_get_unicode_data_name_count (void);

### gucharmap_get_unicode_version ()

    GucharmapUnicodeVersion
    gucharmap_get_unicode_version (gunichar uc);

### gucharmap_get_unicode_category_name ()

    const gchar *
    gucharmap_get_unicode_category_name (gunichar uc);

### gucharmap_get_unihan_count ()

    gint
    gucharmap_get_unihan_count (void);

### gucharmap_get_unicode_kDefinition ()

    const gchar *
    gucharmap_get_unicode_kDefinition (gunichar uc);

### gucharmap_get_unicode_kCantonese ()

    const gchar *
    gucharmap_get_unicode_kCantonese (gunichar uc);

### gucharmap_get_unicode_kMandarin ()

    const gchar *
    gucharmap_get_unicode_kMandarin (gunichar uc);

### gucharmap_get_unicode_kTang ()

    const gchar *
    gucharmap_get_unicode_kTang (gunichar uc);

### gucharmap_get_unicode_kKorean ()

    const gchar *
    gucharmap_get_unicode_kKorean (gunichar uc);

### gucharmap_get_unicode_kJapaneseKun ()

    const gchar *
    gucharmap_get_unicode_kJapaneseKun (gunichar uc);

### gucharmap_get_unicode_kJapaneseOn ()

    const gchar *
    gucharmap_get_unicode_kJapaneseOn (gunichar uc);

### gucharmap_get_unicode_kHangul ()

    const gchar *
    gucharmap_get_unicode_kHangul (gunichar uc);

### gucharmap_get_unicode_kVietnamese ()

    const gchar *
    gucharmap_get_unicode_kVietnamese (gunichar uc);

### gucharmap_get_nameslist_stars ()

    const gchar **
    gucharmap_get_nameslist_stars (gunichar uc);

#### Parameters

uc | a gunichar |

#### Returns

newly allocated null-terminated array of gchar* the items are const, but the array should be freed by the caller.

[transfer container]

### gucharmap_get_nameslist_equals ()

    const gchar **
    gucharmap_get_nameslist_equals (gunichar uc);

#### Parameters

uc | a gunichar |

#### Returns

newly allocated null-terminated array of gchar* the items are const, but the array should be freed by the caller.

[transfer container]

### gucharmap_get_nameslist_exes ()

    gunichar *
    gucharmap_get_nameslist_exes (gunichar uc);

### gucharmap_get_nameslist_pounds ()

    const gchar **
    gucharmap_get_nameslist_pounds (gunichar uc);

#### Parameters

uc | a gunichar |

#### Returns

newly allocated null-terminated array of gchar* the items are const, but the array should be freed by the caller.

[transfer container]

### gucharmap_get_nameslist_colons ()

    const gchar **
    gucharmap_get_nameslist_colons (gunichar uc);

#### Parameters

uc | a gunichar |

#### Returns

newly allocated null-terminated array of gchar* the items are const, but the array should be freed by the caller.

[transfer container]

### gucharmap_unichar_validate ()

    gboolean
    gucharmap_unichar_validate (gunichar uc);

### gucharmap_unichar_to_printable_utf8 ()

    gint
    gucharmap_unichar_to_printable_utf8 (gunichar uc,
                                         gchar *outbuf);

Converts a single character to UTF-8 suitable for rendering. Check the source to see what this means. ;-)

#### Parameters

uc | a unicode character |
outbuf | output buffer, must have at least 10 bytes of space. If `NULL`, the length will be computed and returned and nothing will be written to `outbuf` . |

#### Returns

number of bytes written

### gucharmap_unichar_type ()

    GUnicodeType
    gucharmap_unichar_type (gunichar uc);

Classifies a Unicode character by type.

#### Parameters

uc | a Unicode character |

#### Returns

the type of the character.

### gucharmap_unichar_isdefined ()

    gboolean
    gucharmap_unichar_isdefined (gunichar uc);

Determines if a given character is assigned in the Unicode standard.

#### Parameters

uc | a Unicode character |

#### Returns

`TRUE` if the character has an assigned value

### gucharmap_unichar_isgraph ()

    gboolean
    gucharmap_unichar_isgraph (gunichar uc);

Determines whether a character is printable and not a space (returns `FALSE` for control characters, format characters, and spaces). `g_unichar_isprint()` is similar, but returns `TRUE` for spaces. Given some UTF-8 text, obtain a character value with `g_utf8_get_char()`.

#### Parameters

uc | a Unicode character |

#### Returns

`TRUE` if `c` is printable unless it's a space

### gucharmap_unicode_list_scripts ()

    const gchar **
    gucharmap_unicode_list_scripts (void);

Returns an array of untranslated script names.

The strings in the array are owned by gucharmap and should not be modified or free; the array itself however is allocated and should be freed with `g_free()`.

#### Returns

a newly allocated `NULL`-terminated array of strings.

[transfer container]

### gucharmap_unicode_get_script_for_char ()

    const gchar *
    gucharmap_unicode_get_script_for_char (gunichar wc);

#### Parameters

wc | a character |

#### Returns

The English (untranslated) name of the script to which the character belongs. Characters that don't belong to an actual script return %"Unknown".

### gucharmap_unicode_version_to_string ()

    const gchar *
    gucharmap_unicode_version_to_string (GucharmapUnicodeVersion version);

### gucharmap_unicode_get_locale_character ()

    gunichar
    gucharmap_unicode_get_locale_character
                                   (void);

Determines a character that's commonly used in the current locale's script.

#### Returns

a unicode character

## Types and Values

### enum GucharmapUnicodeVersion

#### Members

GUCHARMAP_UNICODE_VERSION_UNASSIGNED | Unassigned Unicode version |
GUCHARMAP_UNICODE_VERSION_1_1 | Unicode version 1.1 |
GUCHARMAP_UNICODE_VERSION_2_0 | Unicode version 2.0 |
GUCHARMAP_UNICODE_VERSION_2_1 | Unicode version 2.1 |
GUCHARMAP_UNICODE_VERSION_3_0 | Unicode version 3.0 |
GUCHARMAP_UNICODE_VERSION_3_1 | Unicode version 3.1 |
GUCHARMAP_UNICODE_VERSION_3_2 | Unicode version 3.2 |
GUCHARMAP_UNICODE_VERSION_4_0 | Unicode version 4.0 |
GUCHARMAP_UNICODE_VERSION_4_1 | Unicode version 4.1 |
GUCHARMAP_UNICODE_VERSION_5_0 | Unicode version 5.0 |
GUCHARMAP_UNICODE_VERSION_5_1 | Unicode version 5.1 |
GUCHARMAP_UNICODE_VERSION_5_2 | Unicode version 5.2 |
GUCHARMAP_UNICODE_VERSION_6_0 | Unicode version 6.0 |
GUCHARMAP_UNICODE_VERSION_6_1 | Unicode version 6.1 |
GUCHARMAP_UNICODE_VERSION_6_2 | Unicode version 6.2 |
GUCHARMAP_UNICODE_VERSION_6_3 | Unicode version 6.3 |
GUCHARMAP_UNICODE_VERSION_7_0 | Unicode version 7.0 |
GUCHARMAP_UNICODE_VERSION_8_0 | Unicode version 8.0 |
GUCHARMAP_UNICODE_VERSION_9_0 | Unicode version 9.0 |
GUCHARMAP_UNICODE_VERSION_10_0 | Unicode version 10.0 |
GUCHARMAP_UNICODE_VERSION_11_0 | Unicode version 11.0 |
GUCHARMAP_UNICODE_VERSION_12_0 | Unicode version 12.0 |
GUCHARMAP_UNICODE_VERSION_12_1 | Unicode version 12.1 |
GUCHARMAP_UNICODE_VERSION_13_0 | Unicode version 13.0 |
GUCHARMAP_UNICODE_VERSION_14_0 | Unicode version 14.0 |
GUCHARMAP_UNICODE_VERSION_15_0 | Unicode version 15.0 |
GUCHARMAP_UNICODE_VERSION_15_1 | Unicode version 15.1 |
GUCHARMAP_UNICODE_VERSION_16_0 | Unicode version 16.0 |
GUCHARMAP_UNICODE_VERSION_17_0 | Unicode version 17.0 |
GUCHARMAP_UNICODE_VERSION_LATEST | Latest Unicode version |