RubyGems - gsf - Versions diffs - 3.0.9-x86-mingw32 - Mend

gsf 3.0.9-x86-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (166) hide show

data/vendor/local/share/gtk-doc/html/gsf/gsf-Output-to-unstructured-files.html ADDED

@@ -0,0 +1,830 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>GSF Reference Manual: Output to unstructured files</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
+<link rel="home" href="index.html" title="GSF Reference Manual">
+<link rel="up" href="io.html" title="Basic Input/Output">
+<link rel="prev" href="gsf-Input-from-unstructured-files.html" title="Input from unstructured files">
+<link rel="next" href="sources.html" title="Stream Sources">
+<meta name="generator" content="GTK-Doc V1.20 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
+<td width="100%" align="left" class="shortcuts">
+<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
+                  <a href="#gsf-Output-to-unstructured-files.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
+                  <a href="#gsf-Output-to-unstructured-files.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_properties"> <span class="dim">|</span>
+                  <a href="#gsf-Output-to-unstructured-files.properties" class="shortcut">Properties</a></span>
+</td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
+<td><a accesskey="u" href="io.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
+<td><a accesskey="p" href="gsf-Input-from-unstructured-files.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
+<td><a accesskey="n" href="sources.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
+</tr></table>
+<div class="refentry">
+<a name="gsf-Output-to-unstructured-files"></a><div class="titlepage"></div>
+<div class="refnamediv"><table width="100%"><tr>
+<td valign="top">
+<h2><span class="refentrytitle"><a name="gsf-Output-to-unstructured-files.top_of_page"></a>Output to unstructured files</span></h2>
+<p>Output to unstructured files</p>
+</td>
+<td class="gallery_image" valign="top" align="right"></td>
+</tr></table></div>
+<div class="refsect1">
+<a name="gsf-Output-to-unstructured-files.functions"></a><h2>Functions</h2>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="functions_return">
+<col class="functions_name">
+</colgroup>
+<tbody>
+<tr>
+<td class="function_type">
+<a class="link" href="gsf-utils.html#gsf-off-t" title="gsf_off_t"><span class="returnvalue">gsf_off_t</span></a>
+</td>
+<td class="function_name">
+<a class="link" href="gsf-Output-to-unstructured-files.html#gsf-output-size" title="gsf_output_size ()">gsf_output_size</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
+</td>
+<td class="function_name">
+<a class="link" href="gsf-Output-to-unstructured-files.html#gsf-output-close" title="gsf_output_close ()">gsf_output_close</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<a class="link" href="gsf-utils.html#gsf-off-t" title="gsf_off_t"><span class="returnvalue">gsf_off_t</span></a>
+</td>
+<td class="function_name">
+<a class="link" href="gsf-Output-to-unstructured-files.html#gsf-output-tell" title="gsf_output_tell ()">gsf_output_tell</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
+</td>
+<td class="function_name">
+<a class="link" href="gsf-Output-to-unstructured-files.html#gsf-output-seek" title="gsf_output_seek ()">gsf_output_seek</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
+</td>
+<td class="function_name">
+<a class="link" href="gsf-Output-to-unstructured-files.html#gsf-output-write" title="gsf_output_write ()">gsf_output_write</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
+</td>
+<td class="function_name">
+<a class="link" href="gsf-Output-to-unstructured-files.html#gsf-output-puts" title="gsf_output_puts ()">gsf_output_puts</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
+</td>
+<td class="function_name">
+<a class="link" href="gsf-Output-to-unstructured-files.html#gsf-output-printf" title="gsf_output_printf ()">gsf_output_printf</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<a class="link" href="gsf-utils.html#gsf-off-t" title="gsf_off_t"><span class="returnvalue">gsf_off_t</span></a>
+</td>
+<td class="function_name">
+<a class="link" href="gsf-Output-to-unstructured-files.html#gsf-output-vprintf" title="gsf_output_vprintf ()">gsf_output_vprintf</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<a class="link" href="gsf-Outfile-writing-structed-files.html#GsfOutfile"><span class="returnvalue">GsfOutfile</span></a> *
+</td>
+<td class="function_name">
+<a class="link" href="gsf-Output-to-unstructured-files.html#gsf-output-container" title="gsf_output_container ()">gsf_output_container</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">char</span> const   *
+</td>
+<td class="function_name">
+<a class="link" href="gsf-Output-to-unstructured-files.html#gsf-output-name" title="gsf_output_name ()">gsf_output_name</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
+</td>
+<td class="function_name">
+<a class="link" href="gsf-Output-to-unstructured-files.html#gsf-output-set-name-from-filename" title="gsf_output_set_name_from_filename ()">gsf_output_set_name_from_filename</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">GQuark</span>
+</td>
+<td class="function_name">
+<a class="link" href="gsf-Output-to-unstructured-files.html#gsf-output-error-id" title="gsf_output_error_id ()">gsf_output_error_id</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
+</td>
+<td class="function_name">
+<a class="link" href="gsf-Output-to-unstructured-files.html#gsf-output-set-error" title="gsf_output_set_error ()">gsf_output_set_error</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">GError</span> const *
+</td>
+<td class="function_name">
+<a class="link" href="gsf-Output-to-unstructured-files.html#gsf-output-error" title="gsf_output_error ()">gsf_output_error</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
+</td>
+<td class="function_name">
+<a class="link" href="gsf-Output-to-unstructured-files.html#gsf-output-is-closed" title="gsf_output_is_closed ()">gsf_output_is_closed</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
+</td>
+<td class="function_name">
+<a class="link" href="gsf-Output-to-unstructured-files.html#gsf-output-wrap" title="gsf_output_wrap ()">gsf_output_wrap</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">gboolean</span>
+</td>
+<td class="function_name">
+<a class="link" href="gsf-Output-to-unstructured-files.html#gsf-output-unwrap" title="gsf_output_unwrap ()">gsf_output_unwrap</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect1">
+<a name="gsf-Output-to-unstructured-files.properties"></a><h2>Properties</h2>
+<div class="informaltable"><table border="0">
+<colgroup>
+<col width="150px" class="properties_type">
+<col width="300px" class="properties_name">
+<col width="200px" class="properties_flags">
+</colgroup>
+<tbody>
+<tr>
+<td class="property_type">
+<a class="link" href="gsf-Outfile-writing-structed-files.html#GsfOutfile"><span class="type">GsfOutfile</span></a> *</td>
+<td class="property_name"><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput--container" title="The “container” property">container</a></td>
+<td class="property_flags">Read / Write</td>
+</tr>
+<tr>
+<td class="property_type"><span class="type">gboolean</span></td>
+<td class="property_name"><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput--is-closed" title="The “is-closed” property">is-closed</a></td>
+<td class="property_flags">Read</td>
+</tr>
+<tr>
+<td class="property_type">
+<span class="type">GDateTime</span> *</td>
+<td class="property_name"><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput--modtime" title="The “modtime” property">modtime</a></td>
+<td class="property_flags">Read / Write / Construct Only</td>
+</tr>
+<tr>
+<td class="property_type">
+<span class="type">gchar</span> *</td>
+<td class="property_name"><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput--name" title="The “name” property">name</a></td>
+<td class="property_flags">Read / Write</td>
+</tr>
+<tr>
+<td class="property_type"><span class="type">gint64</span></td>
+<td class="property_name"><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput--position" title="The “position” property">position</a></td>
+<td class="property_flags">Read</td>
+</tr>
+<tr>
+<td class="property_type"><span class="type">gint64</span></td>
+<td class="property_name"><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput--size" title="The “size” property">size</a></td>
+<td class="property_flags">Read</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<a name="GsfOutput"></a><div class="refsect1">
+<a name="gsf-Output-to-unstructured-files.other"></a><h2>Types and Values</h2>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="name">
+<col class="description">
+</colgroup>
+<tbody><tr>
+<td class="datatype_keyword"> </td>
+<td class="function_name"><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput-struct" title="GsfOutput">GsfOutput</a></td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect1">
+<a name="gsf-Output-to-unstructured-files.object-hierarchy"></a><h2>Object Hierarchy</h2>
+<pre class="screen">    GObject
+    <span class="lineart">╰──</span> GsfOutput
+        <span class="lineart">├──</span> <a class="link" href="gsf-Outfile-writing-structed-files.html#GsfOutfile">GsfOutfile</a>
+        <span class="lineart">├──</span> <a class="link" href="gsf-Compression.html#GsfOutputBzip">GsfOutputBzip</a>
+        <span class="lineart">├──</span> <a class="link" href="gsf-Text.html#GsfOutputCsv">GsfOutputCsv</a>
+        <span class="lineart">├──</span> <a class="link" href="gsf-Compression.html#GsfOutputGZip">GsfOutputGZip</a>
+        <span class="lineart">├──</span> <a class="link" href="gsf-Text.html#GsfOutputIconv">GsfOutputIconv</a>
+        <span class="lineart">├──</span> <a class="link" href="gsf-GIOChannel.html#GsfOutputIOChannel">GsfOutputIOChannel</a>
+        <span class="lineart">├──</span> <a class="link" href="gsf-memory.html#GsfOutputMemory">GsfOutputMemory</a>
+        <span class="lineart">╰──</span> <a class="link" href="gsf-Reading-and-Writing-from-local-files-and-directories.html#GsfOutputStdio">GsfOutputStdio</a>
+</pre>
+</div>
+<div class="refsect1">
+<a name="gsf-Output-to-unstructured-files.description"></a><h2>Description</h2>
+<p>
+</p>
+</div>
+<div class="refsect1">
+<a name="gsf-Output-to-unstructured-files.functions_details"></a><h2>Functions</h2>
+<div class="refsect2">
+<a name="gsf-output-size"></a><h3>gsf_output_size ()</h3>
+<pre class="programlisting"><a class="link" href="gsf-utils.html#gsf-off-t" title="gsf_off_t"><span class="returnvalue">gsf_off_t</span></a>
+gsf_output_size (<em class="parameter"><code><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a> *output</code></em>);</pre>
+<p>Determine the size of the output stream <em class="parameter"><code>output</code></em>
+.</p>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.2.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>output</p></td>
+<td class="parameter_description"><p><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.2.6"></a><h4>Returns</h4>
+<p> the size of the output, or -1 if it does not have a size.</p>
+<p></p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gsf-output-close"></a><h3>gsf_output_close ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
+gsf_output_close (<em class="parameter"><code><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a> *output</code></em>);</pre>
+<p>Close a stream.</p>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.3.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>output</p></td>
+<td class="parameter_description"><p><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.3.6"></a><h4>Returns</h4>
+<p> <code class="literal">FALSE</code> on error</p>
+<p></p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gsf-output-tell"></a><h3>gsf_output_tell ()</h3>
+<pre class="programlisting"><a class="link" href="gsf-utils.html#gsf-off-t" title="gsf_off_t"><span class="returnvalue">gsf_off_t</span></a>
+gsf_output_tell (<em class="parameter"><code><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a> *output</code></em>);</pre>
+<p>Tell the current position in <em class="parameter"><code>output</code></em>
+, similar to</p>
+<span class="citerefentry"><span class="refentrytitle">ftell</span>(3)</span>.
+<div class="refsect3">
+<a name="id-1.6.3.3.9.4.6"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>output</p></td>
+<td class="parameter_description"><p><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.4.7"></a><h4>Returns</h4>
+<p> the current position in the file</p>
+<p></p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gsf-output-seek"></a><h3>gsf_output_seek ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
+gsf_output_seek (<em class="parameter"><code><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a> *output</code></em>,
+                 <em class="parameter"><code><a class="link" href="gsf-utils.html#gsf-off-t" title="gsf_off_t"><span class="type">gsf_off_t</span></a> offset</code></em>,
+                 <em class="parameter"><code><span class="type">GSeekType</span> whence</code></em>);</pre>
+<p>Reposition in output stream <em class="parameter"><code>output</code></em>
+. <em class="parameter"><code>whence</code></em>
+ specifies what the offset is
+relative to: the beginning of the stream (<code class="literal">G_SEEK_SET</code>), current position in
+the stream (<code class="literal">G_SEEK_CUR</code>) or the end of the stream (<code class="literal">G_SEEK_END</code>).
+This function is similar to</p>
+<span class="citerefentry"><span class="refentrytitle">fseek</span>(3)</span>.
+<div class="refsect3">
+<a name="id-1.6.3.3.9.5.6"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>output</p></td>
+<td class="parameter_description"><p><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>offset</p></td>
+<td class="parameter_description"><p>Relative amount to reposition</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>whence</p></td>
+<td class="parameter_description"><p>What the offset is relative to.</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.5.7"></a><h4>Returns</h4>
+<p> <code class="literal">FALSE</code> on error.</p>
+<p></p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gsf-output-write"></a><h3>gsf_output_write ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
+gsf_output_write (<em class="parameter"><code><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a> *output</code></em>,
+                  <em class="parameter"><code><span class="type">size_t</span> num_bytes</code></em>,
+                  <em class="parameter"><code><span class="type">guint8</span> const *data</code></em>);</pre>
+<p>Write <em class="parameter"><code>num_bytes</code></em>
+ of <em class="parameter"><code>data</code></em>
+ to <em class="parameter"><code>output</code></em>
+.</p>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.6.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>output</p></td>
+<td class="parameter_description"><p>Output stream</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>num_bytes</p></td>
+<td class="parameter_description"><p>Number of bytes to write</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>data</p></td>
+<td class="parameter_description"><p> Data to write. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for input. Default is transfer none."><span class="acronym">in</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=num_bytes]</span></td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.6.6"></a><h4>Returns</h4>
+<p> <code class="literal">FALSE</code> on error.</p>
+<p></p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gsf-output-puts"></a><h3>gsf_output_puts ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
+gsf_output_puts (<em class="parameter"><code><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a> *output</code></em>,
+                 <em class="parameter"><code><span class="type">char</span> const *line</code></em>);</pre>
+<p>Like fputs, this assumes that the line already ends with a newline</p>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.7.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>output</p></td>
+<td class="parameter_description"><p>A <a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>line</p></td>
+<td class="parameter_description"><p>Nul terminated string to write</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.7.6"></a><h4>Returns</h4>
+<p> <code class="literal">TRUE</code> if successful, <code class="literal">FALSE</code> if not</p>
+<p></p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gsf-output-printf"></a><h3>gsf_output_printf ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
+gsf_output_printf (<em class="parameter"><code><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a> *output</code></em>,
+                   <em class="parameter"><code><span class="type">char</span> const *format</code></em>,
+                   <em class="parameter"><code>...</code></em>);</pre>
+<p>Output <em class="parameter"><code>Varargs</code></em>
+ to <em class="parameter"><code>output</code></em>
+ using the format string <em class="parameter"><code>format</code></em>
+, similar to</p>
+<span class="citerefentry"><span class="refentrytitle">printf</span>(3)</span>.
+<div class="refsect3">
+<a name="id-1.6.3.3.9.8.6"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>output</p></td>
+<td class="parameter_description"><p>A <a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>format</p></td>
+<td class="parameter_description"><p>The printf-style format string</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>...</p></td>
+<td class="parameter_description"><p>the arguments for <em class="parameter"><code>format</code></em>
+</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.8.7"></a><h4>Returns</h4>
+<p> <code class="literal">TRUE</code> if successful, <code class="literal">FALSE</code> if not</p>
+<p></p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gsf-output-vprintf"></a><h3>gsf_output_vprintf ()</h3>
+<pre class="programlisting"><a class="link" href="gsf-utils.html#gsf-off-t" title="gsf_off_t"><span class="returnvalue">gsf_off_t</span></a>
+gsf_output_vprintf (<em class="parameter"><code><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a> *output</code></em>,
+                    <em class="parameter"><code><span class="type">char</span> const *format</code></em>,
+                    <em class="parameter"><code><span class="type">va_list</span> args</code></em>);</pre>
+<p>Output <em class="parameter"><code>args</code></em>
+ to <em class="parameter"><code>output</code></em>
+ using the format string <em class="parameter"><code>format</code></em>
+, similar to</p>
+<span class="citerefentry"><span class="refentrytitle">vprintf</span>(3)</span>.
+<div class="refsect3">
+<a name="id-1.6.3.3.9.9.6"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>output</p></td>
+<td class="parameter_description"><p>A <a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>format</p></td>
+<td class="parameter_description"><p>The printf-style format string</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>args</p></td>
+<td class="parameter_description"><p>the arguments for <em class="parameter"><code>format</code></em>
+</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.9.7"></a><h4>Returns</h4>
+<p> number of bytes printed, a negative value if not successful</p>
+<p></p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gsf-output-container"></a><h3>gsf_output_container ()</h3>
+<pre class="programlisting"><a class="link" href="gsf-Outfile-writing-structed-files.html#GsfOutfile"><span class="returnvalue">GsfOutfile</span></a> *
+gsf_output_container (<em class="parameter"><code><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a> const *output</code></em>);</pre>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.10.4"></a><h4>Returns</h4>
+<p> <em class="parameter"><code>output</code></em>
+'s container, potentially <code class="literal">NULL</code>. </p>
+<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gsf-output-name"></a><h3>gsf_output_name ()</h3>
+<pre class="programlisting"><span class="returnvalue">char</span> const   *
+gsf_output_name (<em class="parameter"><code><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a> const *output</code></em>);</pre>
+<p>Give the name of <em class="parameter"><code>output</code></em>
+.</p>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.11.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>output</p></td>
+<td class="parameter_description"><p><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.11.6"></a><h4>Returns</h4>
+<p> <em class="parameter"><code>output</code></em>
+'s name in utf8 form. </p>
+<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gsf-output-set-name-from-filename"></a><h3>gsf_output_set_name_from_filename ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
+gsf_output_set_name_from_filename (<em class="parameter"><code><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a> *output</code></em>,
+                                   <em class="parameter"><code><span class="type">char</span> const *filename</code></em>);</pre>
+<div class="note">This is a utility routine that should only be used by derived
+outputs.</div>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.12.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>output</p></td>
+<td class="parameter_description"><p>the output stream</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>filename</p></td>
+<td class="parameter_description"><p>the (fs-sys encoded) filename</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.12.6"></a><h4>Returns</h4>
+<p> <code class="literal">TRUE</code> if the assignment was ok.</p>
+<p></p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gsf-output-error-id"></a><h3>gsf_output_error_id ()</h3>
+<pre class="programlisting"><span class="returnvalue">GQuark</span>
+gsf_output_error_id (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>
+</p>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.13.5"></a><h4>Returns</h4>
+<p></p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gsf-output-set-error"></a><h3>gsf_output_set_error ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
+gsf_output_set_error (<em class="parameter"><code><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a> *output</code></em>,
+                      <em class="parameter"><code><span class="type">gint</span> code</code></em>,
+                      <em class="parameter"><code><span class="type">char</span> const *format</code></em>,
+                      <em class="parameter"><code>...</code></em>);</pre>
+<div class="note">This is a utility routine that should only be used by derived
+outputs.</div>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.14.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>output</p></td>
+<td class="parameter_description"><p><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>code</p></td>
+<td class="parameter_description"><p>The error id</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>format</p></td>
+<td class="parameter_description"><p>printf style format string</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>...</p></td>
+<td class="parameter_description"><p>arguments for <em class="parameter"><code>format</code></em>
+</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.14.6"></a><h4>Returns</h4>
+<p> Always returns <code class="literal">FALSE</code> to facilitate its use.</p>
+<p></p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gsf-output-error"></a><h3>gsf_output_error ()</h3>
+<pre class="programlisting"><span class="returnvalue">GError</span> const *
+gsf_output_error (<em class="parameter"><code><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a> const *output</code></em>);</pre>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.15.4"></a><h4>Returns</h4>
+<p> the last error logged on the output, or <code class="literal">NULL</code>. </p>
+<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gsf-output-is-closed"></a><h3>gsf_output_is_closed ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
+gsf_output_is_closed (<em class="parameter"><code><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a> const *output</code></em>);</pre>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.16.4"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>output</p></td>
+<td class="parameter_description"><p><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.16.5"></a><h4>Returns</h4>
+<p> <code class="literal">TRUE</code> if <em class="parameter"><code>output</code></em>
+has already been closed.</p>
+<p></p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gsf-output-wrap"></a><h3>gsf_output_wrap ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
+gsf_output_wrap (<em class="parameter"><code><span class="type">GObject</span> *wrapper</code></em>,
+                 <em class="parameter"><code><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a> *wrapee</code></em>);</pre>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.17.4"></a><h4>Returns</h4>
+<p> <code class="literal">TRUE</code> if the wrapping succeeded.</p>
+<p></p>
+</div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gsf-output-unwrap"></a><h3>gsf_output_unwrap ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>
+gsf_output_unwrap (<em class="parameter"><code><span class="type">GObject</span> *wrapper</code></em>,
+                   <em class="parameter"><code><a class="link" href="gsf-Output-to-unstructured-files.html#GsfOutput"><span class="type">GsfOutput</span></a> *wrapee</code></em>);</pre>
+<div class="refsect3">
+<a name="id-1.6.3.3.9.18.4"></a><h4>Returns</h4>
+<p> <code class="literal">TRUE</code> if the unwrapping succeeded.</p>
+<p></p>
+</div>
+</div>
+</div>
+<div class="refsect1">
+<a name="gsf-Output-to-unstructured-files.other_details"></a><h2>Types and Values</h2>
+<div class="refsect2">
+<a name="GsfOutput-struct"></a><h3>GsfOutput</h3>
+<pre class="programlisting">typedef struct _GsfOutput GsfOutput;</pre>
+<p>Class representing an output stream, counterpart to <a class="link" href="gsf-Input-from-unstructured-files.html#GsfInput"><span class="type">GsfInput</span></a>.</p>
+</div>
+</div>
+<div class="refsect1">
+<a name="gsf-Output-to-unstructured-files.property-details"></a><h2>Property Details</h2>
+<div class="refsect2">
+<a name="GsfOutput--container"></a><h3>The <code class="literal">“container”</code> property</h3>
+<pre class="programlisting">  “container”                <a class="link" href="gsf-Outfile-writing-structed-files.html#GsfOutfile"><span class="type">GsfOutfile</span></a> *</pre>
+<p>The container, optionally <code class="literal">NULL</code>, in which this output lives.</p>
+<p>Flags: Read / Write</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GsfOutput--is-closed"></a><h3>The <code class="literal">“is-closed”</code> property</h3>
+<pre class="programlisting">  “is-closed”                <span class="type">gboolean</span></pre>
+<p><code class="literal">TRUE</code> if the output has been closed.</p>
+<p>Flags: Read</p>
+<p>Default value: FALSE</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GsfOutput--modtime"></a><h3>The <code class="literal">“modtime”</code> property</h3>
+<pre class="programlisting">  “modtime”                  <span class="type">GDateTime</span> *</pre>
+<p>The time the output was last updated.  This must be set on object
+construction and represents the timestamp to put on the resulting
+file or <a class="link" href="gsf-Outfile-writing-structed-files.html#GsfOutfile"><span class="type">GsfOutfile</span></a> member.  Not all derived classes will actually
+do anything with this property.</p>
+<p>Flags: Read / Write / Construct Only</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GsfOutput--name"></a><h3>The <code class="literal">“name”</code> property</h3>
+<pre class="programlisting">  “name”                     <span class="type">gchar</span> *</pre>
+<p>The output's name.</p>
+<p>Flags: Read / Write</p>
+<p>Default value: NULL</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GsfOutput--position"></a><h3>The <code class="literal">“position”</code> property</h3>
+<pre class="programlisting">  “position”                 <span class="type">gint64</span></pre>
+<p>The current position in the output.</p>
+<p>Flags: Read</p>
+<p>Allowed values: &gt;= 0</p>
+<p>Default value: 0</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GsfOutput--size"></a><h3>The <code class="literal">“size”</code> property</h3>
+<pre class="programlisting">  “size”                     <span class="type">gint64</span></pre>
+<p>The current file size.</p>
+<p>Flags: Read</p>
+<p>Allowed values: &gt;= 0</p>
+<p>Default value: 0</p>
+</div>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.20</div>
+</body>
+</html>