~ubuntu-branches/debian/sid/glibmm2.4/sid

« back to all changes in this revision

Viewing changes to docs/reference/html/classGio_1_1FileIOStream.html

  • Committer: Bazaar Package Importer
  • Author(s): Deng Xiyue
  • Date: 2009-07-20 10:01:53 UTC
  • mfrom: (1.2.36 upstream)
  • Revision ID: james.westby@ubuntu.com-20090720100153-e2e4u4oshubnem3u
* New upstream release.
* Section of libglibmm-2.4-dbg is "debug" now.
* Update debian/copyright to conform to latest DEP 5.
  + Fix incorrect license.
  + Point to versioned license files.
* Update Standard-Version to 3.8.2.  No change required.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 
2
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
 
3
<title>glibmm 2.4: Gio::FileIOStream Class Reference</title>
 
4
<link href="doxygen.css" rel="stylesheet" type="text/css">
 
5
</head>
 
6
<body bgcolor="#ffffff">
 
7
<table border="0" width="100%">
 
8
<tr>
 
9
    <td width="10%" height="40"><img src="../../images/gtkmm_logo.gif" alt="logo" border="0" width="100%" height="100%"/></td>
 
10
    <td width="90%" height="40"><img src="../../images/top.gif" alt="top" width="100%" height="40"/></td>
 
11
</tr>
 
12
</table>
 
13
<center>
 
14
  <a class="qindex" href="http://www.gtkmm.org/documentation.shtml">Main Page</a> &nbsp;
 
15
  <a class="qindex" href="namespaces.html">glibmm Namespaces</a> &nbsp;
 
16
  <a href="../../../../gtkmm-2.4/docs/tutorial/html/index.html"> Book</a> &nbsp;
 
17
</center>
 
18
<hr width="100%"/>
 
19
 
 
20
<!-- begin main content -->
 
21
<div id="content">
 
22
<!-- Generated by Doxygen 1.5.6 -->
 
23
  <div class="navpath"><a class="el" href="namespaceGio.html">Gio</a>::<a class="el" href="classGio_1_1FileIOStream.html">FileIOStream</a>
 
24
  </div>
 
25
<div class="contents">
 
26
<h1>Gio::FileIOStream Class Reference<br>
 
27
<small>
 
28
[<a class="el" href="group__Streams.html">Stream Classes</a>]</small>
 
29
</h1><!-- doxytag: class="Gio::FileIOStream" --><!-- doxytag: inherits="Gio::IOStream,Gio::Seekable" --><a class="el" href="classGio_1_1FileIOStream.html" title="FileIOStream provides input streams that take their content from a file.">FileIOStream</a> provides input streams that take their content from a file.  
 
30
<a href="#_details">More...</a>
 
31
<p>
 
32
<div class="dynheader">
 
33
Inheritance diagram for Gio::FileIOStream:</div>
 
34
<div class="dynsection">
 
35
<p><center><img src="classGio_1_1FileIOStream__inherit__graph.png" border="0" usemap="#Gio_1_1FileIOStream__inherit__map" alt="Inheritance graph"></center>
 
36
<map name="Gio_1_1FileIOStream__inherit__map">
 
37
<area shape="rect" href="classGio_1_1IOStream.html" title="Gio::IOStream" alt="" coords="5,229,109,256"><area shape="rect" href="classGlib_1_1Object.html" title="Glib::Object" alt="" coords="13,155,104,181"><area shape="rect" href="classGlib_1_1ObjectBase.html" title="Glib::ObjectBase is a common base class for Objects and Interfaces." alt="" coords="59,80,179,107"><area shape="rect" href="classGlib_1_1Interface.html" title="Glib::Interface" alt="" coords="131,155,235,181"><area shape="rect" href="classsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="65,5,172,32"><area shape="rect" href="classGio_1_1Seekable.html" title="Stream seeking interface." alt="" coords="133,229,237,256"></map>
 
38
<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center></div>
 
39
 
 
40
<p>
 
