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>