← Back to branch summary

~ubuntu-branches/debian/squeeze/glib2.0/squeeze

« back to all changes in this revision

Viewing changes to docs/reference/glib/html/glib-String-Chunks.html

  • Committer: Bazaar Package Importer
  • Author(s): Gustavo Noronha Silva
  • Date: 2009-02-15 13:00:43 UTC
  • mfrom: (1.3.1 upstream) (69.1.10 intrepid)
  • Revision ID: james.westby@ubuntu.com-20090215130043-q47fbt3owmt42m2f
Tags: 2.18.4-2
* Release to unstable
* debian/rules:
- bump SHVER, since we are already forcing a 2.18.0 dependecy on the
  symbols introduced in the development versions
* debian/control.in:
- added Homepage and Vcs-* control fields

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/glib/html/glib-String-Chunks.html
1
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
2
<html>
3
3
<head>
4
 
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
 
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>String Chunks</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
7
 
<link rel="start" href="index.html" title="GLib Reference Manual">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
 
7
<link rel="home" href="index.html" title="GLib Reference Manual">
8
8
<link rel="up" href="glib-data-types.html" title="GLib Data Types">
9
9
<link rel="prev" href="glib-Strings.html" title="Strings">
10
10
<link rel="next" href="glib-Arrays.html" title="Arrays">
11
 
<meta name="generator" content="GTK-Doc V1.9 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="chapter" href="glib.html" title="GLib Overview">
14
14
<link rel="chapter" href="glib-fundamentals.html" title="GLib Fundamentals">
26
26
<link rel="index" href="ix08.html" title="Index of new symbols in 2.12">
27
27
<link rel="index" href="ix09.html" title="Index of new symbols in 2.14">
28
28
<link rel="index" href="ix10.html" title="Index of new symbols in 2.16">
 
29
<link rel="index" href="ix11.html" title="Index of new symbols in 2.18">
29
30
</head>
30
31
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
31
32
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
36
37
<th width="100%" align="center">GLib Reference Manual</th>
37
38
<td><a accesskey="n" href="glib-Arrays.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
38
39
</tr>
39
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3369084" class="shortcut">Top</a>
40
 
                  &#160;|&#160;
41
 
                  <a href="#id3369277" class="shortcut">Description</a></nobr></td></tr>
 
40
<tr><td colspan="5" class="shortcuts">
 
41
<a href="#glib-String-Chunks.synopsis" class="shortcut">Top</a>
 
42
                 | 
 
43
                <a href="#glib-String-Chunks.description" class="shortcut">Description</a>
 
44
</td></tr>
42
45
</table>
43
46
<div class="refentry" lang="en">
44
47
<a name="glib-String-Chunks"></a><div class="titlepage"></div>
45
48
<div class="refnamediv"><table width="100%"><tr>
46
49
<td valign="top">
47
 
<h2>
48
 
<a name="id3369084"></a><span class="refentrytitle">String Chunks</span>
49
 
</h2>
50
 
<p>String Chunks &#8212; efficient storage of groups of strings</p>
 
50
<h2><span class="refentrytitle"><a name="glib-String-Chunks.top_of_page"></a>String Chunks</span></h2>
 
51
<p>String Chunks — efficient storage of groups of strings</p>
51
52
</td>
52
53
<td valign="top" align="right"></td>
53
54
</tr></table></div>
54
55
<div class="refsynopsisdiv">
55
 
<h2>Synopsis</h2>
 
56
<a name="glib-String-Chunks.synopsis"></a><h2>Synopsis</h2>
56
57
<pre class="synopsis">
57
58
 
58
59
#include &lt;glib.h&gt;
59
60
 
60
 
 
61
 
                    <a class="link" href="glib-String-Chunks.html#GStringChunk">GStringChunk</a>;
62
 
<a class="link" href="glib-String-Chunks.html#GStringChunk">GStringChunk</a>*       <a class="link" href="glib-String-Chunks.html#g-string-chunk-new">g_string_chunk_new</a>                  (<a class="link" href="glib-Basic-Types.html#gsize">gsize</a> size);
63
 
<a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert">g_string_chunk_insert</a>               (<a class="link" href="glib-String-Chunks.html#GStringChunk">GStringChunk</a> *chunk,
64
 
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string);
65
 
<a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const">g_string_chunk_insert_const</a>         (<a class="link" href="glib-String-Chunks.html#GStringChunk">GStringChunk</a> *chunk,
66
 
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string);
67
 