41
<a href="classGio_1_1FileIOStream-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
 
42
<tr><td></td></tr>
 
43
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
 
44
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1FileIOStream.html#7b412e59741edea22ef424786aa2665a">~FileIOStream</a> ()</td></tr>
 
45
 
 
46
<tr><td class="memItemLeft" nowrap align="right" valign="top">GFileIOStream*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1FileIOStream.html#382fe1830e5e347db4ae0d941398c0df">gobj</a> ()</td></tr>
 
47
 
 
48
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Provides access to the underlying C GObject.  <a href="#382fe1830e5e347db4ae0d941398c0df"></a><br></td></tr>
 
49
<tr><td class="memItemLeft" nowrap align="right" valign="top">const GFileIOStream*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1FileIOStream.html#cd384df600b1aea26bd10ca2e74f1b21">gobj</a> () const </td></tr>
 
50
 
 
51
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Provides access to the underlying C GObject.  <a href="#cd384df600b1aea26bd10ca2e74f1b21"></a><br></td></tr>
 
52
<tr><td class="memItemLeft" nowrap align="right" valign="top">GFileIOStream*&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1FileIOStream.html#2661e78434e66d48a54aa67ddd4d4e53">gobj_copy</a> ()</td></tr>
 
53
 
 
54
<tr><td class="mdescLeft">&nbsp;</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="#2661e78434e66d48a54aa67ddd4d4e53"></a><br></td></tr>
 
