~ubuntu-branches/ubuntu/saucy/pango1.0/saucy-proposed

« back to all changes in this revision

Viewing changes to docs/html/pango-Miscellaneous-Utilities.html

  • Committer: Bazaar Package Importer
  • Author(s): Josselin Mouette
  • Date: 2010-10-19 23:37:45 UTC
  • mfrom: (1.5.12 upstream)
  • Revision ID: james.westby@ubuntu.com-20101019233745-xey8xlf91rpkth51
Tags: 1.28.3-1
* New upstream stable release.
  + Fixes SIGFPE in opentype renderer. Closes: #598166.

Show diffs side-by-side

added added

removed removed

Lines of Context:
8
8
<link rel="up" href="lowlevel.html" title="Low Level Functionality">
9
9
<link rel="prev" href="pango-Modules.html" title="Modules">
10
10
<link rel="next" href="pango-Version-Checking.html" title="Version Checking">
11
 
<meta name="generator" content="GTK-Doc V1.13 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.15.1 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
 
<link rel="chapter" href="pango.html" title="Basic Pango Interfaces">
14
 
<link rel="chapter" href="rendering.html" title="Rendering with Pango">
15
 
<link rel="chapter" href="lowlevel.html" title="Low Level Functionality">
16
 
<link rel="chapter" href="tools.html" title="Pango Tools">
17
 
<link rel="chapter" href="pango-hierarchy.html" title="Object Hierarchy">
18
 
<link rel="index" href="index-all.html" title="Index">
19
 
<link rel="index" href="index-deprecated.html" title="Index of deprecated symbols">
20
 
<link rel="index" href="index-1.2.html" title="Index of new symbols in 1.2">
21
 
<link rel="index" href="index-1.4.html" title="Index of new symbols in 1.4">
22
 
<link rel="index" href="index-1.6.html" title="Index of new symbols in 1.6">
23
 
<link rel="index" href="index-1.8.html" title="Index of new symbols in 1.8">
24
 
<link rel="index" href="index-1.10.html" title="Index of new symbols in 1.10">
25
 
<link rel="index" href="index-1.12.html" title="Index of new symbols in 1.12">
26
 
<link rel="index" href="index-1.14.html" title="Index of new symbols in 1.14">
27
 
<link rel="index" href="index-1.16.html" title="Index of new symbols in 1.16">
28
 
<link rel="index" href="index-1.18.html" title="Index of new symbols in 1.18">
29
 
<link rel="index" href="index-1.20.html" title="Index of new symbols in 1.20">
30
 
<link rel="index" href="index-1.22.html" title="Index of new symbols in 1.22">
31
 
<link rel="index" href="index-1.24.html" title="Index of new symbols in 1.24">
32
 
<link rel="index" href="index-1.26.html" title="Index of new symbols in 1.26">
33
 
<link rel="index" href="index-1.28.html" title="Index of new symbols in 1.26">
34
13
</head>
35
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
36
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
47
26
                  <a href="#pango-Miscellaneous-Utilities.description" class="shortcut">Description</a>
48
27
</td></tr>
49
28
</table>
50
 
<div class="refentry" title="Miscellaneous Utilities">
 
29
<div class="refentry">
51
30
<a name="pango-Miscellaneous-Utilities"></a><div class="titlepage"></div>
52
31
<div class="refnamediv"><table width="100%"><tr>
53
32
<td valign="top">
56
35
</td>
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>);
101
80
</pre>
102
81
</div>
103
 
<div class="refsect1" title="Description">
 
82
<div class="refsect1">
104
83
<a name="pango-Miscellaneous-Utilities.description"></a><h2>Description</h2>
105
84
<p>
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.
108
87
</p>
109
88
</div>
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>
115
94
<p>
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/.
 
97
</p>
118
98
<div class="variablelist"><table border="0">
119
99
<col align="left" valign="top">
120
100
<tbody>
121
101
<tr>
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
124
104
</td>
125
105
</tr>
126
106
<tr>
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>
129
109
</td>
130
110
</tr>
131
111
</tbody>
132
112
</table></div>
133
113
</div>
134
114
<hr>
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>
138
118
<p>
139
 