<a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-len">g_string_chunk_insert_len</a>           (<a class="link" href="glib-String-Chunks.html#GStringChunk">GStringChunk</a> *chunk,
68
 
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
69
 
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> len);
70
 
void                <a class="link" href="glib-String-Chunks.html#g-string-chunk-clear">g_string_chunk_clear</a>                (<a class="link" href="glib-String-Chunks.html#GStringChunk">GStringChunk</a> *chunk);
71
 
void                <a class="link" href="glib-String-Chunks.html#g-string-chunk-free">g_string_chunk_free</a>                 (<a class="link" href="glib-String-Chunks.html#GStringChunk">GStringChunk</a> *chunk);
 
61
                    <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk">GStringChunk</a>;
 
62
<a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk">GStringChunk</a>*       <a class="link" href="glib-String-Chunks.html#g-string-chunk-new" title="g_string_chunk_new ()">g_string_chunk_new</a>                  (<a class="link" href="glib-Basic-Types.html#gsize" title="gsize">gsize</a> size);
 
63
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a>*              <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert" title="g_string_chunk_insert ()">g_string_chunk_insert</a>               (<a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk">GStringChunk</a> *chunk,
 
64
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string);
 
65
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a>*              <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const" title="g_string_chunk_insert_const ()">g_string_chunk_insert_const</a>         (<a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk">GStringChunk</a> *chunk,
 
66
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string);
 
67
<a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a>*              <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-len" title="g_string_chunk_insert_len ()">g_string_chunk_insert_len</a>           (<a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk">GStringChunk</a> *chunk,
 
68
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
 
69
                                                         <a class="link" href="glib-Basic-Types.html#gssize" title="gssize">gssize</a> len);
 
