git.sur5r.net Git - glabels/blob - docs/libglabels/html/libglabels-str.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>String Utility Functions</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
   7 <link rel="home" href="index.html" title="LibGlabels Reference Manual">
   8 <link rel="up" href="ch03.html" title="Miscellaneous">
   9 <link rel="prev" href="libglabels-enums.html" title="Enumerations">
  10 <meta name="generator" content="GTK-Doc V1.11 (XML mode)">
  11 <link rel="stylesheet" href="style.css" type="text/css">
  12 <link rel="chapter" href="ch01.html" title="Basic LibGlabels Usage">
  13 <link rel="chapter" href="ch02.html" title="Working Directly With LibGlabels XML">
  14 <link rel="chapter" href="ch03.html" title="Miscellaneous">
  15 </head>
  16 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  17 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  18 <tr valign="middle">
  19 <td><a accesskey="p" href="libglabels-enums.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  20 <td><a accesskey="u" href="ch03.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  21 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  22 <th width="100%" align="center">LibGlabels Reference Manual</th>
  23 <td> </td>
  24 </tr>
  25 <tr><td colspan="5" class="shortcuts">
  26 <a href="#libglabels-str.synopsis" class="shortcut">Top</a>
  27                  |
  28                 <a href="#libglabels-str.description" class="shortcut">Description</a>
  29 </td></tr>
  30 </table>
  31 <div class="refentry" title="String Utility Functions">
  32 <a name="libglabels-str"></a><div class="titlepage"></div>
  33 <div class="refnamediv"><table width="100%"><tr>
  34 <td valign="top">
  35 <h2><span class="refentrytitle"><a name="libglabels-str.top_of_page"></a>String Utility Functions</span></h2>
  36 <p>String Utility Functions — String utility functions provided by libglabels</p>
  37 </td>
  38 <td valign="top" align="right"></td>
  39 </tr></table></div>
  40 <div class="refsynopsisdiv" title="Synopsis">
  41 <a name="libglabels-str.synopsis"></a><h2>Synopsis</h2>
  42 <pre class="synopsis">
  43
  44 #include &lt;libglabels/str.h&gt;
  45
  46 <a
  47 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
  48 >gint</a>                <a class="link" href="libglabels-str.html#lgl-str-utf8-casecmp" title="lgl_str_utf8_casecmp ()">lgl_str_utf8_casecmp</a>                (const <a
  49 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
  50 >gchar</a> *s1,
  51                                                          const <a
  52 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
  53 >gchar</a> *s2);
  54 </pre>
  55 </div>
  56 <div class="refsect1" title="Description">
  57 <a name="libglabels-str.description"></a><h2>Description</h2>
  58 <p>
  59 This section defines string utility functions used by libglabels and of
  60 possible use to a user of libglabels.
  61 </p>
  62 </div>
  63 <div class="refsect1" title="Details">
  64 <a name="libglabels-str.details"></a><h2>Details</h2>
  65 <div class="refsect2" title="lgl_str_utf8_casecmp ()">
  66 <a name="lgl-str-utf8-casecmp"></a><h3>lgl_str_utf8_casecmp ()</h3>
  67 <pre class="programlisting"><a
  68 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
  69 >gint</a>                lgl_str_utf8_casecmp                (const <a
  70 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
  71 >gchar</a> *s1,
  72                                                          const <a
  73 href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"
  74 >gchar</a> *s2);</pre>
  75 <p>
  76 Compare two UTF-8 strings, ignoring the case of characters.
  77 </p>
  78 <p>
  79 This function should be used only on strings that are known to be encoded
  80 in UTF-8 or a compatible UTF-8 subset.</p>
  81 <p>
  82 </p>
  83 <div class="variablelist"><table border="0">
  84 <col align="left" valign="top">
  85 <tbody>
  86 <tr>
  87 <td><p><span class="term"><em class="parameter"><code>s1</code></em> :</span></p></td>
  88 <td> string to compare with s2.
  89 </td>
  90 </tr>
  91 <tr>
  92 <td><p><span class="term"><em class="parameter"><code>s2</code></em> :</span></p></td>
  93 <td> string to compare with s1.
  94 </td>
  95 </tr>
  96 <tr>
  97 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
  98 <td> 0 if the strings match, a negative value if s1 &lt; s2,
  99          or a positive value if s1 &gt; s2.
 100
 101 </td>
 102 </tr>
 103 </tbody>
 104 </table></div>
 105 </div>
 106 </div>
 107 </div>
 108 <div class="footer">
 109 <hr>
 110           Generated by GTK-Doc V1.11</div>
 111 </body>
 112 </html>