Trims leading and trailing whitespace from a string.</p>
 
119
Trims leading and trailing whitespace from a string.
 
120
</p>
140
121
<div class="variablelist"><table border="0">
141
122
<col align="left" valign="top">
142
123
<tbody>
143
124
<tr>
144
125
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
145
 
<td> a string
 
126
<td>a string
146
127
</td>
147
128
</tr>
148
129
<tr>
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>
151
132
</td>
152
133
</tr>
153
134
</tbody>
154
135
</table></div>
155
136
</div>
156
137
<hr>
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>
161
142
<p>
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
165
146
a comment and skipped. '\' can be used to escape a # character.
166
147
'\' proceeding a line delimiter combines adjacent lines. A '\' proceeding
167
148
any other character is ignored and written into the output buffer
168
 
unmodified.</p>
 
149
unmodified.
 
150
</p>
169
151
<div class="variablelist"><table border="0">
170
152
<col align="left" valign="top">
171
153
<tbody>
172
154
<tr>
173
155
<td><p><span class="term"><em class="parameter"><code>stream</code></em> :</span></p></td>
174
 
<td> a stdio stream
 
156
<td>a stdio stream
175
157
</td>
176
158
</tr>
177
159
<tr>
178
160
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
179
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Strings.html#GString"><span class="type">GString</span></a> buffer into which to write the result
 
161
<td>
 
162
<span class="type">GString</span> buffer into which to write the result
180
163
</td>
181
164
</tr>
182
165
<tr>
190
173
</table></div>
191
174
</div>
192
175
<hr>
193
 
<div class="refsect2" title="pango_skip_space ()">
 
176
<div class="refsect2">
194
177
<a name="pango-skip-space"></a><h3>pango_skip_space ()</h3>
195
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            pango_skip_space                    (const <span class="returnvalue">char</span> **pos);</pre>
 
178
<pre class="programlisting"><span class="returnvalue">gboolean</span>            pango_skip_space                    (<em class="parameter"><code>const <span class="type">char</span> **pos</code></em>);</pre>
196
179
<p>
197
 
Skips 0 or more characters of white space.</p>
 
180
Skips 0 or more characters of white space.
 
181
</p>
198
182
<div class="variablelist"><table border="0">
199
183
<col align="left" valign="top">
200
184
<tbody>
201
185
<tr>
202
186
<td><p><span class="term"><em class="parameter"><code>pos</code></em> :</span></p></td>
203
 
<td> in/out string position
 
187
<td>in/out string position
204
188
</td>
205
189
</tr>
206
190
<tr>
207
191
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
208
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if skipping the white space leaves
 
192
<td> <code class="literal">FALSE</code> if skipping the white space leaves
209
193
the position at a '\0' character.
210
194
</td>
211
195
</tr>
213
197
</table></div>
214
198
</div>
215
199
<hr>
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>
220
204
<p>
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.
 
208
</p>
224
209
<div class="variablelist"><table border="0">
225
210
<col align="left" valign="top">
226
211
<tbody>
227
212
<tr>
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
230
215
</td>
231
216
</tr>
232
217
<tr>
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
235
220
</td>
236
221
</tr>
237
222
<tr>
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.
240
225
</td>
241
226
</tr>
242
227
</tbody>
243
228
</table></div>
244
229
</div>
245
230
<hr>
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>
250
235
<p>
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.
 
240
</p>
255
241
<div class="variablelist"><table border="0">
256
242
<col align="left" valign="top">
257
243
<tbody>
258
244
<tr>
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
261
247
</td>
262
248
</tr>
263
249
<tr>
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
266
252
</td>
267
253
</tr>
268
254
<tr>
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.
271
257
</td>
272
258
</tr>
273
259
</tbody>
274
260
</table></div>
275
261
</div>
276
262
<hr>
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>
281
267
<p>
282
268
Scans an integer.
283
 
Leading white space is skipped.</p>
 
269
Leading white space is skipped.
 
270
</p>
284
271
<div class="variablelist"><table border="0">
285
272
<col align="left" valign="top">
286
273
<tbody>
287
274
<tr>
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
290
277
</td>
291
278
</tr>
292
279
<tr>
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
295
282
</td>
296
283
</tr>
297
284
<tr>
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.
300
287
</td>
301
288
</tr>
302
289
</tbody>
303
290
</table></div>
304
291
</div>
305
292
<hr>
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>
309
296
<p>
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).)
 