55
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileInfo.html">FileInfo</a>&gt;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1FileIOStream.html#11c3696bd12879c7554a8be1246ca069">query_info</a> (const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1Cancellable.html">Cancellable</a>&gt;&amp; cancellable, const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a>&amp; attributes=&quot;*&quot;)</td></tr>
 
56
 
 
57
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Queries a file input stream the given <em>attributes</em>.  <a href="#11c3696bd12879c7554a8be1246ca069"></a><br></td></tr>
 
58
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileInfo.html">FileInfo</a>&gt;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1FileIOStream.html#1c4cefdd3b2ff134f01ecbc7a4439921">query_info</a> (const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a>&amp; attributes=&quot;*&quot;)</td></tr>
 
59
 
 
60
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Queries a file input stream the given <em>attributes</em>.  <a href="#1c4cefdd3b2ff134f01ecbc7a4439921"></a><br></td></tr>
 
61
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1FileIOStream.html#e83afafd7a40cc116026af5452c26151">query_info_async</a> (const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp; slot, const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1Cancellable.html">Cancellable</a>&gt;&amp; cancellable, const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a>&amp; attributes=&quot;*&quot;, int io_priority=Glib::PRIORITY_DEFAULT)</td></tr>
 
62
 
 
63
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Queries the stream information asynchronously.  <a href="#e83afafd7a40cc116026af5452c26151"></a><br></td></tr>
 
64
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1FileIOStream.html#eafe3bd19e6cf993dd7a2bb4e27ebd4d">query_info_async</a> (const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp; slot, const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a>&amp; attributes=&quot;*&quot;, int io_priority=Glib::PRIORITY_DEFAULT)</td></tr>
 
65
 
 
66
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Queries the stream information asynchronously.  <a href="#eafe3bd19e6cf993dd7a2bb4e27ebd4d"></a><br></td></tr>
 
67
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileInfo.html">FileInfo</a>&gt;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1FileIOStream.html#9838bea653f37c9ff298e16a96ce11dd">query_info_finish</a> (const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1AsyncResult.html">AsyncResult</a>&gt;&amp; result)</td></tr>
 
68
 
 
69
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Finalizes the asynchronous query started by g_file_io_stream_query_info_async().  <a href="#9838bea653f37c9ff298e16a96ce11dd"></a><br></td></tr>
 
70
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a>&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1FileIOStream.html#98607843697e850776bd6736a93df4d5">get_etag</a> () const </td></tr>
 
71
 
 
72
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Gets the entity tag for the file when it has been written.  <a href="#98607843697e850776bd6736a93df4d5"></a><br></td></tr>
 
73
<tr><td colspan="2"><br><h2>Related Functions</h2></td></tr>
 
74
<tr><td colspan="2">(Note that these are not member functions.) <br><br></td></tr>
 
75
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileIOStream.html">Gio::FileIOStream</a>&gt;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1FileIOStream.html#44679bcc0dadcf0eb3bf2691e51e7e98">wrap</a> (GFileIOStream* object, bool take_copy=false)</td></tr>
 
76
 
 
77
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A <a class="el" href="namespaceGlib.html#671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object.  <a href="#44679bcc0dadcf0eb3bf2691e51e7e98"></a><br></td></tr>
 
78
</table>
 
79
<hr><a name="_details"></a><h2>Detailed Description</h2>
 
80
<a class="el" href="classGio_1_1FileIOStream.html" title="FileIOStream provides input streams that take their content from a file.">FileIOStream</a> provides input streams that take their content from a file. 
 
81
<p>
 
82
<a class="el" href="classGio_1_1FileInputStream.html" title="FileInputStream provides input streams that take their content from a file.">FileInputStream</a> implements <a class="el" href="classGio_1_1Seekable.html" title="Stream seeking interface.">Seekable</a>, which allows the input stream to jump to arbitrary positions in the file, provided the file system of the file allows it. 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.<hr><h2>Constructor&amp; Destructor Documentation</h2>
 
83
<a class="anchor" name="7b412e59741edea22ef424786aa2665a"></a><!-- doxytag: member="Gio::FileIOStream::~FileIOStream" ref="7b412e59741edea22ef424786aa2665a" args="()" -->
 
84
<div class="memitem">
 
85
<div class="memproto">
 
86
      <table class="memname">
 
87
        <tr>
 
88
          <td class="memname">virtual Gio::FileIOStream::~FileIOStream           </td>
 
89
          <td>(</td>
 
90
          <td class="paramname">          </td>
 
91
          <td>&nbsp;)&nbsp;</td>
 
92
          <td><code> [virtual]</code></td>
 
93
        </tr>
 
94
      </table>
 
95
</div>
 
96
<div class="memdoc">
 
97
 
 
98
<p>
 
99
 
 
100
</div>
 
101
</div><p>
 
102
<hr><h2>Member Function Documentation</h2>
 
103
<a class="anchor" name="382fe1830e5e347db4ae0d941398c0df"></a><!-- doxytag: member="Gio::FileIOStream::gobj" ref="382fe1830e5e347db4ae0d941398c0df" args="()" -->
 
104
<div class="memitem">
 
105
<div class="memproto">
 
106
      <table class="memname">
 
107
        <tr>
 
108
          <td class="memname">GFileIOStream* Gio::FileIOStream::gobj           </td>
 
109
          <td>(</td>
 
110
          <td class="paramname">          </td>
 
111
          <td>&nbsp;)&nbsp;</td>
 
112
          <td><code> [inline]</code></td>
 
113
        </tr>
 
114
      </table>
 
115
</div>
 
116
<div class="memdoc">
 
117
 
 
118
<p>
 
119
Provides access to the underlying C GObject. 
 
120
<p>
 
121
 
 
122
<p>Reimplemented from <a class="el" href="classGio_1_1IOStream.html#6e8d13f8095555cecbe0d59f1542893f">Gio::IOStream</a>.</p>
 
123
 
 
124
</div>
 
125
</div><p>
 
126
<a class="anchor" name="cd384df600b1aea26bd10ca2e74f1b21"></a><!-- doxytag: member="Gio::FileIOStream::gobj" ref="cd384df600b1aea26bd10ca2e74f1b21" args="() const " -->
 
127
<div class="memitem">
 
128
<div class="memproto">
 
129
      <table class="memname">
 
130
        <tr>
 
131
          <td class="memname">const GFileIOStream* Gio::FileIOStream::gobj           </td>
 
132
          <td>(</td>
 
133
          <td class="paramname">          </td>
 
134
          <td>&nbsp;)&nbsp;</td>
 
135
          <td> const<code> [inline]</code></td>
 
136
        </tr>
 
137
      </table>
 
138
</div>
 
139
<div class="memdoc">
 
140
 
 
141
<p>
 
142
Provides access to the underlying C GObject. 
 
143
<p>
 
144
 
 
145
<p>Reimplemented from <a class="el" href="classGio_1_1IOStream.html#94eb81fa811399ece0ef743cd9d178ae">Gio::IOStream</a>.</p>
 
146
 
 
147
</div>
 
148
</div><p>
 
149
<a class="anchor" name="2661e78434e66d48a54aa67ddd4d4e53"></a><!-- doxytag: member="Gio::FileIOStream::gobj_copy" ref="2661e78434e66d48a54aa67ddd4d4e53" args="()" -->
 
150
<div class="memitem">
 
151
<div class="memproto">
 
152
      <table class="memname">
 
153
        <tr>
 
154
          <td class="memname">GFileIOStream* Gio::FileIOStream::gobj_copy           </td>
 
155
          <td>(</td>
 
156
          <td class="paramname">          </td>
 
157
          <td>&nbsp;)&nbsp;</td>
 
158
          <td></td>
 
159
        </tr>
 
160
      </table>
 
161
</div>
 
162
<div class="memdoc">
 
163
 
 
164
<p>
 
165
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. 
 
166
<p>
 
167
 
 
168
<p>Reimplemented from <a class="el" href="classGio_1_1IOStream.html#632594c5b02e0311448e79f6d495c65a">Gio::IOStream</a>.</p>
 
169
 
 
170
</div>
 
171
</div><p>
 
172
<a class="anchor" name="11c3696bd12879c7554a8be1246ca069"></a><!-- doxytag: member="Gio::FileIOStream::query_info" ref="11c3696bd12879c7554a8be1246ca069" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, const std::string &amp;attributes=&quot;*&quot;)" -->
 
173
<div class="memitem">
 
174
<div class="memproto">
 
175
      <table class="memname">
 
176
        <tr>
 
177
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileInfo.html">FileInfo</a>&gt; Gio::FileIOStream::query_info           </td>
 
178
          <td>(</td>
 
179
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1Cancellable.html">Cancellable</a>&gt;&amp;&nbsp;</td>
 
180
          <td class="paramname"> <em>cancellable</em>, </td>
 
181
        </tr>
 
182
        <tr>
 
183
          <td class="paramkey"></td>
 
184
          <td></td>
 
185
          <td class="paramtype">const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> &amp;&nbsp;</td>
 
186
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code></td><td>&nbsp;</td>
 
187
        </tr>
 
188
        <tr>
 
189
          <td></td>
 
190
          <td>)</td>
 
191
          <td></td><td></td><td></td>
 
192
        </tr>
 
193
      </table>
 
194
</div>
 
195
<div class="memdoc">
 
196
 
 
197
<p>
 
198
Queries a file input stream the given <em>attributes</em>. 
 
199
<p>
 
200
This function blocks while querying the stream. For the asynchronous (non-blocking) version of this function, see <a class="el" href="classGio_1_1FileIOStream.html#e83afafd7a40cc116026af5452c26151" 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>
 
201
<dl compact><dt><b>Parameters:</b></dt><dd>
 
202
  <table border="0" cellspacing="2" cellpadding="0">
 
203
    <tr><td valign="top"></td><td valign="top"><em>attributes</em>&nbsp;</td><td>A file attribute query string. </td></tr>
 
204
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td>A <a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
 
205
  </table>
 
206
</dl>
 
207
<dl class="return" compact><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>, or an empty RefPtr on error. </dd></dl>
 
208
 
 
209
</div>
 
210
</div><p>
 
211
<a class="anchor" name="1c4cefdd3b2ff134f01ecbc7a4439921"></a><!-- doxytag: member="Gio::FileIOStream::query_info" ref="1c4cefdd3b2ff134f01ecbc7a4439921" args="(const std::string &amp;attributes=&quot;*&quot;)" -->
 
212
<div class="memitem">
 
213
<div class="memproto">
 
214
      <table class="memname">
 
215
        <tr>
 
216
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileInfo.html">FileInfo</a>&gt; Gio::FileIOStream::query_info           </td>
 
217
          <td>(</td>
 
218
          <td class="paramtype">const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> &amp;&nbsp;</td>
 
219
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code>          </td>
 
220
          <td>&nbsp;)&nbsp;</td>
 
221
          <td></td>
 
222
        </tr>
 
223
      </table>
 
224
</div>
 
225
<div class="memdoc">
 
226
 
 
227
<p>
 
228
Queries a file input stream the given <em>attributes</em>. 
 
229
<p>
 
230
This function blocks while querying the stream. For the asynchronous (non-blocking) version of this function, see <a class="el" href="classGio_1_1FileIOStream.html#e83afafd7a40cc116026af5452c26151" 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>
 
231
<dl compact><dt><b>Parameters:</b></dt><dd>
 
232
  <table border="0" cellspacing="2" cellpadding="0">
 
233
    <tr><td valign="top"></td><td valign="top"><em>attributes</em>&nbsp;</td><td>A file attribute query string. </td></tr>
 
234
  </table>
 
235
</dl>
 
236
<dl class="return" compact><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>, or an empty RefPtr on error. </dd></dl>
 
237
 
 
238
</div>
 
239
</div><p>
 
240
<a class="anchor" name="e83afafd7a40cc116026af5452c26151"></a><!-- doxytag: member="Gio::FileIOStream::query_info_async" ref="e83afafd7a40cc116026af5452c26151" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, const std::string &amp;attributes=&quot;*&quot;, int io_priority=Glib::PRIORITY_DEFAULT)" -->
 
