docs/html/pango-Scripts-and-Languages.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>Scripts and Languages</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.74.3">
   7 <link rel="home" href="index.html" title="Pango Reference Manual">
   8 <link rel="up" href="pango.html" title="Basic Pango Interfaces">
   9 <link rel="prev" href="pango-Layout-Objects.html" title="Layout Objects">
  10 <link rel="next" href="pango-Bidirectional-Text.html" title="Bidirectional Text">
  11 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
  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 </head>
  34 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  35 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  36 <tr valign="middle">
  37 <td><a accesskey="p" href="pango-Layout-Objects.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  38 <td><a accesskey="u" href="pango.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  39 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  40 <th width="100%" align="center">Pango Reference Manual</th>
  41 <td><a accesskey="n" href="pango-Bidirectional-Text.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  42 </tr>
  43 <tr><td colspan="5" class="shortcuts">
  44 <a href="#pango-Scripts-and-Languages.synopsis" class="shortcut">Top</a>
  45                  |
  46                 <a href="#pango-Scripts-and-Languages.description" class="shortcut">Description</a>
  47 </td></tr>
  48 </table>
  49 <div class="refentry" lang="en">
  50 <a name="pango-Scripts-and-Languages"></a><div class="titlepage"></div>
  51 <div class="refnamediv"><table width="100%"><tr>
  52 <td valign="top">
  53 <h2><span class="refentrytitle"><a name="pango-Scripts-and-Languages.top_of_page"></a>Scripts and Languages</span></h2>
  54 <p>Scripts and Languages — Identifying writing systems and languages</p>
  55 </td>
  56 <td valign="top" align="right"></td>
  57 </tr></table></div>
  58 <div class="refsynopsisdiv">
  59 <a name="pango-Scripts-and-Languages.synopsis"></a><h2>Synopsis</h2>
  60 <pre class="synopsis">
  61 enum                <a class="link" href="pango-Scripts-and-Languages.html#PangoScript" title="enum PangoScript">PangoScript</a>;
  62 #define             <a class="link" href="pango-Scripts-and-Languages.html#PANGO-TYPE-SCRIPT--CAPS" title="PANGO_TYPE_SCRIPT">PANGO_TYPE_SCRIPT</a>
  63                     <a class="link" href="pango-Scripts-and-Languages.html#PangoScriptIter" title="PangoScriptIter">PangoScriptIter</a>;
  64 <a class="link" href="pango-Scripts-and-Languages.html#PangoScript" title="enum PangoScript">PangoScript</a>         <a class="link" href="pango-Scripts-and-Languages.html#pango-script-for-unichar" title="pango_script_for_unichar ()">pango_script_for_unichar</a>            (<a
  65 href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"
  66 >gunichar</a> ch);
  67 <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *     <a class="link" href="pango-Scripts-and-Languages.html#pango-script-get-sample-language" title="pango_script_get_sample_language ()">pango_script_get_sample_language</a>    (<a class="link" href="pango-Scripts-and-Languages.html#PangoScript" title="enum PangoScript">PangoScript</a> script);
  68 <a class="link" href="pango-Scripts-and-Languages.html#PangoScriptIter" title="PangoScriptIter">PangoScriptIter</a> *   <a class="link" href="pango-Scripts-and-Languages.html#pango-script-iter-new" title="pango_script_iter_new ()">pango_script_iter_new</a>               (const char *text,
  69                                                          int length);
  70 void                <a class="link" href="pango-Scripts-and-Languages.html#pango-script-iter-get-range" title="pango_script_iter_get_range ()">pango_script_iter_get_range</a>         (<a class="link" href="pango-Scripts-and-Languages.html#PangoScriptIter" title="PangoScriptIter">PangoScriptIter</a> *iter,
  71                                                          G_CONST_RETURN char **start,
  72                                                          G_CONST_RETURN char **end,
  73                                                          <a class="link" href="pango-Scripts-and-Languages.html#PangoScript" title="enum PangoScript">PangoScript</a> *script);
  74 <a
  75 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
  76 >gboolean</a>            <a class="link" href="pango-Scripts-and-Languages.html#pango-script-iter-next" title="pango_script_iter_next ()">pango_script_iter_next</a>              (<a class="link" href="pango-Scripts-and-Languages.html#PangoScriptIter" title="PangoScriptIter">PangoScriptIter</a> *iter);
  77 void                <a class="link" href="pango-Scripts-and-Languages.html#pango-script-iter-free" title="pango_script_iter_free ()">pango_script_iter_free</a>              (<a class="link" href="pango-Scripts-and-Languages.html#PangoScriptIter" title="PangoScriptIter">PangoScriptIter</a> *iter);
  78                     <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a>;
  79 #define             <a class="link" href="pango-Scripts-and-Languages.html#PANGO-TYPE-LANGUAGE--CAPS" title="PANGO_TYPE_LANGUAGE">PANGO_TYPE_LANGUAGE</a>
  80 <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *     <a class="link" href="pango-Scripts-and-Languages.html#pango-language-from-string" title="pango_language_from_string ()">pango_language_from_string</a>          (const char *language);
  81 const char *        <a class="link" href="pango-Scripts-and-Languages.html#pango-language-to-string" title="pango_language_to_string ()">pango_language_to_string</a>            (<a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *language);
  82 <a
  83 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
  84 >gboolean</a>            <a class="link" href="pango-Scripts-and-Languages.html#pango-language-matches" title="pango_language_matches ()">pango_language_matches</a>              (<a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *language,
  85                                                          const char *range_list);
  86 <a
  87 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
  88 >gboolean</a>            <a class="link" href="pango-Scripts-and-Languages.html#pango-language-includes-script" title="pango_language_includes_script ()">pango_language_includes_script</a>      (<a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *language,
  89                                                          <a class="link" href="pango-Scripts-and-Languages.html#PangoScript" title="enum PangoScript">PangoScript</a> script);
  90 const <a class="link" href="pango-Scripts-and-Languages.html#PangoScript" title="enum PangoScript">PangoScript</a> * <a class="link" href="pango-Scripts-and-Languages.html#pango-language-get-scripts" title="pango_language_get_scripts ()">pango_language_get_scripts</a>          (<a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *language,
  91                                                          int *num_scripts);
  92 <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *     <a class="link" href="pango-Scripts-and-Languages.html#pango-language-get-default" title="pango_language_get_default ()">pango_language_get_default</a>          (void);
  93 const char *        <a class="link" href="pango-Scripts-and-Languages.html#pango-language-get-sample-string" title="pango_language_get_sample_string ()">pango_language_get_sample_string</a>    (<a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *language);
  94 </pre>
  95 </div>
  96 <div class="refsect1" lang="en">
  97 <a name="pango-Scripts-and-Languages.description"></a><h2>Description</h2>
  98 <p>
  99 The functions in this section are used to identify the writing
 100 system, or <em class="firstterm">script</em> of individual characters
 101 and of ranges within a larger text string.
 102 </p>
 103 </div>
 104 <div class="refsect1" lang="en">
 105 <a name="pango-Scripts-and-Languages.details"></a><h2>Details</h2>
 106 <div class="refsect2" lang="en">
 107 <a name="PangoScript"></a><h3>enum PangoScript</h3>
 108 <pre class="programlisting">typedef enum {                         /* ISO 15924 code */
 109       PANGO_SCRIPT_INVALID_CODE = -1,
 110       PANGO_SCRIPT_COMMON       = 0,   /* Zyyy */
 111       PANGO_SCRIPT_INHERITED,          /* Qaai */
 112       PANGO_SCRIPT_ARABIC,             /* Arab */
 113       PANGO_SCRIPT_ARMENIAN,           /* Armn */
 114       PANGO_SCRIPT_BENGALI,            /* Beng */
 115       PANGO_SCRIPT_BOPOMOFO,           /* Bopo */
 116       PANGO_SCRIPT_CHEROKEE,           /* Cher */
 117       PANGO_SCRIPT_COPTIC,             /* Qaac */
 118       PANGO_SCRIPT_CYRILLIC,           /* Cyrl (Cyrs) */
 119       PANGO_SCRIPT_DESERET,            /* Dsrt */
 120       PANGO_SCRIPT_DEVANAGARI,         /* Deva */
 121       PANGO_SCRIPT_ETHIOPIC,           /* Ethi */
 122       PANGO_SCRIPT_GEORGIAN,           /* Geor (Geon, Geoa) */
 123       PANGO_SCRIPT_GOTHIC,             /* Goth */
 124       PANGO_SCRIPT_GREEK,              /* Grek */
 125       PANGO_SCRIPT_GUJARATI,           /* Gujr */
 126       PANGO_SCRIPT_GURMUKHI,           /* Guru */
 127       PANGO_SCRIPT_HAN,                /* Hani */
 128       PANGO_SCRIPT_HANGUL,             /* Hang */
 129       PANGO_SCRIPT_HEBREW,             /* Hebr */
 130       PANGO_SCRIPT_HIRAGANA,           /* Hira */
 131       PANGO_SCRIPT_KANNADA,            /* Knda */
 132       PANGO_SCRIPT_KATAKANA,           /* Kana */
 133       PANGO_SCRIPT_KHMER,              /* Khmr */
 134       PANGO_SCRIPT_LAO,                /* Laoo */
 135       PANGO_SCRIPT_LATIN,              /* Latn (Latf, Latg) */
 136       PANGO_SCRIPT_MALAYALAM,          /* Mlym */
 137       PANGO_SCRIPT_MONGOLIAN,          /* Mong */
 138       PANGO_SCRIPT_MYANMAR,            /* Mymr */
 139       PANGO_SCRIPT_OGHAM,              /* Ogam */
 140       PANGO_SCRIPT_OLD_ITALIC,         /* Ital */
 141       PANGO_SCRIPT_ORIYA,              /* Orya */
 142       PANGO_SCRIPT_RUNIC,              /* Runr */
 143       PANGO_SCRIPT_SINHALA,            /* Sinh */
 144       PANGO_SCRIPT_SYRIAC,             /* Syrc (Syrj, Syrn, Syre) */
 145       PANGO_SCRIPT_TAMIL,              /* Taml */
 146       PANGO_SCRIPT_TELUGU,             /* Telu */
 147       PANGO_SCRIPT_THAANA,             /* Thaa */
 148       PANGO_SCRIPT_THAI,               /* Thai */
 149       PANGO_SCRIPT_TIBETAN,            /* Tibt */
 150       PANGO_SCRIPT_CANADIAN_ABORIGINAL, /* Cans */
 151       PANGO_SCRIPT_YI,                 /* Yiii */
 152       PANGO_SCRIPT_TAGALOG,            /* Tglg */
 153       PANGO_SCRIPT_HANUNOO,            /* Hano */
 154       PANGO_SCRIPT_BUHID,              /* Buhd */
 155       PANGO_SCRIPT_TAGBANWA,           /* Tagb */
 156
 157       /* Unicode-4.0 additions */
 158       PANGO_SCRIPT_BRAILLE,            /* Brai */
 159       PANGO_SCRIPT_CYPRIOT,            /* Cprt */
 160       PANGO_SCRIPT_LIMBU,              /* Limb */
 161       PANGO_SCRIPT_OSMANYA,            /* Osma */
 162       PANGO_SCRIPT_SHAVIAN,            /* Shaw */
 163       PANGO_SCRIPT_LINEAR_B,           /* Linb */
 164       PANGO_SCRIPT_TAI_LE,             /* Tale */
 165       PANGO_SCRIPT_UGARITIC,           /* Ugar */
 166
 167       /* Unicode-4.1 additions */
 168       PANGO_SCRIPT_NEW_TAI_LUE,        /* Talu */
 169       PANGO_SCRIPT_BUGINESE,           /* Bugi */
 170       PANGO_SCRIPT_GLAGOLITIC,         /* Glag */
 171       PANGO_SCRIPT_TIFINAGH,           /* Tfng */
 172       PANGO_SCRIPT_SYLOTI_NAGRI,       /* Sylo */
 173       PANGO_SCRIPT_OLD_PERSIAN,        /* Xpeo */
 174       PANGO_SCRIPT_KHAROSHTHI,         /* Khar */
 175
 176       /* Unicode-5.0 additions */
 177       PANGO_SCRIPT_UNKNOWN,            /* Zzzz */
 178       PANGO_SCRIPT_BALINESE,           /* Bali */
 179       PANGO_SCRIPT_CUNEIFORM,          /* Xsux */
 180       PANGO_SCRIPT_PHOENICIAN,         /* Phnx */
 181       PANGO_SCRIPT_PHAGS_PA,           /* Phag */
 182       PANGO_SCRIPT_NKO,                /* Nkoo */
 183
 184       /* Unicode-5.1 additions */
 185       PANGO_SCRIPT_KAYAH_LI,           /* Kali */
 186       PANGO_SCRIPT_LEPCHA,             /* Lepc */
 187       PANGO_SCRIPT_REJANG,             /* Rjng */
 188       PANGO_SCRIPT_SUNDANESE,          /* Sund */
 189       PANGO_SCRIPT_SAURASHTRA,         /* Saur */
 190       PANGO_SCRIPT_CHAM,               /* Cham */
 191       PANGO_SCRIPT_OL_CHIKI,           /* Olck */
 192       PANGO_SCRIPT_VAI,                /* Vaii */
 193       PANGO_SCRIPT_CARIAN,             /* Cari */
 194       PANGO_SCRIPT_LYCIAN,             /* Lyci */
 195       PANGO_SCRIPT_LYDIAN              /* Lydi */
 196 } PangoScript;
 197 </pre>
 198 <p>
 199 The <a class="link" href="pango-Scripts-and-Languages.html#PangoScript" title="enum PangoScript"><span class="type">PangoScript</span></a> enumeration identifies different writing
 200 systems. The values correspond to the names as defined in the
 201 Unicode standard.
 202 Note that new types may be added in the future. Applications should be ready
 203 to handle unknown values.  This enumeration is interchangeable with
 204 <a
 205 href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#GUnicodeScript"
 206 ><span class="type">GUnicodeScript</span></a>.  See <a class="ulink" href="http://www.unicode.org/reports/tr24/" target="_top">Unicode Standard Annex
 207 #24: Script names</a>.
 208 </p>
 209 <div class="variablelist"><table border="0">
 210 <col align="left" valign="top">
 211 <tbody>
 212 <tr>
 213 <td><p><a name="PANGO-SCRIPT-INVALID-CODE--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_INVALID_CODE</code></span></p></td>
 214 <td>a value never returned from <a class="link" href="pango-Scripts-and-Languages.html#pango-script-for-unichar" title="pango_script_for_unichar ()"><code class="function">pango_script_for_unichar()</code></a>
 215 </td>
 216 </tr>
 217 <tr>
 218 <td><p><a name="PANGO-SCRIPT-COMMON--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_COMMON</code></span></p></td>
 219 <td>a character used by multiple different scripts
 220 </td>
 221 </tr>
 222 <tr>
 223 <td><p><a name="PANGO-SCRIPT-INHERITED--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_INHERITED</code></span></p></td>
 224 <td>a mark glyph that takes its script from the
 225   base glyph to which it is attached
 226 </td>
 227 </tr>
 228 <tr>
 229 <td><p><a name="PANGO-SCRIPT-ARABIC--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_ARABIC</code></span></p></td>
 230 <td>    Arabic
 231 </td>
 232 </tr>
 233 <tr>
 234 <td><p><a name="PANGO-SCRIPT-ARMENIAN--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_ARMENIAN</code></span></p></td>
 235 <td>Armenian
 236 </td>
 237 </tr>
 238 <tr>
 239 <td><p><a name="PANGO-SCRIPT-BENGALI--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_BENGALI</code></span></p></td>
 240 <td>    Bengali
 241 </td>
 242 </tr>
 243 <tr>
 244 <td><p><a name="PANGO-SCRIPT-BOPOMOFO--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_BOPOMOFO</code></span></p></td>
 245 <td>Bopomofo
 246 </td>
 247 </tr>
 248 <tr>
 249 <td><p><a name="PANGO-SCRIPT-CHEROKEE--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_CHEROKEE</code></span></p></td>
 250 <td>    Cherokee
 251 </td>
 252 </tr>
 253 <tr>
 254 <td><p><a name="PANGO-SCRIPT-COPTIC--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_COPTIC</code></span></p></td>
 255 <td>    Coptic
 256 </td>
 257 </tr>
 258 <tr>
 259 <td><p><a name="PANGO-SCRIPT-CYRILLIC--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_CYRILLIC</code></span></p></td>
 260 <td>    Cyrillic
 261 </td>
 262 </tr>
 263 <tr>
 264 <td><p><a name="PANGO-SCRIPT-DESERET--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_DESERET</code></span></p></td>
 265 <td>    Deseret
 266 </td>
 267 </tr>
 268 <tr>
 269 <td><p><a name="PANGO-SCRIPT-DEVANAGARI--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_DEVANAGARI</code></span></p></td>
 270 <td>    Devanagari
 271 </td>
 272 </tr>
 273 <tr>
 274 <td><p><a name="PANGO-SCRIPT-ETHIOPIC--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_ETHIOPIC</code></span></p></td>
 275 <td>    Ethiopic
 276 </td>
 277 </tr>
 278 <tr>
 279 <td><p><a name="PANGO-SCRIPT-GEORGIAN--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_GEORGIAN</code></span></p></td>
 280 <td>    Georgian
 281 </td>
 282 </tr>
 283 <tr>
 284 <td><p><a name="PANGO-SCRIPT-GOTHIC--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_GOTHIC</code></span></p></td>
 285 <td>    Gothic
 286 </td>
 287 </tr>
 288 <tr>
 289 <td><p><a name="PANGO-SCRIPT-GREEK--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_GREEK</code></span></p></td>
 290 <td>    Greek
 291 </td>
 292 </tr>
 293 <tr>
 294 <td><p><a name="PANGO-SCRIPT-GUJARATI--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_GUJARATI</code></span></p></td>
 295 <td>    Gujarati
 296 </td>
 297 </tr>
 298 <tr>
 299 <td><p><a name="PANGO-SCRIPT-GURMUKHI--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_GURMUKHI</code></span></p></td>
 300 <td>    Gurmukhi
 301 </td>
 302 </tr>
 303 <tr>
 304 <td><p><a name="PANGO-SCRIPT-HAN--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_HAN</code></span></p></td>
 305 <td>    Han
 306 </td>
 307 </tr>
 308 <tr>
 309 <td><p><a name="PANGO-SCRIPT-HANGUL--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_HANGUL</code></span></p></td>
 310 <td>    Hangul
 311 </td>
 312 </tr>
 313 <tr>
 314 <td><p><a name="PANGO-SCRIPT-HEBREW--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_HEBREW</code></span></p></td>
 315 <td>    Hebrew
 316 </td>
 317 </tr>
 318 <tr>
 319 <td><p><a name="PANGO-SCRIPT-HIRAGANA--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_HIRAGANA</code></span></p></td>
 320 <td>    Hiragana
 321 </td>
 322 </tr>
 323 <tr>
 324 <td><p><a name="PANGO-SCRIPT-KANNADA--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_KANNADA</code></span></p></td>
 325 <td>    Kannada
 326 </td>
 327 </tr>
 328 <tr>
 329 <td><p><a name="PANGO-SCRIPT-KATAKANA--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_KATAKANA</code></span></p></td>
 330 <td>    Katakana
 331 </td>
 332 </tr>
 333 <tr>
 334 <td><p><a name="PANGO-SCRIPT-KHMER--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_KHMER</code></span></p></td>
 335 <td>    Khmer
 336 </td>
 337 </tr>
 338 <tr>
 339 <td><p><a name="PANGO-SCRIPT-LAO--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_LAO</code></span></p></td>
 340 <td>    Lao
 341 </td>
 342 </tr>
 343 <tr>
 344 <td><p><a name="PANGO-SCRIPT-LATIN--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_LATIN</code></span></p></td>
 345 <td>    Latin
 346 </td>
 347 </tr>
 348 <tr>
 349 <td><p><a name="PANGO-SCRIPT-MALAYALAM--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_MALAYALAM</code></span></p></td>
 350 <td>    Malayalam
 351 </td>
 352 </tr>
 353 <tr>
 354 <td><p><a name="PANGO-SCRIPT-MONGOLIAN--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_MONGOLIAN</code></span></p></td>
 355 <td>    Mongolian
 356 </td>
 357 </tr>
 358 <tr>
 359 <td><p><a name="PANGO-SCRIPT-MYANMAR--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_MYANMAR</code></span></p></td>
 360 <td>    Myanmar
 361 </td>
 362 </tr>
 363 <tr>
 364 <td><p><a name="PANGO-SCRIPT-OGHAM--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_OGHAM</code></span></p></td>
 365 <td>    Ogham
 366 </td>
 367 </tr>
 368 <tr>
 369 <td><p><a name="PANGO-SCRIPT-OLD-ITALIC--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_OLD_ITALIC</code></span></p></td>
 370 <td>    Old Italic
 371 </td>
 372 </tr>
 373 <tr>
 374 <td><p><a name="PANGO-SCRIPT-ORIYA--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_ORIYA</code></span></p></td>
 375 <td>    Oriya
 376 </td>
 377 </tr>
 378 <tr>
 379 <td><p><a name="PANGO-SCRIPT-RUNIC--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_RUNIC</code></span></p></td>
 380 <td>    Runic
 381 </td>
 382 </tr>
 383 <tr>
 384 <td><p><a name="PANGO-SCRIPT-SINHALA--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_SINHALA</code></span></p></td>
 385 <td>    Sinhala
 386 </td>
 387 </tr>
 388 <tr>
 389 <td><p><a name="PANGO-SCRIPT-SYRIAC--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_SYRIAC</code></span></p></td>
 390 <td>    Syriac
 391 </td>
 392 </tr>
 393 <tr>
 394 <td><p><a name="PANGO-SCRIPT-TAMIL--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_TAMIL</code></span></p></td>
 395 <td>    Tamil
 396 </td>
 397 </tr>
 398 <tr>
 399 <td><p><a name="PANGO-SCRIPT-TELUGU--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_TELUGU</code></span></p></td>
 400 <td>    Telugu
 401 </td>
 402 </tr>
 403 <tr>
 404 <td><p><a name="PANGO-SCRIPT-THAANA--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_THAANA</code></span></p></td>
 405 <td>    Thaana
 406 </td>
 407 </tr>
 408 <tr>
 409 <td><p><a name="PANGO-SCRIPT-THAI--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_THAI</code></span></p></td>
 410 <td>    Thai
 411 </td>
 412 </tr>
 413 <tr>
 414 <td><p><a name="PANGO-SCRIPT-TIBETAN--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_TIBETAN</code></span></p></td>
 415 <td>    Tibetan
 416 </td>
 417 </tr>
 418 <tr>
 419 <td><p><a name="PANGO-SCRIPT-CANADIAN-ABORIGINAL--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_CANADIAN_ABORIGINAL</code></span></p></td>
 420 <td>    Canadian Aboriginal
 421 </td>
 422 </tr>
 423 <tr>
 424 <td><p><a name="PANGO-SCRIPT-YI--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_YI</code></span></p></td>
 425 <td>    Yi
 426 </td>
 427 </tr>
 428 <tr>
 429 <td><p><a name="PANGO-SCRIPT-TAGALOG--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_TAGALOG</code></span></p></td>
 430 <td>    Tagalog
 431 </td>
 432 </tr>
 433 <tr>
 434 <td><p><a name="PANGO-SCRIPT-HANUNOO--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_HANUNOO</code></span></p></td>
 435 <td>    Hanunoo
 436 </td>
 437 </tr>
 438 <tr>
 439 <td><p><a name="PANGO-SCRIPT-BUHID--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_BUHID</code></span></p></td>
 440 <td>    Buhid
 441 </td>
 442 </tr>
 443 <tr>
 444 <td><p><a name="PANGO-SCRIPT-TAGBANWA--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_TAGBANWA</code></span></p></td>
 445 <td>    Tagbanwa
 446 </td>
 447 </tr>
 448 <tr>
 449 <td><p><a name="PANGO-SCRIPT-BRAILLE--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_BRAILLE</code></span></p></td>
 450 <td>    Braille
 451 </td>
 452 </tr>
 453 <tr>
 454 <td><p><a name="PANGO-SCRIPT-CYPRIOT--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_CYPRIOT</code></span></p></td>
 455 <td>    Cypriot
 456 </td>
 457 </tr>
 458 <tr>
 459 <td><p><a name="PANGO-SCRIPT-LIMBU--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_LIMBU</code></span></p></td>
 460 <td>    Limbu
 461 </td>
 462 </tr>
 463 <tr>
 464 <td><p><a name="PANGO-SCRIPT-OSMANYA--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_OSMANYA</code></span></p></td>
 465 <td>    Osmanya
 466 </td>
 467 </tr>
 468 <tr>
 469 <td><p><a name="PANGO-SCRIPT-SHAVIAN--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_SHAVIAN</code></span></p></td>
 470 <td>    Shavian
 471 </td>
 472 </tr>
 473 <tr>
 474 <td><p><a name="PANGO-SCRIPT-LINEAR-B--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_LINEAR_B</code></span></p></td>
 475 <td>    Linear B
 476 </td>
 477 </tr>
 478 <tr>
 479 <td><p><a name="PANGO-SCRIPT-TAI-LE--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_TAI_LE</code></span></p></td>
 480 <td>    Tai Le
 481 </td>
 482 </tr>
 483 <tr>
 484 <td><p><a name="PANGO-SCRIPT-UGARITIC--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_UGARITIC</code></span></p></td>
 485 <td>    Ugaritic
 486 </td>
 487 </tr>
 488 <tr>
 489 <td><p><a name="PANGO-SCRIPT-NEW-TAI-LUE--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_NEW_TAI_LUE</code></span></p></td>
 490 <td>    New Tai Lue. Since 1.10
 491 </td>
 492 </tr>
 493 <tr>
 494 <td><p><a name="PANGO-SCRIPT-BUGINESE--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_BUGINESE</code></span></p></td>
 495 <td>    Buginese. Since 1.10
 496 </td>
 497 </tr>
 498 <tr>
 499 <td><p><a name="PANGO-SCRIPT-GLAGOLITIC--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_GLAGOLITIC</code></span></p></td>
 500 <td>    Glagolitic. Since 1.10
 501 </td>
 502 </tr>
 503 <tr>
 504 <td><p><a name="PANGO-SCRIPT-TIFINAGH--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_TIFINAGH</code></span></p></td>
 505 <td>    Tifinagh. Since 1.10
 506 </td>
 507 </tr>
 508 <tr>
 509 <td><p><a name="PANGO-SCRIPT-SYLOTI-NAGRI--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_SYLOTI_NAGRI</code></span></p></td>
 510 <td>    Syloti Nagri. Since 1.10
 511 </td>
 512 </tr>
 513 <tr>
 514 <td><p><a name="PANGO-SCRIPT-OLD-PERSIAN--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_OLD_PERSIAN</code></span></p></td>
 515 <td>    Old Persian. Since 1.10
 516 </td>
 517 </tr>
 518 <tr>
 519 <td><p><a name="PANGO-SCRIPT-KHAROSHTHI--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_KHAROSHTHI</code></span></p></td>
 520 <td>    Kharoshthi. Since 1.10
 521 </td>
 522 </tr>
 523 <tr>
 524 <td><p><a name="PANGO-SCRIPT-UNKNOWN--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_UNKNOWN</code></span></p></td>
 525 <td>            an unassigned code point. Since 1.14
 526 </td>
 527 </tr>
 528 <tr>
 529 <td><p><a name="PANGO-SCRIPT-BALINESE--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_BALINESE</code></span></p></td>
 530 <td>            Balinese. Since 1.14
 531 </td>
 532 </tr>
 533 <tr>
 534 <td><p><a name="PANGO-SCRIPT-CUNEIFORM--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_CUNEIFORM</code></span></p></td>
 535 <td>    Cuneiform. Since 1.14
 536 </td>
 537 </tr>
 538 <tr>
 539 <td><p><a name="PANGO-SCRIPT-PHOENICIAN--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_PHOENICIAN</code></span></p></td>
 540 <td>    Phoenician. Since 1.14
 541 </td>
 542 </tr>
 543 <tr>
 544 <td><p><a name="PANGO-SCRIPT-PHAGS-PA--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_PHAGS_PA</code></span></p></td>
 545 <td>            Phags-pa. Since 1.14
 546 </td>
 547 </tr>
 548 <tr>
 549 <td><p><a name="PANGO-SCRIPT-NKO--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_NKO</code></span></p></td>
 550 <td>            N'Ko. Since 1.14
 551 </td>
 552 </tr>
 553 <tr>
 554 <td><p><a name="PANGO-SCRIPT-KAYAH-LI--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_KAYAH_LI</code></span></p></td>
 555 <td>  Kayah Li. Since 1.20.1
 556 </td>
 557 </tr>
 558 <tr>
 559 <td><p><a name="PANGO-SCRIPT-LEPCHA--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_LEPCHA</code></span></p></td>
 560 <td>    Lepcha. Since 1.20.1
 561 </td>
 562 </tr>
 563 <tr>
 564 <td><p><a name="PANGO-SCRIPT-REJANG--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_REJANG</code></span></p></td>
 565 <td>    Rejang. Since 1.20.1
 566 </td>
 567 </tr>
 568 <tr>
 569 <td><p><a name="PANGO-SCRIPT-SUNDANESE--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_SUNDANESE</code></span></p></td>
 570 <td> Sundanese. Since 1.20.1
 571 </td>
 572 </tr>
 573 <tr>
 574 <td><p><a name="PANGO-SCRIPT-SAURASHTRA--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_SAURASHTRA</code></span></p></td>
 575 <td>Saurashtra. Since 1.20.1
 576 </td>
 577 </tr>
 578 <tr>
 579 <td><p><a name="PANGO-SCRIPT-CHAM--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_CHAM</code></span></p></td>
 580 <td>      Cham. Since 1.20.1
 581 </td>
 582 </tr>
 583 <tr>
 584 <td><p><a name="PANGO-SCRIPT-OL-CHIKI--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_OL_CHIKI</code></span></p></td>
 585 <td>  Ol Chiki. Since 1.20.1
 586 </td>
 587 </tr>
 588 <tr>
 589 <td><p><a name="PANGO-SCRIPT-VAI--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_VAI</code></span></p></td>
 590 <td>       Vai. Since 1.20.1
 591 </td>
 592 </tr>
 593 <tr>
 594 <td><p><a name="PANGO-SCRIPT-CARIAN--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_CARIAN</code></span></p></td>
 595 <td>    Carian. Since 1.20.1
 596 </td>
 597 </tr>
 598 <tr>
 599 <td><p><a name="PANGO-SCRIPT-LYCIAN--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_LYCIAN</code></span></p></td>
 600 <td>    Lycian. Since 1.20.1
 601 </td>
 602 </tr>
 603 <tr>
 604 <td><p><a name="PANGO-SCRIPT-LYDIAN--CAPS"></a><span class="term"><code class="literal">PANGO_SCRIPT_LYDIAN</code></span></p></td>
 605 <td>    Lydian. Since 1.20.1
 606 </td>
 607 </tr>
 608 </tbody>
 609 </table></div>
 610 </div>
 611 <hr>
 612 <div class="refsect2" lang="en">
 613 <a name="PANGO-TYPE-SCRIPT--CAPS"></a><h3>PANGO_TYPE_SCRIPT</h3>
 614 <pre class="programlisting">#define PANGO_TYPE_SCRIPT (pango_script_get_type())
 615 </pre>
 616 <p>
 617 The <a
 618 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
 619 ><span class="type">GObject</span></a> type for <a class="link" href="pango-Scripts-and-Languages.html#PangoScript" title="enum PangoScript"><span class="type">PangoScript</span></a>
 620 </p>
 621 </div>
 622 <hr>
 623 <div class="refsect2" lang="en">
 624 <a name="PangoScriptIter"></a><h3>PangoScriptIter</h3>
 625 <pre class="programlisting">typedef struct _PangoScriptIter PangoScriptIter;</pre>
 626 <p>
 627 A <a class="link" href="pango-Scripts-and-Languages.html#PangoScriptIter" title="PangoScriptIter"><span class="type">PangoScriptIter</span></a> is used to iterate through a string
 628 and identify ranges in different scripts.</p>
 629 <p>
 630 </p>
 631 </div>
 632 <hr>
 633 <div class="refsect2" lang="en">
 634 <a name="pango-script-for-unichar"></a><h3>pango_script_for_unichar ()</h3>
 635 <pre class="programlisting"><a class="link" href="pango-Scripts-and-Languages.html#PangoScript" title="enum PangoScript">PangoScript</a>         pango_script_for_unichar            (<a
 636 href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#gunichar"
 637 >gunichar</a> ch);</pre>
 638 <p>
 639 Looks up the <a class="link" href="pango-Scripts-and-Languages.html#PangoScript" title="enum PangoScript"><span class="type">PangoScript</span></a> for a particular character (as defined by
 640 Unicode Standard Annex <span class="type">24</span>). No check is made for <em class="parameter"><code>ch</code></em> being a
 641 valid Unicode character; if you pass in invalid character, the
 642 result is undefined.
 643 </p>
 644 <p>
 645 As of Pango 1.18, this function simply returns the return value of
 646 <a
 647 href="http://library.gnome.org/devel/glib/unstable/glib-Unicode-Manipulation.html#g-unichar-get-script"
 648 ><code class="function">g_unichar_get_script()</code></a>.</p>
 649 <p>
 650 </p>
 651 <div class="variablelist"><table border="0">
 652 <col align="left" valign="top">
 653 <tbody>
 654 <tr>
 655 <td><p><span class="term"><em class="parameter"><code>ch</code></em> :</span></p></td>
 656 <td> a Unicode character
 657 </td>
 658 </tr>
 659 <tr>
 660 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 661 <td> the <a class="link" href="pango-Scripts-and-Languages.html#PangoScript" title="enum PangoScript"><span class="type">PangoScript</span></a> for the character.
 662
 663 </td>
 664 </tr>
 665 </tbody>
 666 </table></div>
 667 <p class="since">Since 1.4</p>
 668 </div>
 669 <hr>
 670 <div class="refsect2" lang="en">
 671 <a name="pango-script-get-sample-language"></a><h3>pango_script_get_sample_language ()</h3>
 672 <pre class="programlisting"><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *     pango_script_get_sample_language    (<a class="link" href="pango-Scripts-and-Languages.html#PangoScript" title="enum PangoScript">PangoScript</a> script);</pre>
 673 <p>
 674 Given a script, finds a language tag that is reasonably
 675 representative of that script. This will usually be the
 676 most widely spoken or used language written in that script:
 677 for instance, the sample language for <a class="link" href="pango-Scripts-and-Languages.html#PANGO-SCRIPT-CYRILLIC--CAPS"><code class="literal">PANGO_SCRIPT_CYRILLIC</code></a>
 678 is <code class="literal">ru</code> (Russian), the sample language
 679 for <a class="link" href="pango-Scripts-and-Languages.html#PANGO-SCRIPT-ARABIC--CAPS"><code class="literal">PANGO_SCRIPT_ARABIC</code></a> is <code class="literal">ar</code>.
 680 </p>
 681 <p>
 682 For some
 683 scripts, no sample language will be returned because there
 684 is no language that is sufficiently representative. The best
 685 example of this is <a class="link" href="pango-Scripts-and-Languages.html#PANGO-SCRIPT-HAN--CAPS"><code class="literal">PANGO_SCRIPT_HAN</code></a>, where various different
 686 variants of written Chinese, Japanese, and Korean all use
 687 significantly different sets of Han characters and forms
 688 of shared characters. No sample language can be provided
 689 for many historical scripts as well.
 690 </p>
 691 <p>
 692 As of 1.18, this function checks the environment variables
 693 PANGO_LANGUAGE and LANGUAGE (checked in that order) first.
 694 If one of them is set, it is parsed as a list of language tags
 695 separated by colons or other separators.  This function
 696 will return the first language in the parsed list that Pango
 697 believes may use <em class="parameter"><code>script</code></em> for writing.  This last predicate
 698 is tested using <a class="link" href="pango-Scripts-and-Languages.html#pango-language-includes-script" title="pango_language_includes_script ()"><code class="function">pango_language_includes_script()</code></a>.  This can
 699 be used to control Pango's font selection for non-primary
 700 languages.  For example, a PANGO_LANGUAGE enviroment variable
 701 set to "en:fa" makes Pango choose fonts suitable for Persian (fa)
 702 instead of Arabic (ar) when a segment of Arabic text is found
 703 in an otherwise non-Arabic text.  The same trick can be used to
 704 choose a default language for <a class="link" href="pango-Scripts-and-Languages.html#PANGO-SCRIPT-HAN--CAPS"><code class="literal">PANGO_SCRIPT_HAN</code></a> when setting
 705 context language is not feasible.</p>
 706 <p>
 707 </p>
 708 <div class="variablelist"><table border="0">
 709 <col align="left" valign="top">
 710 <tbody>
 711 <tr>
 712 <td><p><span class="term"><em class="parameter"><code>script</code></em> :</span></p></td>
 713 <td> a <a class="link" href="pango-Scripts-and-Languages.html#PangoScript" title="enum PangoScript"><span class="type">PangoScript</span></a>
 714 </td>
 715 </tr>
 716 <tr>
 717 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 718 <td> a <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage"><span class="type">PangoLanguage</span></a> that is representative
 719 of the script, or <a
 720 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 721 ><code class="literal">NULL</code></a> if no such language exists.
 722
 723 </td>
 724 </tr>
 725 </tbody>
 726 </table></div>
 727 <p class="since">Since 1.4</p>
 728 </div>
 729 <hr>
 730 <div class="refsect2" lang="en">
 731 <a name="pango-script-iter-new"></a><h3>pango_script_iter_new ()</h3>
 732 <pre class="programlisting"><a class="link" href="pango-Scripts-and-Languages.html#PangoScriptIter" title="PangoScriptIter">PangoScriptIter</a> *   pango_script_iter_new               (const char *text,
 733                                                          int length);</pre>
 734 <p>
 735 Create a new <a class="link" href="pango-Scripts-and-Languages.html#PangoScriptIter" title="PangoScriptIter"><span class="type">PangoScriptIter</span></a>, used to break a string of
 736 Unicode into runs by text. No copy is made of <em class="parameter"><code>text</code></em>, so
 737 the caller needs to make sure it remains valid until
 738 the iterator is freed with <a class="link" href="pango-Scripts-and-Languages.html#pango-script-iter-free" title="pango_script_iter_free ()"><code class="function">pango_script_iter_free()</code></a>.</p>
 739 <p>
 740 </p>
 741 <div class="variablelist"><table border="0">
 742 <col align="left" valign="top">
 743 <tbody>
 744 <tr>
 745 <td><p><span class="term"><em class="parameter"><code>text</code></em> :</span></p></td>
 746 <td> a UTF-8 string
 747 </td>
 748 </tr>
 749 <tr>
 750 <td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
 751 <td> length of <em class="parameter"><code>text</code></em>, or -1 if <em class="parameter"><code>text</code></em> is nul-terminated.
 752 </td>
 753 </tr>
 754 <tr>
 755 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 756 <td> the new script iterator, initialized
 757  to point at the first range in the text, which should be
 758  freed with <a class="link" href="pango-Scripts-and-Languages.html#pango-script-iter-free" title="pango_script_iter_free ()"><code class="function">pango_script_iter_free()</code></a>. If the string is
 759  empty, it will point at an empty range.
 760
 761 </td>
 762 </tr>
 763 </tbody>
 764 </table></div>
 765 <p class="since">Since 1.4</p>
 766 </div>
 767 <hr>
 768 <div class="refsect2" lang="en">
 769 <a name="pango-script-iter-get-range"></a><h3>pango_script_iter_get_range ()</h3>
 770 <pre class="programlisting">void                pango_script_iter_get_range         (<a class="link" href="pango-Scripts-and-Languages.html#PangoScriptIter" title="PangoScriptIter">PangoScriptIter</a> *iter,
 771                                                          G_CONST_RETURN char **start,
 772                                                          G_CONST_RETURN char **end,
 773                                                          <a class="link" href="pango-Scripts-and-Languages.html#PangoScript" title="enum PangoScript">PangoScript</a> *script);</pre>
 774 <p>
 775 Gets information about the range to which <em class="parameter"><code>iter</code></em> currently points.
 776 The range is the set of locations p where *start &lt;= p &lt; *end.
 777 (That is, it doesn't include the character stored at *end)</p>
 778 <p>
 779 </p>
 780 <div class="variablelist"><table border="0">
 781 <col align="left" valign="top">
 782 <tbody>
 783 <tr>
 784 <td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
 785 <td> a <a class="link" href="pango-Scripts-and-Languages.html#PangoScriptIter" title="PangoScriptIter"><span class="type">PangoScriptIter</span></a>
 786 </td>
 787 </tr>
 788 <tr>
 789 <td><p><span class="term"><em class="parameter"><code>start</code></em> :</span></p></td>
 790 <td> location to store start position of the range, or <a
 791 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 792 ><code class="literal">NULL</code></a>
 793 </td>
 794 </tr>
 795 <tr>
 796 <td><p><span class="term"><em class="parameter"><code>end</code></em> :</span></p></td>
 797 <td> location to store end position of the range, or <a
 798 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 799 ><code class="literal">NULL</code></a>
 800 </td>
 801 </tr>
 802 <tr>
 803 <td><p><span class="term"><em class="parameter"><code>script</code></em> :</span></p></td>
 804 <td> location to store script for range, or <a
 805 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 806 ><code class="literal">NULL</code></a>
 807 </td>
 808 </tr>
 809 </tbody>
 810 </table></div>
 811 <p class="since">Since 1.4</p>
 812 </div>
 813 <hr>
 814 <div class="refsect2" lang="en">
 815 <a name="pango-script-iter-next"></a><h3>pango_script_iter_next ()</h3>
 816 <pre class="programlisting"><a
 817 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 818 >gboolean</a>            pango_script_iter_next              (<a class="link" href="pango-Scripts-and-Languages.html#PangoScriptIter" title="PangoScriptIter">PangoScriptIter</a> *iter);</pre>
 819 <p>
 820 Advances a <a class="link" href="pango-Scripts-and-Languages.html#PangoScriptIter" title="PangoScriptIter"><span class="type">PangoScriptIter</span></a> to the next range. If <em class="parameter"><code>iter</code></em>
 821 is already at the end, it is left unchanged and <a
 822 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
 823 ><code class="literal">FALSE</code></a>
 824 is returned.</p>
 825 <p>
 826 </p>
 827 <div class="variablelist"><table border="0">
 828 <col align="left" valign="top">
 829 <tbody>
 830 <tr>
 831 <td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
 832 <td> a <a class="link" href="pango-Scripts-and-Languages.html#PangoScriptIter" title="PangoScriptIter"><span class="type">PangoScriptIter</span></a>
 833 </td>
 834 </tr>
 835 <tr>
 836 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 837 <td> <a
 838 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
 839 ><code class="literal">TRUE</code></a> if <em class="parameter"><code>iter</code></em> was successfully advanced.
 840
 841 </td>
 842 </tr>
 843 </tbody>
 844 </table></div>
 845 <p class="since">Since 1.4</p>
 846 </div>
 847 <hr>
 848 <div class="refsect2" lang="en">
 849 <a name="pango-script-iter-free"></a><h3>pango_script_iter_free ()</h3>
 850 <pre class="programlisting">void                pango_script_iter_free              (<a class="link" href="pango-Scripts-and-Languages.html#PangoScriptIter" title="PangoScriptIter">PangoScriptIter</a> *iter);</pre>
 851 <p>
 852 Frees a <a class="link" href="pango-Scripts-and-Languages.html#PangoScriptIter" title="PangoScriptIter"><span class="type">PangoScriptIter</span></a> created with <a class="link" href="pango-Scripts-and-Languages.html#pango-script-iter-new" title="pango_script_iter_new ()"><code class="function">pango_script_iter_new()</code></a>.</p>
 853 <p>
 854 </p>
 855 <div class="variablelist"><table border="0">
 856 <col align="left" valign="top">
 857 <tbody><tr>
 858 <td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
 859 <td> a <a class="link" href="pango-Scripts-and-Languages.html#PangoScriptIter" title="PangoScriptIter"><span class="type">PangoScriptIter</span></a>
 860 </td>
 861 </tr></tbody>
 862 </table></div>
 863 <p class="since">Since 1.4</p>
 864 </div>
 865 <hr>
 866 <div class="refsect2" lang="en">
 867 <a name="PangoLanguage"></a><h3>PangoLanguage</h3>
 868 <pre class="programlisting">typedef struct _PangoLanguage PangoLanguage;</pre>
 869 <p>
 870 The <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage"><span class="type">PangoLanguage</span></a> structure is used to
 871 represent a language.
 872 </p>
 873 <p>
 874 <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage"><span class="type">PangoLanguage</span></a> pointers can be efficiently
 875 copied and compared with each other.
 876 </p>
 877 </div>
 878 <hr>
 879 <div class="refsect2" lang="en">
 880 <a name="PANGO-TYPE-LANGUAGE--CAPS"></a><h3>PANGO_TYPE_LANGUAGE</h3>
 881 <pre class="programlisting">#define PANGO_TYPE_LANGUAGE (pango_language_get_type ())
 882 </pre>
 883 <p>
 884 The <a
 885 href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
 886 ><span class="type">GObject</span></a> type for <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage"><span class="type">PangoLanguage</span></a>.
 887 </p>
 888 </div>
 889 <hr>
 890 <div class="refsect2" lang="en">
 891 <a name="pango-language-from-string"></a><h3>pango_language_from_string ()</h3>
 892 <pre class="programlisting"><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *     pango_language_from_string          (const char *language);</pre>
 893 <p>
 894 Take a RFC-3066 format language tag as a string and convert it to a
 895 <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage"><span class="type">PangoLanguage</span></a> pointer that can be efficiently copied (copy the
 896 pointer) and compared with other language tags (compare the
 897 pointer.)
 898 </p>
 899 <p>
 900 This function first canonicalizes the string by converting it to
 901 lowercase, mapping '_' to '-', and stripping all characters other
 902 than letters and '-'.
 903 </p>
 904 <p>
 905 Use <a class="link" href="pango-Scripts-and-Languages.html#pango-language-get-default" title="pango_language_get_default ()"><code class="function">pango_language_get_default()</code></a> if you want to get the <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage"><span class="type">PangoLanguage</span></a> for
 906 the current locale of the process.</p>
 907 <p>
 908 </p>
 909 <div class="variablelist"><table border="0">
 910 <col align="left" valign="top">
 911 <tbody>
 912 <tr>
 913 <td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>
 914 <td> a string representing a language tag, or <a
 915 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 916 ><code class="literal">NULL</code></a>
 917 </td>
 918 </tr>
 919 <tr>
 920 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 921 <td> an opaque pointer to a <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage"><span class="type">PangoLanguage</span></a> structure, or <a
 922 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 923 ><code class="literal">NULL</code></a>
 924               if <em class="parameter"><code>language</code></em> was <a
 925 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 926 ><code class="literal">NULL</code></a>.  The returned pointer will be valid
 927               forever after, and should not be freed.
 928 </td>
 929 </tr>
 930 </tbody>
 931 </table></div>
 932 </div>
 933 <hr>
 934 <div class="refsect2" lang="en">
 935 <a name="pango-language-to-string"></a><h3>pango_language_to_string ()</h3>
 936 <pre class="programlisting">const char *        pango_language_to_string            (<a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *language);</pre>
 937 <p>
 938 Gets the RFC-3066 format string representing the given language tag.</p>
 939 <p>
 940 </p>
 941 <div class="variablelist"><table border="0">
 942 <col align="left" valign="top">
 943 <tbody>
 944 <tr>
 945 <td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>
 946 <td> a language tag.
 947 </td>
 948 </tr>
 949 <tr>
 950 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 951 <td> a string representing the language tag.  This is owned by
 952          Pango and should not be freed.
 953 </td>
 954 </tr>
 955 </tbody>
 956 </table></div>
 957 </div>
 958 <hr>
 959 <div class="refsect2" lang="en">
 960 <a name="pango-language-matches"></a><h3>pango_language_matches ()</h3>
 961 <pre class="programlisting"><a
 962 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
 963 >gboolean</a>            pango_language_matches              (<a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *language,
 964                                                          const char *range_list);</pre>
 965 <p>
 966 Checks if a language tag matches one of the elements in a list of
 967 language ranges. A language tag is considered to match a range
 968 in the list if the range is '*', the range is exactly the tag,
 969 or the range is a prefix of the tag, and the character after it
 970 in the tag is '-'.</p>
 971 <p>
 972 </p>
 973 <div class="variablelist"><table border="0">
 974 <col align="left" valign="top">
 975 <tbody>
 976 <tr>
 977 <td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>
 978 <td> a language tag (see <a class="link" href="pango-Scripts-and-Languages.html#pango-language-from-string" title="pango_language_from_string ()"><code class="function">pango_language_from_string()</code></a>),
 979            <a
 980 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
 981 ><code class="literal">NULL</code></a> is allowed and matches nothing but '*'
 982 </td>
 983 </tr>
 984 <tr>
 985 <td><p><span class="term"><em class="parameter"><code>range_list</code></em> :</span></p></td>
 986 <td> a list of language ranges, separated by ';', ':',
 987   ',', or space characters.
 988   Each element must either be '*', or a RFC 3066 language range
 989   canonicalized as by <a class="link" href="pango-Scripts-and-Languages.html#pango-language-from-string" title="pango_language_from_string ()"><code class="function">pango_language_from_string()</code></a>
 990 </td>
 991 </tr>
 992 <tr>
 993 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 994 <td> <a
 995 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
 996 ><code class="literal">TRUE</code></a> if a match was found.
 997 </td>
 998 </tr>
 999 </tbody>
