<a name="pango-font-description-copy-static"></a>pango_font_description_copy_static ()</h3><a class="indexterm" name="id3116482"></a><pre class="programlisting"><a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a>* pango_font_description_copy_static                                                        (const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);</pre><p>Like <a href="pango-Fonts.html#pango-font-description-copy"><code class="function">pango_font_description_copy()</code></a>, but only a shallow copy is madeof the family name and other allocated fields. The result can onlybe used until <em class="parameter"><code>desc</code></em> is modified or freed. This is meant to be usedwhen the copy is only needed temporarily.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>desc</code></em>&#160;:</span></td><td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td><td> the newly allocated <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, which should              be freed with <a href="pango-Fonts.html#pango-font-description-free"><code class="function">pango_font_description_free()</code></a>.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3116594"></a><h3><a name="pango-font-description-hash"></a>pango_font_description_hash ()</h3><a class="indexterm" name="id3116606"></a><pre class="programlisting"><ahref="../glib/glib-Basic-Types.html#guint">guint</a>               pango_font_description_hash         (const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);</pre><p>Computes a hash of a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a> structure suitableto be used, for example, as an argument to <ahref="../glib/glib-Hash-Tables.html#g-hash-table-new"><code class="function">g_hash_table_new()</code></a>.The hash value is independent of <em class="parameter"><code>desc-&gt;mask</code></em>.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>desc</code></em>&#160;:</span></td><td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td><td> the hash value.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3116704"></a><h3><a name="pango-font-description-equal"></a>pango_font_description_equal ()</h3><a class="indexterm" name="id3116717"></a><pre class="programlisting"><ahref="../glib/glib-Basic-Types.html#gboolean">gboolean</a>            pango_font_description_equal        (const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc1,                                                         const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc2);</pre><p>Compares two font descriptions for equality. Two font descriptionsare considered equal if the fonts they describe are provably identical.This means that their masks do not have to match, as long as other fieldsare all the same. (Two font descriptions may result in identical fontsbeing loaded, but still compare <ahref="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.)</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>desc1</code></em>&#160;:</span></td><td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></td></tr><tr><td><span class="term"><em class="parameter"><code>desc2</code></em>&#160;:</span></td><td> another <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td><td> <ahref="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the two font descriptions are identical,	 <ahref="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3116854"></a><h3><a name="pango-font-description-free"></a>pango_font_description_free ()</h3><a class="indexterm" name="id3116868"></a><pre class="programlisting">void                pango_font_description_free         (<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);</pre><p>Frees a font description.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>desc</code></em>&#160;:</span></td><td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, or <ahref="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3116937"></a><h3><a name="pango-font-descriptions-free"></a>pango_font_descriptions_free ()</h3><a class="indexterm" name="id3116950"></a><pre class="programlisting">void                pango_font_descriptions_free        (<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> **descs,                                                         int n_descs);</pre><p>Frees a list of font descriptions from <code class="function">pango_font_map_list_fonts()</code></p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>descs</code></em>&#160;:</span></td><td> a pointer to an array of <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, or <ahref="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td></tr><tr><td><span class="term"><em class="parameter"><code>n_descs</code></em>&#160;:</span></td><td> number of font descriptions in <em class="parameter"><code>descs</code></em></td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3117059"></a><h3><a name="pango-font-description-set-family"></a>pango_font_description_set_family ()</h3><a class="indexterm" name="id3117074"></a><pre class="programlisting">void                pango_font_description_set_family   (<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,                                                         const char *family);</pre><p>Sets the family name field of a font description. The familyname represents a family of related font styles, and willresolve to a particular <a href="pango-Fonts.html#PangoFontFamily"><span class="type">PangoFontFamily</span></a>. In some uses of<a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>, it is also possible to use a commaseparated list of family names for this field.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>desc</code></em>&#160;:</span></td><td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</td></tr><tr><td><span class="term"><em class="parameter"><code>family</code></em>&#160;:</span></td><td> a string representing the family name.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3117175"></a><h3><a name="pango-font-description-set-family-static"></a>pango_font_description_set_family_static ()</h3><a class="indexterm" name="id3117189"></a><pre class="programlisting">void                pango_font_description_set_family_static                                                        (<a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc,                                                         const char *family);</pre><p>Like <a href="pango-Fonts.html#pango-font-description-set-family"><code class="function">pango_font_description_set_family()</code></a>, except that nocopy of <em class="parameter"><code>family</code></em> is made. The caller must make sure that thestring passed in stays around until <em class="parameter"><code>desc</code></em> has been freedor the name is set again. This function can be used if<em class="parameter"><code>family</code></em> is a static string such as a C string literal, orif <em class="parameter"><code>desc</code></em> is only needed temporarily.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>desc</code></em>&#160;:</span></td><td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a></td></tr><tr><td><span class="term"><em class="parameter"><code>family</code></em>&#160;:</span></td><td> a string representing the family name.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3117311"></a><h3><a name="pango-font-description-get-family"></a>pango_font_description_get_family ()</h3><a class="indexterm" name="id3117325"></a><pre class="programlisting">const char*         pango_font_description_get_family   (const <a href="pango-Fonts.html#PangoFontDescription">PangoFontDescription</a> *desc);</pre><p>Gets the family name field of a font description. See<a href="pango-Fonts.html#pango-font-description-set-family"><code class="function">pango_font_description_set_family()</code></a>.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>desc</code></em>&#160;:</span></td><td> a <a href="pango-Fonts.html#PangoFontDescription"><span class="type">PangoFontDescription</span></a>.</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td><td> the family name field for the font description, or