241
<div class="memitem">
 
242
<div class="memproto">
 
243
      <table class="memname">
 
244
        <tr>
 
245
          <td class="memname">void Gio::FileIOStream::query_info_async           </td>
 
246
          <td>(</td>
 
247
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
248
          <td class="paramname"> <em>slot</em>, </td>
 
249
        </tr>
 
250
        <tr>
 
251
          <td class="paramkey"></td>
 
252
          <td></td>
 
253
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1Cancellable.html">Cancellable</a>&gt;&amp;&nbsp;</td>
 
254
          <td class="paramname"> <em>cancellable</em>, </td>
 
255
        </tr>
 
256
        <tr>
 
257
          <td class="paramkey"></td>
 
258
          <td></td>
 
259
          <td class="paramtype">const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> &amp;&nbsp;</td>
 
260
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code>, </td>
 
261
        </tr>
 
262
        <tr>
 
263
          <td class="paramkey"></td>
 
264
          <td></td>
 
265
          <td class="paramtype">int&nbsp;</td>
 
266
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
 
267
        </tr>
 
268
        <tr>
 
269
          <td></td>
 
270
          <td>)</td>
 
271
          <td></td><td></td><td></td>
 
272
        </tr>
 
273
      </table>
 
274
</div>
 
275
<div class="memdoc">
 
