~ivoks/ubuntu/lucid/glib2.0/887946
» Revision
57
: docs/reference/glib/html/glib-Unicode-Manipulation.html
« back to all changes in this revision
Viewing changes to docs/reference/glib/html/glib-Unicode-Manipulation.html
- browse files at revision 57
- compare with another revision
- download diff
- download tarball
- view history from revision 57
- Committer: Bazaar Package Importer
- Author(s): Sebastien Bacher
- Date: 2010-05-05 12:42:47 UTC
- Revision ID: james.westby@ubuntu.com-20100505124247-oyejlzn54pq4ihdl
Tags: 2.24.1-0ubuntu1
New upstream version (lp: #575777):
Bugs fixed:
615379 g_new macros crash if sizeof(struct_type) == 0
614185 g_type_class_add_private() documentation is not correct
614372 g_stat() is funny
615111 GAsyncInitable's default implementation is broken
Fix race in g_cancellable_cancel
Fix for g_variant_iter_loop
Make g_string_append_len() accept NULL lf len == 0
Fix typo in GMutex error message
Bugs fixed:
615379 g_new macros crash if sizeof(struct_type) == 0
614185 g_type_class_add_private() documentation is not correct
614372 g_stat() is funny
615111 GAsyncInitable's default implementation is broken
Fix race in g_cancellable_cancel
Fix for g_variant_iter_loop
Make g_string_append_len() accept NULL lf len == 0
Fix typo in GMutex error message
- files modified:
- ChangeLog
added
removed
docs/reference/glib/html/glib-Unicode-Manipulation.html
8
8
<link rel="up" href="glib-utilities.html" title="GLib Utilities">
9
9
<link rel="prev" href="glib-Character-Set-Conversion.html" title="Character Set Conversion">
10
10
<link rel="next" href="glib-Base64-Encoding.html" title="Base64 Encoding">
11
<meta name="generator" content="GTK-Doc V1.13 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
<link rel="chapter" href="glib.html" title="GLib Overview">
14
<link rel="chapter" href="glib-fundamentals.html" title="GLib Fundamentals">
15
<link rel="chapter" href="glib-core.html" title="GLib Core Application Support">
16
<link rel="chapter" href="glib-utilities.html" title="GLib Utilities">
17
<link rel="chapter" href="glib-data-types.html" title="GLib Data Types">
18
<link rel="chapter" href="tools.html" title="GLib Tools">
19
<link rel="index" href="api-index-full.html" title="Index">
20
<link rel="index" href="api-index-deprecated.html" title="Index of deprecated symbols">
21
<link rel="index" href="api-index-2-2.html" title="Index of new symbols in 2.2">
22
<link rel="index" href="api-index-2-4.html" title="Index of new symbols in 2.4">
23
<link rel="index" href="api-index-2-6.html" title="Index of new symbols in 2.6">
24
<link rel="index" href="api-index-2-8.html" title="Index of new symbols in 2.8">
25
<link rel="index" href="api-index-2-10.html" title="Index of new symbols in 2.10">
26
<link rel="index" href="api-index-2-12.html" title="Index of new symbols in 2.12">
27
<link rel="index" href="api-index-2-14.html" title="Index of new symbols in 2.14">
28
<link rel="index" href="api-index-2-16.html" title="Index of new symbols in 2.16">
29
<link rel="index" href="api-index-2-18.html" title="Index of new symbols in 2.18">
30
<link rel="index" href="api-index-2-20.html" title="Index of new symbols in 2.20">
31
<link rel="index" href="api-index-2-22.html" title="Index of new symbols in 2.22">
32
<link rel="index" href="api-index-2-24.html" title="Index of new symbols in 2.24">
33
13
</head>
34
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
35
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
63
43
typedef <a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar">gunichar</a>;
64
44
typedef <a class="link" href="glib-Unicode-Manipulation.html#gunichar2" title="gunichar2">gunichar2</a>;
65
45
66
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-validate" title="g_unichar_validate ()">g_unichar_validate</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> ch);
67
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-isalnum" title="g_unichar_isalnum ()">g_unichar_isalnum</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
68
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-isalpha" title="g_unichar_isalpha ()">g_unichar_isalpha</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
69
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-iscntrl" title="g_unichar_iscntrl ()">g_unichar_iscntrl</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
70
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-isdefined" title="g_unichar_isdefined ()">g_unichar_isdefined</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
71
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-isdigit" title="g_unichar_isdigit ()">g_unichar_isdigit</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
72
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-isgraph" title="g_unichar_isgraph ()">g_unichar_isgraph</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
73
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-islower" title="g_unichar_islower ()">g_unichar_islower</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
74
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-ismark" title="g_unichar_ismark ()">g_unichar_ismark</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
75
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-isprint" title="g_unichar_isprint ()">g_unichar_isprint</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
76
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-ispunct" title="g_unichar_ispunct ()">g_unichar_ispunct</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
77
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-isspace" title="g_unichar_isspace ()">g_unichar_isspace</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
78
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-istitle" title="g_unichar_istitle ()">g_unichar_istitle</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
79
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-isupper" title="g_unichar_isupper ()">g_unichar_isupper</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
80
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-isxdigit" title="g_unichar_isxdigit ()">g_unichar_isxdigit</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
81
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-iswide" title="g_unichar_iswide ()">g_unichar_iswide</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
82
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-iswide-cjk" title="g_unichar_iswide_cjk ()">g_unichar_iswide_cjk</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
83
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-iszerowidth" title="g_unichar_iszerowidth ()">g_unichar_iszerowidth</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
84
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-toupper" title="g_unichar_toupper ()">g_unichar_toupper</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
85
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-tolower" title="g_unichar_tolower ()">g_unichar_tolower</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
86
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-totitle" title="g_unichar_totitle ()">g_unichar_totitle</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
87
<a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-digit-value" title="g_unichar_digit_value ()">g_unichar_digit_value</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
88
<a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-xdigit-value" title="g_unichar_xdigit_value ()">g_unichar_xdigit_value</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
46
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-validate" title="g_unichar_validate ()">g_unichar_validate</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> ch</code></em>);
47
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-isalnum" title="g_unichar_isalnum ()">g_unichar_isalnum</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
48
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-isalpha" title="g_unichar_isalpha ()">g_unichar_isalpha</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
49
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-iscntrl" title="g_unichar_iscntrl ()">g_unichar_iscntrl</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
50
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-isdefined" title="g_unichar_isdefined ()">g_unichar_isdefined</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
51
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-isdigit" title="g_unichar_isdigit ()">g_unichar_isdigit</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
52
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-isgraph" title="g_unichar_isgraph ()">g_unichar_isgraph</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
53
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-islower" title="g_unichar_islower ()">g_unichar_islower</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
54
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-ismark" title="g_unichar_ismark ()">g_unichar_ismark</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
55
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-isprint" title="g_unichar_isprint ()">g_unichar_isprint</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
56
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-ispunct" title="g_unichar_ispunct ()">g_unichar_ispunct</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
57
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-isspace" title="g_unichar_isspace ()">g_unichar_isspace</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
58
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-istitle" title="g_unichar_istitle ()">g_unichar_istitle</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
59
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-isupper" title="g_unichar_isupper ()">g_unichar_isupper</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
60
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-isxdigit" title="g_unichar_isxdigit ()">g_unichar_isxdigit</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
61
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-iswide" title="g_unichar_iswide ()">g_unichar_iswide</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
62
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-iswide-cjk" title="g_unichar_iswide_cjk ()">g_unichar_iswide_cjk</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
63
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-iszerowidth" title="g_unichar_iszerowidth ()">g_unichar_iszerowidth</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
64
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-toupper" title="g_unichar_toupper ()">g_unichar_toupper</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
65
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-tolower" title="g_unichar_tolower ()">g_unichar_tolower</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
66
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-totitle" title="g_unichar_totitle ()">g_unichar_totitle</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
67
<a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-digit-value" title="g_unichar_digit_value ()">g_unichar_digit_value</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
68
<a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-xdigit-value" title="g_unichar_xdigit_value ()">g_unichar_xdigit_value</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
89
69
enum <a class="link" href="glib-Unicode-Manipulation.html#GUnicodeType" title="enum GUnicodeType">GUnicodeType</a>;
90
<a class="link" href="glib-Unicode-Manipulation.html#GUnicodeType" title="enum GUnicodeType"><span class="returnvalue">GUnicodeType</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-type" title="g_unichar_type ()">g_unichar_type</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
70
<a class="link" href="glib-Unicode-Manipulation.html#GUnicodeType" title="enum GUnicodeType"><span class="returnvalue">GUnicodeType</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-type" title="g_unichar_type ()">g_unichar_type</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
91
71
enum <a class="link" href="glib-Unicode-Manipulation.html#GUnicodeBreakType" title="enum GUnicodeBreakType">GUnicodeBreakType</a>;
92
<a class="link" href="glib-Unicode-Manipulation.html#GUnicodeBreakType" title="enum GUnicodeBreakType"><span class="returnvalue">GUnicodeBreakType</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-break-type" title="g_unichar_break_type ()">g_unichar_break_type</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
93
<a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-combining-class" title="g_unichar_combining_class ()">g_unichar_combining_class</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> uc);
94
<span class="returnvalue">void</span> <a class="link" href="glib-Unicode-Manipulation.html#g-unicode-canonical-ordering" title="g_unicode_canonical_ordering ()">g_unicode_canonical_ordering</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> *string,
95
<a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> len);
96
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-unicode-canonical-decomposition" title="g_unicode_canonical_decomposition ()">g_unicode_canonical_decomposition</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> ch,
97
<a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> *result_len);
98
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-get-mirror-char" title="g_unichar_get_mirror_char ()">g_unichar_get_mirror_char</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> ch,
99
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> *mirrored_ch);
72
<a class="link" href="glib-Unicode-Manipulation.html#GUnicodeBreakType" title="enum GUnicodeBreakType"><span class="returnvalue">GUnicodeBreakType</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-break-type" title="g_unichar_break_type ()">g_unichar_break_type</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
73
<a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-combining-class" title="g_unichar_combining_class ()">g_unichar_combining_class</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> uc</code></em>);
74
<span class="returnvalue">void</span> <a class="link" href="glib-Unicode-Manipulation.html#g-unicode-canonical-ordering" title="g_unicode_canonical_ordering ()">g_unicode_canonical_ordering</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> *string</code></em>,
75
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> len</code></em>);
76
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-unicode-canonical-decomposition" title="g_unicode_canonical_decomposition ()">g_unicode_canonical_decomposition</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> ch</code></em>,
77
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *result_len</code></em>);
78
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-get-mirror-char" title="g_unichar_get_mirror_char ()">g_unichar_get_mirror_char</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> ch</code></em>,
79
<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> *mirrored_ch</code></em>);
100
80
enum <a class="link" href="glib-Unicode-Manipulation.html#GUnicodeScript" title="enum GUnicodeScript">GUnicodeScript</a>;
101
<a class="link" href="glib-Unicode-Manipulation.html#GUnicodeScript" title="enum GUnicodeScript"><span class="returnvalue">GUnicodeScript</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-get-script" title="g_unichar_get_script ()">g_unichar_get_script</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> ch);
81
<a class="link" href="glib-Unicode-Manipulation.html#GUnicodeScript" title="enum GUnicodeScript"><span class="returnvalue">GUnicodeScript</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-get-script" title="g_unichar_get_script ()">g_unichar_get_script</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> ch</code></em>);
102
82
103
83
#define <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-next-char" title="g_utf8_next_char()">g_utf8_next_char</a> (p)
104
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-get-char" title="g_utf8_get_char ()">g_utf8_get_char</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *p);
105
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-get-char-validated" title="g_utf8_get_char_validated ()">g_utf8_get_char_validated</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *p,
106
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> max_len);
107
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-offset-to-pointer" title="g_utf8_offset_to_pointer ()">g_utf8_offset_to_pointer</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
108
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> offset);
109
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-pointer-to-offset" title="g_utf8_pointer_to_offset ()">g_utf8_pointer_to_offset</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
110
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *pos);
111
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-prev-char" title="g_utf8_prev_char ()">g_utf8_prev_char</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *p);
112
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-find-next-char" title="g_utf8_find_next_char ()">g_utf8_find_next_char</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *p,
113
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *end);
114
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-find-prev-char" title="g_utf8_find_prev_char ()">g_utf8_find_prev_char</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
115
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *p);
116
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-strlen" title="g_utf8_strlen ()">g_utf8_strlen</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *p,
117
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> max);
118
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-strncpy" title="g_utf8_strncpy ()">g_utf8_strncpy</a> (<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *dest,
119
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *src,
120
<a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> n);
121
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-strchr" title="g_utf8_strchr ()">g_utf8_strchr</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *p,
122
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> len,
123
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
124
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-strrchr" title="g_utf8_strrchr ()">g_utf8_strrchr</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *p,
125
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> len,
126
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);
127
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-strreverse" title="g_utf8_strreverse ()">g_utf8_strreverse</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
128
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> len);
129
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-validate" title="g_utf8_validate ()">g_utf8_validate</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
130
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> max_len,
131
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **end);
84
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-get-char" title="g_utf8_get_char ()">g_utf8_get_char</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *p</code></em>);
85
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-get-char-validated" title="g_utf8_get_char_validated ()">g_utf8_get_char_validated</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *p</code></em>,
86
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> max_len</code></em>);
87
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-offset-to-pointer" title="g_utf8_offset_to_pointer ()">g_utf8_offset_to_pointer</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
88
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> offset</code></em>);
89
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-pointer-to-offset" title="g_utf8_pointer_to_offset ()">g_utf8_pointer_to_offset</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
90
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *pos</code></em>);
91
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-prev-char" title="g_utf8_prev_char ()">g_utf8_prev_char</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *p</code></em>);
92
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-find-next-char" title="g_utf8_find_next_char ()">g_utf8_find_next_char</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *p</code></em>,
93
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *end</code></em>);
94
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-find-prev-char" title="g_utf8_find_prev_char ()">g_utf8_find_prev_char</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
95
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *p</code></em>);
96
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-strlen" title="g_utf8_strlen ()">g_utf8_strlen</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *p</code></em>,
97
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> max</code></em>);
98
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-strncpy" title="g_utf8_strncpy ()">g_utf8_strncpy</a> (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *dest</code></em>,
99
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *src</code></em>,
100
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> n</code></em>);
101
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-strchr" title="g_utf8_strchr ()">g_utf8_strchr</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *p</code></em>,
102
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>,
103
<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
104
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-strrchr" title="g_utf8_strrchr ()">g_utf8_strrchr</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *p</code></em>,
105
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>,
106
<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);
107
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-strreverse" title="g_utf8_strreverse ()">g_utf8_strreverse</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
108
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>);
109
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-validate" title="g_utf8_validate ()">g_utf8_validate</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
110
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> max_len</code></em>,
111
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **end</code></em>);
132
112
133
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-strup" title="g_utf8_strup ()">g_utf8_strup</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
134
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> len);
135
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-strdown" title="g_utf8_strdown ()">g_utf8_strdown</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
136
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> len);
137
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-casefold" title="g_utf8_casefold ()">g_utf8_casefold</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
138
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> len);
139
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-normalize" title="g_utf8_normalize ()">g_utf8_normalize</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
140
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> len,
141
<a class="link" href="glib-Unicode-Manipulation.html#GNormalizeMode" title="enum GNormalizeMode"><span class="returnvalue">GNormalizeMode</span></a> mode);
113
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-strup" title="g_utf8_strup ()">g_utf8_strup</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
114
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>);
115
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-strdown" title="g_utf8_strdown ()">g_utf8_strdown</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
116
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>);
117
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-casefold" title="g_utf8_casefold ()">g_utf8_casefold</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
118
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>);
119
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-normalize" title="g_utf8_normalize ()">g_utf8_normalize</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
120
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>,
121
<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#GNormalizeMode" title="enum GNormalizeMode"><span class="type">GNormalizeMode</span></a> mode</code></em>);
142
122
enum <a class="link" href="glib-Unicode-Manipulation.html#GNormalizeMode" title="enum GNormalizeMode">GNormalizeMode</a>;
143
<a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-collate" title="g_utf8_collate ()">g_utf8_collate</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str1,
144
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str2);
145
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-collate-key" title="g_utf8_collate_key ()">g_utf8_collate_key</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
146
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> len);
147
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-collate-key-for-filename" title="g_utf8_collate_key_for_filename ()">g_utf8_collate_key_for_filename</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
148
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> len);
123
<a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-collate" title="g_utf8_collate ()">g_utf8_collate</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str1</code></em>,
124
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str2</code></em>);
125
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-collate-key" title="g_utf8_collate_key ()">g_utf8_collate_key</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
126
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>);
127
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-collate-key-for-filename" title="g_utf8_collate_key_for_filename ()">g_utf8_collate_key_for_filename</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
128
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>);
149
129
150
<a class="link" href="glib-Unicode-Manipulation.html#gunichar2" title="gunichar2"><span class="returnvalue">gunichar2</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-to-utf16" title="g_utf8_to_utf16 ()">g_utf8_to_utf16</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
151
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> len,
152
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_read,
153
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_written,
154
<a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);
155
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-to-ucs4" title="g_utf8_to_ucs4 ()">g_utf8_to_ucs4</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
156
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> len,
157
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_read,
158
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_written,
159
<a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);
160
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-to-ucs4-fast" title="g_utf8_to_ucs4_fast ()">g_utf8_to_ucs4_fast</a> (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
161
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> len,
162
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_written);
163
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-utf16-to-ucs4" title="g_utf16_to_ucs4 ()">g_utf16_to_ucs4</a> (const <a class="link" href="glib-Unicode-Manipulation.html#gunichar2" title="gunichar2"><span class="returnvalue">gunichar2</span></a> *str,
164
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> len,
165
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_read,
166
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_written,
167
<a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);
168
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="glib-Unicode-Manipulation.html#g-utf16-to-utf8" title="g_utf16_to_utf8 ()">g_utf16_to_utf8</a> (const <a class="link" href="glib-Unicode-Manipulation.html#gunichar2" title="gunichar2"><span class="returnvalue">gunichar2</span></a> *str,
169
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> len,
170
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_read,
171
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_written,
172
<a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);
173
<a class="link" href="glib-Unicode-Manipulation.html#gunichar2" title="gunichar2"><span class="returnvalue">gunichar2</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-ucs4-to-utf16" title="g_ucs4_to_utf16 ()">g_ucs4_to_utf16</a> (const <a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> *str,
174
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> len,
175
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_read,
176
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_written,
177
<a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);
178
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="glib-Unicode-Manipulation.html#g-ucs4-to-utf8" title="g_ucs4_to_utf8 ()">g_ucs4_to_utf8</a> (const <a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> *str,
179
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> len,
180
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_read,
181
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_written,
182
<a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);
183
<a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-to-utf8" title="g_unichar_to_utf8 ()">g_unichar_to_utf8</a> (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c,
184
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *outbuf);
130
<a class="link" href="glib-Unicode-Manipulation.html#gunichar2" title="gunichar2"><span class="returnvalue">gunichar2</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-to-utf16" title="g_utf8_to_utf16 ()">g_utf8_to_utf16</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
131
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> len</code></em>,
132
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_read</code></em>,
133
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_written</code></em>,
134
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
135
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-to-ucs4" title="g_utf8_to_ucs4 ()">g_utf8_to_ucs4</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
136
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> len</code></em>,
137
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_read</code></em>,
138
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_written</code></em>,
139
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
140
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-to-ucs4-fast" title="g_utf8_to_ucs4_fast ()">g_utf8_to_ucs4_fast</a> (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
141
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> len</code></em>,
142
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_written</code></em>);
143
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-utf16-to-ucs4" title="g_utf16_to_ucs4 ()">g_utf16_to_ucs4</a> (<em class="parameter"><code>const <a class="link" href="glib-Unicode-Manipulation.html#gunichar2" title="gunichar2"><span class="type">gunichar2</span></a> *str</code></em>,
144
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> len</code></em>,
145
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_read</code></em>,
146
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_written</code></em>,
147
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
148
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="glib-Unicode-Manipulation.html#g-utf16-to-utf8" title="g_utf16_to_utf8 ()">g_utf16_to_utf8</a> (<em class="parameter"><code>const <a class="link" href="glib-Unicode-Manipulation.html#gunichar2" title="gunichar2"><span class="type">gunichar2</span></a> *str</code></em>,
149
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> len</code></em>,
150
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_read</code></em>,
151
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_written</code></em>,
152
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
153
<a class="link" href="glib-Unicode-Manipulation.html#gunichar2" title="gunichar2"><span class="returnvalue">gunichar2</span></a> * <a class="link" href="glib-Unicode-Manipulation.html#g-ucs4-to-utf16" title="g_ucs4_to_utf16 ()">g_ucs4_to_utf16</a> (<em class="parameter"><code>const <a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> *str</code></em>,
154
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> len</code></em>,
155
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_read</code></em>,
156
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_written</code></em>,
157
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
158
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* <a class="link" href="glib-Unicode-Manipulation.html#g-ucs4-to-utf8" title="g_ucs4_to_utf8 ()">g_ucs4_to_utf8</a> (<em class="parameter"><code>const <a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> *str</code></em>,
159
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> len</code></em>,
160
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_read</code></em>,
161
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_written</code></em>,
162
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);
163
<a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-to-utf8" title="g_unichar_to_utf8 ()">g_unichar_to_utf8</a> (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>,
164
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *outbuf</code></em>);
185
165
</pre>
186
166
</div>
187
167
<div class="refsect1" title="Description">
231
211
"U+<code class="literal">04</code>"G_GINT32_FORMAT"X".
232
212
To scan, use the format string "U+<code class="literal">06</code>"G_GINT32_FORMAT"X".
233
213
</p>
234
<div class="informalexample"><pre class="programlisting">
235
gunichar c;
236
sscanf ("U+0041", "U+%06"G_GINT32_FORMAT"X", &c)
237
g_print ("Read U+%04"G_GINT32_FORMAT"X", c);
238
</pre></div>
214
<div class="informalexample">
215
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
216
<tbody>
217
<tr>
218
<td class="listing_lines" align="right"><pre>1
219
2
220
3</pre></td>
221
<td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-Unicode-Manipulation.html#gunichar">gunichar</a> c</span><span class="symbol">;</span>
222
<span class="function">sscanf</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"U+0041"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"U+%06"</span><span class="normal"><a href="glib-Miscellaneous-Macros.html#G-GINT32-FORMAT:CAPS">G_GINT32_FORMAT</a></span><span class="string">"X"</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">c</span><span class="symbol">)</span>
223
<span class="function"><a href="glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Read U+%04"</span><span class="normal"><a href="glib-Miscellaneous-Macros.html#G-GINT32-FORMAT:CAPS">G_GINT32_FORMAT</a></span><span class="string">"X"</span><span class="symbol">,</span><span class="normal"> c</span><span class="symbol">);</span></pre></td>
224
</tr>
225
</tbody>
226
</table>
227
</div>
228
239
229
<p>
240
230
</p>
241
231
</div>
260
250
<hr>
261
251
<div class="refsect2" title="g_unichar_validate ()">
262
252
<a name="g-unichar-validate"></a><h3>g_unichar_validate ()</h3>
263
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_validate (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> ch);</pre>
253
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_validate (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> ch</code></em>);</pre>
264
254
<p>
265
255
Checks whether <em class="parameter"><code>ch</code></em> is a valid Unicode character. Some possible
266
256
integer values of <em class="parameter"><code>ch</code></em> will not be valid. 0 is considered a valid
267
character, though it's normally a string terminator.</p>
257
character, though it's normally a string terminator.
258
</p>
268
259
<div class="variablelist"><table border="0">
269
260
<col align="left" valign="top">
270
261
<tbody>
271
262
<tr>
272
263
<td><p><span class="term"><em class="parameter"><code>ch</code></em> :</span></p></td>
273
<td> a Unicode character
264
<td>a Unicode character
274
265
</td>
275
266
</tr>
276
267
<tr>
284
275
<hr>
285
276
<div class="refsect2" title="g_unichar_isalnum ()">
286
277
<a name="g-unichar-isalnum"></a><h3>g_unichar_isalnum ()</h3>
287
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_isalnum (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
278
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_isalnum (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
288
279
<p>
289
280
Determines whether a character is alphanumeric.
290
281
Given some UTF-8 text, obtain a character value
291
with <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-get-char" title="g_utf8_get_char ()"><code class="function">g_utf8_get_char()</code></a>.</p>
282
with <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-get-char" title="g_utf8_get_char ()"><code class="function">g_utf8_get_char()</code></a>.
283
</p>
292
284
<div class="variablelist"><table border="0">
293
285
<col align="left" valign="top">
294
286
<tbody>
295
287
<tr>
296
288
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
297
<td> a Unicode character
289
<td>a Unicode character
298
290
</td>
299
291
</tr>
300
292
<tr>
308
300
<hr>
309
301
<div class="refsect2" title="g_unichar_isalpha ()">
310
302
<a name="g-unichar-isalpha"></a><h3>g_unichar_isalpha ()</h3>
311
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_isalpha (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
303
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_isalpha (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
312
304
<p>
313
305
Determines whether a character is alphabetic (i.e. a letter).
314
306
Given some UTF-8 text, obtain a character value with
315
<a class="link" href="glib-Unicode-Manipulation.html#g-utf8-get-char" title="g_utf8_get_char ()"><code class="function">g_utf8_get_char()</code></a>.</p>
307
<a class="link" href="glib-Unicode-Manipulation.html#g-utf8-get-char" title="g_utf8_get_char ()"><code class="function">g_utf8_get_char()</code></a>.
308
</p>
316
309
<div class="variablelist"><table border="0">
317
310
<col align="left" valign="top">
318
311
<tbody>
319
312
<tr>
320
313
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
321
<td> a Unicode character
314
<td>a Unicode character
322
315
</td>
323
316
</tr>
324
317
<tr>
332
325
<hr>
333
326
<div class="refsect2" title="g_unichar_iscntrl ()">
334
327
<a name="g-unichar-iscntrl"></a><h3>g_unichar_iscntrl ()</h3>
335
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_iscntrl (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
328
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_iscntrl (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
336
329
<p>
337
330
Determines whether a character is a control character.
338
331
Given some UTF-8 text, obtain a character value with
339
<a class="link" href="glib-Unicode-Manipulation.html#g-utf8-get-char" title="g_utf8_get_char ()"><code class="function">g_utf8_get_char()</code></a>.</p>
332
<a class="link" href="glib-Unicode-Manipulation.html#g-utf8-get-char" title="g_utf8_get_char ()"><code class="function">g_utf8_get_char()</code></a>.
333
</p>
340
334
<div class="variablelist"><table border="0">
341
335
<col align="left" valign="top">
342
336
<tbody>
343
337
<tr>
344
338
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
345
<td> a Unicode character
339
<td>a Unicode character
346
340
</td>
347
341
</tr>
348
342
<tr>
356
350
<hr>
357
351
<div class="refsect2" title="g_unichar_isdefined ()">
358
352
<a name="g-unichar-isdefined"></a><h3>g_unichar_isdefined ()</h3>
359
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_isdefined (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
353
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_isdefined (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
360
354
<p>
361
355
Determines if a given character is assigned in the Unicode
362
standard.</p>
356
standard.
357
</p>
363
358
<div class="variablelist"><table border="0">
364
359
<col align="left" valign="top">
365
360
<tbody>
366
361
<tr>
367
362
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
368
<td> a Unicode character
363
<td>a Unicode character
369
364
</td>
370
365
</tr>
371
366
<tr>
379
374
<hr>
380
375
<div class="refsect2" title="g_unichar_isdigit ()">
381
376
<a name="g-unichar-isdigit"></a><h3>g_unichar_isdigit ()</h3>
382
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_isdigit (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
377
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_isdigit (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
383
378
<p>
384
379
Determines whether a character is numeric (i.e. a digit). This
385
380
covers ASCII 0-9 and also digits in other languages/scripts. Given
386
some UTF-8 text, obtain a character value with <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-get-char" title="g_utf8_get_char ()"><code class="function">g_utf8_get_char()</code></a>.</p>
381
some UTF-8 text, obtain a character value with <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-get-char" title="g_utf8_get_char ()"><code class="function">g_utf8_get_char()</code></a>.
382
</p>
387
383
<div class="variablelist"><table border="0">
388
384
<col align="left" valign="top">
389
385
<tbody>
390
386
<tr>
391
387
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
392
<td> a Unicode character
388
<td>a Unicode character
393
389
</td>
394
390
</tr>
395
391
<tr>
403
399
<hr>
404
400
<div class="refsect2" title="g_unichar_isgraph ()">
405
401
<a name="g-unichar-isgraph"></a><h3>g_unichar_isgraph ()</h3>
406
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_isgraph (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
402
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_isgraph (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
407
403
<p>
408
404
Determines whether a character is printable and not a space
409
405
(returns <a class="link" href="glib-Standard-Macros.html#FALSE:CAPS" title="FALSE"><code class="literal">FALSE</code></a> for control characters, format characters, and
410
406
spaces). <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-isprint" title="g_unichar_isprint ()"><code class="function">g_unichar_isprint()</code></a> is similar, but returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> for
411
407
spaces. Given some UTF-8 text, obtain a character value with
412
<a class="link" href="glib-Unicode-Manipulation.html#g-utf8-get-char" title="g_utf8_get_char ()"><code class="function">g_utf8_get_char()</code></a>.</p>
408
<a class="link" href="glib-Unicode-Manipulation.html#g-utf8-get-char" title="g_utf8_get_char ()"><code class="function">g_utf8_get_char()</code></a>.
409
</p>
413
410
<div class="variablelist"><table border="0">
414
411
<col align="left" valign="top">
415
412
<tbody>
416
413
<tr>
417
414
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
418
<td> a Unicode character
415
<td>a Unicode character
419
416
</td>
420
417
</tr>
421
418
<tr>
429
426
<hr>
430
427
<div class="refsect2" title="g_unichar_islower ()">
431
428
<a name="g-unichar-islower"></a><h3>g_unichar_islower ()</h3>
432
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_islower (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
429
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_islower (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
433
430
<p>
434
431
Determines whether a character is a lowercase letter.
435
432
Given some UTF-8 text, obtain a character value with
436
<a class="link" href="glib-Unicode-Manipulation.html#g-utf8-get-char" title="g_utf8_get_char ()"><code class="function">g_utf8_get_char()</code></a>.</p>
433
<a class="link" href="glib-Unicode-Manipulation.html#g-utf8-get-char" title="g_utf8_get_char ()"><code class="function">g_utf8_get_char()</code></a>.
434
</p>
437
435
<div class="variablelist"><table border="0">
438
436
<col align="left" valign="top">
439
437
<tbody>
440
438
<tr>
441
439
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
442
<td> a Unicode character
440
<td>a Unicode character
443
441
</td>
444
442
</tr>
445
443
<tr>
453
451
<hr>
454
452
<div class="refsect2" title="g_unichar_ismark ()">
455
453
<a name="g-unichar-ismark"></a><h3>g_unichar_ismark ()</h3>
456
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_ismark (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
454
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_ismark (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
457
455
<p>
458
456
Determines whether a character is a mark (non-spacing mark,
459
457
combining mark, or enclosing mark in Unicode speak).
464
462
Note: in most cases where isalpha characters are allowed,
465
463
ismark characters should be allowed to as they are essential
466
464
for writing most European languages as well as many non-Latin
467
scripts.</p>
465
scripts.
466
</p>
468
467
<div class="variablelist"><table border="0">
469
468
<col align="left" valign="top">
470
469
<tbody>
471
470
<tr>
472
471
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
473
<td> a Unicode character
472
<td>a Unicode character
474
473
</td>
475
474
</tr>
476
475
<tr>
486
485
<hr>
487
486
<div class="refsect2" title="g_unichar_isprint ()">
488
487
<a name="g-unichar-isprint"></a><h3>g_unichar_isprint ()</h3>
489
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_isprint (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
488
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_isprint (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
490
489
<p>
491
490
Determines whether a character is printable.
492
491
Unlike <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-isgraph" title="g_unichar_isgraph ()"><code class="function">g_unichar_isgraph()</code></a>, returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> for spaces.
493
492
Given some UTF-8 text, obtain a character value with
494
<a class="link" href="glib-Unicode-Manipulation.html#g-utf8-get-char" title="g_utf8_get_char ()"><code class="function">g_utf8_get_char()</code></a>.</p>
493
<a class="link" href="glib-Unicode-Manipulation.html#g-utf8-get-char" title="g_utf8_get_char ()"><code class="function">g_utf8_get_char()</code></a>.
494
</p>
495
495
<div class="variablelist"><table border="0">
496
496
<col align="left" valign="top">
497
497
<tbody>
498
498
<tr>
499
499
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
500
<td> a Unicode character
500
<td>a Unicode character
501
501
</td>
502
502
</tr>
503
503
<tr>
511
511
<hr>
512
512
<div class="refsect2" title="g_unichar_ispunct ()">
513
513
<a name="g-unichar-ispunct"></a><h3>g_unichar_ispunct ()</h3>
514
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_ispunct (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
514
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_ispunct (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
515
515
<p>
516
516
Determines whether a character is punctuation or a symbol.
517
517
Given some UTF-8 text, obtain a character value with
518
<a class="link" href="glib-Unicode-Manipulation.html#g-utf8-get-char" title="g_utf8_get_char ()"><code class="function">g_utf8_get_char()</code></a>.</p>
518
<a class="link" href="glib-Unicode-Manipulation.html#g-utf8-get-char" title="g_utf8_get_char ()"><code class="function">g_utf8_get_char()</code></a>.
519
</p>
519
520
<div class="variablelist"><table border="0">
520
521
<col align="left" valign="top">
521
522
<tbody>
522
523
<tr>
523
524
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
524
<td> a Unicode character
525
<td>a Unicode character
525
526
</td>
526
527
</tr>
527
528
<tr>
535
536
<hr>
536
537
<div class="refsect2" title="g_unichar_isspace ()">
537
538
<a name="g-unichar-isspace"></a><h3>g_unichar_isspace ()</h3>
538
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_isspace (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
539
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_isspace (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
539
540
<p>
540
541
Determines whether a character is a space, tab, or line separator
541
542
(newline, carriage return, etc.). Given some UTF-8 text, obtain a
544
545
<p>
545
546
(Note: don't use this to do word breaking; you have to use
546
547
Pango or equivalent to get word breaking right, the algorithm
547
is fairly complex.)</p>
548
is fairly complex.)
549
</p>
548
550
<div class="variablelist"><table border="0">
549
551
<col align="left" valign="top">
550
552
<tbody>
551
553
<tr>
552
554
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
553
<td> a Unicode character
555
<td>a Unicode character
554
556
</td>
555
557
</tr>
556
558
<tr>
564
566
<hr>
565
567
<div class="refsect2" title="g_unichar_istitle ()">
566
568
<a name="g-unichar-istitle"></a><h3>g_unichar_istitle ()</h3>
567
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_istitle (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
569
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_istitle (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
568
570
<p>
569
571
Determines if a character is titlecase. Some characters in
570
572
Unicode which are composites, such as the DZ digraph
571
573
have three case variants instead of just two. The titlecase
572
574
form is used at the beginning of a word where only the
573
575
first letter is capitalized. The titlecase form of the DZ
574
digraph is U+01F2 LATIN CAPITAL LETTTER D WITH SMALL LETTER Z.</p>
576
digraph is U+01F2 LATIN CAPITAL LETTTER D WITH SMALL LETTER Z.
577
</p>
575
578
<div class="variablelist"><table border="0">
576
579
<col align="left" valign="top">
577
580
<tbody>
578
581
<tr>
579
582
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
580
<td> a Unicode character
583
<td>a Unicode character
581
584
</td>
582
585
</tr>
583
586
<tr>
591
594
<hr>
592
595
<div class="refsect2" title="g_unichar_isupper ()">
593
596
<a name="g-unichar-isupper"></a><h3>g_unichar_isupper ()</h3>
594
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_isupper (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
597
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_isupper (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
595
598
<p>
596
Determines if a character is uppercase.</p>
599
Determines if a character is uppercase.
600
</p>
597
601
<div class="variablelist"><table border="0">
598
602
<col align="left" valign="top">
599
603
<tbody>
600
604
<tr>
601
605
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
602
<td> a Unicode character
606
<td>a Unicode character
603
607
</td>
604
608
</tr>
605
609
<tr>
613
617
<hr>
614
618
<div class="refsect2" title="g_unichar_isxdigit ()">
615
619
<a name="g-unichar-isxdigit"></a><h3>g_unichar_isxdigit ()</h3>
616
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_isxdigit (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
620
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_isxdigit (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
617
621
<p>
618
Determines if a character is a hexidecimal digit.</p>
622
Determines if a character is a hexidecimal digit.
623
</p>
619
624
<div class="variablelist"><table border="0">
620
625
<col align="left" valign="top">
621
626
<tbody>
622
627
<tr>
623
628
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
624
<td> a Unicode character.
629
<td>a Unicode character.
625
630
</td>
626
631
</tr>
627
632
<tr>
635
640
<hr>
636
641
<div class="refsect2" title="g_unichar_iswide ()">
637
642
<a name="g-unichar-iswide"></a><h3>g_unichar_iswide ()</h3>
638
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_iswide (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
643
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_iswide (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
639
644
<p>
640
645
Determines if a character is typically rendered in a double-width
641
cell.</p>
646
cell.
647
</p>
642
648
<div class="variablelist"><table border="0">
643
649
<col align="left" valign="top">
644
650
<tbody>
645
651
<tr>
646
652
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
647
<td> a Unicode character
653
<td>a Unicode character
648
654
</td>
649
655
</tr>
650
656
<tr>
658
664
<hr>
659
665
<div class="refsect2" title="g_unichar_iswide_cjk ()">
660
666
<a name="g-unichar-iswide-cjk"></a><h3>g_unichar_iswide_cjk ()</h3>
661
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_iswide_cjk (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
667
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_iswide_cjk (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
662
668
<p>
663
669
Determines if a character is typically rendered in a double-width
664
670
cell under legacy East Asian locales. If a character is wide according to
670
676
<p>
671
677
If a character passes the <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-iswide" title="g_unichar_iswide ()"><code class="function">g_unichar_iswide()</code></a> test then it will also pass
672
678
this test, but not the other way around. Note that some characters may
673
pas both this test and <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-iszerowidth" title="g_unichar_iszerowidth ()"><code class="function">g_unichar_iszerowidth()</code></a>.</p>
679
pas both this test and <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-iszerowidth" title="g_unichar_iszerowidth ()"><code class="function">g_unichar_iszerowidth()</code></a>.
680
</p>
674
681
<div class="variablelist"><table border="0">
675
682
<col align="left" valign="top">
676
683
<tbody>
677
684
<tr>
678
685
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
679
<td> a Unicode character
686
<td>a Unicode character
680
687
</td>
681
688
</tr>
682
689
<tr>
692
699
<hr>
693
700
<div class="refsect2" title="g_unichar_iszerowidth ()">
694
701
<a name="g-unichar-iszerowidth"></a><h3>g_unichar_iszerowidth ()</h3>
695
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_iszerowidth (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
702
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_iszerowidth (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
696
703
<p>
697
704
Determines if a given character typically takes zero width when rendered.
698
705
The return value is <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> for all non-spacing and enclosing marks
703
710
A typical use of this function is with one of <a class="link" href="glib-Unicode-Manipulation.html#g-unichar-iswide" title="g_unichar_iswide ()"><code class="function">g_unichar_iswide()</code></a> or
704
711
<a class="link" href="glib-Unicode-Manipulation.html#g-unichar-iswide-cjk" title="g_unichar_iswide_cjk ()"><code class="function">g_unichar_iswide_cjk()</code></a> to determine the number of cells a string occupies
705
712
when displayed on a grid display (terminals). However, note that not all
706
terminals support zero-width rendering of zero-width marks.</p>
713
terminals support zero-width rendering of zero-width marks.
714
</p>
707
715
<div class="variablelist"><table border="0">
708
716
<col align="left" valign="top">
709
717
<tbody>
710
718
<tr>
711
719
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
712
<td> a Unicode character
720
<td>a Unicode character
713
721
</td>
714
722
</tr>
715
723
<tr>
725
733
<hr>
726
734
<div class="refsect2" title="g_unichar_toupper ()">
727
735
<a name="g-unichar-toupper"></a><h3>g_unichar_toupper ()</h3>
728
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> g_unichar_toupper (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
736
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> g_unichar_toupper (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
729
737
<p>
730
Converts a character to uppercase.</p>
738
Converts a character to uppercase.
739
</p>
731
740
<div class="variablelist"><table border="0">
732
741
<col align="left" valign="top">
733
742
<tbody>
734
743
<tr>
735
744
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
736
<td> a Unicode character
745
<td>a Unicode character
737
746
</td>
738
747
</tr>
739
748
<tr>
749
758
<hr>
750
759
<div class="refsect2" title="g_unichar_tolower ()">
751
760
<a name="g-unichar-tolower"></a><h3>g_unichar_tolower ()</h3>
752
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> g_unichar_tolower (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
761
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> g_unichar_tolower (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
753
762
<p>
754
Converts a character to lower case.</p>
763
Converts a character to lower case.
764
</p>
755
765
<div class="variablelist"><table border="0">
756
766
<col align="left" valign="top">
757
767
<tbody>
758
768
<tr>
759
769
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
760
<td> a Unicode character.
770
<td>a Unicode character.
761
771
</td>
762
772
</tr>
763
773
<tr>
773
783
<hr>
774
784
<div class="refsect2" title="g_unichar_totitle ()">
775
785
<a name="g-unichar-totitle"></a><h3>g_unichar_totitle ()</h3>
776
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> g_unichar_totitle (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
786
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> g_unichar_totitle (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
777
787
<p>
778
Converts a character to the titlecase.</p>
788
Converts a character to the titlecase.
789
</p>
779
790
<div class="variablelist"><table border="0">
780
791
<col align="left" valign="top">
781
792
<tbody>
782
793
<tr>
783
794
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
784
<td> a Unicode character
795
<td>a Unicode character
785
796
</td>
786
797
</tr>
787
798
<tr>
797
808
<hr>
798
809
<div class="refsect2" title="g_unichar_digit_value ()">
799
810
<a name="g-unichar-digit-value"></a><h3>g_unichar_digit_value ()</h3>
800
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_unichar_digit_value (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
811
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_unichar_digit_value (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
801
812
<p>
802
813
Determines the numeric value of a character as a decimal
803
digit.</p>
814
digit.
815
</p>
804
816
<div class="variablelist"><table border="0">
805
817
<col align="left" valign="top">
806
818
<tbody>
807
819
<tr>
808
820
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
809
<td> a Unicode character
821
<td>a Unicode character
810
822
</td>
811
823
</tr>
812
824
<tr>
821
833
<hr>
822
834
<div class="refsect2" title="g_unichar_xdigit_value ()">
823
835
<a name="g-unichar-xdigit-value"></a><h3>g_unichar_xdigit_value ()</h3>
824
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_unichar_xdigit_value (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
836
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_unichar_xdigit_value (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
825
837
<p>
826
838
Determines the numeric value of a character as a hexidecimal
827
digit.</p>
839
digit.
840
</p>
828
841
<div class="variablelist"><table border="0">
829
842
<col align="left" valign="top">
830
843
<tbody>
831
844
<tr>
832
845
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
833
<td> a Unicode character
846
<td>a Unicode character
834
847
</td>
835
848
</tr>
836
849
<tr>
1043
1056
<hr>
1044
1057
<div class="refsect2" title="g_unichar_type ()">
1045
1058
<a name="g-unichar-type"></a><h3>g_unichar_type ()</h3>
1046
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#GUnicodeType" title="enum GUnicodeType"><span class="returnvalue">GUnicodeType</span></a> g_unichar_type (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
1059
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#GUnicodeType" title="enum GUnicodeType"><span class="returnvalue">GUnicodeType</span></a> g_unichar_type (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
1047
1060
<p>
1048
Classifies a Unicode character by type.</p>
1061
Classifies a Unicode character by type.
1062
</p>
1049
1063
<div class="variablelist"><table border="0">
1050
1064
<col align="left" valign="top">
1051
1065
<tbody>
1052
1066
<tr>
1053
1067
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
1054
<td> a Unicode character
1068
<td>a Unicode character
1055
1069
</td>
1056
1070
</tr>
1057
1071
<tr>
1302
1316
<hr>
1303
1317
<div class="refsect2" title="g_unichar_break_type ()">
1304
1318
<a name="g-unichar-break-type"></a><h3>g_unichar_break_type ()</h3>
1305
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#GUnicodeBreakType" title="enum GUnicodeBreakType"><span class="returnvalue">GUnicodeBreakType</span></a> g_unichar_break_type (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
1319
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#GUnicodeBreakType" title="enum GUnicodeBreakType"><span class="returnvalue">GUnicodeBreakType</span></a> g_unichar_break_type (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
1306
1320
<p>
1307
1321
Determines the break type of <em class="parameter"><code>c</code></em>. <em class="parameter"><code>c</code></em> should be a Unicode character
1308
1322
(to derive a character from UTF-8 encoded text, use
1309
1323
<a class="link" href="glib-Unicode-Manipulation.html#g-utf8-get-char" title="g_utf8_get_char ()"><code class="function">g_utf8_get_char()</code></a>). The break type is used to find word and line
1310
1324
breaks ("text boundaries"), Pango implements the Unicode boundary
1311
1325
resolution algorithms and normally you would use a function such
1312
as <a href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#pango-break"><code class="function">pango_break()</code></a> instead of caring about break types yourself.</p>
1326
as <a href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#pango-break"><code class="function">pango_break()</code></a> instead of caring about break types yourself.
1327
</p>
1313
1328
<div class="variablelist"><table border="0">
1314
1329
<col align="left" valign="top">
1315
1330
<tbody>
1316
1331
<tr>
1317
1332
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
1318
<td> a Unicode character
1333
<td>a Unicode character
1319
1334
</td>
1320
1335
</tr>
1321
1336
<tr>
1329
1344
<hr>
1330
1345
<div class="refsect2" title="g_unichar_combining_class ()">
1331
1346
<a name="g-unichar-combining-class"></a><h3>g_unichar_combining_class ()</h3>
1332
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_unichar_combining_class (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> uc);</pre>
1347
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_unichar_combining_class (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> uc</code></em>);</pre>
1333
1348
<p>
1334
Determines the canonical combining class of a Unicode character.</p>
1349
Determines the canonical combining class of a Unicode character.
1350
</p>
1335
1351
<div class="variablelist"><table border="0">
1336
1352
<col align="left" valign="top">
1337
1353
<tbody>
1338
1354
<tr>
1339
1355
<td><p><span class="term"><em class="parameter"><code>uc</code></em> :</span></p></td>
1340
<td> a Unicode character
1356
<td>a Unicode character
1341
1357
</td>
1342
1358
</tr>
1343
1359
<tr>
1353
1369
<hr>
1354
1370
<div class="refsect2" title="g_unicode_canonical_ordering ()">
1355
1371
<a name="g-unicode-canonical-ordering"></a><h3>g_unicode_canonical_ordering ()</h3>
1356
<pre class="programlisting"><span class="returnvalue">void</span> g_unicode_canonical_ordering (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> *string,
1357
<a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> len);</pre>
1372
<pre class="programlisting"><span class="returnvalue">void</span> g_unicode_canonical_ordering (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> *string</code></em>,
1373
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> len</code></em>);</pre>
1358
1374
<p>
1359
1375
Computes the canonical ordering of a string in-place.
1360
1376
This rearranges decomposed characters in the string
1361
1377
according to their combining classes. See the Unicode
1362
manual for more information.</p>
1378
manual for more information.
1379
</p>
1363
1380
<div class="variablelist"><table border="0">
1364
1381
<col align="left" valign="top">
1365
1382
<tbody>
1366
1383
<tr>
1367
1384
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
1368
<td> a UCS-4 encoded string.
1385
<td>a UCS-4 encoded string.
1369
1386
</td>
1370
1387
</tr>
1371
1388
<tr>
1372
1389
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
1373
<td> the maximum length of <em class="parameter"><code>string</code></em> to use.
1390
<td>the maximum length of <em class="parameter"><code>string</code></em> to use.
1374
1391
</td>
1375
1392
</tr>
1376
1393
</tbody>
1379
1396
<hr>
1380
1397
<div class="refsect2" title="g_unicode_canonical_decomposition ()">
1381
1398
<a name="g-unicode-canonical-decomposition"></a><h3>g_unicode_canonical_decomposition ()</h3>
1382
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> * g_unicode_canonical_decomposition (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> ch,
1383
<a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> *result_len);</pre>
1399
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> * g_unicode_canonical_decomposition (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> ch</code></em>,
1400
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> *result_len</code></em>);</pre>
1384
1401
<p>
1385
Computes the canonical decomposition of a Unicode character.</p>
1402
Computes the canonical decomposition of a Unicode character.
1403
</p>
1386
1404
<div class="variablelist"><table border="0">
1387
1405
<col align="left" valign="top">
1388
1406
<tbody>
1389
1407
<tr>
1390
1408
<td><p><span class="term"><em class="parameter"><code>ch</code></em> :</span></p></td>
1391
<td> a Unicode character.
1409
<td>a Unicode character.
1392
1410
</td>
1393
1411
</tr>
1394
1412
<tr>
1395
1413
<td><p><span class="term"><em class="parameter"><code>result_len</code></em> :</span></p></td>
1396
<td> location to store the length of the return value.
1414
<td>location to store the length of the return value.
1397
1415
</td>
1398
1416
</tr>
1399
1417
<tr>
1408
1426
<hr>
1409
1427
<div class="refsect2" title="g_unichar_get_mirror_char ()">
1410
1428
<a name="g-unichar-get-mirror-char"></a><h3>g_unichar_get_mirror_char ()</h3>
1411
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_get_mirror_char (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> ch,
1412
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> *mirrored_ch);</pre>
1429
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_unichar_get_mirror_char (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> ch</code></em>,
1430
<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> *mirrored_ch</code></em>);</pre>
1413
1431
<p>
1414
1432
In Unicode, some characters are <em class="firstterm">mirrored</em>. This
1415
1433
means that their images are mirrored horizontally in text that is laid
1420
1438
If <em class="parameter"><code>ch</code></em> has the Unicode mirrored property and there is another unicode
1421
1439
character that typically has a glyph that is the mirror image of <em class="parameter"><code>ch</code></em>'s
1422
1440
glyph and <em class="parameter"><code>mirrored_ch</code></em> is set, it puts that character in the address
1423
pointed to by <em class="parameter"><code>mirrored_ch</code></em>. Otherwise the original character is put.</p>
1441
pointed to by <em class="parameter"><code>mirrored_ch</code></em>. Otherwise the original character is put.
1442
</p>
1424
1443
<div class="variablelist"><table border="0">
1425
1444
<col align="left" valign="top">
1426
1445
<tbody>
1427
1446
<tr>
1428
1447
<td><p><span class="term"><em class="parameter"><code>ch</code></em> :</span></p></td>
1429
<td> a Unicode character
1448
<td>a Unicode character
1430
1449
</td>
1431
1450
</tr>
1432
1451
<tr>
1433
1452
<td><p><span class="term"><em class="parameter"><code>mirrored_ch</code></em> :</span></p></td>
1434
<td> location to store the mirrored character
1453
<td>location to store the mirrored character
1435
1454
</td>
1436
1455
</tr>
1437
1456
<tr>
1954
1973
<hr>
1955
1974
<div class="refsect2" title="g_unichar_get_script ()">
1956
1975
<a name="g-unichar-get-script"></a><h3>g_unichar_get_script ()</h3>
1957
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#GUnicodeScript" title="enum GUnicodeScript"><span class="returnvalue">GUnicodeScript</span></a> g_unichar_get_script (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> ch);</pre>
1976
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#GUnicodeScript" title="enum GUnicodeScript"><span class="returnvalue">GUnicodeScript</span></a> g_unichar_get_script (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> ch</code></em>);</pre>
1958
1977
<p>
1959
1978
Looks up the <a class="link" href="glib-Unicode-Manipulation.html#GUnicodeScript" title="enum GUnicodeScript"><span class="type">GUnicodeScript</span></a> for a particular character (as defined
1960
1979
by Unicode Standard Annex <span class="type">24</span>). No check is made for <em class="parameter"><code>ch</code></em> being a
1963
1982
</p>
1964
1983
<p>
1965
1984
This function is equivalent to <a href="/usr/share/gtk-doc/html/pango/pango-Scripts-and-Languages.html#pango-script-for-unichar"><code class="function">pango_script_for_unichar()</code></a> and the
1966
two are interchangeable.</p>
1985
two are interchangeable.
1986
</p>
1967
1987
<div class="variablelist"><table border="0">
1968
1988
<col align="left" valign="top">
1969
1989
<tbody>
1970
1990
<tr>
1971
1991
<td><p><span class="term"><em class="parameter"><code>ch</code></em> :</span></p></td>
1972
<td> a Unicode character
1992
<td>a Unicode character
1973
1993
</td>
1974
1994
</tr>
1975
1995
<tr>
2006
2026
<hr>
2007
2027
<div class="refsect2" title="g_utf8_get_char ()">
2008
2028
<a name="g-utf8-get-char"></a><h3>g_utf8_get_char ()</h3>
2009
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> g_utf8_get_char (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *p);</pre>
2029
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> g_utf8_get_char (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *p</code></em>);</pre>
2010
2030
<p>
2011
2031
Converts a sequence of bytes encoded as UTF-8 to a Unicode character.
2012
2032
If <em class="parameter"><code>p</code></em> does not point to a valid UTF-8 encoded character, results are
2013
2033
undefined. If you are not sure that the bytes are complete
2014
2034
valid Unicode characters, you should use <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-get-char-validated" title="g_utf8_get_char_validated ()"><code class="function">g_utf8_get_char_validated()</code></a>
2015
instead.</p>
2035
instead.
2036
</p>
2016
2037
<div class="variablelist"><table border="0">
2017
2038
<col align="left" valign="top">
2018
2039
<tbody>
2019
2040
<tr>
2020
2041
<td><p><span class="term"><em class="parameter"><code>p</code></em> :</span></p></td>
2021
<td> a pointer to Unicode character encoded as UTF-8
2042
<td>a pointer to Unicode character encoded as UTF-8
2022
2043
</td>
2023
2044
</tr>
2024
2045
<tr>
2032
2053
<hr>
2033
2054
<div class="refsect2" title="g_utf8_get_char_validated ()">
2034
2055
<a name="g-utf8-get-char-validated"></a><h3>g_utf8_get_char_validated ()</h3>
2035
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> g_utf8_get_char_validated (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *p,
2036
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> max_len);</pre>
2056
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> g_utf8_get_char_validated (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *p</code></em>,
2057
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> max_len</code></em>);</pre>
2037
2058
<p>
2038
2059
Convert a sequence of bytes encoded as UTF-8 to a Unicode character.
2039
2060
This function checks for incomplete characters, for invalid characters
2040
2061
such as characters that are out of the range of Unicode, and for
2041
overlong encodings of valid characters.</p>
2062
overlong encodings of valid characters.
2063
</p>
2042
2064
<div class="variablelist"><table border="0">
2043
2065
<col align="left" valign="top">
2044
2066
<tbody>
2045
2067
<tr>
2046
2068
<td><p><span class="term"><em class="parameter"><code>p</code></em> :</span></p></td>
2047
<td> a pointer to Unicode character encoded as UTF-8
2069
<td>a pointer to Unicode character encoded as UTF-8
2048
2070
</td>
2049
2071
</tr>
2050
2072
<tr>
2051
2073
<td><p><span class="term"><em class="parameter"><code>max_len</code></em> :</span></p></td>
2052
<td> the maximum number of bytes to read, or -1, for no maximum or
2074
<td>the maximum number of bytes to read, or -1, for no maximum or
2053
2075
if <em class="parameter"><code>p</code></em> is nul-terminated
2054
2076
</td>
2055
2077
</tr>
2068
2090
<hr>
2069
2091
<div class="refsect2" title="g_utf8_offset_to_pointer ()">
2070
2092
<a name="g-utf8-offset-to-pointer"></a><h3>g_utf8_offset_to_pointer ()</h3>
2071
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* g_utf8_offset_to_pointer (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
2072
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> offset);</pre>
2093
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* g_utf8_offset_to_pointer (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
2094
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> offset</code></em>);</pre>
2073
2095
<p>
2074
2096
Converts from an integer character offset to a pointer to a position
2075
2097
within the string.
2094
2116
text rendering and therefore has to be as fast as possible.
2095
2117
</p>
2096
2118
</div>
2119
<p>
2120
</p>
2097
2121
<div class="variablelist"><table border="0">
2098
2122
<col align="left" valign="top">
2099
2123
<tbody>
2100
2124
<tr>
2101
2125
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
2102
<td> a UTF-8 encoded string
2126
<td>a UTF-8 encoded string
2103
2127
</td>
2104
2128
</tr>
2105
2129
<tr>
2106
2130
<td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
2107
<td> a character offset within <em class="parameter"><code>str</code></em>
2131
<td>a character offset within <em class="parameter"><code>str</code></em>
2108
2132
</td>
2109
2133
</tr>
2110
2134
<tr>
2118
2142
<hr>
2119
2143
<div class="refsect2" title="g_utf8_pointer_to_offset ()">
2120
2144
<a name="g-utf8-pointer-to-offset"></a><h3>g_utf8_pointer_to_offset ()</h3>
2121
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> g_utf8_pointer_to_offset (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
2122
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *pos);</pre>
2145
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> g_utf8_pointer_to_offset (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
2146
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *pos</code></em>);</pre>
2123
2147
<p>
2124
2148
Converts from a pointer to position within a string to a integer
2125
2149
character offset.
2126
2150
</p>
2127
2151
<p>
2128
2152
Since 2.10, this function allows <em class="parameter"><code>pos</code></em> to be before <em class="parameter"><code>str</code></em>, and returns
2129
a negative offset in this case.</p>
2153
a negative offset in this case.
2154
</p>
2130
2155
<div class="variablelist"><table border="0">
2131
2156
<col align="left" valign="top">
2132
2157
<tbody>
2133
2158
<tr>
2134
2159
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
2135
<td> a UTF-8 encoded string
2160
<td>a UTF-8 encoded string
2136
2161
</td>
2137
2162
</tr>
2138
2163
<tr>
2139
2164
<td><p><span class="term"><em class="parameter"><code>pos</code></em> :</span></p></td>
2140
<td> a pointer to a position within <em class="parameter"><code>str</code></em>
2165
<td>a pointer to a position within <em class="parameter"><code>str</code></em>
2141
2166
</td>
2142
2167
</tr>
2143
2168
<tr>
2151
2176
<hr>
2152
2177
<div class="refsect2" title="g_utf8_prev_char ()">
2153
2178
<a name="g-utf8-prev-char"></a><h3>g_utf8_prev_char ()</h3>
2154
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* g_utf8_prev_char (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *p);</pre>
2179
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* g_utf8_prev_char (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *p</code></em>);</pre>
2155
2180
<p>
2156
2181
Finds the previous UTF-8 character in the string before <em class="parameter"><code>p</code></em>.
2157
2182
</p>
2159
2184
<em class="parameter"><code>p</code></em> does not have to be at the beginning of a UTF-8 character. No check
2160
2185
is made to see if the character found is actually valid other than
2161
2186
it starts with an appropriate byte. If <em class="parameter"><code>p</code></em> might be the first
2162
character of the string, you must use <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-find-prev-char" title="g_utf8_find_prev_char ()"><code class="function">g_utf8_find_prev_char()</code></a> instead.</p>
2187
character of the string, you must use <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-find-prev-char" title="g_utf8_find_prev_char ()"><code class="function">g_utf8_find_prev_char()</code></a> instead.
2188
</p>
2163
2189
<div class="variablelist"><table border="0">
2164
2190
<col align="left" valign="top">
2165
2191
<tbody>
2166
2192
<tr>
2167
2193
<td><p><span class="term"><em class="parameter"><code>p</code></em> :</span></p></td>
2168
<td> a pointer to a position within a UTF-8 encoded string
2194
<td>a pointer to a position within a UTF-8 encoded string
2169
2195
</td>
2170
2196
</tr>
2171
2197
<tr>
2179
2205
<hr>
2180
2206
<div class="refsect2" title="g_utf8_find_next_char ()">
2181
2207
<a name="g-utf8-find-next-char"></a><h3>g_utf8_find_next_char ()</h3>
2182
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* g_utf8_find_next_char (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *p,
2183
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *end);</pre>
2208
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* g_utf8_find_next_char (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *p</code></em>,
2209
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *end</code></em>);</pre>
2184
2210
<p>
2185
2211
Finds the start of the next UTF-8 character in the string after <em class="parameter"><code>p</code></em>.
2186
2212
</p>
2187
2213
<p>
2188
2214
<em class="parameter"><code>p</code></em> does not have to be at the beginning of a UTF-8 character. No check
2189
2215
is made to see if the character found is actually valid other than
2190
it starts with an appropriate byte.</p>
2216
it starts with an appropriate byte.
2217
</p>
2191
2218
<div class="variablelist"><table border="0">
2192
2219
<col align="left" valign="top">
2193
2220
<tbody>
2194
2221
<tr>
2195
2222
<td><p><span class="term"><em class="parameter"><code>p</code></em> :</span></p></td>
2196
<td> a pointer to a position within a UTF-8 encoded string
2223
<td>a pointer to a position within a UTF-8 encoded string
2197
2224
</td>
2198
2225
</tr>
2199
2226
<tr>
2200
2227
<td><p><span class="term"><em class="parameter"><code>end</code></em> :</span></p></td>
2201
<td> a pointer to the byte following the end of the string,
2228
<td>a pointer to the byte following the end of the string,
2202
2229
or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to indicate that the string is nul-terminated.
2203
2230
</td>
2204
2231
</tr>
2213
2240
<hr>
2214
2241
<div class="refsect2" title="g_utf8_find_prev_char ()">
2215
2242
<a name="g-utf8-find-prev-char"></a><h3>g_utf8_find_prev_char ()</h3>
2216
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* g_utf8_find_prev_char (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
2217
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *p);</pre>
2243
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* g_utf8_find_prev_char (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
2244
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *p</code></em>);</pre>
2218
2245
<p>
2219
2246
Given a position <em class="parameter"><code>p</code></em> with a UTF-8 encoded string <em class="parameter"><code>str</code></em>, find the start
2220
2247
of the previous UTF-8 character starting before <em class="parameter"><code>p</code></em>. Returns <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if no
2223
2250
<p>
2224
2251
<em class="parameter"><code>p</code></em> does not have to be at the beginning of a UTF-8 character. No check
2225
2252
is made to see if the character found is actually valid other than
2226
it starts with an appropriate byte.</p>
2253
it starts with an appropriate byte.
2254
</p>
2227
2255
<div class="variablelist"><table border="0">
2228
2256
<col align="left" valign="top">
2229
2257
<tbody>
2230
2258
<tr>
2231
2259
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
2232
<td> pointer to the beginning of a UTF-8 encoded string
2260
<td>pointer to the beginning of a UTF-8 encoded string
2233
2261
</td>
2234
2262
</tr>
2235
2263
<tr>
2236
2264
<td><p><span class="term"><em class="parameter"><code>p</code></em> :</span></p></td>
2237
<td> pointer to some position within <em class="parameter"><code>str</code></em>
2265
<td>pointer to some position within <em class="parameter"><code>str</code></em>
2238
2266
</td>
2239
2267
</tr>
2240
2268
<tr>
2248
2276
<hr>
2249
2277
<div class="refsect2" title="g_utf8_strlen ()">
2250
2278
<a name="g-utf8-strlen"></a><h3>g_utf8_strlen ()</h3>
2251
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> g_utf8_strlen (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *p,
2252
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> max);</pre>
2279
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> g_utf8_strlen (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *p</code></em>,
2280
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> max</code></em>);</pre>
2253
2281
<p>
2254
2282
Computes the length of the string in characters, not including
2255
the terminating nul character.</p>
2283
the terminating nul character.
2284
</p>
2256
2285
<div class="variablelist"><table border="0">
2257
2286
<col align="left" valign="top">
2258
2287
<tbody>
2259
2288
<tr>
2260
2289
<td><p><span class="term"><em class="parameter"><code>p</code></em> :</span></p></td>
2261
<td> pointer to the start of a UTF-8 encoded string
2290
<td>pointer to the start of a UTF-8 encoded string
2262
2291
</td>
2263
2292
</tr>
2264
2293
<tr>
2265
2294
<td><p><span class="term"><em class="parameter"><code>max</code></em> :</span></p></td>
2266
<td> the maximum number of bytes to examine. If <em class="parameter"><code>max</code></em>
2295
<td>the maximum number of bytes to examine. If <em class="parameter"><code>max</code></em>
2267
2296
is less than 0, then the string is assumed to be
2268
2297
nul-terminated. If <em class="parameter"><code>max</code></em> is 0, <em class="parameter"><code>p</code></em> will not be examined and
2269
2298
may be <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
2280
2309
<hr>
2281
2310
<div class="refsect2" title="g_utf8_strncpy ()">
2282
2311
<a name="g-utf8-strncpy"></a><h3>g_utf8_strncpy ()</h3>
2283
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* g_utf8_strncpy (<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *dest,
2284
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *src,
2285
<a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="returnvalue">gsize</span></a> n);</pre>
2312
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* g_utf8_strncpy (<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *dest</code></em>,
2313
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *src</code></em>,
2314
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gsize" title="gsize"><span class="type">gsize</span></a> n</code></em>);</pre>
2286
2315
<p>
2287
2316
Like the standard C <code class="function">strncpy()</code> function, but
2288
2317
copies a given number of characters instead of a given number of
2289
2318
bytes. The <em class="parameter"><code>src</code></em> string must be valid UTF-8 encoded text.
2290
2319
(Use <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-validate" title="g_utf8_validate ()"><code class="function">g_utf8_validate()</code></a> on all text before trying to use UTF-8
2291
utility functions with it.)</p>
2320
utility functions with it.)
2321
</p>
2292
2322
<div class="variablelist"><table border="0">
2293
2323
<col align="left" valign="top">
2294
2324
<tbody>
2295
2325
<tr>
2296
2326
<td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
2297
<td> buffer to fill with characters from <em class="parameter"><code>src</code></em>
2327
<td>buffer to fill with characters from <em class="parameter"><code>src</code></em>
2298
2328
</td>
2299
2329
</tr>
2300
2330
<tr>
2301
2331
<td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
2302
<td> UTF-8 encoded string
2332
<td>UTF-8 encoded string
2303
2333
</td>
2304
2334
</tr>
2305
2335
<tr>
2306
2336
<td><p><span class="term"><em class="parameter"><code>n</code></em> :</span></p></td>
2307
<td> character count
2337
<td>character count
2308
2338
</td>
2309
2339
</tr>
2310
2340
<tr>
2318
2348
<hr>
2319
2349
<div class="refsect2" title="g_utf8_strchr ()">
2320
2350
<a name="g-utf8-strchr"></a><h3>g_utf8_strchr ()</h3>
2321
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* g_utf8_strchr (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *p,
2322
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> len,
2323
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
2351
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* g_utf8_strchr (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *p</code></em>,
2352
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>,
2353
<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
2324
2354
<p>
2325
2355
Finds the leftmost occurrence of the given Unicode character
2326
2356
in a UTF-8 encoded string, while limiting the search to <em class="parameter"><code>len</code></em> bytes.
2327
If <em class="parameter"><code>len</code></em> is -1, allow unbounded search.</p>
2357
If <em class="parameter"><code>len</code></em> is -1, allow unbounded search.
2358
</p>
2328
2359
<div class="variablelist"><table border="0">
2329
2360
<col align="left" valign="top">
2330
2361
<tbody>
2331
2362
<tr>
2332
2363
<td><p><span class="term"><em class="parameter"><code>p</code></em> :</span></p></td>
2333
<td> a nul-terminated UTF-8 encoded string
2364
<td>a nul-terminated UTF-8 encoded string
2334
2365
</td>
2335
2366
</tr>
2336
2367
<tr>
2337
2368
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
2338
<td> the maximum length of <em class="parameter"><code>p</code></em>
2369
<td>the maximum length of <em class="parameter"><code>p</code></em>
2339
2370
</td>
2340
2371
</tr>
2341
2372
<tr>
2342
2373
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
2343
<td> a Unicode character
2374
<td>a Unicode character
2344
2375
</td>
2345
2376
</tr>
2346
2377
<tr>
2356
2387
<hr>
2357
2388
<div class="refsect2" title="g_utf8_strrchr ()">
2358
2389
<a name="g-utf8-strrchr"></a><h3>g_utf8_strrchr ()</h3>
2359
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* g_utf8_strrchr (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *p,
2360
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> len,
2361
<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c);</pre>
2390
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* g_utf8_strrchr (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *p</code></em>,
2391
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>,
2392
<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>);</pre>
2362
2393
<p>
2363
2394
Find the rightmost occurrence of the given Unicode character
2364
2395
in a UTF-8 encoded string, while limiting the search to <em class="parameter"><code>len</code></em> bytes.
2365
If <em class="parameter"><code>len</code></em> is -1, allow unbounded search.</p>
2396
If <em class="parameter"><code>len</code></em> is -1, allow unbounded search.
2397
</p>
2366
2398
<div class="variablelist"><table border="0">
2367
2399
<col align="left" valign="top">
2368
2400
<tbody>
2369
2401
<tr>
2370
2402
<td><p><span class="term"><em class="parameter"><code>p</code></em> :</span></p></td>
2371
<td> a nul-terminated UTF-8 encoded string
2403
<td>a nul-terminated UTF-8 encoded string
2372
2404
</td>
2373
2405
</tr>
2374
2406
<tr>
2375
2407
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
2376
<td> the maximum length of <em class="parameter"><code>p</code></em>
2408
<td>the maximum length of <em class="parameter"><code>p</code></em>
2377
2409
</td>
2378
2410
</tr>
2379
2411
<tr>
2380
2412
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
2381
<td> a Unicode character
2413
<td>a Unicode character
2382
2414
</td>
2383
2415
</tr>
2384
2416
<tr>
2394
2426
<hr>
2395
2427
<div class="refsect2" title="g_utf8_strreverse ()">
2396
2428
<a name="g-utf8-strreverse"></a><h3>g_utf8_strreverse ()</h3>
2397
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* g_utf8_strreverse (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
2398
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> len);</pre>
2429
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* g_utf8_strreverse (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
2430
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>);</pre>
2399
2431
<p>
2400
2432
Reverses a UTF-8 string. <em class="parameter"><code>str</code></em> must be valid UTF-8 encoded text.
2401
2433
(Use <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-validate" title="g_utf8_validate ()"><code class="function">g_utf8_validate()</code></a> on all text before trying to use UTF-8
2411
2443
<p>
2412
2444
Note that unlike <a class="link" href="glib-String-Utility-Functions.html#g-strreverse" title="g_strreverse ()"><code class="function">g_strreverse()</code></a>, this function returns
2413
2445
newly-allocated memory, which should be freed with <a class="link" href="glib-Memory-Allocation.html#g-free" title="g_free ()"><code class="function">g_free()</code></a> when
2414
no longer needed.</p>
2446
no longer needed.
2447
</p>
2415
2448
<div class="variablelist"><table border="0">
2416
2449
<col align="left" valign="top">
2417
2450
<tbody>
2418
2451
<tr>
2419
2452
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
2420
<td> a UTF-8 encoded string
2453
<td>a UTF-8 encoded string
2421
2454
</td>
2422
2455
</tr>
2423
2456
<tr>
2424
2457
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
2425
<td> the maximum length of <em class="parameter"><code>str</code></em> to use, in bytes. If <em class="parameter"><code>len</code></em> < 0,
2458
<td>the maximum length of <em class="parameter"><code>str</code></em> to use, in bytes. If <em class="parameter"><code>len</code></em> < 0,
2426
2459
then the string is nul-terminated.
2427
2460
</td>
2428
2461
</tr>
2439
2472
<hr>
2440
2473
<div class="refsect2" title="g_utf8_validate ()">
2441
2474
<a name="g-utf8-validate"></a><h3>g_utf8_validate ()</h3>
2442
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_utf8_validate (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
2443
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> max_len,
2444
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> **end);</pre>
2475
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean"><span class="returnvalue">gboolean</span></a> g_utf8_validate (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
2476
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> max_len</code></em>,
2477
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> **end</code></em>);</pre>
2445
2478
<p>
2446
2479
Validates UTF-8 encoded text. <em class="parameter"><code>str</code></em> is the text to validate;
2447
2480
if <em class="parameter"><code>str</code></em> is nul-terminated, then <em class="parameter"><code>max_len</code></em> can be -1, otherwise
2459
2492
Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if all of <em class="parameter"><code>str</code></em> was valid. Many GLib and GTK+
2460
2493
routines <span class="emphasis"><em>require</em></span> valid UTF-8 as input;
2461
2494
so data read from a file or the network should be checked
2462
with <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-validate" title="g_utf8_validate ()"><code class="function">g_utf8_validate()</code></a> before doing anything else with it.</p>
2495
with <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-validate" title="g_utf8_validate ()"><code class="function">g_utf8_validate()</code></a> before doing anything else with it.
2496
</p>
2463
2497
<div class="variablelist"><table border="0">
2464
2498
<col align="left" valign="top">
2465
2499
<tbody>
2466
2500
<tr>
2467
2501
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
2468
<td> a pointer to character data
2502
<td>a pointer to character data
2469
2503
</td>
2470
2504
</tr>
2471
2505
<tr>
2472
2506
<td><p><span class="term"><em class="parameter"><code>max_len</code></em> :</span></p></td>
2473
<td> max bytes to validate, or -1 to go until NUL
2507
<td>max bytes to validate, or -1 to go until NUL
2474
2508
</td>
2475
2509
</tr>
2476
2510
<tr>
2477
2511
<td><p><span class="term"><em class="parameter"><code>end</code></em> :</span></p></td>
2478
<td> return location for end of valid data
2512
<td>return location for end of valid data
2479
2513
</td>
2480
2514
</tr>
2481
2515
<tr>
2489
2523
<hr>
2490
2524
<div class="refsect2" title="g_utf8_strup ()">
2491
2525
<a name="g-utf8-strup"></a><h3>g_utf8_strup ()</h3>
2492
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_utf8_strup (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
2493
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> len);</pre>
2526
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_utf8_strup (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
2527
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>);</pre>
2494
2528
<p>
2495
2529
Converts all Unicode characters in the string that have a case
2496
2530
to uppercase. The exact manner that this is done depends
2497
2531
on the current locale, and may result in the number of
2498
2532
characters in the string increasing. (For instance, the
2499
German ess-zet will be changed to SS.)</p>
2533
German ess-zet will be changed to SS.)
2534
</p>
2500
2535
<div class="variablelist"><table border="0">
2501
2536
<col align="left" valign="top">
2502
2537
<tbody>
2503
2538
<tr>
2504
2539
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
2505
<td> a UTF-8 encoded string
2540
<td>a UTF-8 encoded string
2506
2541
</td>
2507
2542
</tr>
2508
2543
<tr>
2509
2544
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
2510
<td> length of <em class="parameter"><code>str</code></em>, in bytes, or -1 if <em class="parameter"><code>str</code></em> is nul-terminated.
2545
<td>length of <em class="parameter"><code>str</code></em>, in bytes, or -1 if <em class="parameter"><code>str</code></em> is nul-terminated.
2511
2546
</td>
2512
2547
</tr>
2513
2548
<tr>
2522
2557
<hr>
2523
2558
<div class="refsect2" title="g_utf8_strdown ()">
2524
2559
<a name="g-utf8-strdown"></a><h3>g_utf8_strdown ()</h3>
2525
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_utf8_strdown (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
2526
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> len);</pre>
2560
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_utf8_strdown (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
2561
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>);</pre>
2527
2562
<p>
2528
2563
Converts all Unicode characters in the string that have a case
2529
2564
to lowercase. The exact manner that this is done depends
2530
2565
on the current locale, and may result in the number of
2531
characters in the string changing.</p>
2566
characters in the string changing.
2567
</p>
2532
2568
<div class="variablelist"><table border="0">
2533
2569
<col align="left" valign="top">
2534
2570
<tbody>
2535
2571
<tr>
2536
2572
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
2537
<td> a UTF-8 encoded string
2573
<td>a UTF-8 encoded string
2538
2574
</td>
2539
2575
</tr>
2540
2576
<tr>
2541
2577
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
2542
<td> length of <em class="parameter"><code>str</code></em>, in bytes, or -1 if <em class="parameter"><code>str</code></em> is nul-terminated.
2578
<td>length of <em class="parameter"><code>str</code></em>, in bytes, or -1 if <em class="parameter"><code>str</code></em> is nul-terminated.
2543
2579
</td>
2544
2580
</tr>
2545
2581
<tr>
2554
2590
<hr>
2555
2591
<div class="refsect2" title="g_utf8_casefold ()">
2556
2592
<a name="g-utf8-casefold"></a><h3>g_utf8_casefold ()</h3>
2557
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_utf8_casefold (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
2558
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> len);</pre>
2593
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_utf8_casefold (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
2594
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>);</pre>
2559
2595
<p>
2560
2596
Converts a string into a form that is independent of case. The
2561
2597
result will not correspond to any particular case, but can be
2568
2604
ordering, though it is a fairly good one. Getting this exactly
2569
2605
right would require a more sophisticated collation function that
2570
2606
takes case sensitivity into account. GLib does not currently
2571
provide such a function.</p>
2607
provide such a function.
2608
</p>
2572
2609
<div class="variablelist"><table border="0">
2573
2610
<col align="left" valign="top">
2574
2611
<tbody>
2575
2612
<tr>
2576
2613
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
2577
<td> a UTF-8 encoded string
2614
<td>a UTF-8 encoded string
2578
2615
</td>
2579
2616
</tr>
2580
2617
<tr>
2581
2618
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
2582
<td> length of <em class="parameter"><code>str</code></em>, in bytes, or -1 if <em class="parameter"><code>str</code></em> is nul-terminated.
2619
<td>length of <em class="parameter"><code>str</code></em>, in bytes, or -1 if <em class="parameter"><code>str</code></em> is nul-terminated.
2583
2620
</td>
2584
2621
</tr>
2585
2622
<tr>
2594
2631
<hr>
2595
2632
<div class="refsect2" title="g_utf8_normalize ()">
2596
2633
<a name="g-utf8-normalize"></a><h3>g_utf8_normalize ()</h3>
2597
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_utf8_normalize (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
2598
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> len,
2599
<a class="link" href="glib-Unicode-Manipulation.html#GNormalizeMode" title="enum GNormalizeMode"><span class="returnvalue">GNormalizeMode</span></a> mode);</pre>
2634
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_utf8_normalize (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
2635
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>,
2636
<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#GNormalizeMode" title="enum GNormalizeMode"><span class="type">GNormalizeMode</span></a> mode</code></em>);</pre>
2600
2637
<p>
2601
2638
Converts a string into canonical form, standardizing
2602
2639
such issues as whether a character with an accent
2624
2661
than a maximally decomposed form. This is often
2625
2662
useful if you intend to convert the string to
2626
2663
a legacy encoding or pass it to a system with
2627
less capable Unicode handling.</p>
2664
less capable Unicode handling.
2665
</p>
2628
2666
<div class="variablelist"><table border="0">
2629
2667
<col align="left" valign="top">
2630
2668
<tbody>
2631
2669
<tr>
2632
2670
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
2633
<td> a UTF-8 encoded string.
2671
<td>a UTF-8 encoded string.
2634
2672
</td>
2635
2673
</tr>
2636
2674
<tr>
2637
2675
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
2638
<td> length of <em class="parameter"><code>str</code></em>, in bytes, or -1 if <em class="parameter"><code>str</code></em> is nul-terminated.
2676
<td>length of <em class="parameter"><code>str</code></em>, in bytes, or -1 if <em class="parameter"><code>str</code></em> is nul-terminated.
2639
2677
</td>
2640
2678
</tr>
2641
2679
<tr>
2642
2680
<td><p><span class="term"><em class="parameter"><code>mode</code></em> :</span></p></td>
2643
<td> the type of normalization to perform.
2681
<td>the type of normalization to perform.
2644
2682
</td>
2645
2683
</tr>
2646
2684
<tr>
2729
2767
<hr>
2730
2768
<div class="refsect2" title="g_utf8_collate ()">
2731
2769
<a name="g-utf8-collate"></a><h3>g_utf8_collate ()</h3>
2732
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_utf8_collate (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str1,
2733
const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str2);</pre>
2770
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_utf8_collate (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str1</code></em>,
2771
<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str2</code></em>);</pre>
2734
2772
<p>
2735
2773
Compares two strings for ordering using the linguistically
2736
2774
correct rules for the <a class="link" href="glib-running.html#setlocale" title="Locale">current locale</a>.
2737
2775
When sorting a large number of strings, it will be significantly
2738
2776
faster to obtain collation keys with <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-collate-key" title="g_utf8_collate_key ()"><code class="function">g_utf8_collate_key()</code></a> and
2739
2777
compare the keys with <code class="function">strcmp()</code> when sorting instead of sorting
2740
the original strings.</p>
2778
the original strings.
2779
</p>
2741
2780
<div class="variablelist"><table border="0">
2742
2781
<col align="left" valign="top">
2743
2782
<tbody>
2744
2783
<tr>
2745
2784
<td><p><span class="term"><em class="parameter"><code>str1</code></em> :</span></p></td>
2746
<td> a UTF-8 encoded string
2785
<td>a UTF-8 encoded string
2747
2786
</td>
2748
2787
</tr>
2749
2788
<tr>
2750
2789
<td><p><span class="term"><em class="parameter"><code>str2</code></em> :</span></p></td>
2751
<td> a UTF-8 encoded string
2790
<td>a UTF-8 encoded string
2752
2791
</td>
2753
2792
</tr>
2754
2793
<tr>
2763
2802
<hr>
2764
2803
<div class="refsect2" title="g_utf8_collate_key ()">
2765
2804
<a name="g-utf8-collate-key"></a><h3>g_utf8_collate_key ()</h3>
2766
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_utf8_collate_key (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
2767
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> len);</pre>
2805
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_utf8_collate_key (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
2806
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>);</pre>
2768
2807
<p>
2769
2808
Converts a string into a collation key that can be compared
2770
2809
with other collation keys produced by the same function using
2777
2816
</p>
2778
2817
<p>
2779
2818
Note that this function depends on the
2780
<a class="link" href="glib-running.html#setlocale" title="Locale">current locale</a>.</p>
2819
<a class="link" href="glib-running.html#setlocale" title="Locale">current locale</a>.
2820
</p>
2781
2821
<div class="variablelist"><table border="0">
2782
2822
<col align="left" valign="top">
2783
2823
<tbody>
2784
2824
<tr>
2785
2825
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
2786
<td> a UTF-8 encoded string.
2826
<td>a UTF-8 encoded string.
2787
2827
</td>
2788
2828
</tr>
2789
2829
<tr>
2790
2830
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
2791
<td> length of <em class="parameter"><code>str</code></em>, in bytes, or -1 if <em class="parameter"><code>str</code></em> is nul-terminated.
2831
<td>length of <em class="parameter"><code>str</code></em>, in bytes, or -1 if <em class="parameter"><code>str</code></em> is nul-terminated.
2792
2832
</td>
2793
2833
</tr>
2794
2834
<tr>
2803
2843
<hr>
2804
2844
<div class="refsect2" title="g_utf8_collate_key_for_filename ()">
2805
2845
<a name="g-utf8-collate-key-for-filename"></a><h3>g_utf8_collate_key_for_filename ()</h3>
2806
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_utf8_collate_key_for_filename (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
2807
<a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="returnvalue">gssize</span></a> len);</pre>
2846
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> * g_utf8_collate_key_for_filename (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
2847
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gssize" title="gssize"><span class="type">gssize</span></a> len</code></em>);</pre>
2808
2848
<p>
2809
2849
Converts a string into a collation key that can be compared
2810
2850
with other collation keys produced by the same function using <code class="function">strcmp()</code>.
2819
2859
</p>
2820
2860
<p>
2821
2861
Note that this function depends on the
2822
<a class="link" href="glib-running.html#setlocale" title="Locale">current locale</a>.</p>
2862
<a class="link" href="glib-running.html#setlocale" title="Locale">current locale</a>.
2863
</p>
2823
2864
<div class="variablelist"><table border="0">
2824
2865
<col align="left" valign="top">
2825
2866
<tbody>
2826
2867
<tr>
2827
2868
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
2828
<td> a UTF-8 encoded string.
2869
<td>a UTF-8 encoded string.
2829
2870
</td>
2830
2871
</tr>
2831
2872
<tr>
2832
2873
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
2833
<td> length of <em class="parameter"><code>str</code></em>, in bytes, or -1 if <em class="parameter"><code>str</code></em> is nul-terminated.
2874
<td>length of <em class="parameter"><code>str</code></em>, in bytes, or -1 if <em class="parameter"><code>str</code></em> is nul-terminated.
2834
2875
</td>
2835
2876
</tr>
2836
2877
<tr>
2847
2888
<hr>
2848
2889
<div class="refsect2" title="g_utf8_to_utf16 ()">
2849
2890
<a name="g-utf8-to-utf16"></a><h3>g_utf8_to_utf16 ()</h3>
2850
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#gunichar2" title="gunichar2"><span class="returnvalue">gunichar2</span></a> * g_utf8_to_utf16 (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
2851
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> len,
2852
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_read,
2853
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_written,
2854
<a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);</pre>
2891
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#gunichar2" title="gunichar2"><span class="returnvalue">gunichar2</span></a> * g_utf8_to_utf16 (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
2892
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> len</code></em>,
2893
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_read</code></em>,
2894
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_written</code></em>,
2895
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2855
2896
<p>
2856
2897
Convert a string from UTF-8 to UTF-16. A 0 character will be
2857
added to the result after the converted text.</p>
2898
added to the result after the converted text.
2899
</p>
2858
2900
<div class="variablelist"><table border="0">
2859
2901
<col align="left" valign="top">
2860
2902
<tbody>
2861
2903
<tr>
2862
2904
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
2863
<td> a UTF-8 encoded string
2905
<td>a UTF-8 encoded string
2864
2906
</td>
2865
2907
</tr>
2866
2908
<tr>
2867
2909
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
2868
<td> the maximum length (number of bytes) of <em class="parameter"><code>str</code></em> to use.
2910
<td>the maximum length (number of bytes) of <em class="parameter"><code>str</code></em> to use.
2869
2911
If <em class="parameter"><code>len</code></em> < 0, then the string is nul-terminated.
2870
2912
</td>
2871
2913
</tr>
2872
2914
<tr>
2873
2915
<td><p><span class="term"><em class="parameter"><code>items_read</code></em> :</span></p></td>
2874
<td> location to store number of bytes read, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
2916
<td>location to store number of bytes read, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
2875
2917
If <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, then <a class="link" href="glib-Character-Set-Conversion.html#G-CONVERT-ERROR-PARTIAL-INPUT:CAPS"><code class="literal">G_CONVERT_ERROR_PARTIAL_INPUT</code></a> will be
2876
2918
returned in case <em class="parameter"><code>str</code></em> contains a trailing partial
2877
2919
character. If an error occurs then the index of the
2880
2922
</tr>
2881
2923
<tr>
2882
2924
<td><p><span class="term"><em class="parameter"><code>items_written</code></em> :</span></p></td>
2883
<td> location to store number of <span class="type">gunichar2</span> written,
2925
<td>location to store number of <span class="type">gunichar2</span> written,
2884
2926
or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
2885
2927
The value stored here does not include the trailing 0.
2886
2928
</td>
2887
2929
</tr>
2888
2930
<tr>
2889
2931
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2890
<td> location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore
2932
<td>location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore
2891
2933
errors. Any of the errors in <a class="link" href="glib-Character-Set-Conversion.html#GConvertError" title="enum GConvertError"><span class="type">GConvertError</span></a> other than
2892
2934
<a class="link" href="glib-Character-Set-Conversion.html#G-CONVERT-ERROR-NO-CONVERSION:CAPS"><code class="literal">G_CONVERT_ERROR_NO_CONVERSION</code></a> may occur.
2893
2935
</td>
2906
2948
<hr>
2907
2949
<div class="refsect2" title="g_utf8_to_ucs4 ()">
2908
2950
<a name="g-utf8-to-ucs4"></a><h3>g_utf8_to_ucs4 ()</h3>
2909
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> * g_utf8_to_ucs4 (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
2910
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> len,
2911
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_read,
2912
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_written,
2913
<a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);</pre>
2951
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> * g_utf8_to_ucs4 (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
2952
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> len</code></em>,
2953
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_read</code></em>,
2954
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_written</code></em>,
2955
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2914
2956
<p>
2915
2957
Convert a string from UTF-8 to a 32-bit fixed width
2916
2958
representation as UCS-4. A trailing 0 will be added to the
2917
string after the converted text.</p>
2959
string after the converted text.
2960
</p>
2918
2961
<div class="variablelist"><table border="0">
2919
2962
<col align="left" valign="top">
2920
2963
<tbody>
2921
2964
<tr>
2922
2965
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
2923
<td> a UTF-8 encoded string
2966
<td>a UTF-8 encoded string
2924
2967
</td>
2925
2968
</tr>
2926
2969
<tr>
2927
2970
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
2928
<td> the maximum length of <em class="parameter"><code>str</code></em> to use, in bytes. If <em class="parameter"><code>len</code></em> < 0,
2971
<td>the maximum length of <em class="parameter"><code>str</code></em> to use, in bytes. If <em class="parameter"><code>len</code></em> < 0,
2929
2972
then the string is nul-terminated.
2930
2973
</td>
2931
2974
</tr>
2932
2975
<tr>
2933
2976
<td><p><span class="term"><em class="parameter"><code>items_read</code></em> :</span></p></td>
2934
<td> location to store number of bytes read, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
2977
<td>location to store number of bytes read, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
2935
2978
If <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, then <a class="link" href="glib-Character-Set-Conversion.html#G-CONVERT-ERROR-PARTIAL-INPUT:CAPS"><code class="literal">G_CONVERT_ERROR_PARTIAL_INPUT</code></a> will be
2936
2979
returned in case <em class="parameter"><code>str</code></em> contains a trailing partial
2937
2980
character. If an error occurs then the index of the
2940
2983
</tr>
2941
2984
<tr>
2942
2985
<td><p><span class="term"><em class="parameter"><code>items_written</code></em> :</span></p></td>
2943
<td> location to store number of characters written or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
2986
<td>location to store number of characters written or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
2944
2987
The value here stored does not include the trailing 0
2945
2988
character.
2946
2989
</td>
2947
2990
</tr>
2948
2991
<tr>
2949
2992
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2950
<td> location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore
2993
<td>location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore
2951
2994
errors. Any of the errors in <a class="link" href="glib-Character-Set-Conversion.html#GConvertError" title="enum GConvertError"><span class="type">GConvertError</span></a> other than
2952
2995
<a class="link" href="glib-Character-Set-Conversion.html#G-CONVERT-ERROR-NO-CONVERSION:CAPS"><code class="literal">G_CONVERT_ERROR_NO_CONVERSION</code></a> may occur.
2953
2996
</td>
2966
3009
<hr>
2967
3010
<div class="refsect2" title="g_utf8_to_ucs4_fast ()">
2968
3011
<a name="g-utf8-to-ucs4-fast"></a><h3>g_utf8_to_ucs4_fast ()</h3>
2969
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> * g_utf8_to_ucs4_fast (const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *str,
2970
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> len,
2971
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_written);</pre>
3012
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> * g_utf8_to_ucs4_fast (<em class="parameter"><code>const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *str</code></em>,
3013
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> len</code></em>,
3014
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_written</code></em>);</pre>
2972
3015
<p>
2973
3016
Convert a string from UTF-8 to a 32-bit fixed width
2974
3017
representation as UCS-4, assuming valid UTF-8 input.
2975
3018
This function is roughly twice as fast as <a class="link" href="glib-Unicode-Manipulation.html#g-utf8-to-ucs4" title="g_utf8_to_ucs4 ()"><code class="function">g_utf8_to_ucs4()</code></a>
2976
but does no error checking on the input.</p>
3019
but does no error checking on the input.
3020
</p>
2977
3021
<div class="variablelist"><table border="0">
2978
3022
<col align="left" valign="top">
2979
3023
<tbody>
2980
3024
<tr>
2981
3025
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
2982
<td> a UTF-8 encoded string
3026
<td>a UTF-8 encoded string
2983
3027
</td>
2984
3028
</tr>
2985
3029
<tr>
2986
3030
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
2987
<td> the maximum length of <em class="parameter"><code>str</code></em> to use, in bytes. If <em class="parameter"><code>len</code></em> < 0,
3031
<td>the maximum length of <em class="parameter"><code>str</code></em> to use, in bytes. If <em class="parameter"><code>len</code></em> < 0,
2988
3032
then the string is nul-terminated.
2989
3033
</td>
2990
3034
</tr>
2991
3035
<tr>
2992
3036
<td><p><span class="term"><em class="parameter"><code>items_written</code></em> :</span></p></td>
2993
<td> location to store the number of characters in the
3037
<td>location to store the number of characters in the
2994
3038
result, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
2995
3039
</td>
2996
3040
</tr>
3006
3050
<hr>
3007
3051
<div class="refsect2" title="g_utf16_to_ucs4 ()">
3008
3052
<a name="g-utf16-to-ucs4"></a><h3>g_utf16_to_ucs4 ()</h3>
3009
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> * g_utf16_to_ucs4 (const <a class="link" href="glib-Unicode-Manipulation.html#gunichar2" title="gunichar2"><span class="returnvalue">gunichar2</span></a> *str,
3010
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> len,
3011
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_read,
3012
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_written,
3013
<a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);</pre>
3053
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> * g_utf16_to_ucs4 (<em class="parameter"><code>const <a class="link" href="glib-Unicode-Manipulation.html#gunichar2" title="gunichar2"><span class="type">gunichar2</span></a> *str</code></em>,
3054
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> len</code></em>,
3055
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_read</code></em>,
3056
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_written</code></em>,
3057
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3014
3058
<p>
3015
3059
Convert a string from UTF-16 to UCS-4. The result will be
3016
nul-terminated.</p>
3060
nul-terminated.
3061
</p>
3017
3062
<div class="variablelist"><table border="0">
3018
3063
<col align="left" valign="top">
3019
3064
<tbody>
3020
3065
<tr>
3021
3066
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
3022
<td> a UTF-16 encoded string
3067
<td>a UTF-16 encoded string
3023
3068
</td>
3024
3069
</tr>
3025
3070
<tr>
3026
3071
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
3027
<td> the maximum length (number of <span class="type">gunichar2</span>) of <em class="parameter"><code>str</code></em> to use.
3072
<td>the maximum length (number of <span class="type">gunichar2</span>) of <em class="parameter"><code>str</code></em> to use.
3028
3073
If <em class="parameter"><code>len</code></em> < 0, then the string is nul-terminated.
3029
3074
</td>
3030
3075
</tr>
3031
3076
<tr>
3032
3077
<td><p><span class="term"><em class="parameter"><code>items_read</code></em> :</span></p></td>
3033
<td> location to store number of words read, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
3078
<td>location to store number of words read, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
3034
3079
If <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, then <a class="link" href="glib-Character-Set-Conversion.html#G-CONVERT-ERROR-PARTIAL-INPUT:CAPS"><code class="literal">G_CONVERT_ERROR_PARTIAL_INPUT</code></a> will be
3035
3080
returned in case <em class="parameter"><code>str</code></em> contains a trailing partial
3036
3081
character. If an error occurs then the index of the
3039
3084
</tr>
3040
3085
<tr>
3041
3086
<td><p><span class="term"><em class="parameter"><code>items_written</code></em> :</span></p></td>
3042
<td> location to store number of characters written, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
3087
<td>location to store number of characters written, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
3043
3088
The value stored here does not include the trailing
3044
3089
0 character.
3045
3090
</td>
3046
3091
</tr>
3047
3092
<tr>
3048
3093
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3049
<td> location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore
3094
<td>location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore
3050
3095
errors. Any of the errors in <a class="link" href="glib-Character-Set-Conversion.html#GConvertError" title="enum GConvertError"><span class="type">GConvertError</span></a> other than
3051
3096
<a class="link" href="glib-Character-Set-Conversion.html#G-CONVERT-ERROR-NO-CONVERSION:CAPS"><code class="literal">G_CONVERT_ERROR_NO_CONVERSION</code></a> may occur.
3052
3097
</td>
3065
3110
<hr>
3066
3111
<div class="refsect2" title="g_utf16_to_utf8 ()">
3067
3112
<a name="g-utf16-to-utf8"></a><h3>g_utf16_to_utf8 ()</h3>
3068
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* g_utf16_to_utf8 (const <a class="link" href="glib-Unicode-Manipulation.html#gunichar2" title="gunichar2"><span class="returnvalue">gunichar2</span></a> *str,
3069
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> len,
3070
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_read,
3071
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_written,
3072
<a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);</pre>
3113
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* g_utf16_to_utf8 (<em class="parameter"><code>const <a class="link" href="glib-Unicode-Manipulation.html#gunichar2" title="gunichar2"><span class="type">gunichar2</span></a> *str</code></em>,
3114
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> len</code></em>,
3115
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_read</code></em>,
3116
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_written</code></em>,
3117
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3073
3118
<p>
3074
3119
Convert a string from UTF-16 to UTF-8. The result will be
3075
3120
terminated with a 0 byte.
3085
3130
string; it may e.g. include embedded NUL characters. The only
3086
3131
validation done by this function is to ensure that the input can
3087
3132
be correctly interpreted as UTF-16, i.e. it doesn't contain
3088
things unpaired surrogates.</p>
3133
things unpaired surrogates.
3134
</p>
3089
3135
<div class="variablelist"><table border="0">
3090
3136
<col align="left" valign="top">
3091
3137
<tbody>
3092
3138
<tr>
3093
3139
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
3094
<td> a UTF-16 encoded string
3140
<td>a UTF-16 encoded string
3095
3141
</td>
3096
3142
</tr>
3097
3143
<tr>
3098
3144
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
3099
<td> the maximum length (number of <span class="type">gunichar2</span>) of <em class="parameter"><code>str</code></em> to use.
3145
<td>the maximum length (number of <span class="type">gunichar2</span>) of <em class="parameter"><code>str</code></em> to use.
3100
3146
If <em class="parameter"><code>len</code></em> < 0, then the string is nul-terminated.
3101
3147
</td>
3102
3148
</tr>
3103
3149
<tr>
3104
3150
<td><p><span class="term"><em class="parameter"><code>items_read</code></em> :</span></p></td>
3105
<td> location to store number of words read, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
3151
<td>location to store number of words read, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
3106
3152
If <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, then <a class="link" href="glib-Character-Set-Conversion.html#G-CONVERT-ERROR-PARTIAL-INPUT:CAPS"><code class="literal">G_CONVERT_ERROR_PARTIAL_INPUT</code></a> will be
3107
3153
returned in case <em class="parameter"><code>str</code></em> contains a trailing partial
3108
3154
character. If an error occurs then the index of the
3111
3157
</tr>
3112
3158
<tr>
3113
3159
<td><p><span class="term"><em class="parameter"><code>items_written</code></em> :</span></p></td>
3114
<td> location to store number of bytes written, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
3160
<td>location to store number of bytes written, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
3115
3161
The value stored here does not include the trailing
3116
3162
0 byte.
3117
3163
</td>
3118
3164
</tr>
3119
3165
<tr>
3120
3166
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3121
<td> location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore
3167
<td>location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore
3122
3168
errors. Any of the errors in <a class="link" href="glib-Character-Set-Conversion.html#GConvertError" title="enum GConvertError"><span class="type">GConvertError</span></a> other than
3123
3169
<a class="link" href="glib-Character-Set-Conversion.html#G-CONVERT-ERROR-NO-CONVERSION:CAPS"><code class="literal">G_CONVERT_ERROR_NO_CONVERSION</code></a> may occur.
3124
3170
</td>
3137
3183
<hr>
3138
3184
<div class="refsect2" title="g_ucs4_to_utf16 ()">
3139
3185
<a name="g-ucs4-to-utf16"></a><h3>g_ucs4_to_utf16 ()</h3>
3140
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#gunichar2" title="gunichar2"><span class="returnvalue">gunichar2</span></a> * g_ucs4_to_utf16 (const <a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> *str,
3141
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> len,
3142
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_read,
3143
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_written,
3144
<a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);</pre>
3186
<pre class="programlisting"><a class="link" href="glib-Unicode-Manipulation.html#gunichar2" title="gunichar2"><span class="returnvalue">gunichar2</span></a> * g_ucs4_to_utf16 (<em class="parameter"><code>const <a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> *str</code></em>,
3187
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> len</code></em>,
3188
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_read</code></em>,
3189
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_written</code></em>,
3190
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3145
3191
<p>
3146
3192
Convert a string from UCS-4 to UTF-16. A 0 character will be
3147
added to the result after the converted text.</p>
3193
added to the result after the converted text.
3194
</p>
3148
3195
<div class="variablelist"><table border="0">
3149
3196
<col align="left" valign="top">
3150
3197
<tbody>
3151
3198
<tr>
3152
3199
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
3153
<td> a UCS-4 encoded string
3200
<td>a UCS-4 encoded string
3154
3201
</td>
3155
3202
</tr>
3156
3203
<tr>
3157
3204
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
3158
<td> the maximum length (number of characters) of <em class="parameter"><code>str</code></em> to use.
3205
<td>the maximum length (number of characters) of <em class="parameter"><code>str</code></em> to use.
3159
3206
If <em class="parameter"><code>len</code></em> < 0, then the string is nul-terminated.
3160
3207
</td>
3161
3208
</tr>
3162
3209
<tr>
3163
3210
<td><p><span class="term"><em class="parameter"><code>items_read</code></em> :</span></p></td>
3164
<td> location to store number of bytes read, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
3211
<td>location to store number of bytes read, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
3165
3212
If an error occurs then the index of the invalid input
3166
3213
is stored here.
3167
3214
</td>
3168
3215
</tr>
3169
3216
<tr>
3170
3217
<td><p><span class="term"><em class="parameter"><code>items_written</code></em> :</span></p></td>
3171
<td> location to store number of <span class="type">gunichar2</span>
3218
<td>location to store number of <span class="type">gunichar2</span>
3172
3219
written, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. The value stored here does not
3173
3220
include the trailing 0.
3174
3221
</td>
3175
3222
</tr>
3176
3223
<tr>
3177
3224
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3178
<td> location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore
3225
<td>location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore
3179
3226
errors. Any of the errors in <a class="link" href="glib-Character-Set-Conversion.html#GConvertError" title="enum GConvertError"><span class="type">GConvertError</span></a> other than
3180
3227
<a class="link" href="glib-Character-Set-Conversion.html#G-CONVERT-ERROR-NO-CONVERSION:CAPS"><code class="literal">G_CONVERT_ERROR_NO_CONVERSION</code></a> may occur.
3181
3228
</td>
3194
3241
<hr>
3195
3242
<div class="refsect2" title="g_ucs4_to_utf8 ()">
3196
3243
<a name="g-ucs4-to-utf8"></a><h3>g_ucs4_to_utf8 ()</h3>
3197
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* g_ucs4_to_utf8 (const <a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> *str,
3198
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> len,
3199
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_read,
3200
<a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="returnvalue">glong</span></a> *items_written,
3201
<a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="returnvalue">GError</span></a> **error);</pre>
3244
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a>* g_ucs4_to_utf8 (<em class="parameter"><code>const <a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> *str</code></em>,
3245
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> len</code></em>,
3246
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_read</code></em>,
3247
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#glong" title="glong"><span class="type">glong</span></a> *items_written</code></em>,
3248
<em class="parameter"><code><a class="link" href="glib-Error-Reporting.html#GError" title="GError"><span class="type">GError</span></a> **error</code></em>);</pre>
3202
3249
<p>
3203
3250
Convert a string from a 32-bit fixed width representation as UCS-4.
3204
to UTF-8. The result will be terminated with a 0 byte.</p>
3251
to UTF-8. The result will be terminated with a 0 byte.
3252
</p>
3205
3253
<div class="variablelist"><table border="0">
3206
3254
<col align="left" valign="top">
3207
3255
<tbody>
3208
3256
<tr>
3209
3257
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
3210
<td> a UCS-4 encoded string
3258
<td>a UCS-4 encoded string
3211
3259
</td>
3212
3260
</tr>
3213
3261
<tr>
3214
3262
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
3215
<td> the maximum length (number of characters) of <em class="parameter"><code>str</code></em> to use.
3263
<td>the maximum length (number of characters) of <em class="parameter"><code>str</code></em> to use.
3216
3264
If <em class="parameter"><code>len</code></em> < 0, then the string is nul-terminated.
3217
3265
</td>
3218
3266
</tr>
3219
3267
<tr>
3220
3268
<td><p><span class="term"><em class="parameter"><code>items_read</code></em> :</span></p></td>
3221
<td> location to store number of characters read, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
3269
<td>location to store number of characters read, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
3222
3270
</td>
3223
3271
</tr>
3224
3272
<tr>
3225
3273
<td><p><span class="term"><em class="parameter"><code>items_written</code></em> :</span></p></td>
3226
<td> location to store number of bytes written or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
3274
<td>location to store number of bytes written or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
3227
3275
The value here stored does not include the trailing 0
3228
3276
byte.
3229
3277
</td>
3230
3278
</tr>
3231
3279
<tr>
3232
3280
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
3233
<td> location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore
3281
<td>location to store the error occuring, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> to ignore
3234
3282
errors. Any of the errors in <a class="link" href="glib-Character-Set-Conversion.html#GConvertError" title="enum GConvertError"><span class="type">GConvertError</span></a> other than
3235
3283
<a class="link" href="glib-Character-Set-Conversion.html#G-CONVERT-ERROR-NO-CONVERSION:CAPS"><code class="literal">G_CONVERT_ERROR_NO_CONVERSION</code></a> may occur.
3236
3284
</td>
3251
3299
<hr>
3252
3300
<div class="refsect2" title="g_unichar_to_utf8 ()">
3253
3301
<a name="g-unichar-to-utf8"></a><h3>g_unichar_to_utf8 ()</h3>
3254
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_unichar_to_utf8 (<a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="returnvalue">gunichar</span></a> c,
3255
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="returnvalue">gchar</span></a> *outbuf);</pre>
3302
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> g_unichar_to_utf8 (<em class="parameter"><code><a class="link" href="glib-Unicode-Manipulation.html#gunichar" title="gunichar"><span class="type">gunichar</span></a> c</code></em>,
3303
<em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gchar" title="gchar"><span class="type">gchar</span></a> *outbuf</code></em>);</pre>
3256
3304
<p>
3257
Converts a single character to UTF-8.</p>
3305
Converts a single character to UTF-8.
3306
</p>
3258
3307
<div class="variablelist"><table border="0">
3259
3308
<col align="left" valign="top">
3260
3309
<tbody>
3261
3310
<tr>
3262
3311
<td><p><span class="term"><em class="parameter"><code>c</code></em> :</span></p></td>
3263
<td> a Unicode character code
3312
<td>a Unicode character code
3264
3313
</td>
3265
3314
</tr>
3266
3315
<tr>
3267
3316
<td><p><span class="term"><em class="parameter"><code>outbuf</code></em> :</span></p></td>
3268
<td> output buffer, must have at least 6 bytes of space.
3317
<td>output buffer, must have at least 6 bytes of space.
3269
3318
If <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, the length will be computed and returned
3270
3319
and nothing will be written to <em class="parameter"><code>outbuf</code></em>.
3271
3320
</td>
3302
3351
</div>
3303
3352
<div class="footer">
3304
3353
<hr>
3305
Generated by GTK-Doc V1.13</div>
3354
Generated by GTK-Doc V1.14</div>
3306
3355
</body>
3307
3356
</html>
b'\\ No newline at end of file'
Loggerhead is a web-based interface for Breezy
Version: 2.0.1