70
void                <a class="link" href="glib-String-Chunks.html#g-string-chunk-clear" title="g_string_chunk_clear ()">g_string_chunk_clear</a>                (<a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk">GStringChunk</a> *chunk);
 
71
void                <a class="link" href="glib-String-Chunks.html#g-string-chunk-free" title="g_string_chunk_free ()">g_string_chunk_free</a>                 (<a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk">GStringChunk</a> *chunk);
72
72
</pre>
73
73
</div>
74
74
<div class="refsect1" lang="en">
75
 
<a name="id3369277"></a><h2>Description</h2>
 
75
<a name="glib-String-Chunks.description"></a><h2>Description</h2>
76
76
<p>
77
77
String chunks are used to store groups of strings.
78
 
Memory is allocated in blocks, and as strings are added to the <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>
 
78
Memory is allocated in blocks, and as strings are added to the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>
79
79
they are copied into the next free position in a block. When a block is
80
80
full a new block is allocated.
81
81
</p>
82
82
<p>
83
83
When storing a large number of strings, string chunks are more efficient
84
 
than using <a class="link" href="glib-String-Utility-Functions.html#g-strdup"><code class="function">g_strdup()</code></a> since fewer calls to <code class="function">malloc()</code> are needed, and less 
 
84
than using <a class="link" href="glib-String-Utility-Functions.html#g-strdup" title="g_strdup ()"><code class="function">g_strdup()</code></a> since fewer calls to <code class="function">malloc()</code> are needed, and less
85
85
memory is wasted in memory allocation overheads.
86
86
</p>
87
87
<p>
88
 
By adding strings with <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const"><code class="function">g_string_chunk_insert_const()</code></a> it is also possible
 
88
By adding strings with <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const" title="g_string_chunk_insert_const ()"><code class="function">g_string_chunk_insert_const()</code></a> it is also possible
89
89
to remove duplicates.
90
90
</p>
91
91
<p>
92
 
To create a new <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a> use <a class="link" href="glib-String-Chunks.html#g-string-chunk-new"><code class="function">g_string_chunk_new()</code></a>.
93
 
</p>
94
 
<p>
95
 
To add strings to a <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a> use <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert"><code class="function">g_string_chunk_insert()</code></a>.
96
 
</p>
97
 
<p>
98
 
To add strings to a <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>, but without duplicating strings which are
99
 
already in the <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>, use <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const"><code class="function">g_string_chunk_insert_const()</code></a>.
100
 
</p>
101
 
<p>
102
 
To free the entire <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a> use <a class="link" href="glib-String-Chunks.html#g-string-chunk-free"><code class="function">g_string_chunk_free()</code></a>.
 
92
To create a new <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a> use <a class="link" href="glib-String-Chunks.html#g-string-chunk-new" title="g_string_chunk_new ()"><code class="function">g_string_chunk_new()</code></a>.
 
93
</p>
 
94
<p>
 
95
To add strings to a <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a> use <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert" title="g_string_chunk_insert ()"><code class="function">g_string_chunk_insert()</code></a>.
 
96
</p>
 
97
<p>
 
98
To add strings to a <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>, but without duplicating strings which are
 
99
already in the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>, use <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const" title="g_string_chunk_insert_const ()"><code class="function">g_string_chunk_insert_const()</code></a>.
 
100
</p>
 
101
<p>
 
102
To free the entire <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a> use <a class="link" href="glib-String-Chunks.html#g-string-chunk-free" title="g_string_chunk_free ()"><code class="function">g_string_chunk_free()</code></a>.
103
103
It is not possible to free individual strings.
104
104
</p>
105
105
</div>
106
106
<div class="refsect1" lang="en">
107
 
<a name="id3369447"></a><h2>Details</h2>
 
107
<a name="glib-String-Chunks.details"></a><h2>Details</h2>
108
108
<div class="refsect2" lang="en">
109
 
<a name="id3369457"></a><h3>
110
 
<a name="GStringChunk"></a>GStringChunk</h3>
111
 
<a class="indexterm" name="id3369469"></a><pre class="programlisting">typedef struct _GStringChunk GStringChunk;</pre>
 
109
<a name="GStringChunk"></a><h3>GStringChunk</h3>
 
110
<pre class="programlisting">typedef struct _GStringChunk GStringChunk;</pre>
112
111
<p>
113
112
An opaque data structure representing String Chunks.
114
113
It should only be accessed by using the following functions.
116
115
</div>
117
116
<hr>
118
117
<div class="refsect2" lang="en">
119
 
<a name="id3369487"></a><h3>
120
 
<a name="g-string-chunk-new"></a>g_string_chunk_new ()</h3>
121
 
<a class="indexterm" name="id3369500"></a><pre class="programlisting"><a class="link" href="glib-String-Chunks.html#GStringChunk">GStringChunk</a>*       g_string_chunk_new                  (<a class="link" href="glib-Basic-Types.html#gsize">gsize</a> size);</pre>
122
 
<p>
123
 
Creates a new <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>.</p>
124
 
<p>
125
 
 
 
118
<a name="g-string-chunk-new"></a><h3>g_string_chunk_new ()</h3>
 
119
<pre class="programlisting"><a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk">GStringChunk</a>*       g_string_chunk_new                  (<a class="link" href="glib-Basic-Types.html#gsize" title="gsize">gsize</a> size);</pre>
 
120
<p>
 
121
Creates a new <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>.</p>
 
122
<p>
126
123
</p>
127
124
<div class="variablelist"><table border="0">
128
125
<col align="left" valign="top">
129
126
<tbody>
130
127
<tr>
131
 
<td><p><span class="term"><em class="parameter"><code>size</code></em>&#160;:</span></p></td>
 
128
<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
132
129
<td> the default size of the blocks of memory which are 
133
130
       allocated to store the strings. If a particular string 
134
131
       is larger than this default size, a larger block of 
136
133
</td>
137
134
</tr>
138
135
<tr>
139
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
140
 
<td> a new <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>
 
136
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
137
<td> a new <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>
141
138
</td>
142
139
</tr>
143
140
</tbody>
145
142
</div>
146
143
<hr>
147
144
<div class="refsect2" lang="en">
148
 
<a name="id3369580"></a><h3>
149
 
<a name="g-string-chunk-insert"></a>g_string_chunk_insert ()</h3>
150
 
<a class="indexterm" name="id3369594"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_string_chunk_insert               (<a class="link" href="glib-String-Chunks.html#GStringChunk">GStringChunk</a> *chunk,
151
 
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string);</pre>
 
145
<a name="g-string-chunk-insert"></a><h3>g_string_chunk_insert ()</h3>
 
146
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a>*              g_string_chunk_insert               (<a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk">GStringChunk</a> *chunk,
 
147
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string);</pre>
152
148
<p>
153
 
Adds a copy of <em class="parameter"><code>string</code></em> to the <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>.
 
149
Adds a copy of <em class="parameter"><code>string</code></em> to the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>.
154
150
It returns a pointer to the new copy of the string 
155
 
in the <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>. The characters in the string 
 
151
in the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>. The characters in the string 
156
152
can be changed, if necessary, though you should not 
157
153
change anything after the end of the string.
158
154
</p>
159
155
<p>
160
 
Unlike <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const"><code class="function">g_string_chunk_insert_const()</code></a>, this function 
 
156
Unlike <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const" title="g_string_chunk_insert_const ()"><code class="function">g_string_chunk_insert_const()</code></a>, this function 
161
157
does not check for duplicates. Also strings added 
162
 
with <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert"><code class="function">g_string_chunk_insert()</code></a> will not be searched 
163
 
by <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const"><code class="function">g_string_chunk_insert_const()</code></a> when looking for 
 
158
with <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert" title="g_string_chunk_insert ()"><code class="function">g_string_chunk_insert()</code></a> will not be searched 
 
159
by <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const" title="g_string_chunk_insert_const ()"><code class="function">g_string_chunk_insert_const()</code></a> when looking for 
164
160
duplicates.</p>
165
161
<p>
166
 
 
167
162
</p>
168
163
<div class="variablelist"><table border="0">
169
164
<col align="left" valign="top">
170
165
<tbody>
171
166
<tr>
172
 
<td><p><span class="term"><em class="parameter"><code>chunk</code></em>&#160;:</span></p></td>
173
 
<td> a <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>
 
167
<td><p><span class="term"><em class="parameter"><code>chunk</code></em> :</span></p></td>
 
168
<td> a <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>
174
169
</td>
175
170
</tr>
176
171
<tr>
177
 
<td><p><span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></p></td>
 
172
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
178
173
<td> the string to add
179
174
</td>
180
175
</tr>
181
176
<tr>
182
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
177
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
183
178
<td> a pointer to the copy of <em class="parameter"><code>string</code></em> within 
184
 
         the <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>
 
179
         the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>
185
180
</td>
186
181
</tr>
187
182
</tbody>
189
184
</div>
190
185
<hr>
191
186
<div class="refsect2" lang="en">
192
 
<a name="id3369763"></a><h3>
193
 
<a name="g-string-chunk-insert-const"></a>g_string_chunk_insert_const ()</h3>
194
 
<a class="indexterm" name="id3369777"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_string_chunk_insert_const         (<a class="link" href="glib-String-Chunks.html#GStringChunk">GStringChunk</a> *chunk,
195
 
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string);</pre>
 
187
<a name="g-string-chunk-insert-const"></a><h3>g_string_chunk_insert_const ()</h3>
 
188
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a>*              g_string_chunk_insert_const         (<a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk">GStringChunk</a> *chunk,
 
189
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string);</pre>
196
190
<p>
197
 
Adds a copy of <em class="parameter"><code>string</code></em> to the <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>, unless the same 
198
 
string has already been added to the <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a> with 
199
 
<a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const"><code class="function">g_string_chunk_insert_const()</code></a>.
 
191
Adds a copy of <em class="parameter"><code>string</code></em> to the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>, unless the same 
 
192
string has already been added to the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a> with 
 
193
<a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const" title="g_string_chunk_insert_const ()"><code class="function">g_string_chunk_insert_const()</code></a>.
200
194
</p>
201
195
<p>
202
196
This function is useful if you need to copy a large number 
206
200
should be done very carefully.
207
201
</p>
208
202
<p>
209
 
Note that <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const"><code class="function">g_string_chunk_insert_const()</code></a> will not return a 
210
 
pointer to a string added with <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert"><code class="function">g_string_chunk_insert()</code></a>, even 
 
203
Note that <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert-const" title="g_string_chunk_insert_const ()"><code class="function">g_string_chunk_insert_const()</code></a> will not return a 
 
204
pointer to a string added with <a class="link" href="glib-String-Chunks.html#g-string-chunk-insert" title="g_string_chunk_insert ()"><code class="function">g_string_chunk_insert()</code></a>, even 
211
205
if they do match.</p>
212
206
<p>
213
 
 
214
207
</p>
215
208
<div class="variablelist"><table border="0">
216
209
<col align="left" valign="top">
217
210
<tbody>
218
211
<tr>
219
 
<td><p><span class="term"><em class="parameter"><code>chunk</code></em>&#160;:</span></p></td>
220
 
<td> a <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>
 
212
<td><p><span class="term"><em class="parameter"><code>chunk</code></em> :</span></p></td>
 
213
<td> a <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>
221
214
</td>
222
215
</tr>
223
216
<tr>
224
 
<td><p><span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></p></td>
 
217
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
225
218
<td> the string to add
226
219
</td>
227
220
</tr>
228
221
<tr>
229
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
222
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
230
223
<td> a pointer to the new or existing copy of <em class="parameter"><code>string</code></em> 
231
 
         within the <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>
 
224
         within the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>
232
225
</td>
233
226
</tr>
234
227
</tbody>
236
229
</div>
237
230
<hr>
238
231
<div class="refsect2" lang="en">
239
 
<a name="id3369952"></a><h3>
240
 
<a name="g-string-chunk-insert-len"></a>g_string_chunk_insert_len ()</h3>
241
 
<a class="indexterm" name="id3369967"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_string_chunk_insert_len           (<a class="link" href="glib-String-Chunks.html#GStringChunk">GStringChunk</a> *chunk,
242
 
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *string,
243
 
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> len);</pre>
 
232
<a name="g-string-chunk-insert-len"></a><h3>g_string_chunk_insert_len ()</h3>
 
233
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a>*              g_string_chunk_insert_len           (<a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk">GStringChunk</a> *chunk,
 
234
                                                         const <a class="link" href="glib-Basic-Types.html#gchar" title="gchar">gchar</a> *string,
 
235
                                                         <a class="link" href="glib-Basic-Types.html#gssize" title="gssize">gssize</a> len);</pre>
244
236
<p>
245
 
Adds a copy of the first <em class="parameter"><code>len</code></em> bytes of <em class="parameter"><code>string</code></em> to the <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>. 
 
237
Adds a copy of the first <em class="parameter"><code>len</code></em> bytes of <em class="parameter"><code>string</code></em> to the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>. 
246
238
The copy is nul-terminated.
247
239
</p>
248
240
<p>
254
246
The characters in the returned string can be changed, if necessary, 
255
247
though you should not change anything after the end of the string.</p>
256
248
<p>
257
 
 
258
249
</p>
259
250
<div class="variablelist"><table border="0">
260
251
<col align="left" valign="top">
261
252
<tbody>
262
253
<tr>
263
 
<td><p><span class="term"><em class="parameter"><code>chunk</code></em>&#160;:</span></p></td>
264
 
<td> a <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>
 
254
<td><p><span class="term"><em class="parameter"><code>chunk</code></em> :</span></p></td>
 
255
<td> a <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>
265
256
</td>
266
257
</tr>
267
258
<tr>
268
 
<td><p><span class="term"><em class="parameter"><code>string</code></em>&#160;:</span></p></td>
 
259
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
269
260
<td> bytes to insert
270
261
</td>
271
262
</tr>
272
263
<tr>
273
 
<td><p><span class="term"><em class="parameter"><code>len</code></em>&#160;:</span></p></td>
 
264
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
274
265
<td> number of bytes of <em class="parameter"><code>string</code></em> to insert, or -1 to insert a 
275
266
    nul-terminated string 
276
267
</td>
277
268
</tr>
278
269
<tr>
279
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
280
 
<td> a pointer to the copy of <em class="parameter"><code>string</code></em> within the <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>
 
270
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
271
<td> a pointer to the copy of <em class="parameter"><code>string</code></em> within the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>
281
272
 
282
273
</td>
283
274
</tr>
284
275
</tbody>
285
276
</table></div>
286
 
<p class="since">Since  2.4
287
 
</p>
288
 
</div>
289
 
<hr>
290
 
<div class="refsect2" lang="en">
291
 
<a name="id3370150"></a><h3>
292
 
<a name="g-string-chunk-clear"></a>g_string_chunk_clear ()</h3>
293
 
<a class="indexterm" name="id3370165"></a><pre class="programlisting">void                g_string_chunk_clear                (<a class="link" href="glib-String-Chunks.html#GStringChunk">GStringChunk</a> *chunk);</pre>
294
 
<p>
295
 
Frees all strings contained within the <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>.
296
 
After calling <a class="link" href="glib-String-Chunks.html#g-string-chunk-clear"><code class="function">g_string_chunk_clear()</code></a> it is not safe to
297
 
access any of the strings which were contained within it.</p>
298
 
<p>
299
 
 
300
 
</p>
301
 
<div class="variablelist"><table border="0">
302
 
<col align="left" valign="top">
303
 
<tbody><tr>
304
 
<td><p><span class="term"><em class="parameter"><code>chunk</code></em>&#160;:</span></p></td>
305
 
<td> a <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>
306
 
</td>
307
 
</tr></tbody>
308
 
</table></div>
309
 
<p class="since">Since  2.14
310
 
</p>
311
 
</div>
312
 
<hr>
313
 
<div class="refsect2" lang="en">
314
 
<a name="id3370252"></a><h3>
315
 
<a name="g-string-chunk-free"></a>g_string_chunk_free ()</h3>
316
 
<a class="indexterm" name="id3370266"></a><pre class="programlisting">void                g_string_chunk_free                 (<a class="link" href="glib-String-Chunks.html#GStringChunk">GStringChunk</a> *chunk);</pre>
317
 
<p>
318
 
Frees all memory allocated by the <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a>.
319
 
After calling <a class="link" href="glib-String-Chunks.html#g-string-chunk-free"><code class="function">g_string_chunk_free()</code></a> it is not safe to
320
 
access any of the strings which were contained within it.</p>
321
 
<p>
322
 
 
323
 
</p>
324
 
<div class="variablelist"><table border="0">
325
 
<col align="left" valign="top">
326
 
<tbody><tr>
327
 
<td><p><span class="term"><em class="parameter"><code>chunk</code></em>&#160;:</span></p></td>
328
 
<td> a <a class="link" href="glib-String-Chunks.html#GStringChunk"><span class="type">GStringChunk</span></a> 
329
 
</td>
330
 
</tr></tbody>
331
 
</table></div>
332
 
</div>
333
 
</div>
334
 
<div class="refsect1" lang="en">
335
 
<a name="id3370345"></a><div class="refsect2" lang="en"><a name="id3370346"></a></div>
336
 
<hr>
337
 
<div class="refsect2" lang="en"><a name="id3370347"></a></div>
338
 
</div>
339
 
</div>
 
277
<p class="since">Since 2.4</p>
 
278
</div>
 
279
<hr>
 
280
<div class="refsect2" lang="en">
 
281
<a name="g-string-chunk-clear"></a><h3>g_string_chunk_clear ()</h3>
 
282
<pre class="programlisting">void                g_string_chunk_clear                (<a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk">GStringChunk</a> *chunk);</pre>
 
283
<p>
 
284
Frees all strings contained within the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>.
 
285
After calling <a class="link" href="glib-String-Chunks.html#g-string-chunk-clear" title="g_string_chunk_clear ()"><code class="function">g_string_chunk_clear()</code></a> it is not safe to
 
286
access any of the strings which were contained within it.</p>
 
287
<p>
 
288
</p>
 
289
<div class="variablelist"><table border="0">
 
290
<col align="left" valign="top">
 
291
<tbody><tr>
 
292
<td><p><span class="term"><em class="parameter"><code>chunk</code></em> :</span></p></td>
 
293
<td> a <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>
 
294
</td>
 
295
</tr></tbody>
 
296
</table></div>
 
297
<p class="since">Since 2.14</p>
 
298
</div>
 
299
<hr>
 
300
<div class="refsect2" lang="en">
 
301
<a name="g-string-chunk-free"></a><h3>g_string_chunk_free ()</h3>
 
302
<pre class="programlisting">void                g_string_chunk_free                 (<a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk">GStringChunk</a> *chunk);</pre>
 
303
<p>
 
304
Frees all memory allocated by the <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a>.
 
305
After calling <a class="link" href="glib-String-Chunks.html#g-string-chunk-free" title="g_string_chunk_free ()"><code class="function">g_string_chunk_free()</code></a> it is not safe to
 
306
access any of the strings which were contained within it.</p>
 
307
<p>
 
308
</p>
 
309
<div class="variablelist"><table border="0">
 
310
<col align="left" valign="top">
 
311
<tbody><tr>
 
312
<td><p><span class="term"><em class="parameter"><code>chunk</code></em> :</span></p></td>
 
313
<td> a <a class="link" href="glib-String-Chunks.html#GStringChunk" title="GStringChunk"><span class="type">GStringChunk</span></a> 
 
314
</td>
 
315
</tr></tbody>
 
316
</table></div>
 
317
</div>
 
318
</div>
 
319
</div>
 
320
<div class="footer">
 
321
<hr>
 
322
          Generated by GTK-Doc V1.11</div>
340
323
</body>
341
324
</html>