276
 
 
277
<p>
 
278
Queries the stream information asynchronously. 
 
279
<p>
 
280
For the synchronous version of this function, see <a class="el" href="classGio_1_1FileIOStream.html#11c3696bd12879c7554a8be1246ca069" title="Queries a file input stream the given attributes.">query_info()</a>.<p>
 
281
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 will be thrown.<p>
 
282
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1FileIOStream.html#9838bea653f37c9ff298e16a96ce11dd" title="Finalizes the asynchronous query started by g_file_io_stream_query_info_async().">query_info_finish()</a> to get the result of the operation.<p>
 
283
<dl compact><dt><b>Parameters:</b></dt><dd>
 
284
  <table border="0" cellspacing="2" cellpadding="0">
 
285
    <tr><td valign="top"></td><td valign="top"><em>slot</em>&nbsp;</td><td>A callback slot which will be called when the request is satisfied. </td></tr>
 
286
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td>A <a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object which can be used to cancel the operation. </td></tr>
 
287
    <tr><td valign="top"></td><td valign="top"><em>attributes</em>&nbsp;</td><td>A file attribute query string. </td></tr>
 
288
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
 
289
  </table>
 
290
</dl>
 
291
 
 
292
</div>
 
293
</div><p>
 
294
<a class="anchor" name="eafe3bd19e6cf993dd7a2bb4e27ebd4d"></a><!-- doxytag: member="Gio::FileIOStream::query_info_async" ref="eafe3bd19e6cf993dd7a2bb4e27ebd4d" args="(const SlotAsyncReady &amp;slot, const std::string &amp;attributes=&quot;*&quot;, int io_priority=Glib::PRIORITY_DEFAULT)" -->
 
