57
36
<td valign="top" align="right"></td>
58
37
</tr></table></div>
59
<div class="refsynopsisdiv" title="Synopsis">
38
<div class="refsynopsisdiv">
60
39
<a name="pango-Miscellaneous-Utilities.synopsis"></a><h2>Synopsis</h2>
61
<pre class="synopsis"><span class="returnvalue">char</span> ** <a class="link" href="pango-Miscellaneous-Utilities.html#pango-split-file-list" title="pango_split_file_list ()">pango_split_file_list</a> (const <span class="returnvalue">char</span> *str);
62
<span class="returnvalue">char</span> * <a class="link" href="pango-Miscellaneous-Utilities.html#pango-trim-string" title="pango_trim_string ()">pango_trim_string</a> (const <span class="returnvalue">char</span> *str);
63
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-read-line" title="pango_read_line ()">pango_read_line</a> (<span class="returnvalue">FILE</span> *stream,
64
<a href="/usr/share/gtk-doc/html/glib/glib-Strings.html#GString"><span class="returnvalue">GString</span></a> *str);
65
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-skip-space" title="pango_skip_space ()">pango_skip_space</a> (const <span class="returnvalue">char</span> **pos);
66
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-scan-word" title="pango_scan_word ()">pango_scan_word</a> (const <span class="returnvalue">char</span> **pos,
67
<a href="/usr/share/gtk-doc/html/glib/glib-Strings.html#GString"><span class="returnvalue">GString</span></a> *out);
68
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-scan-string" title="pango_scan_string ()">pango_scan_string</a> (const <span class="returnvalue">char</span> **pos,
69
<a href="/usr/share/gtk-doc/html/glib/glib-Strings.html#GString"><span class="returnvalue">GString</span></a> *out);
70
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-scan-int" title="pango_scan_int ()">pango_scan_int</a> (const <span class="returnvalue">char</span> **pos,
71
<span class="returnvalue">int</span> *out);
72
<span class="returnvalue">char</span> * <a class="link" href="pango-Miscellaneous-Utilities.html#pango-config-key-get" title="pango_config_key_get ()">pango_config_key_get</a> (const <span class="returnvalue">char</span> *key);
73
<span class="returnvalue">void</span> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-lookup-aliases" title="pango_lookup_aliases ()">pango_lookup_aliases</a> (const <span class="returnvalue">char</span> *fontname,
74
<span class="returnvalue">char</span> ***families,
75
<span class="returnvalue">int</span> *n_families);
76
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-parse-enum" title="pango_parse_enum ()">pango_parse_enum</a> (<a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> type,
77
const <span class="returnvalue">char</span> *str,
78
<span class="returnvalue">int</span> *value,
79
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> warn,
80
<span class="returnvalue">char</span> **possible_values);
81
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-parse-style" title="pango_parse_style ()">pango_parse_style</a> (const <span class="returnvalue">char</span> *str,
82
<a class="link" href="pango-Fonts.html#PangoStyle" title="enum PangoStyle"><span class="returnvalue">PangoStyle</span></a> *style,
83
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> warn);
84
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-parse-variant" title="pango_parse_variant ()">pango_parse_variant</a> (const <span class="returnvalue">char</span> *str,
85
<a class="link" href="pango-Fonts.html#PangoVariant" title="enum PangoVariant"><span class="returnvalue">PangoVariant</span></a> *variant,
86
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> warn);
87
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-parse-weight" title="pango_parse_weight ()">pango_parse_weight</a> (const <span class="returnvalue">char</span> *str,
88
<a class="link" href="pango-Fonts.html#PangoWeight" title="enum PangoWeight"><span class="returnvalue">PangoWeight</span></a> *weight,
89
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> warn);
90
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-parse-stretch" title="pango_parse_stretch ()">pango_parse_stretch</a> (const <span class="returnvalue">char</span> *str,
91
<a class="link" href="pango-Fonts.html#PangoStretch" title="enum PangoStretch"><span class="returnvalue">PangoStretch</span></a> *stretch,
92
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> warn);
93
const <span class="returnvalue">char</span> * <a class="link" href="pango-Miscellaneous-Utilities.html#pango-get-sysconf-subdirectory" title="pango_get_sysconf_subdirectory ()">pango_get_sysconf_subdirectory</a> (void);
94
const <span class="returnvalue">char</span> * <a class="link" href="pango-Miscellaneous-Utilities.html#pango-get-lib-subdirectory" title="pango_get_lib_subdirectory ()">pango_get_lib_subdirectory</a> (void);
95
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint8"><span class="returnvalue">guint8</span></a> * <a class="link" href="pango-Miscellaneous-Utilities.html#pango-log2vis-get-embedding-levels" title="pango_log2vis_get_embedding_levels ()">pango_log2vis_get_embedding_levels</a> (const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *text,
96
<span class="returnvalue">int</span> length,
97
<a class="link" href="pango-Bidirectional-Text.html#PangoDirection" title="enum PangoDirection"><span class="returnvalue">PangoDirection</span></a> *pbase_dir);
98
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-is-zero-width" title="pango_is_zero_width ()">pango_is_zero_width</a> (<a href="/usr/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html#gunichar"><span class="returnvalue">gunichar</span></a> ch);
99
<span class="returnvalue">void</span> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-quantize-line-geometry" title="pango_quantize_line_geometry ()">pango_quantize_line_geometry</a> (<span class="returnvalue">int</span> *thickness,
100
<span class="returnvalue">int</span> *position);
40
<pre class="synopsis"><span class="returnvalue">char</span> ** <a class="link" href="pango-Miscellaneous-Utilities.html#pango-split-file-list" title="pango_split_file_list ()">pango_split_file_list</a> (<em class="parameter"><code>const <span class="type">char</span> *str</code></em>);
41
<span class="returnvalue">char</span> * <a class="link" href="pango-Miscellaneous-Utilities.html#pango-trim-string" title="pango_trim_string ()">pango_trim_string</a> (<em class="parameter"><code>const <span class="type">char</span> *str</code></em>);
42
<span class="returnvalue">gint</span> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-read-line" title="pango_read_line ()">pango_read_line</a> (<em class="parameter"><code><span class="type">FILE</span> *stream</code></em>,
43
<em class="parameter"><code><span class="type">GString</span> *str</code></em>);
44
<span class="returnvalue">gboolean</span> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-skip-space" title="pango_skip_space ()">pango_skip_space</a> (<em class="parameter"><code>const <span class="type">char</span> **pos</code></em>);
45
<span class="returnvalue">gboolean</span> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-scan-word" title="pango_scan_word ()">pango_scan_word</a> (<em class="parameter"><code>const <span class="type">char</span> **pos</code></em>,
46
<em class="parameter"><code><span class="type">GString</span> *out</code></em>);
47
<span class="returnvalue">gboolean</span> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-scan-string" title="pango_scan_string ()">pango_scan_string</a> (<em class="parameter"><code>const <span class="type">char</span> **pos</code></em>,
48
<em class="parameter"><code><span class="type">GString</span> *out</code></em>);
49
<span class="returnvalue">gboolean</span> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-scan-int" title="pango_scan_int ()">pango_scan_int</a> (<em class="parameter"><code>const <span class="type">char</span> **pos</code></em>,
50
<em class="parameter"><code><span class="type">int</span> *out</code></em>);
51
<span class="returnvalue">char</span> * <a class="link" href="pango-Miscellaneous-Utilities.html#pango-config-key-get" title="pango_config_key_get ()">pango_config_key_get</a> (<em class="parameter"><code>const <span class="type">char</span> *key</code></em>);
52
<span class="returnvalue">void</span> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-lookup-aliases" title="pango_lookup_aliases ()">pango_lookup_aliases</a> (<em class="parameter"><code>const <span class="type">char</span> *fontname</code></em>,
53
<em class="parameter"><code><span class="type">char</span> ***families</code></em>,
54
<em class="parameter"><code><span class="type">int</span> *n_families</code></em>);
55
<span class="returnvalue">gboolean</span> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-parse-enum" title="pango_parse_enum ()">pango_parse_enum</a> (<em class="parameter"><code><span class="type">GType</span> type</code></em>,
56
<em class="parameter"><code>const <span class="type">char</span> *str</code></em>,
57
<em class="parameter"><code><span class="type">int</span> *value</code></em>,
58
<em class="parameter"><code><span class="type">gboolean</span> warn</code></em>,
59
<em class="parameter"><code><span class="type">char</span> **possible_values</code></em>);
60
<span class="returnvalue">gboolean</span> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-parse-style" title="pango_parse_style ()">pango_parse_style</a> (<em class="parameter"><code>const <span class="type">char</span> *str</code></em>,
61
<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoStyle" title="enum PangoStyle"><span class="type">PangoStyle</span></a> *style</code></em>,
62
<em class="parameter"><code><span class="type">gboolean</span> warn</code></em>);
63
<span class="returnvalue">gboolean</span> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-parse-variant" title="pango_parse_variant ()">pango_parse_variant</a> (<em class="parameter"><code>const <span class="type">char</span> *str</code></em>,
64
<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoVariant" title="enum PangoVariant"><span class="type">PangoVariant</span></a> *variant</code></em>,
65
<em class="parameter"><code><span class="type">gboolean</span> warn</code></em>);
66
<span class="returnvalue">gboolean</span> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-parse-weight" title="pango_parse_weight ()">pango_parse_weight</a> (<em class="parameter"><code>const <span class="type">char</span> *str</code></em>,
67
<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoWeight" title="enum PangoWeight"><span class="type">PangoWeight</span></a> *weight</code></em>,
68
<em class="parameter"><code><span class="type">gboolean</span> warn</code></em>);
69
<span class="returnvalue">gboolean</span> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-parse-stretch" title="pango_parse_stretch ()">pango_parse_stretch</a> (<em class="parameter"><code>const <span class="type">char</span> *str</code></em>,
70
<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoStretch" title="enum PangoStretch"><span class="type">PangoStretch</span></a> *stretch</code></em>,
71
<em class="parameter"><code><span class="type">gboolean</span> warn</code></em>);
72
const <span class="returnvalue">char</span> * <a class="link" href="pango-Miscellaneous-Utilities.html#pango-get-sysconf-subdirectory" title="pango_get_sysconf_subdirectory ()">pango_get_sysconf_subdirectory</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
73
const <span class="returnvalue">char</span> * <a class="link" href="pango-Miscellaneous-Utilities.html#pango-get-lib-subdirectory" title="pango_get_lib_subdirectory ()">pango_get_lib_subdirectory</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
74
<span class="returnvalue">guint8</span> * <a class="link" href="pango-Miscellaneous-Utilities.html#pango-log2vis-get-embedding-levels" title="pango_log2vis_get_embedding_levels ()">pango_log2vis_get_embedding_levels</a> (<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
75
<em class="parameter"><code><span class="type">int</span> length</code></em>,
76
<em class="parameter"><code><a class="link" href="pango-Bidirectional-Text.html#PangoDirection" title="enum PangoDirection"><span class="type">PangoDirection</span></a> *pbase_dir</code></em>);
77
<span class="returnvalue">gboolean</span> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-is-zero-width" title="pango_is_zero_width ()">pango_is_zero_width</a> (<em class="parameter"><code><span class="type">gunichar</span> ch</code></em>);
78
<span class="returnvalue">void</span> <a class="link" href="pango-Miscellaneous-Utilities.html#pango-quantize-line-geometry" title="pango_quantize_line_geometry ()">pango_quantize_line_geometry</a> (<em class="parameter"><code><span class="type">int</span> *thickness</code></em>,
79
<em class="parameter"><code><span class="type">int</span> *position</code></em>);
103
<div class="refsect1" title="Description">
82
<div class="refsect1">
104
83
<a name="pango-Miscellaneous-Utilities.description"></a><h2>Description</h2>
106
85
The functions and utilities in this section are mostly used from Pango
107
86
backends and modules, but may be useful for other purposes too.
110
<div class="refsect1" title="Details">
89
<div class="refsect1">
111
90
<a name="pango-Miscellaneous-Utilities.details"></a><h2>Details</h2>
112
<div class="refsect2" title="pango_split_file_list ()">
91
<div class="refsect2">
113
92
<a name="pango-split-file-list"></a><h3>pango_split_file_list ()</h3>
114
<pre class="programlisting"><span class="returnvalue">char</span> ** pango_split_file_list (const <span class="returnvalue">char</span> *str);</pre>
93
<pre class="programlisting"><span class="returnvalue">char</span> ** pango_split_file_list (<em class="parameter"><code>const <span class="type">char</span> *str</code></em>);</pre>
116
Splits a <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#G-SEARCHPATH-SEPARATOR:CAPS"><code class="literal">G_SEARCHPATH_SEPARATOR</code></a>-separated list of files, stripping
117
white space and substituting ~/ with $HOME/.</p>
95
Splits a <code class="literal">G_SEARCHPATH_SEPARATOR</code>-separated list of files, stripping
96
white space and substituting ~/ with $HOME/.
118
98
<div class="variablelist"><table border="0">
119
99
<col align="left" valign="top">
122
102
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
123
<td> a <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#G-SEARCHPATH-SEPARATOR:CAPS"><code class="literal">G_SEARCHPATH_SEPARATOR</code></a> separated list of filenames
103
<td>a <code class="literal">G_SEARCHPATH_SEPARATOR</code> separated list of filenames
127
107
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
128
<td> a list of strings to be freed with <a href="/usr/share/gtk-doc/html/glib/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a>
108
<td> a list of strings to be freed with <code class="function">g_strfreev()</code>
135
<div class="refsect2" title="pango_trim_string ()">
115
<div class="refsect2">
136
116
<a name="pango-trim-string"></a><h3>pango_trim_string ()</h3>
137
<pre class="programlisting"><span class="returnvalue">char</span> * pango_trim_string (const <span class="returnvalue">char</span> *str);</pre>
117
<pre class="programlisting"><span class="returnvalue">char</span> * pango_trim_string (<em class="parameter"><code>const <span class="type">char</span> *str</code></em>);</pre>
139
Trims leading and trailing whitespace from a string.</p>
119
Trims leading and trailing whitespace from a string.
140
121
<div class="variablelist"><table border="0">
141
122
<col align="left" valign="top">
144
125
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
149
130
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
150
<td> A newly-allocated string that must be freed with <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>
131
<td> A newly-allocated string that must be freed with <code class="function">g_free()</code>
157
<div class="refsect2" title="pango_read_line ()">
138
<div class="refsect2">
158
139
<a name="pango-read-line"></a><h3>pango_read_line ()</h3>
159
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a> pango_read_line (<span class="returnvalue">FILE</span> *stream,
160
<a href="/usr/share/gtk-doc/html/glib/glib-Strings.html#GString"><span class="returnvalue">GString</span></a> *str);</pre>
140
<pre class="programlisting"><span class="returnvalue">gint</span> pango_read_line (<em class="parameter"><code><span class="type">FILE</span> *stream</code></em>,
141
<em class="parameter"><code><span class="type">GString</span> *str</code></em>);</pre>
162
143
Reads an entire line from a file into a buffer. Lines may
163
144
be delimited with '\n', '\r', '\n\r', or '\r\n'. The delimiter
216
<div class="refsect2" title="pango_scan_word ()">
200
<div class="refsect2">
217
201
<a name="pango-scan-word"></a><h3>pango_scan_word ()</h3>
218
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_scan_word (const <span class="returnvalue">char</span> **pos,
219
<a href="/usr/share/gtk-doc/html/glib/glib-Strings.html#GString"><span class="returnvalue">GString</span></a> *out);</pre>
202
<pre class="programlisting"><span class="returnvalue">gboolean</span> pango_scan_word (<em class="parameter"><code>const <span class="type">char</span> **pos</code></em>,
203
<em class="parameter"><code><span class="type">GString</span> *out</code></em>);</pre>
221
Scans a word into a <a href="/usr/share/gtk-doc/html/glib/glib-Strings.html#GString"><span class="type">GString</span></a> buffer. A word consists
205
Scans a word into a <span class="type">GString</span> buffer. A word consists
222
206
of [A-Za-z_] followed by zero or more [A-Za-z_0-9]
223
Leading white space is skipped.</p>
207
Leading white space is skipped.
224
209
<div class="variablelist"><table border="0">
225
210
<col align="left" valign="top">
228
213
<td><p><span class="term"><em class="parameter"><code>pos</code></em> :</span></p></td>
229
<td> in/out string position
214
<td>in/out string position
233
218
<td><p><span class="term"><em class="parameter"><code>out</code></em> :</span></p></td>
234
<td> a <a href="/usr/share/gtk-doc/html/glib/glib-Strings.html#GString"><span class="type">GString</span></a> into which to write the result
219
<td>a <span class="type">GString</span> into which to write the result
238
223
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
239
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if a parse error occurred.
224
<td> <code class="literal">FALSE</code> if a parse error occurred.
246
<div class="refsect2" title="pango_scan_string ()">
231
<div class="refsect2">
247
232
<a name="pango-scan-string"></a><h3>pango_scan_string ()</h3>
248
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_scan_string (const <span class="returnvalue">char</span> **pos,
249
<a href="/usr/share/gtk-doc/html/glib/glib-Strings.html#GString"><span class="returnvalue">GString</span></a> *out);</pre>
233
<pre class="programlisting"><span class="returnvalue">gboolean</span> pango_scan_string (<em class="parameter"><code>const <span class="type">char</span> **pos</code></em>,
234
<em class="parameter"><code><span class="type">GString</span> *out</code></em>);</pre>
251
Scans a string into a <a href="/usr/share/gtk-doc/html/glib/glib-Strings.html#GString"><span class="type">GString</span></a> buffer. The string may either
236
Scans a string into a <span class="type">GString</span> buffer. The string may either
252
237
be a sequence of non-white-space characters, or a quoted
253
238
string with '"'. Instead a quoted string, '\"' represents
254
a literal quote. Leading white space outside of quotes is skipped.</p>
239
a literal quote. Leading white space outside of quotes is skipped.
255
241
<div class="variablelist"><table border="0">
256
242
<col align="left" valign="top">
259
245
<td><p><span class="term"><em class="parameter"><code>pos</code></em> :</span></p></td>
260
<td> in/out string position
246
<td>in/out string position
264
250
<td><p><span class="term"><em class="parameter"><code>out</code></em> :</span></p></td>
265
<td> a <a href="/usr/share/gtk-doc/html/glib/glib-Strings.html#GString"><span class="type">GString</span></a> into which to write the result
251
<td>a <span class="type">GString</span> into which to write the result
269
255
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
270
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if a parse error occurred.
256
<td> <code class="literal">FALSE</code> if a parse error occurred.
277
<div class="refsect2" title="pango_scan_int ()">
263
<div class="refsect2">
278
264
<a name="pango-scan-int"></a><h3>pango_scan_int ()</h3>
279
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_scan_int (const <span class="returnvalue">char</span> **pos,
280
<span class="returnvalue">int</span> *out);</pre>
265
<pre class="programlisting"><span class="returnvalue">gboolean</span> pango_scan_int (<em class="parameter"><code>const <span class="type">char</span> **pos</code></em>,
266
<em class="parameter"><code><span class="type">int</span> *out</code></em>);</pre>
282
268
Scans an integer.
283
Leading white space is skipped.</p>
269
Leading white space is skipped.
284
271
<div class="variablelist"><table border="0">
285
272
<col align="left" valign="top">
288
275
<td><p><span class="term"><em class="parameter"><code>pos</code></em> :</span></p></td>
289
<td> in/out string position
276
<td>in/out string position
293
280
<td><p><span class="term"><em class="parameter"><code>out</code></em> :</span></p></td>
294
<td> an int into which to write the result
281
<td>an int into which to write the result
298
285
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
299
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if a parse error occurred.
286
<td> <code class="literal">FALSE</code> if a parse error occurred.
306
<div class="refsect2" title="pango_config_key_get ()">
293
<div class="refsect2">
307
294
<a name="pango-config-key-get"></a><h3>pango_config_key_get ()</h3>
308
<pre class="programlisting"><span class="returnvalue">char</span> * pango_config_key_get (const <span class="returnvalue">char</span> *key);</pre>
295
<pre class="programlisting"><span class="returnvalue">char</span> * pango_config_key_get (<em class="parameter"><code>const <span class="type">char</span> *key</code></em>);</pre>
310
297
Looks up a key in the Pango config database
311
298
(pseudo-win.ini style, read from $sysconfdir/pango/pangorc,
312
~/.pangorc, and getenv (PANGO_RC_FILE).)</p>
299
~/.pangorc, and getenv (PANGO_RC_FILE).)
313
301
<div class="variablelist"><table border="0">
314
302
<col align="left" valign="top">
317
305
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
318
<td> Key to look up, in the form "SECTION/KEY".
306
<td>Key to look up, in the form "SECTION/KEY".
322
310
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
323
<td> the value, if found, otherwise <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. The value is a
324
newly-allocated string and must be freed with <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.
311
<td> the value, if found, otherwise <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. The value is a
312
newly-allocated string and must be freed with <code class="function">g_free()</code>.
331
<div class="refsect2" title="pango_lookup_aliases ()">
319
<div class="refsect2">
332
320
<a name="pango-lookup-aliases"></a><h3>pango_lookup_aliases ()</h3>
333
<pre class="programlisting"><span class="returnvalue">void</span> pango_lookup_aliases (const <span class="returnvalue">char</span> *fontname,
334
<span class="returnvalue">char</span> ***families,
335
<span class="returnvalue">int</span> *n_families);</pre>
321
<pre class="programlisting"><span class="returnvalue">void</span> pango_lookup_aliases (<em class="parameter"><code>const <span class="type">char</span> *fontname</code></em>,
322
<em class="parameter"><code><span class="type">char</span> ***families</code></em>,
323
<em class="parameter"><code><span class="type">int</span> *n_families</code></em>);</pre>
337
325
Look up all user defined aliases for the alias <em class="parameter"><code>fontname</code></em>.
338
326
The resulting font family names will be stored in <em class="parameter"><code>families</code></em>,
339
and the number of families in <em class="parameter"><code>n_families</code></em>.</p>
327
and the number of families in <em class="parameter"><code>n_families</code></em>.
340
329
<div class="variablelist"><table border="0">
341
330
<col align="left" valign="top">
344
333
<td><p><span class="term"><em class="parameter"><code>fontname</code></em> :</span></p></td>
349
338
<td><p><span class="term"><em class="parameter"><code>families</code></em> :</span></p></td>
350
<td> will be set to an array of font family names.
339
<td>will be set to an array of font family names.
351
340
this array is owned by pango and should not be freed.
355
344
<td><p><span class="term"><em class="parameter"><code>n_families</code></em> :</span></p></td>
356
<td> will be set to the length of the <em class="parameter"><code>families</code></em> array.
345
<td>will be set to the length of the <em class="parameter"><code>families</code></em> array.
363
<div class="refsect2" title="pango_parse_enum ()">
352
<div class="refsect2">
364
353
<a name="pango-parse-enum"></a><h3>pango_parse_enum ()</h3>
365
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_parse_enum (<a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a> type,
366
const <span class="returnvalue">char</span> *str,
367
<span class="returnvalue">int</span> *value,
368
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> warn,
369
<span class="returnvalue">char</span> **possible_values);</pre>
354
<pre class="programlisting"><span class="returnvalue">gboolean</span> pango_parse_enum (<em class="parameter"><code><span class="type">GType</span> type</code></em>,
355
<em class="parameter"><code>const <span class="type">char</span> *str</code></em>,
356
<em class="parameter"><code><span class="type">int</span> *value</code></em>,
357
<em class="parameter"><code><span class="type">gboolean</span> warn</code></em>,
358
<em class="parameter"><code><span class="type">char</span> **possible_values</code></em>);</pre>
371
360
Parses an enum type and stores the result in <em class="parameter"><code>value</code></em>.
374
363
If <em class="parameter"><code>str</code></em> does not match the nick name of any of the possible values for the
375
enum and is not an integer, <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> is returned, a warning is issued
376
if <em class="parameter"><code>warn</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, and a
364
enum and is not an integer, <code class="literal">FALSE</code> is returned, a warning is issued
365
if <em class="parameter"><code>warn</code></em> is <code class="literal">TRUE</code>, and a
377
366
string representing the list of possible values is stored in
378
367
<em class="parameter"><code>possible_values</code></em>. The list is slash-separated, eg.
379
"none/start/middle/end". If failed and <em class="parameter"><code>possible_values</code></em> is not <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>,
380
returned string should be freed using <a href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</p>
368
"none/start/middle/end". If failed and <em class="parameter"><code>possible_values</code></em> is not <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>,
369
returned string should be freed using <code class="function">g_free()</code>.
381
371
<div class="variablelist"><table border="0">
382
372
<col align="left" valign="top">
385
375
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
386
<td> enum type to parse, eg. <a class="link" href="pango-Layout-Objects.html#PANGO-TYPE-ELLIPSIZE-MODE:CAPS" title="PANGO_TYPE_ELLIPSIZE_MODE"><code class="literal">PANGO_TYPE_ELLIPSIZE_MODE</code></a>.
376
<td>enum type to parse, eg. <a class="link" href="pango-Layout-Objects.html#PANGO-TYPE-ELLIPSIZE-MODE:CAPS" title="PANGO_TYPE_ELLIPSIZE_MODE"><code class="literal">PANGO_TYPE_ELLIPSIZE_MODE</code></a>.
390
380
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
391
<td> string to parse. May be <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
381
<td>string to parse. May be <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>.
395
385
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
396
<td> integer to store the result in, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
386
<td>integer to store the result in, or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>.
400
390
<td><p><span class="term"><em class="parameter"><code>warn</code></em> :</span></p></td>
401
<td> if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, issue a <a href="/usr/share/gtk-doc/html/glib/glib-Message-Logging.html#g-warning"><code class="function">g_warning()</code></a> on bad input.
391
<td>if <code class="literal">TRUE</code>, issue a <code class="function">g_warning()</code> on bad input.
405
395
<td><p><span class="term"><em class="parameter"><code>possible_values</code></em> :</span></p></td>
406
<td> place to store list of possible values on failure, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
396
<td>place to store list of possible values on failure, or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>.
410
400
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
411
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>str</code></em> was successfully parsed.
401
<td> <code class="literal">TRUE</code> if <em class="parameter"><code>str</code></em> was successfully parsed.
417
407
<p class="since">Since 1.16</p>
420
<div class="refsect2" title="pango_parse_style ()">
410
<div class="refsect2">
421
411
<a name="pango-parse-style"></a><h3>pango_parse_style ()</h3>
422
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_parse_style (const <span class="returnvalue">char</span> *str,
423
<a class="link" href="pango-Fonts.html#PangoStyle" title="enum PangoStyle"><span class="returnvalue">PangoStyle</span></a> *style,
424
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> warn);</pre>
412
<pre class="programlisting"><span class="returnvalue">gboolean</span> pango_parse_style (<em class="parameter"><code>const <span class="type">char</span> *str</code></em>,
413
<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoStyle" title="enum PangoStyle"><span class="type">PangoStyle</span></a> *style</code></em>,
414
<em class="parameter"><code><span class="type">gboolean</span> warn</code></em>);</pre>
426
416
Parses a font style. The allowed values are "normal",
427
417
"italic" and "oblique", case variations being
429
420
<div class="variablelist"><table border="0">
430
421
<col align="left" valign="top">
433
424
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
434
<td> a string to parse.
425
<td>a string to parse.
438
429
<td><p><span class="term"><em class="parameter"><code>style</code></em> :</span></p></td>
439
<td> a <a class="link" href="pango-Fonts.html#PangoStyle" title="enum PangoStyle"><span class="type">PangoStyle</span></a> to store the result in.
430
<td>a <a class="link" href="pango-Fonts.html#PangoStyle" title="enum PangoStyle"><span class="type">PangoStyle</span></a> to store the result in.
443
434
<td><p><span class="term"><em class="parameter"><code>warn</code></em> :</span></p></td>
444
<td> if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, issue a <a href="/usr/share/gtk-doc/html/glib/glib-Message-Logging.html#g-warning"><code class="function">g_warning()</code></a> on bad input.
435
<td>if <code class="literal">TRUE</code>, issue a <code class="function">g_warning()</code> on bad input.
448
439
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
449
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>str</code></em> was successfully parsed.
440
<td> <code class="literal">TRUE</code> if <em class="parameter"><code>str</code></em> was successfully parsed.
456
<div class="refsect2" title="pango_parse_variant ()">
447
<div class="refsect2">
457
448
<a name="pango-parse-variant"></a><h3>pango_parse_variant ()</h3>
458
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_parse_variant (const <span class="returnvalue">char</span> *str,
459
<a class="link" href="pango-Fonts.html#PangoVariant" title="enum PangoVariant"><span class="returnvalue">PangoVariant</span></a> *variant,
460
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> warn);</pre>
449
<pre class="programlisting"><span class="returnvalue">gboolean</span> pango_parse_variant (<em class="parameter"><code>const <span class="type">char</span> *str</code></em>,
450
<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoVariant" title="enum PangoVariant"><span class="type">PangoVariant</span></a> *variant</code></em>,
451
<em class="parameter"><code><span class="type">gboolean</span> warn</code></em>);</pre>
462
453
Parses a font variant. The allowed values are "normal"
463
454
and "smallcaps" or "small_caps", case variations being
465
457
<div class="variablelist"><table border="0">
466
458
<col align="left" valign="top">
469
461
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
470
<td> a string to parse.
462
<td>a string to parse.
474
466
<td><p><span class="term"><em class="parameter"><code>variant</code></em> :</span></p></td>
475
<td> a <a class="link" href="pango-Fonts.html#PangoVariant" title="enum PangoVariant"><span class="type">PangoVariant</span></a> to store the result in.
467
<td>a <a class="link" href="pango-Fonts.html#PangoVariant" title="enum PangoVariant"><span class="type">PangoVariant</span></a> to store the result in.
479
471
<td><p><span class="term"><em class="parameter"><code>warn</code></em> :</span></p></td>
480
<td> if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, issue a <a href="/usr/share/gtk-doc/html/glib/glib-Message-Logging.html#g-warning"><code class="function">g_warning()</code></a> on bad input.
472
<td>if <code class="literal">TRUE</code>, issue a <code class="function">g_warning()</code> on bad input.
484
476
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
485
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>str</code></em> was successfully parsed.
477
<td> <code class="literal">TRUE</code> if <em class="parameter"><code>str</code></em> was successfully parsed.
492
<div class="refsect2" title="pango_parse_weight ()">
484
<div class="refsect2">
493
485
<a name="pango-parse-weight"></a><h3>pango_parse_weight ()</h3>
494
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_parse_weight (const <span class="returnvalue">char</span> *str,
495
<a class="link" href="pango-Fonts.html#PangoWeight" title="enum PangoWeight"><span class="returnvalue">PangoWeight</span></a> *weight,
496
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> warn);</pre>
486
<pre class="programlisting"><span class="returnvalue">gboolean</span> pango_parse_weight (<em class="parameter"><code>const <span class="type">char</span> *str</code></em>,
487
<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoWeight" title="enum PangoWeight"><span class="type">PangoWeight</span></a> *weight</code></em>,
488
<em class="parameter"><code><span class="type">gboolean</span> warn</code></em>);</pre>
498
490
Parses a font weight. The allowed values are "heavy",
499
491
"ultrabold", "bold", "normal", "light", "ultraleight"
500
and integers. Case variations are ignored.</p>
492
and integers. Case variations are ignored.
501
494
<div class="variablelist"><table border="0">
502
495
<col align="left" valign="top">
505
498
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
506
<td> a string to parse.
499
<td>a string to parse.
510
503
<td><p><span class="term"><em class="parameter"><code>weight</code></em> :</span></p></td>
511
<td> a <a class="link" href="pango-Fonts.html#PangoWeight" title="enum PangoWeight"><span class="type">PangoWeight</span></a> to store the result in.
504
<td>a <a class="link" href="pango-Fonts.html#PangoWeight" title="enum PangoWeight"><span class="type">PangoWeight</span></a> to store the result in.
515
508
<td><p><span class="term"><em class="parameter"><code>warn</code></em> :</span></p></td>
516
<td> if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, issue a <a href="/usr/share/gtk-doc/html/glib/glib-Message-Logging.html#g-warning"><code class="function">g_warning()</code></a> on bad input.
509
<td>if <code class="literal">TRUE</code>, issue a <code class="function">g_warning()</code> on bad input.
520
513
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
521
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>str</code></em> was successfully parsed.
514
<td> <code class="literal">TRUE</code> if <em class="parameter"><code>str</code></em> was successfully parsed.
528
<div class="refsect2" title="pango_parse_stretch ()">
521
<div class="refsect2">
529
522
<a name="pango-parse-stretch"></a><h3>pango_parse_stretch ()</h3>
530
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> pango_parse_stretch (const <span class="returnvalue">char</span> *str,
531
<a class="link" href="pango-Fonts.html#PangoStretch" title="enum PangoStretch"><span class="returnvalue">PangoStretch</span></a> *stretch,
532
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> warn);</pre>
523
<pre class="programlisting"><span class="returnvalue">gboolean</span> pango_parse_stretch (<em class="parameter"><code>const <span class="type">char</span> *str</code></em>,
524
<em class="parameter"><code><a class="link" href="pango-Fonts.html#PangoStretch" title="enum PangoStretch"><span class="type">PangoStretch</span></a> *stretch</code></em>,
525
<em class="parameter"><code><span class="type">gboolean</span> warn</code></em>);</pre>
534
527
Parses a font stretch. The allowed values are
535
528
"ultra_condensed", "extra_condensed", "condensed",
536
529
"semi_condensed", "normal", "semi_expanded", "expanded",
537
530
"extra_expanded" and "ultra_expanded". Case variations are
538
ignored and the '_' characters may be omitted.</p>
531
ignored and the '_' characters may be omitted.
539
533
<div class="variablelist"><table border="0">
540
534
<col align="left" valign="top">
543
537
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
544
<td> a string to parse.
538
<td>a string to parse.
548
542
<td><p><span class="term"><em class="parameter"><code>stretch</code></em> :</span></p></td>
549
<td> a <a class="link" href="pango-Fonts.html#PangoStretch" title="enum PangoStretch"><span class="type">PangoStretch</span></a> to store the result in.
543
<td>a <a class="link" href="pango-Fonts.html#PangoStretch" title="enum PangoStretch"><span class="type">PangoStretch</span></a> to store the result in.
553
547
<td><p><span class="term"><em class="parameter"><code>warn</code></em> :</span></p></td>
554
<td> if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, issue a <a href="/usr/share/gtk-doc/html/glib/glib-Message-Logging.html#g-warning"><code class="function">g_warning()</code></a> on bad input.
548
<td>if <code class="literal">TRUE</code>, issue a <code class="function">g_warning()</code> on bad input.
558
552
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
559
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>str</code></em> was successfully parsed.
553
<td> <code class="literal">TRUE</code> if <em class="parameter"><code>str</code></em> was successfully parsed.
566
<div class="refsect2" title="pango_get_sysconf_subdirectory ()">
560
<div class="refsect2">
567
561
<a name="pango-get-sysconf-subdirectory"></a><h3>pango_get_sysconf_subdirectory ()</h3>
568
<pre class="programlisting">const <span class="returnvalue">char</span> * pango_get_sysconf_subdirectory (void);</pre>
562
<pre class="programlisting">const <span class="returnvalue">char</span> * pango_get_sysconf_subdirectory (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
570
564
On Unix, returns the name of the "pango" subdirectory of SYSCONFDIR
571
565
(which is set at compile time). On Windows, returns the etc\pango
572
566
subdirectory of the Pango installation directory (which is deduced
573
at run time from the DLL's location).</p>
567
at run time from the DLL's location).
574
569
<div class="variablelist"><table border="0">
575
570
<col align="left" valign="top">