"Initial commit to Gerrit"
[profile/ivi/libgsf.git] / doc / html / gsf-Reading-and-Writing-from-local-files-and-directories.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>Reading and Writing from local files and directories</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
7 <link rel="home" href="index.html" title="GSF Reference Manual">
8 <link rel="up" href="sources.html" title="Stream Sources">
9 <link rel="prev" href="gsf-Outfile-writing-structed-files.html" title="Outfile writing structed files">
10 <link rel="next" href="gsf-memory.html" title="memory">
11 <meta name="generator" content="GTK-Doc V1.14 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
13 </head>
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16 <tr valign="middle">
17 <td><a accesskey="p" href="gsf-Outfile-writing-structed-files.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="sources.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20 <th width="100%" align="center">GSF Reference Manual</th>
21 <td><a accesskey="n" href="gsf-memory.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22 </tr>
23 <tr><td colspan="5" class="shortcuts">
24 <a href="#gsf-Reading-and-Writing-from-local-files-and-directories.synopsis" class="shortcut">Top</a>
25                    | 
26                   <a href="#gsf-Reading-and-Writing-from-local-files-and-directories.description" class="shortcut">Description</a>
27                    | 
28                   <a href="#gsf-Reading-and-Writing-from-local-files-and-directories.object-hierarchy" class="shortcut">Object Hierarchy</a>
29 </td></tr>
30 </table>
31 <div class="refentry" title="Reading and Writing from local files and directories">
32 <a name="gsf-Reading-and-Writing-from-local-files-and-directories"></a><div class="titlepage"></div>
33 <div class="refnamediv"><table width="100%"><tr>
34 <td valign="top">
35 <h2><span class="refentrytitle"><a name="gsf-Reading-and-Writing-from-local-files-and-directories.top_of_page"></a>Reading and Writing from local files and directories</span></h2>
36 <p>Reading and Writing from local files and directories</p>
37 </td>
38 <td valign="top" align="right"></td>
39 </tr></table></div>
40 <div class="refsynopsisdiv" title="Synopsis">
41 <a name="gsf-Reading-and-Writing-from-local-files-and-directories.synopsis"></a><h2>Synopsis</h2>
42 <a name="GsfInputStdio"></a><a name="GsfOutputStdio"></a><a name="GsfOutfileStdio"></a><a name="GsfInfileStdio"></a><pre class="synopsis">                    <a class="link" href="gsf-Reading-and-Writing-from-local-files-and-directories.html#GsfInputStdio-struct" title="GsfInputStdio">GsfInputStdio</a>;
43 <a class="link" href="gsf-Input-from-unstructured-files.html#GsfInput"><span class="returnvalue">GsfInput</span></a> *          <a class="link" href="gsf-Reading-and-Writing-from-local-files-and-directories.html#gsf-input-stdio-new" title="gsf_input_stdio_new ()">gsf_input_stdio_new</a>                 (<em class="parameter"><code><span class="type">char</span> const *filename</code></em>,
44                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
45 <a class="link" href="gsf-Input-from-unstructured-files.html#GsfInput"><span class="returnvalue">GsfInput</span></a> *          <a class="link" href="gsf-Reading-and-Writing-from-local-files-and-directories.html#gsf-input-stdio-new-FILE" title="gsf_input_stdio_new_FILE ()">gsf_input_stdio_new_FILE</a>            (<em class="parameter"><code><span class="type">char</span> const *filename</code></em>,
46                                                          <em class="parameter"><code><span class="type">FILE</span> *file</code></em>,
47                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> keep_open</code></em>);
48                     <a class="link" href="gsf-Reading-and-Writing-from-local-files-and-directories.html#GsfOutputStdio-struct" title="GsfOutputStdio">GsfOutputStdio</a>;
49 <a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="returnvalue">GsfOutput</span></a> *         <a class="link" href="gsf-Reading-and-Writing-from-local-files-and-directories.html#gsf-output-stdio-new" title="gsf_output_stdio_new ()">gsf_output_stdio_new</a>                (<em class="parameter"><code><span class="type">char</span> const *filename</code></em>,
50                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
51 <a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="returnvalue">GsfOutput</span></a> *         <a class="link" href="gsf-Reading-and-Writing-from-local-files-and-directories.html#gsf-output-stdio-new-full" title="gsf_output_stdio_new_full ()">gsf_output_stdio_new_full</a>           (<em class="parameter"><code><span class="type">char</span> const *filename</code></em>,
52                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>,
53                                                          <em class="parameter"><code><span class="type">char</span> const *first_property_name</code></em>,
54                                                          <em class="parameter"><code>...</code></em>);
55 <a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="returnvalue">GsfOutput</span></a> *         <a class="link" href="gsf-Reading-and-Writing-from-local-files-and-directories.html#gsf-output-stdio-new-valist" title="gsf_output_stdio_new_valist ()">gsf_output_stdio_new_valist</a>         (<em class="parameter"><code><span class="type">char</span> const *filename</code></em>,
56                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>,
57                                                          <em class="parameter"><code><span class="type">char</span> const *first_property_name</code></em>,
58                                                          <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);
59 <a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="returnvalue">GsfOutput</span></a> *         <a class="link" href="gsf-Reading-and-Writing-from-local-files-and-directories.html#gsf-output-stdio-new-FILE" title="gsf_output_stdio_new_FILE ()">gsf_output_stdio_new_FILE</a>           (<em class="parameter"><code><span class="type">char</span> const *filename</code></em>,
60                                                          <em class="parameter"><code><span class="type">FILE</span> *file</code></em>,
61                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> keep_open</code></em>);
62                     <a class="link" href="gsf-Reading-and-Writing-from-local-files-and-directories.html#GsfOutfileStdio-struct" title="GsfOutfileStdio">GsfOutfileStdio</a>;
63 <a class="link" href="gsf-Outfile-writing-structed-files.html#GsfOutfile"><span class="returnvalue">GsfOutfile</span></a> *        <a class="link" href="gsf-Reading-and-Writing-from-local-files-and-directories.html#gsf-outfile-stdio-new" title="gsf_outfile_stdio_new ()">gsf_outfile_stdio_new</a>               (<em class="parameter"><code><span class="type">char</span> const *root</code></em>,
64                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
65 <a class="link" href="gsf-Outfile-writing-structed-files.html#GsfOutfile"><span class="returnvalue">GsfOutfile</span></a> *        <a class="link" href="gsf-Reading-and-Writing-from-local-files-and-directories.html#gsf-outfile-stdio-new-full" title="gsf_outfile_stdio_new_full ()">gsf_outfile_stdio_new_full</a>          (<em class="parameter"><code><span class="type">char</span> const *root</code></em>,
66                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>,
67                                                          <em class="parameter"><code><span class="type">char</span> const *first_property_name</code></em>,
68                                                          <em class="parameter"><code>...</code></em>);
69 <a class="link" href="gsf-Outfile-writing-structed-files.html#GsfOutfile"><span class="returnvalue">GsfOutfile</span></a> *        <a class="link" href="gsf-Reading-and-Writing-from-local-files-and-directories.html#gsf-outfile-stdio-new-valist" title="gsf_outfile_stdio_new_valist ()">gsf_outfile_stdio_new_valist</a>        (<em class="parameter"><code><span class="type">char</span> const *root</code></em>,
70                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>,
71                                                          <em class="parameter"><code><span class="type">char</span> const *first_property_name</code></em>,
72                                                          <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);
73                     <a class="link" href="gsf-Reading-and-Writing-from-local-files-and-directories.html#GsfInfileStdio-struct" title="GsfInfileStdio">GsfInfileStdio</a>;
74 <a class="link" href="gsf-Infile-reading-structed-files.html#GsfInfile"><span class="returnvalue">GsfInfile</span></a> *         <a class="link" href="gsf-Reading-and-Writing-from-local-files-and-directories.html#gsf-infile-stdio-new" title="gsf_infile_stdio_new ()">gsf_infile_stdio_new</a>                (<em class="parameter"><code><span class="type">char</span> const *root</code></em>,
75                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);
76 </pre>
77 </div>
78 <div class="refsect1" title="Object Hierarchy">
79 <a name="gsf-Reading-and-Writing-from-local-files-and-directories.object-hierarchy"></a><h2>Object Hierarchy</h2>
80 <pre class="synopsis">
81   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
82    +----<a class="link" href="gsf-Input-from-unstructured-files.html#GsfInput">GsfInput</a>
83          +----GsfInputStdio
84 </pre>
85 <pre class="synopsis">
86   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
87    +----<a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput">GsfOutput</a>
88          +----GsfOutputStdio
89 </pre>
90 <pre class="synopsis">
91   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
92    +----<a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput">GsfOutput</a>
93          +----<a class="link" href="gsf-Outfile-writing-structed-files.html#GsfOutfile">GsfOutfile</a>
94                +----GsfOutfileStdio
95 </pre>
96 <pre class="synopsis">
97   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
98    +----<a class="link" href="gsf-Input-from-unstructured-files.html#GsfInput">GsfInput</a>
99          +----<a class="link" href="gsf-Infile-reading-structed-files.html#GsfInfile">GsfInfile</a>
100                +----GsfInfileStdio
101 </pre>
102 </div>
103 <div class="refsect1" title="Description">
104 <a name="gsf-Reading-and-Writing-from-local-files-and-directories.description"></a><h2>Description</h2>
105 <p>
106 </p>
107 </div>
108 <div class="refsect1" title="Details">
109 <a name="gsf-Reading-and-Writing-from-local-files-and-directories.details"></a><h2>Details</h2>
110 <div class="refsect2" title="GsfInputStdio">
111 <a name="GsfInputStdio-struct"></a><h3>GsfInputStdio</h3>
112 <pre class="programlisting">typedef struct _GsfInputStdio GsfInputStdio;</pre>
113 <p>
114 </p>
115 </div>
116 <hr>
117 <div class="refsect2" title="gsf_input_stdio_new ()">
118 <a name="gsf-input-stdio-new"></a><h3>gsf_input_stdio_new ()</h3>
119 <pre class="programlisting"><a class="link" href="gsf-Input-from-unstructured-files.html#GsfInput"><span class="returnvalue">GsfInput</span></a> *          gsf_input_stdio_new                 (<em class="parameter"><code><span class="type">char</span> const *filename</code></em>,
120                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
121 <div class="variablelist"><table border="0">
122 <col align="left" valign="top">
123 <tbody>
124 <tr>
125 <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
126 <td>in utf8.
127 </td>
128 </tr>
129 <tr>
130 <td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
131 <td>optionally NULL.
132 </td>
133 </tr>
134 <tr>
135 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
136 <td> a new file or NULL.
137 </td>
138 </tr>
139 </tbody>
140 </table></div>
141 </div>
142 <hr>
143 <div class="refsect2" title="gsf_input_stdio_new_FILE ()">
144 <a name="gsf-input-stdio-new-FILE"></a><h3>gsf_input_stdio_new_FILE ()</h3>
145 <pre class="programlisting"><a class="link" href="gsf-Input-from-unstructured-files.html#GsfInput"><span class="returnvalue">GsfInput</span></a> *          gsf_input_stdio_new_FILE            (<em class="parameter"><code><span class="type">char</span> const *filename</code></em>,
146                                                          <em class="parameter"><code><span class="type">FILE</span> *file</code></em>,
147                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> keep_open</code></em>);</pre>
148 <p>
149 Assumes ownership of <em class="parameter"><code>file</code></em> when succeeding.  If <em class="parameter"><code>keep_open</code></em> is true,
150 ownership reverts to caller when the GsfObject is closed.
151 </p>
152 <div class="variablelist"><table border="0">
153 <col align="left" valign="top">
154 <tbody>
155 <tr>
156 <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
157 <td>The filename corresponding to <em class="parameter"><code>file</code></em>.
158 </td>
159 </tr>
160 <tr>
161 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
162 <td>an existing stdio FILE *
163 </td>
164 </tr>
165 <tr>
166 <td><p><span class="term"><em class="parameter"><code>keep_open</code></em> :</span></p></td>
167 <td>Should <em class="parameter"><code>file</code></em> be closed when the wrapper is closed
168 </td>
169 </tr>
170 <tr>
171 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
172 <td> a new GsfInput wrapper for <em class="parameter"><code>file</code></em>.  Note that if the file is not
173         seekable, this function will make a local copy of the entire file.
174 </td>
175 </tr>
176 </tbody>
177 </table></div>
178 </div>
179 <hr>
180 <div class="refsect2" title="GsfOutputStdio">
181 <a name="GsfOutputStdio-struct"></a><h3>GsfOutputStdio</h3>
182 <pre class="programlisting">typedef struct _GsfOutputStdio GsfOutputStdio;</pre>
183 <p>
184 </p>
185 </div>
186 <hr>
187 <div class="refsect2" title="gsf_output_stdio_new ()">
188 <a name="gsf-output-stdio-new"></a><h3>gsf_output_stdio_new ()</h3>
189 <pre class="programlisting"><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="returnvalue">GsfOutput</span></a> *         gsf_output_stdio_new                (<em class="parameter"><code><span class="type">char</span> const *filename</code></em>,
190                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
191 <div class="variablelist"><table border="0">
192 <col align="left" valign="top">
193 <tbody>
194 <tr>
195 <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
196 <td>name of file to create or replace.
197 </td>
198 </tr>
199 <tr>
200 <td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
201 <td>optionally <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
202 </td>
203 </tr>
204 <tr>
205 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
206 <td> a new file or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
207 </td>
208 </tr>
209 </tbody>
210 </table></div>
211 </div>
212 <hr>
213 <div class="refsect2" title="gsf_output_stdio_new_full ()">
214 <a name="gsf-output-stdio-new-full"></a><h3>gsf_output_stdio_new_full ()</h3>
215 <pre class="programlisting"><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="returnvalue">GsfOutput</span></a> *         gsf_output_stdio_new_full           (<em class="parameter"><code><span class="type">char</span> const *filename</code></em>,
216                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>,
217                                                          <em class="parameter"><code><span class="type">char</span> const *first_property_name</code></em>,
218                                                          <em class="parameter"><code>...</code></em>);</pre>
219 <div class="variablelist"><table border="0">
220 <col align="left" valign="top">
221 <tbody>
222 <tr>
223 <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
224 <td>name of file to create or replace.
225 </td>
226 </tr>
227 <tr>
228 <td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
229 <td>optionally <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
230 </td>
231 </tr>
232 <tr>
233 <td><p><span class="term"><em class="parameter"><code>first_property_name</code></em> :</span></p></td>
234 <td>
235 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> terminated list of properties
236 </td>
237 </tr>
238 <tr>
239 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
240 <td> a new file or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
241 </td>
242 </tr>
243 </tbody>
244 </table></div>
245 </div>
246 <hr>
247 <div class="refsect2" title="gsf_output_stdio_new_valist ()">
248 <a name="gsf-output-stdio-new-valist"></a><h3>gsf_output_stdio_new_valist ()</h3>
249 <pre class="programlisting"><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="returnvalue">GsfOutput</span></a> *         gsf_output_stdio_new_valist         (<em class="parameter"><code><span class="type">char</span> const *filename</code></em>,
250                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>,
251                                                          <em class="parameter"><code><span class="type">char</span> const *first_property_name</code></em>,
252                                                          <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);</pre>
253 <p>
254 </p>
255 <div class="variablelist"><table border="0">
256 <col align="left" valign="top">
257 <tbody>
258 <tr>
259 <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
260 <td>
261 </td>
262 </tr>
263 <tr>
264 <td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
265 <td>
266 </td>
267 </tr>
268 <tr>
269 <td><p><span class="term"><em class="parameter"><code>first_property_name</code></em> :</span></p></td>
270 <td>
271 </td>
272 </tr>
273 <tr>
274 <td><p><span class="term"><em class="parameter"><code>var_args</code></em> :</span></p></td>
275 <td>
276 </td>
277 </tr>
278 <tr>
279 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
280 <td>
281 </td>
282 </tr>
283 </tbody>
284 </table></div>
285 </div>
286 <hr>
287 <div class="refsect2" title="gsf_output_stdio_new_FILE ()">
288 <a name="gsf-output-stdio-new-FILE"></a><h3>gsf_output_stdio_new_FILE ()</h3>
289 <pre class="programlisting"><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="returnvalue">GsfOutput</span></a> *         gsf_output_stdio_new_FILE           (<em class="parameter"><code><span class="type">char</span> const *filename</code></em>,
290                                                          <em class="parameter"><code><span class="type">FILE</span> *file</code></em>,
291                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> keep_open</code></em>);</pre>
292 <p>
293 Assumes ownership of <em class="parameter"><code>file</code></em>.  If <em class="parameter"><code>keep_open</code></em> is true, ownership reverts
294 to caller when the GsfObject is closed.
295 </p>
296 <div class="variablelist"><table border="0">
297 <col align="left" valign="top">
298 <tbody>
299 <tr>
300 <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
301 <td>The filename corresponding to <em class="parameter"><code>file</code></em>.
302 </td>
303 </tr>
304 <tr>
305 <td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
306 <td>an existing stdio FILE *
307 </td>
308 </tr>
309 <tr>
310 <td><p><span class="term"><em class="parameter"><code>keep_open</code></em> :</span></p></td>
311 <td>Should <em class="parameter"><code>file</code></em> be closed when the wrapper is closed
312 </td>
313 </tr>
314 <tr>
315 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
316 <td> a new GsfOutput wrapper for <em class="parameter"><code>file</code></em>.  Warning: the result will be
317 seekable only if <em class="parameter"><code>file</code></em> is seekable.  If it is seekable, the resulting
318 GsfOutput object will seek relative to <em class="parameter"><code>file</code></em>'s beginning, not its
319 current location at the time the GsfOutput object is created.
320 </td>
321 </tr>
322 </tbody>
323 </table></div>
324 </div>
325 <hr>
326 <div class="refsect2" title="GsfOutfileStdio">
327 <a name="GsfOutfileStdio-struct"></a><h3>GsfOutfileStdio</h3>
328 <pre class="programlisting">typedef struct _GsfOutfileStdio GsfOutfileStdio;</pre>
329 <p>
330 </p>
331 </div>
332 <hr>
333 <div class="refsect2" title="gsf_outfile_stdio_new ()">
334 <a name="gsf-outfile-stdio-new"></a><h3>gsf_outfile_stdio_new ()</h3>
335 <pre class="programlisting"><a class="link" href="gsf-Outfile-writing-structed-files.html#GsfOutfile"><span class="returnvalue">GsfOutfile</span></a> *        gsf_outfile_stdio_new               (<em class="parameter"><code><span class="type">char</span> const *root</code></em>,
336                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
337 <div class="variablelist"><table border="0">
338 <col align="left" valign="top">
339 <tbody>
340 <tr>
341 <td><p><span class="term"><em class="parameter"><code>root</code></em> :</span></p></td>
342 <td>root directory in utf8.
343 </td>
344 </tr>
345 <tr>
346 <td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
347 <td>optionally NULL.
348 </td>
349 </tr>
350 <tr>
351 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
352 <td> a new outfile or NULL.
353 </td>
354 </tr>
355 </tbody>
356 </table></div>
357 </div>
358 <hr>
359 <div class="refsect2" title="gsf_outfile_stdio_new_full ()">
360 <a name="gsf-outfile-stdio-new-full"></a><h3>gsf_outfile_stdio_new_full ()</h3>
361 <pre class="programlisting"><a class="link" href="gsf-Outfile-writing-structed-files.html#GsfOutfile"><span class="returnvalue">GsfOutfile</span></a> *        gsf_outfile_stdio_new_full          (<em class="parameter"><code><span class="type">char</span> const *root</code></em>,
362                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>,
363                                                          <em class="parameter"><code><span class="type">char</span> const *first_property_name</code></em>,
364                                                          <em class="parameter"><code>...</code></em>);</pre>
365 <div class="variablelist"><table border="0">
366 <col align="left" valign="top">
367 <tbody>
368 <tr>
369 <td><p><span class="term"><em class="parameter"><code>root</code></em> :</span></p></td>
370 <td>root directory in utf8.
371 </td>
372 </tr>
373 <tr>
374 <td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
375 <td>optionally NULL.
376 </td>
377 </tr>
378 <tr>
379 <td><p><span class="term"><em class="parameter"><code>first_property_name</code></em> :</span></p></td>
380 <td>name of first property to set
381 </td>
382 </tr>
383 <tr>
384 <td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
385 <td>value of first property, followed by more properties,
386                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated
387 </td>
388 </tr>
389 <tr>
390 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
391 <td> a new outfile or NULL.
392 </td>
393 </tr>
394 </tbody>
395 </table></div>
396 </div>
397 <hr>
398 <div class="refsect2" title="gsf_outfile_stdio_new_valist ()">
399 <a name="gsf-outfile-stdio-new-valist"></a><h3>gsf_outfile_stdio_new_valist ()</h3>
400 <pre class="programlisting"><a class="link" href="gsf-Outfile-writing-structed-files.html#GsfOutfile"><span class="returnvalue">GsfOutfile</span></a> *        gsf_outfile_stdio_new_valist        (<em class="parameter"><code><span class="type">char</span> const *root</code></em>,
401                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>,
402                                                          <em class="parameter"><code><span class="type">char</span> const *first_property_name</code></em>,
403                                                          <em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);</pre>
404 <div class="variablelist"><table border="0">
405 <col align="left" valign="top">
406 <tbody>
407 <tr>
408 <td><p><span class="term"><em class="parameter"><code>root</code></em> :</span></p></td>
409 <td>root directory in utf8.
410 </td>
411 </tr>
412 <tr>
413 <td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
414 <td>optionally NULL.
415 </td>
416 </tr>
417 <tr>
418 <td><p><span class="term"><em class="parameter"><code>first_property_name</code></em> :</span></p></td>
419 <td>name of first property to set
420 </td>
421 </tr>
422 <tr>
423 <td><p><span class="term"><em class="parameter"><code>var_args</code></em> :</span></p></td>
424 <td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated <span class="type">va_list</span>
425 </td>
426 </tr>
427 <tr>
428 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
429 <td> a new outfile or NULL.
430 </td>
431 </tr>
432 </tbody>
433 </table></div>
434 </div>
435 <hr>
436 <div class="refsect2" title="GsfInfileStdio">
437 <a name="GsfInfileStdio-struct"></a><h3>GsfInfileStdio</h3>
438 <pre class="programlisting">typedef struct _GsfInfileStdio GsfInfileStdio;</pre>
439 <p>
440 </p>
441 </div>
442 <hr>
443 <div class="refsect2" title="gsf_infile_stdio_new ()">
444 <a name="gsf-infile-stdio-new"></a><h3>gsf_infile_stdio_new ()</h3>
445 <pre class="programlisting"><a class="link" href="gsf-Infile-reading-structed-files.html#GsfInfile"><span class="returnvalue">GsfInfile</span></a> *         gsf_infile_stdio_new                (<em class="parameter"><code><span class="type">char</span> const *root</code></em>,
446                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **err</code></em>);</pre>
447 <div class="variablelist"><table border="0">
448 <col align="left" valign="top">
449 <tbody>
450 <tr>
451 <td><p><span class="term"><em class="parameter"><code>root</code></em> :</span></p></td>
452 <td>in locale dependent encoding
453 </td>
454 </tr>
455 <tr>
456 <td><p><span class="term"><em class="parameter"><code>err</code></em> :</span></p></td>
457 <td>optionally <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
458 </td>
459 </tr>
460 <tr>
461 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
462 <td> a new file or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
463 </td>
464 </tr>
465 </tbody>
466 </table></div>
467 </div>
468 </div>
469 </div>
470 <div class="footer">
471 <hr>
472           Generated by GTK-Doc V1.14</div>
473 </body>
474 </html>