File: //usr/local/ssl/share/gtk-doc/html/gsf/gsf-memory.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>memory</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
<link rel="start" href="index.html" title="GSF Reference Manual">
<link rel="up" href="sources.html" title="Stream Sources">
<link rel="prev" href="gsf-Reading-and-Writing-from-local-files-and-directories.html" title="Reading and Writing from local files and directories">
<link rel="next" href="gsf-GIOChannel.html" title="GIOChannel">
<meta name="generator" content="GTK-Doc V1.6 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="intro.html" title="Part I. GSF: Introduction">
<link rel="part" href="history.html" title="Part II. GSF: History">
<link rel="part" href="dependencies.html" title="Part III. GSF: Dependencies">
<link rel="part" href="gsf-users.html" title="Part IV. Projects using GSF">
<link rel="part" href="api.html" title="Part V. API Reference">
<link rel="chapter" href="io.html" title="Basic Input/Output">
<link rel="chapter" href="sources.html" title="Stream Sources">
<link rel="chapter" href="parsers.html" title="Stream Parsers">
<link rel="chapter" href="misc.html" title="Miscellaneous">
<link rel="index" href="ix01.html" title="Index">
</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="2">
<tr valign="middle">
<td><a accesskey="p" href="gsf-Reading-and-Writing-from-local-files-and-directories.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="sources.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GSF Reference Manual</th>
<td><a accesskey="n" href="gsf-GIOChannel.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#top_of_page" class="shortcut">Top</a>
 | 
<a href="#desc" class="shortcut">Description</a>
 | 