295
<div class="memitem">
 
296
<div class="memproto">
 
297
      <table class="memname">
 
298
        <tr>
 
299
          <td class="memname">void Gio::FileIOStream::query_info_async           </td>
 
300
          <td>(</td>
 
301
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
302
          <td class="paramname"> <em>slot</em>, </td>
 
303
        </tr>
 
304
        <tr>
 
305
          <td class="paramkey"></td>
 
306
          <td></td>
 
307
          <td class="paramtype">const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> &amp;&nbsp;</td>
 
308
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code>, </td>
 
309
        </tr>
 
310
        <tr>
 
311
          <td class="paramkey"></td>
 
312
          <td></td>
 
313
          <td class="paramtype">int&nbsp;</td>
 
314
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
 
315
        </tr>
 
316
        <tr>
 
317
          <td></td>
 
318
          <td>)</td>
 
319
          <td></td><td></td><td></td>
 
320
        </tr>
 
321
      </table>
 
322
</div>
 
323
<div class="memdoc">
 
324
 
 
325
<p>
 
326
Queries the stream information asynchronously. 
 
327
<p>
 
328
For the synchronous version of this function, see <a class="el" href="classGio_1_1FileIOStream.html#11c3696bd12879c7554a8be1246ca069" title="Queries a file input stream the given attributes.">query_info()</a>.<p>
 
329
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1FileIOStream.html#9838bea653f37c9ff298e16a96ce11dd" title="Finalizes the asynchronous query started by g_file_io_stream_query_info_async().">query_info_finish()</a> to get the result of the operation.<p>
 
330
<dl compact><dt><b>Parameters:</b></dt><dd>
 
331
  <table border="0" cellspacing="2" cellpadding="0">
 
332
    <tr><td valign="top"></td><td valign="top"><em>slot</em>&nbsp;</td><td>A callback slot which will be called when the request is satisfied. </td></tr>
 
333
    <tr><td valign="top"></td><td valign="top"><em>attributes</em>&nbsp;</td><td>A file attribute query string. </td></tr>
 
334
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
 
335
  </table>
 
336
</dl>
 
337
 
 
338
</div>
 
339
</div><p>
 
340
<a class="anchor" name="9838bea653f37c9ff298e16a96ce11dd"></a><!-- doxytag: member="Gio::FileIOStream::query_info_finish" ref="9838bea653f37c9ff298e16a96ce11dd" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
 
341
<div class="memitem">
 
342
<div class="memproto">
 
343
      <table class="memname">
 
344
        <tr>
 
345
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileInfo.html">FileInfo</a>&gt; Gio::FileIOStream::query_info_finish           </td>
 
346
          <td>(</td>
 
347
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1AsyncResult.html">AsyncResult</a>&gt;&amp;&nbsp;</td>
 
348
          <td class="paramname"> <em>result</em>          </td>
 
349
          <td>&nbsp;)&nbsp;</td>
 
350
          <td></td>
 
351
        </tr>
 
352
      </table>
 
353
</div>
 
354
<div class="memdoc">
 
355
 
 
356
<p>
 
357
Finalizes the asynchronous query started by g_file_io_stream_query_info_async(). 
 
