<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>glibmm: Gio::FileOutputStream Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.6.1 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="examples.html"><span>Examples</span></a></li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<div class="navpath"><a class="el" href="namespaceGio.html">Gio</a>::<a class="el" href="classGio_1_1FileOutputStream.html">FileOutputStream</a>
</div>
</div>
<div class="contents">
<h1>Gio::FileOutputStream Class Reference<br/>
<small>
[<a class="el" href="group__Streams.html">Stream Classes</a>]</small>
</h1><!-- doxytag: class="Gio::FileOutputStream" --><!-- doxytag: inherits="Gio::OutputStream,Gio::Seekable" -->
<p><a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a> provides output streams that write their content to a file. <a href="#_details">More...</a></p>
<p>Inherits <a class="el" href="classGio_1_1OutputStream.html">Gio::OutputStream</a>, and <a class="el" href="classGio_1_1Seekable.html">Gio::Seekable</a>.</p>
<div class="dynheader">
Collaboration diagram for Gio::FileOutputStream:</div>
<div class="dynsection">
<div class="center"><img src="classGio_1_1FileOutputStream__coll__graph.png" border="0" usemap="#Gio_1_1FileOutputStream_coll__map" alt="Collaboration graph"/></div>
<map name="Gio_1_1FileOutputStream_coll__map" id="Gio_1_1FileOutputStream_coll__map">
<area shape="rect" href="classGio_1_1OutputStream.html" title="Base class for implementing streaming output." alt="" coords="5,237,136,267"/><area shape="rect" href="classGlib_1_1Object.html" title="Glib::Object" alt="" coords="31,160,121,189"/><area shape="rect" href="classGlib_1_1ObjectBase.html" title="Glib::ObjectBase is a common base class for Objects and Interfaces." alt="" coords="76,83,196,112"/><area shape="rect" href="classGlib_1_1Interface.html" title="Glib::Interface" alt="" coords="155,160,259,189"/><area shape="rect" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="83,5,189,35"/><area shape="rect" href="classGio_1_1Seekable.html" title="Stream seeking interface." alt="" coords="160,237,264,267"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<p><a href="classGio_1_1FileOutputStream-members.html">List of all members.</a></p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1FileOutputStream.html#ad441ab4039675535b59c65b4c5d14804">~FileOutputStream</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">GFileOutputStream* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1FileOutputStream.html#aa69b1c94c5a3a2e0002fc6cf5127fc70">gobj</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#aa69b1c94c5a3a2e0002fc6cf5127fc70"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const GFileOutputStream* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1FileOutputStream.html#a2bf847a5064b01e671731ecd56f88968">gobj</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#a2bf847a5064b01e671731ecd56f88968"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">GFileOutputStream* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1FileOutputStream.html#af536865a9ed17c3093ab67465fba908b">gobj_copy</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. <a href="#af536865a9ed17c3093ab67465fba908b"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1FileInfo.html">FileInfo</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1FileOutputStream.html#a660a0130611aad21965a3f74c2fe90cd">query_info</a> (const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> >& cancellable, const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a>& attributes="*")</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Queries a file output stream for the given <em>attributes</em> . <a href="#a660a0130611aad21965a3f74c2fe90cd"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1FileInfo.html">FileInfo</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1FileOutputStream.html#a9b67d7fa0b9309ca42dea8607d2ef3d5">query_info</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a>& attributes="*")</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Queries a file output stream for the given <em>attributes</em> . <a href="#a9b67d7fa0b9309ca42dea8607d2ef3d5"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1FileOutputStream.html#a926ddca8782aeb271560a058ee6554aa">query_info_async</a> (const <a class="el" href="namespaceGio.html#aecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&<a class="elRef" href="../../../libsigc++-2.0/reference/html/classsigc_1_1slot.html">slot</a>, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> >& cancellable, const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a>& attributes="*", int io_priority=Glib::PRIORITY_DEFAULT)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Queries the stream information asynchronously. <a href="#a926ddca8782aeb271560a058ee6554aa"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1FileOutputStream.html#aa9297d379f28510afd0d5dabba65a447">query_info_async</a> (const <a class="el" href="namespaceGio.html#aecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&<a class="elRef" href="../../../libsigc++-2.0/reference/html/classsigc_1_1slot.html">slot</a>, const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a>& attributes="*", int io_priority=Glib::PRIORITY_DEFAULT)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Queries the stream information asynchronously. <a href="#aa9297d379f28510afd0d5dabba65a447"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1FileInfo.html">FileInfo</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1FileOutputStream.html#aff73b62f94cc0be14f8271480aab6299">query_info_finish</a> (const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1AsyncResult.html">AsyncResult</a> >& result)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Finalizes the asynchronous query started by g_file_output_stream_query_info_async(). <a href="#aff73b62f94cc0be14f8271480aab6299"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1FileOutputStream.html#a8e29de4e67428a79b41180ca27af0a3d">get_etag</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the entity tag for the file when it has been written. <a href="#a8e29de4e67428a79b41180ca27af0a3d"></a><br/></td></tr>
<tr><td colspan="2"><h2>Related Functions</h2></td></tr>
<tr><td colspan="2"><p>(Note that these are not member functions.) </p>
<br/><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><br class="typebreak"/>
< <a class="el" href="classGio_1_1FileOutputStream.html">Gio::FileOutputStream</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1FileOutputStream.html#a5fe0a7a8069a65b4a83b36f3a54b3142">wrap</a> (GFileOutputStream* object, bool take_copy=false)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A <a class="el" href="namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#a5fe0a7a8069a65b4a83b36f3a54b3142"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p><a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a> provides output streams that write their content to a file. </p>
<p><a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a> implements <a class="el" href="classGio_1_1Seekable.html" title="Stream seeking interface.">Seekable</a>, which allows the output stream to jump to arbitrary positions in the file and to truncate the file, provided the file system of the file supports these operations. Use the methods of the <a class="el" href="classGio_1_1Seekable.html" title="Stream seeking interface.">Seekable</a> base class for seeking and positioning.</p>
<dl class="since_2_16"><dt><b><a class="el" href="since_2_16.html#_since_2_16000032">Since glibmm 2.16:</a></b></dt><dd></dd></dl>
<hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="ad441ab4039675535b59c65b4c5d14804"></a><!-- doxytag: member="Gio::FileOutputStream::~FileOutputStream" ref="ad441ab4039675535b59c65b4c5d14804" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual Gio::FileOutputStream::~FileOutputStream </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a8e29de4e67428a79b41180ca27af0a3d"></a><!-- doxytag: member="Gio::FileOutputStream::get_etag" ref="a8e29de4e67428a79b41180ca27af0a3d" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> Gio::FileOutputStream::get_etag </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the entity tag for the file when it has been written. </p>
<p>This must be called after the stream has been written and closed, as the etag can change while writing. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The entity tag for the stream. </dd></dl>
</div>
</div>
<a class="anchor" id="a2bf847a5064b01e671731ecd56f88968"></a><!-- doxytag: member="Gio::FileOutputStream::gobj" ref="a2bf847a5064b01e671731ecd56f88968" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const GFileOutputStream* Gio::FileOutputStream::gobj </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Provides access to the underlying C GObject. </p>
<p>Reimplemented from <a class="el" href="classGio_1_1OutputStream.html#ac29e6ad7ccffde24201a1da608f25ac9">Gio::OutputStream</a>.</p>
</div>
</div>
<a class="anchor" id="aa69b1c94c5a3a2e0002fc6cf5127fc70"></a><!-- doxytag: member="Gio::FileOutputStream::gobj" ref="aa69b1c94c5a3a2e0002fc6cf5127fc70" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GFileOutputStream* Gio::FileOutputStream::gobj </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Provides access to the underlying C GObject. </p>
<p>Reimplemented from <a class="el" href="classGio_1_1OutputStream.html#ac5a71a1f432f8ac2a53de2c66eb81d9d">Gio::OutputStream</a>.</p>
</div>
</div>
<a class="anchor" id="af536865a9ed17c3093ab67465fba908b"></a><!-- doxytag: member="Gio::FileOutputStream::gobj_copy" ref="af536865a9ed17c3093ab67465fba908b" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GFileOutputStream* Gio::FileOutputStream::gobj_copy </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. </p>
<p>Reimplemented from <a class="el" href="classGio_1_1OutputStream.html#ad9128985ea683716db40d7831cb7075c">Gio::OutputStream</a>.</p>
</div>
</div>
<a class="anchor" id="a9b67d7fa0b9309ca42dea8607d2ef3d5"></a><!-- doxytag: member="Gio::FileOutputStream::query_info" ref="a9b67d7fa0b9309ca42dea8607d2ef3d5" args="(const std::string &attributes="*")" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGio_1_1FileInfo.html">FileInfo</a>> Gio::FileOutputStream::query_info </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>attributes</em> = <code>"*"</code></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Queries a file output stream for the given <em>attributes</em> . </p>
<p>This function blocks while querying the stream. For the asynchronous version of this function, see <a class="el" href="classGio_1_1FileOutputStream.html#a926ddca8782aeb271560a058ee6554aa" title="Queries the stream information asynchronously.">query_info_async()</a>. While the stream is blocked, the stream will set the pending flag internally, and any other operations on the stream will throw a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with PENDING.</p>
<p>Can fail if the stream was already closed (with a CLOSED error), the stream has pending operations (with an PENDING error), or if querying info is not supported for the stream's interface (with a NOT_SUPPORTED error). In all cases of failure, an empty RefPtr will be returned.</p>
<p>The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with CANCELLED may be thrown, and an empty RefPtr will be returned.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>cancellable</em> </td><td>A <a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>attributes</em> </td><td>A file attribute query string. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> for the stream, or an empty RefPtr on error. </dd></dl>
</div>
</div>
<a class="anchor" id="a660a0130611aad21965a3f74c2fe90cd"></a><!-- doxytag: member="Gio::FileOutputStream::query_info" ref="a660a0130611aad21965a3f74c2fe90cd" args="(const Glib::RefPtr< Cancellable > &cancellable, const std::string &attributes="*")" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGio_1_1FileInfo.html">FileInfo</a>> Gio::FileOutputStream::query_info </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> >& </td>
<td class="paramname"> <em>cancellable</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>attributes</em> = <code>"*"</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Queries a file output stream for the given <em>attributes</em> . </p>
<p>This function blocks while querying the stream. For the asynchronous version of this function, see <a class="el" href="classGio_1_1FileOutputStream.html#a926ddca8782aeb271560a058ee6554aa" title="Queries the stream information asynchronously.">query_info_async()</a>. While the stream is blocked, the stream will set the pending flag internally, and any other operations on the stream will throw a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with PENDING.</p>
<p>Can fail if the stream was already closed (with a CLOSED error), the stream has pending operations (with a PENDING error), or if querying info is not supported for the stream's interface (with a NOT_SUPPORTED error). In all cases of failure, an empty RefPtr will be returned.</p>
<p>The operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with CANCELLED may be thrown, and an empty RefPtr will be returned.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>cancellable</em> </td><td>A <a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>attributes</em> </td><td>A file attribute query string. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> for the stream, or an empty RefPtr on error. </dd></dl>
</div>
</div>
<a class="anchor" id="aa9297d379f28510afd0d5dabba65a447"></a><!-- doxytag: member="Gio::FileOutputStream::query_info_async" ref="aa9297d379f28510afd0d5dabba65a447" args="(const SlotAsyncReady &slot, const std::string &attributes="*", int io_priority=Glib::PRIORITY_DEFAULT)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gio::FileOutputStream::query_info_async </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="namespaceGio.html#aecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>& </td>
<td class="paramname"> <em>slot</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>attributes</em> = <code>"*"</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Queries the stream information asynchronously. </p>
<p>When the operation is finished <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1FileOutputStream.html#aff73b62f94cc0be14f8271480aab6299" title="Finalizes the asynchronous query started by g_file_output_stream_query_info_async()...">query_info_finish()</a> to get the result of the operation.</p>
<p>For the synchronous version of this function, see <a class="el" href="classGio_1_1FileOutputStream.html#a660a0130611aad21965a3f74c2fe90cd" title="Queries a file output stream for the given attributes .">query_info()</a>.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>slot</em> </td><td>Callback to call when the request is satisfied. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>attributes</em> </td><td>A file attribute query string. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>io_priority</em> </td><td>The <io-priority of the request. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a926ddca8782aeb271560a058ee6554aa"></a><!-- doxytag: member="Gio::FileOutputStream::query_info_async" ref="a926ddca8782aeb271560a058ee6554aa" args="(const SlotAsyncReady &slot, const Glib::RefPtr< Cancellable > &cancellable, const std::string &attributes="*", int io_priority=Glib::PRIORITY_DEFAULT)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gio::FileOutputStream::query_info_async </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="namespaceGio.html#aecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>& </td>
<td class="paramname"> <em>slot</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1Cancellable.html">Cancellable</a> >& </td>
<td class="paramname"> <em>cancellable</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>attributes</em> = <code>"*"</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Queries the stream information asynchronously. </p>
<p>When the operation is finished <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1FileOutputStream.html#aff73b62f94cc0be14f8271480aab6299" title="Finalizes the asynchronous query started by g_file_output_stream_query_info_async()...">query_info_finish()</a> to get the result of the operation.</p>
<p>For the synchronous version of this function, see <a class="el" href="classGio_1_1FileOutputStream.html#a660a0130611aad21965a3f74c2fe90cd" title="Queries a file output stream for the given attributes .">query_info()</a>.</p>
<p>If <em>cancellable</em> is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with CANCELLED may be thrown</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>slot</em> </td><td>Callback to call when the request is satisfied. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>cancellable</em> </td><td>A <a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>attributes</em> </td><td>A file attribute query string. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>io_priority</em> </td><td>The <io-priority of the request. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="aff73b62f94cc0be14f8271480aab6299"></a><!-- doxytag: member="Gio::FileOutputStream::query_info_finish" ref="aff73b62f94cc0be14f8271480aab6299" args="(const Glib::RefPtr< AsyncResult > &result)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGio_1_1FileInfo.html">FileInfo</a>> Gio::FileOutputStream::query_info_finish </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1AsyncResult.html">AsyncResult</a> >& </td>
<td class="paramname"> <em>result</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Finalizes the asynchronous query started by g_file_output_stream_query_info_async(). </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>result</em> </td><td>A <a class="el" href="classGio_1_1AsyncResult.html" title="Provides a base class for implementing asynchronous function results.">AsyncResult</a>. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> for the finished query. </dd></dl>
</div>
</div>
<hr/><h2>Friends And Related Function Documentation</h2>
<a class="anchor" id="a5fe0a7a8069a65b4a83b36f3a54b3142"></a><!-- doxytag: member="Gio::FileOutputStream::wrap" ref="a5fe0a7a8069a65b4a83b36f3a54b3142" args="(GFileOutputStream *object, bool take_copy=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGio_1_1FileOutputStream.html">Gio::FileOutputStream</a> > wrap </td>
<td>(</td>
<td class="paramtype">GFileOutputStream * </td>
<td class="paramname"> <em>object</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>take_copy</em> = <code>false</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [related]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>A <a class="el" href="namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>object</em> </td><td>The C instance. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>take_copy</em> </td><td>False if the result should take ownership of the C instance. True if it should take a new copy or ref. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
</div>
</div>
<hr/>The documentation for this class was generated from the following file:<ul>
<li>giomm/fileoutputstream.h</li>
</ul>
</div>
<hr size="1"/><address style="text-align: right;"><small>Generated on Mon Sep 21 11:07:23 2009 for glibmm by 
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
</body>
</html>
