<refentry id="pango-Scripts"><refmeta><refentrytitle role="top_of_page">Scripts</refentrytitle><manvolnum>3</manvolnum><refmiscinfo>PANGO Library</refmiscinfo></refmeta><refnamediv><refname>Scripts</refname><refpurpose>Identifying writing systems</refpurpose><!--[<xref linkend="desc" endterm="desc.title"/>]--></refnamediv><refsynopsisdiv role="synopsis"><title role="synopsis.title">Synopsis</title><synopsis>                    <link linkend="PangoScriptIter">PangoScriptIter</link>;enum                <link linkend="PangoScript">PangoScript</link>;#define             <link linkend="PANGO-TYPE-SCRIPT:CAPS">PANGO_TYPE_SCRIPT</link><link linkend="PangoScript">PangoScript</link>         <link linkend="pango-script-for-unichar">pango_script_for_unichar</link>            (<link linkend="gunichar">gunichar</link> ch);<link linkend="PangoLanguage">PangoLanguage</link>*      <link linkend="pango-script-get-sample-language">pango_script_get_sample_language</link>    (<link linkend="PangoScript">PangoScript</link> script);<link linkend="gboolean">gboolean</link>            <link linkend="pango-language-includes-script">pango_language_includes_script</link>      (<link linkend="PangoLanguage">PangoLanguage</link> *language,                                                         <link linkend="PangoScript">PangoScript</link> script);<link linkend="PangoScriptIter">PangoScriptIter</link>*    <link linkend="pango-script-iter-new">pango_script_iter_new</link>               (const <link linkend="char">char</link> *text,                                                         <link linkend="int">int</link> length);<link linkend="void">void</link>                <link linkend="pango-script-iter-get-range">pango_script_iter_get_range</link>         (<link linkend="PangoScriptIter">PangoScriptIter</link> *iter,                                                         G_CONST_RETURN <link linkend="char">char</link> **start,                                                         G_CONST_RETURN <link linkend="char">char</link> **end,                                                         <link linkend="PangoScript">PangoScript</link> *script);<link linkend="gboolean">gboolean</link>            <link linkend="pango-script-iter-next">pango_script_iter_next</link>              (<link linkend="PangoScriptIter">PangoScriptIter</link> *iter);<link linkend="void">void</link>                <link linkend="pango-script-iter-free">pango_script_iter_free</link>              (<link linkend="PangoScriptIter">PangoScriptIter</link> *iter);</synopsis></refsynopsisdiv><refsect1 role="desc"><title role="desc.title">Description</title><para>The functions in this section are used to identify the writingsystem, or <firstterm>script</firstterm> of individual charactersand of ranges within a larger text string.</para></refsect1><refsect1 role="details"><title role="details.title">Details</title><refsect2><title><anchor id="PangoScriptIter" role="struct"/>PangoScriptIter</title><indexterm><primary>PangoScriptIter</primary></indexterm><programlisting>typedef struct _PangoScriptIter PangoScriptIter;</programlisting><para>A <link linkend="PangoScriptIter"><type>PangoScriptIter</type></link> is used to iterate through a stringand identify ranges in different scripts.</para><para></para></refsect2><refsect2><title><anchor id="PangoScript" role="enum"/>enum PangoScript</title><indexterm><primary>PangoScript</primary></indexterm><programlisting>typedef enum {                         /* ISO 15924 code */      PANGO_SCRIPT_INVALID_CODE = -1,      PANGO_SCRIPT_COMMON       = 0,   /* Zyyy */      PANGO_SCRIPT_INHERITED,          /* Qaai */      PANGO_SCRIPT_ARABIC,             /* Arab */      PANGO_SCRIPT_ARMENIAN,           /* Armn */      PANGO_SCRIPT_BENGALI,            /* Beng */      PANGO_SCRIPT_BOPOMOFO,           /* Bopo */      PANGO_SCRIPT_CHEROKEE,           /* Cher */      PANGO_SCRIPT_COPTIC,             /* Qaac */      PANGO_SCRIPT_CYRILLIC,           /* Cyrl (Cyrs) */      PANGO_SCRIPT_DESERET,            /* Dsrt */      PANGO_SCRIPT_DEVANAGARI,         /* Deva */      PANGO_SCRIPT_ETHIOPIC,           /* Ethi */      PANGO_SCRIPT_GEORGIAN,           /* Geor (Geon, Geoa) */      PANGO_SCRIPT_GOTHIC,             /* Goth */      PANGO_SCRIPT_GREEK,              /* Grek */      PANGO_SCRIPT_GUJARATI,           /* Gujr */      PANGO_SCRIPT_GURMUKHI,           /* Guru */      PANGO_SCRIPT_HAN,                /* Hani */      PANGO_SCRIPT_HANGUL,             /* Hang */      PANGO_SCRIPT_HEBREW,             /* Hebr */      PANGO_SCRIPT_HIRAGANA,           /* Hira */      PANGO_SCRIPT_KANNADA,            /* Knda */      PANGO_SCRIPT_KATAKANA,           /* Kana */      PANGO_SCRIPT_KHMER,              /* Khmr */      PANGO_SCRIPT_LAO,                /* Laoo */      PANGO_SCRIPT_LATIN,              /* Latn (Latf, Latg) */      PANGO_SCRIPT_MALAYALAM,          /* Mlym */      PANGO_SCRIPT_MONGOLIAN,          /* Mong */      PANGO_SCRIPT_MYANMAR,            /* Mymr */      PANGO_SCRIPT_OGHAM,              /* Ogam */      PANGO_SCRIPT_OLD_ITALIC,         /* Ital */      PANGO_SCRIPT_ORIYA,              /* Orya */      PANGO_SCRIPT_RUNIC,              /* Runr */      PANGO_SCRIPT_SINHALA,            /* Sinh */      PANGO_SCRIPT_SYRIAC,             /* Syrc (Syrj, Syrn, Syre) */      PANGO_SCRIPT_TAMIL,              /* Taml */      PANGO_SCRIPT_TELUGU,             /* Telu */      PANGO_SCRIPT_THAANA,             /* Thaa */      PANGO_SCRIPT_THAI,               /* Thai */      PANGO_SCRIPT_TIBETAN,            /* Tibt */      PANGO_SCRIPT_CANADIAN_ABORIGINAL, /* Cans */      PANGO_SCRIPT_YI,                 /* Yiii */      PANGO_SCRIPT_TAGALOG,            /* Tglg */      PANGO_SCRIPT_HANUNOO,            /* Hano */      PANGO_SCRIPT_BUHID,              /* Buhd */      PANGO_SCRIPT_TAGBANWA,           /* Tagb */      /* Unicode-4.0 additions */      PANGO_SCRIPT_BRAILLE,            /* Brai */      PANGO_SCRIPT_CYPRIOT,            /* Cprt */      PANGO_SCRIPT_LIMBU,              /* Limb */      PANGO_SCRIPT_OSMANYA,            /* Osma */      PANGO_SCRIPT_SHAVIAN,            /* Shaw */      PANGO_SCRIPT_LINEAR_B,           /* Linb */      PANGO_SCRIPT_TAI_LE,             /* Tale */      PANGO_SCRIPT_UGARITIC,           /* Ugar */      /* Unicode-4.1 additions */      PANGO_SCRIPT_NEW_TAI_LUE,        /* Talu */      PANGO_SCRIPT_BUGINESE,           /* Bugi */      PANGO_SCRIPT_GLAGOLITIC,         /* Glag */      PANGO_SCRIPT_TIFINAGH,           /* Tfng */      PANGO_SCRIPT_SYLOTI_NAGRI,       /* Sylo */      PANGO_SCRIPT_OLD_PERSIAN,        /* Xpeo */      PANGO_SCRIPT_KHAROSHTHI,         /* Khar */      /* Unicode-5.0 additions */      PANGO_SCRIPT_UNKNOWN,            /* Zzzz */      PANGO_SCRIPT_BALINESE,           /* Bali */      PANGO_SCRIPT_CUNEIFORM,          /* Xsux */      PANGO_SCRIPT_PHOENICIAN,         /* Phnx */      PANGO_SCRIPT_PHAGS_PA,           /* Phag */      PANGO_SCRIPT_NKO                 /* Nkoo */} PangoScript;</programlisting><para>The <link linkend="PangoScript"><type>PangoScript</type></link> enumeration identifies different writingsystems. The values correspond to the names as defined in theUnicode standard.Note that new types may be added in the future. Applications should be readyto handle unknown values.  This enumeration is interchangeable with<link linkend="GUnicodeScript"><type>GUnicodeScript</type></link>.  See <ulinkurl="http://www.unicode.org/reports/tr24/">Unicode Standard Annex<link linkend="24--:CAPS"><type>24:</type></link> Script names</ulink>.</para><variablelist role="enum"><varlistentry><term><anchor id="PANGO-SCRIPT-INVALID-CODE:CAPS" role="constant"/><literal>PANGO_SCRIPT_INVALID_CODE</literal></term><listitem><simpara>a value never returned from <link linkend="pango-script-for-unichar"><function>pango_script_for_unichar()</function></link></simpara></listitem></varlistentry><varlistentry><term><anchor id="PANGO-SCRIPT-COMMON:CAPS" role="constant"/><literal>PANGO_SCRIPT_COMMON</literal></term><listitem><simpara>a character used by multiple different scripts</simpara></listitem></varlistentry><varlistentry><term><anchor id="PANGO-SCRIPT-INHERITED:CAPS" role="constant"/><literal>PANGO_SCRIPT_INHERITED</literal></term><listitem><simpara>a mark glyph that takes its script from the  base glyph to which it is attached</simpara></listitem></varlistentry><varlistentry><term><anchor id="PANGO-SCRIPT-ARABIC:CAPS" role="constant"/><literal>PANGO_SCRIPT_ARABIC</literal></term><listitem><simpara>	Arabic</simpara></listitem></varlistentry><varlistentry><term><anchor id="PANGO-SCRIPT-ARMENIAN:CAPS" role="constant"/><literal>PANGO_SCRIPT_ARMENIAN</literal></term><listitem><simpara>Armenian</simpara></listitem></varlistentry><varlistentry><term><anchor id="PANGO-SCRIPT-BENGALI:CAPS" role="constant"/><literal>PANGO_SCRIPT_BENGALI</literal></term><listitem><simpara>	Bengali</simpara></listitem></varlistentry><varlistentry><term><anchor id="PANGO-SCRIPT-BOPOMOFO:CAPS" role="constant"/><literal>PANGO_SCRIPT_BOPOMOFO</literal></term><listitem><simpara>Bopomofo</simpara></listitem></varlistentry><varlistentry><term><anchor id="PANGO-SCRIPT-CHEROKEE:CAPS" role="constant"/><literal>PANGO_SCRIPT_CHEROKEE</literal></term><listitem><simpara>	Cherokee</simpara></listitem></varlistentry><varlistentry><term><anchor id="PANGO-SCRIPT-COPTIC:CAPS" role="constant"/><literal>PANGO_SCRIPT_COPTIC</literal></term><listitem><simpara>	Coptic</simpara></listitem></varlistentry><varlistentry><term><anchor id="PANGO-SCRIPT-CYRILLIC:CAPS" role="constant"/><literal>PANGO_SCRIPT_CYRILLIC</literal></term><listitem><simpara>	Cyrillic</simpara></listitem></varlistentry><varlistentry><term><anchor id="PANGO-SCRIPT-DESERET:CAPS" role="constant"/><literal>PANGO_SCRIPT_DESERET</literal></term><listitem><simpara>	Deseret</simpara></listitem></varlistentry><varlistentry><term><anchor id="PANGO-SCRIPT-DEVANAGARI:CAPS" role="constant"/><literal>PANGO_SCRIPT_DEVANAGARI</literal></term><listitem><simpara>	Devanagari</simpara></listitem></varlistentry><varlistentry><term><anchor id="PANGO-SCRIPT-ETHIOPIC:CAPS" role="constant"/><literal>PANGO_SCRIPT_ETHIOPIC</literal></term><listitem><simpara>	Ethiopic</simpara></listitem></varlistentry><varlistentry><term><anchor id="PANGO-SCRIPT-GEORGIAN:CAPS" role="constant"/><literal>PANGO_SCRIPT_GEORGIAN</literal></term><listitem><simpara>	Georgian</simpara></listitem></varlistentry><varlistentry><term><anchor id="PANGO-SCRIPT-GOTHIC:CAPS" role="constant"/><literal>PANGO_SCRIPT_GOTHIC</literal></term><listitem><simpara>	Gothic</simpara></listitem></varlistentry><varlistentry><term><anchor id="PANGO-SCRIPT-GREEK:CAPS" role="constant"/><literal>PANGO_SCRIPT_GREEK</literal></term>