300
</p>
313
301
<div class="variablelist"><table border="0">
314
302
<col align="left" valign="top">
315
303
<tbody>
316
304
<tr>
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".
319
307
</td>
320
308
</tr>
321
309
<tr>
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>.
325
313
</td>
326
314
</tr>
327
315
</tbody>
328
316
</table></div>
329
317
</div>
330
318
<hr>
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>
336
324
<p>
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>.
 
328
</p>
340
329
<div class="variablelist"><table border="0">
341
330
<col align="left" valign="top">
342
331
<tbody>
343
332
<tr>
344
333
<td><p><span class="term"><em class="parameter"><code>fontname</code></em> :</span></p></td>
345
 
<td> an ascii string
 
334
<td>an ascii string
346
335
</td>
347
336
</tr>
348
337
<tr>
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.
352
341
</td>
353
342
</tr>
354
343
<tr>
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.
357
346
</td>
358
347
</tr>
359
348
</tbody>
360
349
</table></div>
361
350
</div>
362
351
<hr>
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>
370
359
<p>
371
360
Parses an enum type and stores the result in <em class="parameter"><code>value</code></em>.
372
361
</p>
373
362
<p>
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>.
 
370
</p>
381
371
<div class="variablelist"><table border="0">
382
372
<col align="left" valign="top">
383
373
<tbody>
384
374
<tr>
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>.
387
377
</td>
388
378
</tr>
389
379
<tr>
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>.
392
382
</td>
393
383
</tr>
394
384
<tr>
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>.
397
387
</td>
398
388
</tr>
399
389
<tr>
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.
402
392
</td>
403
393
</tr>
404
394
<tr>
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>.
407
397
</td>
408
398
</tr>
409
399
<tr>
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.
412
402
 
413
403
</td>
414
404
</tr>
417
407
<p class="since">Since 1.16</p>
418
408
</div>
419
409
<hr>
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>
425
415
<p>
426
416
Parses a font style. The allowed values are "normal",
427
417
"italic" and "oblique", case variations being
428
 
ignored.</p>
 
418
ignored.
 
419
</p>
429
420
<div class="variablelist"><table border="0">
430
421
<col align="left" valign="top">
431
422
<tbody>
432
423
<tr>
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.
435
426
</td>
436
427
</tr>
437
428
<tr>
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.
440
431
</td>
441
432
</tr>
442
433
<tr>
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.
445
436
</td>
446
437
</tr>
447
438
<tr>
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.
450
441
</td>
451
442
</tr>
452
443
</tbody>
453
444
</table></div>
454
445
</div>
455
446
<hr>
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>
461
452
<p>
462
453
Parses a font variant. The allowed values are "normal"
463
454
and "smallcaps" or "small_caps", case variations being
464
 
ignored.</p>
 
455
ignored.
 
456
</p>
465
457
<div class="variablelist"><table border="0">
466
458
<col align="left" valign="top">
467
459
<tbody>
468
460
<tr>
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.
471
463
</td>
472
464
</tr>
473
465
<tr>
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.
476
468
</td>
477
469
</tr>
478
470
<tr>
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.
481
473
</td>
482
474
</tr>
483
475
<tr>
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.
486
478
</td>
487
479
</tr>
488
480
</tbody>
489
481
</table></div>
490
482
</div>
491
483
<hr>
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>
497
489
<p>
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.
 
493
</p>
501
494
<div class="variablelist"><table border="0">
502
495
<col align="left" valign="top">
503
496
<tbody>
504
497
<tr>
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.
507
500
</td>
508
501
</tr>
509
502
<tr>
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.
512
505
</td>
513
506
</tr>
514
507
<tr>
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.
517
510
</td>
518
511
</tr>
519
512
<tr>
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.
522
515
</td>
523
516
</tr>
524
517
</tbody>
525
518
</table></div>
526
519
</div>
527
520
<hr>
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>
533
526
<p>
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.
 
