glib-strings.html

来自「最新gtk中文资料集」· HTML 代码 · 共 1,286 行 · 第 1/5 页

<a name="g-string-sized-new"></a>g_string_sized_new ()</h3>
<a class="indexterm" name="id3301850"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_sized_new                  (<a class="link" href="glib-Basic-Types.html#gsize">gsize</a> dfl_size);</pre>
<p>
Creates a new <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>, with enough space for <em class="parameter"><code>dfl_size</code></em> 
bytes. This is useful if you are going to add a lot of 
text to the string and don't want it to be reallocated 
too often.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>dfl_size</code></em>&#160;:</span></p></td>
<td> the default size of the space allocated to 
           hold the string
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the new <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3301935"></a><h3>
<a name="g-string-assign"></a>g_string_assign ()</h3>
<a class="indexterm" name="id3301948"></a><pre class="programlisting"><a class="link" href="glib-Strings.html#GString">GString</a>*            g_string_assign                     (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *rval);</pre>
<p>
Copies the bytes from a string into a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>, 
destroying any previous contents. It is rather like 
the standard <code class="function">strcpy()</code> function, except that you do not 
have to worry about having enough space to copy the string.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></p></td>
<td> the destination <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>. Its current contents 
         are destroyed.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>rval</code></em>&#160;:</span></p></td>
<td> the string to copy into <em class="parameter"><code>string</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <em class="parameter"><code>string</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3302072"></a><h3>
<a name="g-string-sprintf"></a>g_string_sprintf</h3>
<a class="indexterm" name="id3302088"></a><pre class="programlisting">#define             g_string_sprintf</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">g_string_sprintf</code> is deprecated and should not be used in newly-written code. This function has been renamed to <a class="link" href="glib-Strings.html#g-string-printf"><code class="function">g_string_printf()</code></a>.</p>
</div>
<p>
Writes a formatted string into a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>.
This is similar to the standard <code class="function">sprintf()</code> function,
except that the <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a> buffer automatically expands 
to contain the results. The previous contents of the 
<a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a> are destroyed.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>format</code></em>&#160;:</span></p></td>
<td> the string format. See the <code class="function">sprintf()</code> documentation
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></p></td>
<td> the parameters to insert into the format string
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3302231"></a><h3>
<a name="g-string-sprintfa"></a>g_string_sprintfa</h3>
<a class="indexterm" name="id3302247"></a><pre class="programlisting">#define             g_string_sprintfa</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">g_string_sprintfa</code> is deprecated and should not be used in newly-written code. This function has been renamed to <a class="link" href="glib-Strings.html#g-string-append-printf"><code class="function">g_string_append_printf()</code></a></p>
</div>
<p>
Appends a formatted string onto the end of a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>.
This function is similar to <a class="link" href="glib-Strings.html#g-string-sprintf"><code class="function">g_string_sprintf()</code></a> except that
the text is appended to the <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>format</code></em>&#160;:</span></p></td>
<td> the string format. See the <code class="function">sprintf()</code> documentation
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></p></td>
<td> the parameters to insert into the format string
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3302381"></a><h3>
<a name="g-string-vprintf"></a>g_string_vprintf ()</h3>
<a class="indexterm" name="id3302396"></a><pre class="programlisting">void                g_string_vprintf                    (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *format,
                                                         va_list args);</pre>
<p>
Writes a formatted string into a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>. 
This function is similar to <a class="link" href="glib-Strings.html#g-string-printf"><code class="function">g_string_printf()</code></a> except that 
the arguments to the format string are passed as a va_list.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>format</code></em>&#160;:</span></p></td>
<td> the string format. See the <code class="function">printf()</code> documentation
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>args</code></em>&#160;:</span></p></td>
<td> the parameters to insert into the format string
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.14
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3302536"></a><h3>
<a name="g-string-append-vprintf"></a>g_string_append_vprintf ()</h3>
<a class="indexterm" name="id3302552"></a><pre class="programlisting">void                g_string_append_vprintf             (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *format,
                                                         va_list args);</pre>
<p>
Appends a formatted string onto the end of a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>.
This function is similar to <a class="link" href="glib-Strings.html#g-string-append-printf"><code class="function">g_string_append_printf()</code></a>
except that the arguments to the format string are passed
as a va_list.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>format</code></em>&#160;:</span></p></td>
<td> the string format. See the <code class="function">printf()</code> documentation
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>args</code></em>&#160;:</span></p></td>
<td> the list of arguments to insert in the output
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.14
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3302692"></a><h3>
<a name="g-string-printf"></a>g_string_printf ()</h3>
<a class="indexterm" name="id3302705"></a><pre class="programlisting">void                g_string_printf                     (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *format,
                                                         ...);</pre>
<p>
Writes a formatted string into a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>.
This is similar to the standard <code class="function">sprintf()</code> function,
except that the <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a> buffer automatically expands 
to contain the results. The previous contents of the 
<a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a> are destroyed.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Strings.html#GString"><span class="type">GString</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>format</code></em>&#160;:</span></p></td>
<td> the string format. See the <code class="function">printf()</code> documentation
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></p></td>
<td> the parameters to insert into the format string
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3302847"></a><h3>
<a name="g-string-append-printf"></a>g_string_append_printf ()</h3>
<a class="indexterm" name="id3302860"></a><pre class="programlisting">void                g_string_append_printf              (<a class="link" href="glib-Strings.html#GString">GString</a> *string,
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *format,
                                                         ...);</pre>