<a href="#object_hierarchy" class="shortcut">Object Hierarchy</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="gsf-memory"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="top_of_page"></a>memory</span></h2>
<p>memory — </p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="synopsis"></a><h2>Synopsis</h2>
<a name="GsfInputMemory"></a><a name="GsfOutputMemory"></a><pre class="synopsis">
<a href="gsf-memory.html#GsfInputMemory-struct">GsfInputMemory</a>;
<a href="gsf-Input-from-unstructured-files.html#GsfInput">GsfInput</a>* <a href="gsf-memory.html#gsf-input-mmap-new">gsf_input_mmap_new</a> (char const *filename,
GError **err);
<a href="gsf-Input-from-unstructured-files.html#GsfInput">GsfInput</a>* <a href="gsf-memory.html#gsf-input-memory-new">gsf_input_memory_new</a> (guint8 const *buf,
<a href="gsf-utils.html#gsf-off-t">gsf_off_t</a> length,
gboolean needs_free);
<a href="gsf-Input-from-unstructured-files.html#GsfInput">GsfInput</a>* <a href="gsf-memory.html#gsf-input-memory-new-clone">gsf_input_memory_new_clone</a> (guint8 const *buf,
<a href="gsf-utils.html#gsf-off-t">gsf_off_t</a> length);
<a href="gsf-Input-from-unstructured-files.html#GsfInput">GsfInput</a>* <a href="gsf-memory.html#gsf-input-memory-new-from-iochannel">gsf_input_memory_new_from_iochannel</a>
(GIOChannel *channel,
GError **error);
<a href="gsf-memory.html#GsfOutputMemory-struct">GsfOutputMemory</a>;
const guint8* <a href="gsf-memory.html#gsf-output-memory-get-bytes">gsf_output_memory_get_bytes</a> (<a href="gsf-memory.html#GsfOutputMemory">GsfOutputMemory</a> *mem);
GType <a href="gsf-memory.html#gsf-output-memory-get-type">gsf_output_memory_get_type</a> (void);
<a href="gsf-Output-to-unstructured-files.html#GsfOutput">GsfOutput</a>* <a href="gsf-memory.html#gsf-output-memory-new">gsf_output_memory_new</a> (void);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="object_hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
GObject
+----<a href="gsf-Input-from-unstructured-files.html#GsfInput">GsfInput</a>
+----GsfInputMemory
</pre>
<pre class="synopsis">
GObject
+----<a href="gsf-Output-to-unstructured-files.html#GsfOutput">GsfOutput</a>
+----GsfOutputMemory
</pre>
</div>
<div class="refsect1" lang="en">
<a name="desc"></a><h2>Description</h2>
<p>
</p>
</div>
<div class="refsect1" lang="en">
<a name="details"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2537315"></a><h3>
<a name="GsfInputMemory-struct"></a>GsfInputMemory</h3>
<a class="indexterm" name="id2537327"></a><pre class="programlisting">typedef struct _GsfInputMemory GsfInputMemory;</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2537342"></a><h3>
<a name="gsf-input-mmap-new"></a>gsf_input_mmap_new ()</h3>
<a class="indexterm" name="id2537354"></a><pre class="programlisting"><a href="gsf-Input-from-unstructured-files.html#GsfInput">GsfInput</a>* gsf_input_mmap_new (char const *filename,
GError **err);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>filename</code></em> :</span></td>
<td> The file on disk that you want to mmap
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>err</code></em> :</span></td>
<td> A <span class="type">GError</span>, or optionally <code class="literal">null</code>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> A new <a href="gsf-memory.html#GsfInputMemory"><span class="type">GsfInputMemory</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2537462"></a><h3>
<a name="gsf-input-memory-new"></a>gsf_input_memory_new ()</h3>
<a class="indexterm" name="id2537474"></a><pre class="programlisting"><a href="gsf-Input-from-unstructured-files.html#GsfInput">GsfInput</a>* gsf_input_memory_new (guint8 const *buf,
<a href="gsf-utils.html#gsf-off-t">gsf_off_t</a> length,
gboolean needs_free);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>buf</code></em> :</span></td>
<td> The input bytes
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>length</code></em> :</span></td>
<td> The length of <em class="parameter"><code>buf</code></em>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>needs_free</code></em> :</span></td>
<td> Whether you want this memory to be free'd at object destruction
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> A new <a href="gsf-memory.html#GsfInputMemory"><span class="type">GsfInputMemory</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2537592"></a><h3>
<a name="gsf-input-memory-new-clone"></a>gsf_input_memory_new_clone ()</h3>
<a class="indexterm" name="id2537606"></a><pre class="programlisting"><a href="gsf-Input-from-unstructured-files.html#GsfInput">GsfInput</a>* gsf_input_memory_new_clone (guint8 const *buf,
<a href="gsf-utils.html#gsf-off-t">gsf_off_t</a> length);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>buf</code></em> :</span></td>
<td> The input bytes
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>length</code></em> :</span></td>
<td> The length of <em class="parameter"><code>buf</code></em>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> A new <a href="gsf-memory.html#GsfInputMemory"><span class="type">GsfInputMemory</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2537700"></a><h3>
<a name="gsf-input-memory-new-from-iochannel"></a>gsf_input_memory_new_from_iochannel ()</h3>
<a class="indexterm" name="id2537715"></a><pre class="programlisting"><a href="gsf-Input-from-unstructured-files.html#GsfInput">GsfInput</a>* gsf_input_memory_new_from_iochannel
(GIOChannel *channel,
GError **error);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>channel</code></em> :</span></td>
<td> a <span class="type">GIOChannel</span>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>error</code></em> :</span></td>
<td> a <span class="type">GError</span>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>a new <a href="gsf-memory.html#GsfInputMemory"><span class="type">GsfInputMemory</span></a> or NULL.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2537820"></a><h3>
<a name="GsfOutputMemory-struct"></a>GsfOutputMemory</h3>
<a class="indexterm" name="id2537833"></a><pre class="programlisting">typedef struct _GsfOutputMemory GsfOutputMemory;</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2537849"></a><h3>
<a name="gsf-output-memory-get-bytes"></a>gsf_output_memory_get_bytes ()</h3>
<a class="indexterm" name="id2537862"></a><pre class="programlisting">const guint8* gsf_output_memory_get_bytes (<a href="gsf-memory.html#GsfOutputMemory">GsfOutputMemory</a> *mem);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>mem</code></em> :</span></td>
<td> the output device.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> The data that has been written to <em class="parameter"><code>mem</code></em>, or <code class="literal">null</code>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2537939"></a><h3>
<a name="gsf-output-memory-get-type"></a>gsf_output_memory_get_type ()</h3>
<a class="indexterm" name="id2537952"></a><pre class="programlisting">GType gsf_output_memory_get_type (void);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2537988"></a><h3>
<a name="gsf-output-memory-new"></a>gsf_output_memory_new ()</h3>
<a class="indexterm" name="id2538001"></a><pre class="programlisting"><a href="gsf-Output-to-unstructured-files.html#GsfOutput">GsfOutput</a>* gsf_output_memory_new (void);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>a new file or NULL.
</td>
</tr></tbody>
</table></div>
</div>
</div>
</div>
</body>
</html>