532
</p>
539
533
<div class="variablelist"><table border="0">
540
534
<col align="left" valign="top">
541
535
<tbody>
542
536
<tr>
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.
545
539
</td>
546
540
</tr>
547
541
<tr>
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.
550
544
</td>
551
545
</tr>
552
546
<tr>
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.
555
549
</td>
556
550
</tr>
557
551
<tr>
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.
560
554
</td>
561
555
</tr>
562
556
</tbody>
563
557
</table></div>
564
558
</div>
565
559
<hr>
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>
569
563
<p>
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).
 
568
</p>
574
569
<div class="variablelist"><table border="0">
575
570
<col align="left" valign="top">
576
571
<tbody><tr>
582
577
</table></div>
583
578
</div>
584
579
<hr>
585
 
<div class="refsect2" title="pango_get_lib_subdirectory ()">
 
580
<div class="refsect2">
586
581
<a name="pango-get-lib-subdirectory"></a><h3>pango_get_lib_subdirectory ()</h3>
587
 
<pre class="programlisting">const <span class="returnvalue">char</span> *        pango_get_lib_subdirectory          (void);</pre>
 
582
<pre class="programlisting">const <span class="returnvalue">char</span> *        pango_get_lib_subdirectory          (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
588
583
<p>
589
584
On Unix, returns the name of the "pango" subdirectory of LIBDIR
590
585
(which is set at compile time). On Windows, returns the lib\pango
591
586
subdirectory of the Pango installation directory (which is deduced
592
 
at run time from the DLL's location).</p>
 
587
at run time from the DLL's location).
 
588
</p>
593
589
<div class="variablelist"><table border="0">
594
590
<col align="left" valign="top">
595
591
<tbody><tr>
601
597
</table></div>
602
598
</div>
603
599
<hr>
604
 
<div class="refsect2" title="pango_log2vis_get_embedding_levels ()">
 
600
<div class="refsect2">
605
601
<a name="pango-log2vis-get-embedding-levels"></a><h3>pango_log2vis_get_embedding_levels ()</h3>
606
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint8"><span class="returnvalue">guint8</span></a> *            pango_log2vis_get_embedding_levels  (const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *text,
607
 
                                                         <span class="returnvalue">int</span> length,
608
 
                                                         <a class="link" href="pango-Bidirectional-Text.html#PangoDirection" title="enum PangoDirection"><span class="returnvalue">PangoDirection</span></a> *pbase_dir);</pre>
 
602
<pre class="programlisting"><span class="returnvalue">guint8</span> *            pango_log2vis_get_embedding_levels  (<em class="parameter"><code>const <span class="type">gchar</span> *text</code></em>,
 
603
                                                         <em class="parameter"><code><span class="type">int</span> length</code></em>,
 
604
                                                         <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>);</pre>
609
605
<p>
610
606
This will return the bidirectional embedding levels of the input paragraph
611
607
as defined by the Unicode Bidirectional Algorithm available at:
615
611
</p>
616
612
<p>
617
613
If the input base direction is a weak direction, the direction of the
618
 
characters in the text will determine the final resolved direction.</p>
 
614
characters in the text will determine the final resolved direction.
 
615
</p>
619
616
<div class="variablelist"><table border="0">
620
617
<col align="left" valign="top">
621
618
<tbody>
622
619
<tr>
623
620
<td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
624
 
<td>      the text to itemize.
 
621
<td>the text to itemize.
625
622
</td>
626
623
</tr>
627
624
<tr>
628
625
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
629
 
<td>    the number of bytes (not characters) to process, or -1
 
626
<td>the number of bytes (not characters) to process, or -1
630
627
            if <em class="parameter"><code>text</code></em> is nul-terminated and the length should be calculated.
631
628
</td>
632
629
</tr>
633
630
<tr>
634
631
<td><p><span class="term"><em class="parameter"><code>pbase_dir</code></em> :</span></p></td>
635
 
<td> input base direction, and output resolved direction.
 
632
<td>input base direction, and output resolved direction.
636
633
</td>
637
634
</tr>
638
635
<tr>
647
644
<p class="since">Since 1.4</p>
648
645
</div>
649
646
<hr>
650
 
<div class="refsect2" title="pango_is_zero_width ()">
 
647
<div class="refsect2">
651
648
<a name="pango-is-zero-width"></a><h3>pango_is_zero_width ()</h3>
652
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            pango_is_zero_width                 (<a href="/usr/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html#gunichar"><span class="returnvalue">gunichar</span></a> ch);</pre>
 
649
<pre class="programlisting"><span class="returnvalue">gboolean</span>            pango_is_zero_width                 (<em class="parameter"><code><span class="type">gunichar</span> ch</code></em>);</pre>
653
650
<p>
654
651
Checks <em class="parameter"><code>ch</code></em> to see if it is a character that should not be
655
652
normally rendered on the screen.  This includes all Unicode characters
656
653
with "ZERO WIDTH" in their name, as well as <em class="firstterm">bidi</em> formatting characters, and
657
 
a few other ones.  This is totally different from <a href="/usr/share/gtk-doc/html/glib/glib-Unicode-Manipulation.html#g-unichar-iszerowidth"><code class="function">g_unichar_iszerowidth()</code></a>
658
 
and is at best misnamed.</p>
 
654
a few other ones.  This is totally different from <code class="function">g_unichar_iszerowidth()</code>
 
655
and is at best misnamed.
 
656
</p>
659
657
<div class="variablelist"><table border="0">
660
658
<col align="left" valign="top">
661
659
<tbody>
662
660
<tr>
663
661
<td><p><span class="term"><em class="parameter"><code>ch</code></em> :</span></p></td>
664
 
<td> a Unicode character
 
662
<td>a Unicode character
665
663
</td>
666
664
</tr>
667
665
<tr>
668
666
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
669
 
<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>ch</code></em> is a zero-width character, <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise
 
667
<td> <code class="literal">TRUE</code> if <em class="parameter"><code>ch</code></em> is a zero-width character, <code class="literal">FALSE</code> otherwise
670
668
 
671
669
</td>
672
670
</tr>
675
673
<p class="since">Since 1.10</p>
676
674
</div>
677
675
<hr>
678
 
<div class="refsect2" title="pango_quantize_line_geometry ()">
 
676
<div class="refsect2">
679
677
<a name="pango-quantize-line-geometry"></a><h3>pango_quantize_line_geometry ()</h3>
680
 
<pre class="programlisting"><span class="returnvalue">void</span>                pango_quantize_line_geometry        (<span class="returnvalue">int</span> *thickness,
681
 
                                                         <span class="returnvalue">int</span> *position);</pre>
 
678
<pre class="programlisting"><span class="returnvalue">void</span>                pango_quantize_line_geometry        (<em class="parameter"><code><span class="type">int</span> *thickness</code></em>,
 
679
                                                         <em class="parameter"><code><span class="type">int</span> *position</code></em>);</pre>
682
680
<p>
683
681
Quantizes the thickness and position of a line, typically an
684
682
underline or strikethrough, to whole device pixels, that is integer
688
686
<p>
689
687
Care is taken to make sure <em class="parameter"><code>thickness</code></em> is at least one pixel when this
690
688
function returns, but returned <em class="parameter"><code>position</code></em> may become zero as a result
691
 
of rounding.</p>
 
689
of rounding.
 
690
</p>
692
691
<div class="variablelist"><table border="0">
693
692
<col align="left" valign="top">
694
693
<tbody>
695
694
<tr>
696
695
<td><p><span class="term"><em class="parameter"><code>thickness</code></em> :</span></p></td>
697
 
<td> pointer to the thickness of a line, in Pango units
 
696
<td>pointer to the thickness of a line, in Pango units
698
697
</td>
699
698
</tr>
700
699
<tr>
701
700
<td><p><span class="term"><em class="parameter"><code>position</code></em> :</span></p></td>
702
 
<td> corresponding position
 
701
<td>corresponding position
703
702
</td>
704
703
</tr>
705
704
</tbody>
710
709
</div>
711
710
<div class="footer">
712
711
<hr>
713
 
          Generated by GTK-Doc V1.13</div>
 
712
          Generated by GTK-Doc V1.15.1</div>
714
713
</body>
715
714
</html>
 
 
b'\\ No newline at end of file'