358
<p>
 
359
<dl compact><dt><b>Parameters:</b></dt><dd>
 
360
  <table border="0" cellspacing="2" cellpadding="0">
 
361
    <tr><td valign="top"></td><td valign="top"><em>result</em>&nbsp;</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>
 
362
  </table>
 
363
</dl>
 
364
<dl class="return" compact><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>
 
365
 
366
</div>
 
367
</div><p>
 
368
<a class="anchor" name="98607843697e850776bd6736a93df4d5"></a><!-- doxytag: member="Gio::FileIOStream::get_etag" ref="98607843697e850776bd6736a93df4d5" args="() const " -->
 
369
<div class="memitem">
 
370
<div class="memproto">
 
371
      <table class="memname">
 
372
        <tr>
 
373
          <td class="memname"><a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> Gio::FileIOStream::get_etag           </td>
 
374
          <td>(</td>
 
375
          <td class="paramname">          </td>
 
376
          <td>&nbsp;)&nbsp;</td>
 
377
          <td> const</td>
 
378
        </tr>
 
379
      </table>
 
380
</div>
 
381
<div class="memdoc">
 
382
 
 
383
<p>
 
384
Gets the entity tag for the file when it has been written. 
 
385
<p>
 
386
This must be called after the stream has been written and closed, as the etag can change while writing. <dl class="return" compact><dt><b>Returns:</b></dt><dd>The entity tag for the stream.</dd></dl>
 
387
 
388
</div>
 
389
</div><p>
 
390
<hr><h2>Friends And Related Function Documentation</h2>
 
391
<a class="anchor" name="44679bcc0dadcf0eb3bf2691e51e7e98"></a><!-- doxytag: member="Gio::FileIOStream::wrap" ref="44679bcc0dadcf0eb3bf2691e51e7e98" args="(GFileIOStream *object, bool take_copy=false)" -->
 
392
<div class="memitem">
 
393
<div class="memproto">
 
394
      <table class="memname">
 
395
        <tr>
 
396
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileIOStream.html">Gio::FileIOStream</a>&gt; wrap           </td>
 
397
          <td>(</td>
 
398
          <td class="paramtype">GFileIOStream *&nbsp;</td>
 
399
          <td class="paramname"> <em>object</em>, </td>
 
400
        </tr>
 
401
        <tr>
 
402
          <td class="paramkey"></td>
 
403
          <td></td>
 
404
          <td class="paramtype">bool&nbsp;</td>
 
405
          <td class="paramname"> <em>take_copy</em> = <code>false</code></td><td>&nbsp;</td>
 
406
        </tr>
 
407
        <tr>
 
408
          <td></td>
 
409
          <td>)</td>
 
410
          <td></td><td></td><td><code> [related]</code></td>
 
411
        </tr>
 
412
      </table>
 
413
</div>
 
414
<div class="memdoc">
 
415
 
 
416
<p>
 
417
A <a class="el" href="namespaceGlib.html#671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. 
 
418
<p>
 
419
<dl compact><dt><b>Parameters:</b></dt><dd>
 
420
  <table border="0" cellspacing="2" cellpadding="0">
 
421
    <tr><td valign="top"></td><td valign="top"><em>object</em>&nbsp;</td><td>The C instance. </td></tr>
 
422
    <tr><td valign="top"></td><td valign="top"><em>take_copy</em>&nbsp;</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>
 
423
  </table>
 
424
</dl>
 
425
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
 
426
 
 
427
</div>
 
428
</div><p>
 
429
<hr>The documentation for this class was generated from the following file:<ul>
 
430
<li><a class="el" href="fileiostream_8h.html">fileiostream.h</a></ul>
 
431
</div>
 
432
</div> <!-- end main content -->
 
433
 
 
434
<hr><address><small>
 
435
Generated for glibmm 2.4 by <a href="http://www.doxygen.org/index.html">
 
436
Doxygen</a> 1.5.6 &copy;&nbsp;1997-2001</small></address>
 
437
</body>
 
438
</html>