1000 </table></div>
1001 </div>
1002 <hr>
1003 <div class="refsect2" lang="en">
1004 <a name="pango-language-includes-script"></a><h3>pango_language_includes_script ()</h3>
1005 <pre class="programlisting"><a
1006 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
1007 >gboolean</a>            pango_language_includes_script      (<a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *language,
1008                                                          <a class="link" href="pango-Scripts-and-Languages.html#PangoScript" title="enum PangoScript">PangoScript</a> script);</pre>
1009 <p>
1010 Determines if <em class="parameter"><code>script</code></em> is one of the scripts used to
1011 write <em class="parameter"><code>language</code></em>. The returned value is conservative;
1012 if nothing is known about the language tag <em class="parameter"><code>language</code></em>,
1013 <a
1014 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
1015 ><code class="literal">TRUE</code></a> will be returned, since, as far as Pango knows,
1016 <em class="parameter"><code>script</code></em> might be used to write <em class="parameter"><code>language</code></em>.
1017 </p>
1018 <p>
1019 This routine is used in Pango's itemization process when
1020 determining if a supplied language tag is relevant to
1021 a particular section of text. It probably is not useful for
1022 applications in most circumstances.
1023 </p>
1024 <p>
1025 This function uses <a class="link" href="pango-Scripts-and-Languages.html#pango-language-get-scripts" title="pango_language_get_scripts ()"><code class="function">pango_language_get_scripts()</code></a> internally.</p>
1026 <p>
1027 </p>
1028 <div class="variablelist"><table border="0">
1029 <col align="left" valign="top">
1030 <tbody>
1031 <tr>
1032 <td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>
1033 <td> a <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage"><span class="type">PangoLanguage</span></a>, or <a
1034 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1035 ><code class="literal">NULL</code></a>
1036 </td>
1037 </tr>
1038 <tr>
1039 <td><p><span class="term"><em class="parameter"><code>script</code></em> :</span></p></td>
1040 <td> a <a class="link" href="pango-Scripts-and-Languages.html#PangoScript" title="enum PangoScript"><span class="type">PangoScript</span></a>
1041 </td>
1042 </tr>
1043 <tr>
1044 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1045 <td> <a
1046 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE--CAPS"
1047 ><code class="literal">TRUE</code></a> if <em class="parameter"><code>script</code></em> is one of the scripts used
1048 to write <em class="parameter"><code>language</code></em> or if nothing is known about <em class="parameter"><code>language</code></em>
1049 (including the case that <em class="parameter"><code>language</code></em> is <a
1050 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1051 ><code class="literal">NULL</code></a>),
1052 <a
1053 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE--CAPS"
1054 ><code class="literal">FALSE</code></a> otherwise.
1055
1056 </td>
1057 </tr>
1058 </tbody>
1059 </table></div>
1060 <p class="since">Since 1.4</p>
1061 </div>
1062 <hr>
1063 <div class="refsect2" lang="en">
1064 <a name="pango-language-get-scripts"></a><h3>pango_language_get_scripts ()</h3>
1065 <pre class="programlisting">const <a class="link" href="pango-Scripts-and-Languages.html#PangoScript" title="enum PangoScript">PangoScript</a> * pango_language_get_scripts          (<a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *language,
1066                                                          int *num_scripts);</pre>
1067 <p>
1068 Determines the scripts used to to write <em class="parameter"><code>language</code></em>.
1069 If nothing is known about the language tag <em class="parameter"><code>language</code></em>,
1070 or if <em class="parameter"><code>language</code></em> is <a
1071 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1072 ><code class="literal">NULL</code></a>, then <a
1073 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1074 ><code class="literal">NULL</code></a> is returned.
1075 The list of scripts returned starts with the script that the
1076 language uses most and continues to the one it uses least.
1077 </p>
1078 <p>
1079 The value <em class="parameter"><code>num_script</code></em> points at will be set to the number
1080 of scripts in the returned array (or zero if <a
1081 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1082 ><code class="literal">NULL</code></a> is returned).
1083 </p>
1084 <p>
1085 Most languages use only one script for writing, but there are
1086 some that use two (Latin and Cyrillic for example), and a few
1087 use three (Japanese for example).  Applications should not make
1088 any assumptions on the maximum number of scripts returned
1089 though, except that it is positive if the return value is not
1090 <a
1091 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1092 ><code class="literal">NULL</code></a>, and it is a small number.
1093 </p>
1094 <p>
1095 The <a class="link" href="pango-Scripts-and-Languages.html#pango-language-includes-script" title="pango_language_includes_script ()"><code class="function">pango_language_includes_script()</code></a> function uses this function
1096 internally.</p>
1097 <p>
1098 </p>
1099 <div class="variablelist"><table border="0">
1100 <col align="left" valign="top">
1101 <tbody>
1102 <tr>
1103 <td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>
1104 <td> a <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage"><span class="type">PangoLanguage</span></a>, or <a
1105 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1106 ><code class="literal">NULL</code></a>
1107 </td>
1108 </tr>
1109 <tr>
1110 <td><p><span class="term"><em class="parameter"><code>num_scripts</code></em> :</span></p></td>
1111 <td> location to return number of scripts, or <a
1112 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1113 ><code class="literal">NULL</code></a>
1114 </td>
1115 </tr>
1116 <tr>
1117 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1118 <td> An array of <a class="link" href="pango-Scripts-and-Languages.html#PangoScript" title="enum PangoScript"><span class="type">PangoScript</span></a> values, with the
1119 number of entries in the array stored in <em class="parameter"><code>num_scripts</code></em>, or
1120 <a
1121 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1122 ><code class="literal">NULL</code></a> if Pango does not have any information about this
1123 particular language tag (also the case if <em class="parameter"><code>language</code></em> is <a
1124 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1125 ><code class="literal">NULL</code></a>).
1126 The returned array is owned by Pango and should not be modified
1127 or freed.
1128
1129 </td>
1130 </tr>
1131 </tbody>
1132 </table></div>
1133 <p class="since">Since 1.22</p>
1134 </div>
1135 <hr>
1136 <div class="refsect2" lang="en">
1137 <a name="pango-language-get-default"></a><h3>pango_language_get_default ()</h3>
1138 <pre class="programlisting"><a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *     pango_language_get_default          (void);</pre>
1139 <p>
1140 Returns the <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage"><span class="type">PangoLanguage</span></a> for the current locale of the process.
1141 Note that this can change over the life of an application.
1142 </p>
1143 <p>
1144 On Unix systems, this is the return value is derived from
1145 <code class="literal">setlocale(LC_CTYPE, NULL)</code>, and the user can
1146 affect this through the environment variables LC_ALL, LC_CTYPE or
1147 LANG (checked in that order). The locale string typically is in
1148 the form lang_COUNTRY, where lang is an ISO-639 language code, and
1149 COUNTRY is an ISO-3166 country code. For instance, sv_FI for
1150 Swedish as written in Finland or pt_BR for Portuguese as written in
1151 Brazil.
1152 </p>
1153 <p>
1154 On Windows, the C library does not use any such environment
1155 variables, and setting them won't affect the behavior of functions
1156 like <code class="function">ctime()</code>. The user sets the locale through the Regional Options
1157 in the Control Panel. The C library (in the <a
1158 href="http://library.gnome.org/devel/glib/unstable/glib-running.html#setlocale"
1159 ><code class="function">setlocale()</code></a> function)
1160 does not use country and language codes, but country and language
1161 names spelled out in English.
1162 However, this function does check the above environment
1163 variables, and does return a Unix-style locale string based on
1164 either said environment variables or the thread's current locale.
1165 </p>
1166 <p>
1167 Your application should call <code class="literal">setlocale(LC_ALL, "");</code>
1168 for the user settings to take effect.  Gtk+ does this in its initialization
1169 functions automatically (by calling <a
1170 href="http://library.gnome.org/devel/gtk/unstable/gtk-General.html#gtk-set-locale"
1171 ><code class="function">gtk_set_locale()</code></a>).
1172 See <code class="literal">man setlocale</code> for more details.</p>
1173 <p>
1174 </p>
1175 <div class="variablelist"><table border="0">
1176 <col align="left" valign="top">
1177 <tbody><tr>
1178 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1179 <td> the default language as a <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage"><span class="type">PangoLanguage</span></a>, must not be
1180               freed.
1181
1182 </td>
1183 </tr></tbody>
1184 </table></div>
1185 <p class="since">Since 1.16</p>
1186 </div>
1187 <hr>
1188 <div class="refsect2" lang="en">
1189 <a name="pango-language-get-sample-string"></a><h3>pango_language_get_sample_string ()</h3>
1190 <pre class="programlisting">const char *        pango_language_get_sample_string    (<a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage">PangoLanguage</a> *language);</pre>
1191 <p>
1192 Get a string that is representative of the characters needed to
1193 render a particular language.
1194 </p>
1195 <p>
1196 The sample text may be a pangram, but is not necessarily.  It is chosen to
1197 be demonstrative of normal text in the language, as well as exposing font
1198 feature requirements unique to the language.  It is suitable for use
1199 as sample text in a font selection dialog.
1200 </p>
1201 <p>
1202 If <em class="parameter"><code>language</code></em> is <a
1203 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1204 ><code class="literal">NULL</code></a>, the default language as found by
1205 <a class="link" href="pango-Scripts-and-Languages.html#pango-language-get-default" title="pango_language_get_default ()"><code class="function">pango_language_get_default()</code></a> is used.
1206 </p>
1207 <p>
1208 If Pango does not have a sample string for <em class="parameter"><code>language</code></em>, the classic
1209 "The quick brown fox..." is returned.  This can be detected by
1210 comparing the returned pointer value to that returned for (non-existent)
1211 language code "xx".  That is, compare to:
1212 </p>
1213 <div class="informalexample"><pre class="programlisting">
1214 pango_language_get_sample_string (pango_language_from_string ("xx"))
1215 </pre></div>
1216 <p>
1217 </p>
1218 <div class="variablelist"><table border="0">
1219 <col align="left" valign="top">
1220 <tbody>
1221 <tr>
1222 <td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>
1223 <td> a <a class="link" href="pango-Scripts-and-Languages.html#PangoLanguage" title="PangoLanguage"><span class="type">PangoLanguage</span></a>, or <a
1224 href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL--CAPS"
1225 ><code class="literal">NULL</code></a>
1226 </td>
1227 </tr>
1228 <tr>
1229 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1230 <td> the sample string. This value is owned by Pango
1231   and should not be freed.
1232 </td>
1233 </tr>
1234 </tbody>
1235 </table></div>
1236 </div>
1237 </div>
1238 </div>
1239 <div class="footer">
1240 <hr>
1241           Generated by GTK-Doc V1.11</div>
1242 </body>
1243 </html>