4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>EPoolv</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
6
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7
7
<link rel="home" href="index.html" title="Evolution Shell Reference Manual">
8
8
<link rel="up" href="ch02.html" title="Basic Utility Functions">
9
9
<link rel="prev" href="eshell-Icon-Utilities-(Legacy).html" title="Icon Utilities (Legacy)">
10
10
<link rel="next" href="eshell-Printing.html" title="Printing">
11
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.17 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
38
38
<div class="refsynopsisdiv">
39
39
<a name="eshell-EPoolv.synopsis"></a><h2>Synopsis</h2>
40
40
<pre class="synopsis"> <a class="link" href="eshell-EPoolv.html#EPoolv" title="EPoolv">EPoolv</a>;
41
<a class="link" href="eshell-EPoolv.html#EPoolv" title="EPoolv"><span class="returnvalue">EPoolv</span></a> * <a class="link" href="eshell-EPoolv.html#e-poolv-new" title="e_poolv_new ()">e_poolv_new</a> (<em class="parameter"><code><span class="type">guint</span> size</code></em>);
42
<a class="link" href="eshell-EPoolv.html#EPoolv" title="EPoolv"><span class="returnvalue">EPoolv</span></a> * <a class="link" href="eshell-EPoolv.html#e-poolv-set" title="e_poolv_set ()">e_poolv_set</a> (<em class="parameter"><code><a class="link" href="eshell-EPoolv.html#EPoolv" title="EPoolv"><span class="type">EPoolv</span></a> *poolv</code></em>,
43
<em class="parameter"><code><span class="type">gint</span> index</code></em>,
44
<em class="parameter"><code><span class="type">gchar</span> *str</code></em>,
45
<em class="parameter"><code><span class="type">gint</span> freeit</code></em>);
46
const <span class="returnvalue">gchar</span> * <a class="link" href="eshell-EPoolv.html#e-poolv-get" title="e_poolv_get ()">e_poolv_get</a> (<em class="parameter"><code><a class="link" href="eshell-EPoolv.html#EPoolv" title="EPoolv"><span class="type">EPoolv</span></a> *poolv</code></em>,
47
<em class="parameter"><code><span class="type">gint</span> index</code></em>);
41
<a class="link" href="eshell-EPoolv.html#EPoolv" title="EPoolv"><span class="returnvalue">EPoolv</span></a> * <a class="link" href="eshell-EPoolv.html#e-poolv-new" title="e_poolv_new ()">e_poolv_new</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> size</code></em>);
42
<a class="link" href="eshell-EPoolv.html#EPoolv" title="EPoolv"><span class="returnvalue">EPoolv</span></a> * <a class="link" href="eshell-EPoolv.html#e-poolv-set" title="e_poolv_set ()">e_poolv_set</a> (<em class="parameter"><code><a class="link" href="eshell-EPoolv.html#EPoolv" title="EPoolv"><span class="type">EPoolv</span></a> *poolv</code></em>,
43
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> index</code></em>,
44
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>,
45
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> freeit</code></em>);
46
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="eshell-EPoolv.html#e-poolv-get" title="e_poolv_get ()">e_poolv_get</a> (<em class="parameter"><code><a class="link" href="eshell-EPoolv.html#EPoolv" title="EPoolv"><span class="type">EPoolv</span></a> *poolv</code></em>,
47
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> index</code></em>);
48
48
<span class="returnvalue">void</span> <a class="link" href="eshell-EPoolv.html#e-poolv-destroy" title="e_poolv_destroy ()">e_poolv_destroy</a> (<em class="parameter"><code><a class="link" href="eshell-EPoolv.html#EPoolv" title="EPoolv"><span class="type">EPoolv</span></a> *poolv</code></em>);
65
65
<div class="refsect2">
66
66
<a name="e-poolv-new"></a><h3>e_poolv_new ()</h3>
67
<pre class="programlisting"><a class="link" href="eshell-EPoolv.html#EPoolv" title="EPoolv"><span class="returnvalue">EPoolv</span></a> * e_poolv_new (<em class="parameter"><code><span class="type">guint</span> size</code></em>);</pre>
67
<pre class="programlisting"><a class="link" href="eshell-EPoolv.html#EPoolv" title="EPoolv"><span class="returnvalue">EPoolv</span></a> * e_poolv_new (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> size</code></em>);</pre>
69
69
Create a new <a class="link" href="eshell-EPoolv.html#EPoolv" title="EPoolv"><span class="type">EPoolv</span></a>: a string vector which shares a global string
70
70
pool. An <a class="link" href="eshell-EPoolv.html#EPoolv" title="EPoolv"><span class="type">EPoolv</span></a> can be used to work with arrays of strings which
93
93
<div class="refsect2">
94
94
<a name="e-poolv-set"></a><h3>e_poolv_set ()</h3>
95
<pre class="programlisting"><a class="link" href="eshell-EPoolv.html#EPoolv" title="EPoolv"><span class="returnvalue">EPoolv</span></a> * e_poolv_set (<em class="parameter"><code><a class="link" href="eshell-EPoolv.html#EPoolv" title="EPoolv"><span class="type">EPoolv</span></a> *poolv</code></em>,
96
<em class="parameter"><code><span class="type">gint</span> index</code></em>,
97
<em class="parameter"><code><span class="type">gchar</span> *str</code></em>,
98
<em class="parameter"><code><span class="type">gint</span> freeit</code></em>);</pre>
95
<pre class="programlisting"><a class="link" href="eshell-EPoolv.html#EPoolv" title="EPoolv"><span class="returnvalue">EPoolv</span></a> * e_poolv_set (<em class="parameter"><code><a class="link" href="eshell-EPoolv.html#EPoolv" title="EPoolv"><span class="type">EPoolv</span></a> *poolv</code></em>,
96
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> index</code></em>,
97
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>,
98
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> freeit</code></em>);</pre>
100
100
Set a string vector reference. If the caller will no longer be
101
101
referencing the string, freeit should be TRUE. Otherwise, this
132
132
<div class="refsect2">
133
133
<a name="e-poolv-get"></a><h3>e_poolv_get ()</h3>
134
<pre class="programlisting">const <span class="returnvalue">gchar</span> * e_poolv_get (<em class="parameter"><code><a class="link" href="eshell-EPoolv.html#EPoolv" title="EPoolv"><span class="type">EPoolv</span></a> *poolv</code></em>,
135
<em class="parameter"><code><span class="type">gint</span> index</code></em>);</pre>
134
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * e_poolv_get (<em class="parameter"><code><a class="link" href="eshell-EPoolv.html#EPoolv" title="EPoolv"><span class="type">EPoolv</span></a> *poolv</code></em>,
135
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> index</code></em>);</pre>
137
137
Retrieve a string by index. This could possibly just be a macro.