← Back to branch summary

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

« back to all changes in this revision

Viewing changes to docs/reference/html/classGio_1_1File.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:
docs/reference/html/classGio_1_1File.html
19
19
 
20
20
<!-- begin main content -->
21
21
<div id="content">
22
 
<!-- Generated by Doxygen 1.5.8 -->
 
22
<!-- Generated by Doxygen 1.5.6 -->
23
23
  <div class="navpath"><a class="el" href="namespaceGio.html">Gio</a>::<a class="el" href="classGio_1_1File.html">File</a>
24
24
  </div>
25
25
<div class="contents">
30
30
Inheritance diagram for Gio::File:</div>
31
31
<div class="dynsection">
32
32
<p><center><img src="classGio_1_1File__inherit__graph.png" border="0" usemap="#Gio_1_1File__inherit__map" alt="Inheritance graph"></center>
 
33
<map name="Gio_1_1File__inherit__map">
 
34
<area shape="rect" href="classGlib_1_1Interface.html" title="Glib::Interface" alt="" coords="13,154,117,181"><area shape="rect" href="classGlib_1_1ObjectBase.html" title="Glib::ObjectBase is a common base class for Objects and Interfaces." alt="" coords="5,80,125,106"><area shape="rect" href="classsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="12,5,119,32"></map>
33
35
<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center></div>
34
36
 
35
37
<p>
36
38
<a href="classGio_1_1File-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
37
39
<tr><td></td></tr>
38
40
<tr><td colspan="2"><br><h2>Public Types</h2></td></tr>
39
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef sigc::slot&lt; void, <br class="typebreak">
 
41
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef sigc::slot&lt; void, <br>
40
42
goffset, goffset &gt;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1File.html#c5ff32ee99845479d138eee49d92e59c">SlotFileProgress</a></td></tr>
41
43
 
42
44
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A signal handler would be, for instance: void on_file_progress(goffset current_num_bytes, goffset total_num_bytes);.  <a href="#c5ff32ee99845479d138eee49d92e59c"></a><br></td></tr>
43
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef sigc::slot&lt; bool, <br class="typebreak">
 
45
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef sigc::slot&lt; bool, <br>
44
46
const char*, goffset &gt;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1File.html#dd182d22071784fc345adc757b3d687b">SlotReadMore</a></td></tr>
45
47
 
46
48
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">A signal handler would be, for instance: bool on_read_more(const char* file_contents, goffset file_size);.  <a href="#dd182d22071784fc345adc757b3d687b"></a><br></td></tr>
307
309
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1File.html#8a9a3d060c2675ff9ac1c758f0b2c024">make_symbolic_link</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; symlink_value)</td></tr>
308
310
 
309
311
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Creates a symbolic link.  <a href="#8a9a3d060c2675ff9ac1c758f0b2c024"></a><br></td></tr>
310
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><br class="typebreak">
 
312
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><br>
311
313
&lt;<a class="el" href="classGio_1_1FileAttributeInfoList.html">FileAttributeInfoList</a>&gt;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1File.html#4a543339b58cff6a7e5ddd840df0e69e">query_settable_attributes</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)</td></tr>
312
314
 
313
315
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Obtain the list of settable attributes for the file.  <a href="#4a543339b58cff6a7e5ddd840df0e69e"></a><br></td></tr>
314
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><br class="typebreak">
 
316
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><br>
315
317
&lt;<a class="el" href="classGio_1_1FileAttributeInfoList.html">FileAttributeInfoList</a>&gt;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1File.html#1ae03d0652bcfbad2f47409b8f815bc4">query_settable_attributes</a> ()</td></tr>
316
318
 
317
319
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Obtain the list of settable attributes for the file.  <a href="#1ae03d0652bcfbad2f47409b8f815bc4"></a><br></td></tr>
318
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><br class="typebreak">
 
320
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><br>
319
321
&lt;<a class="el" href="classGio_1_1FileAttributeInfoList.html">FileAttributeInfoList</a>&gt;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1File.html#f5c7463b92e2887597486e7b195ca12f">query_writable_namespaces</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)</td></tr>
320
322
 
321
323
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Obtain the list of attribute namespaces where new attributes can be created by a user.  <a href="#f5c7463b92e2887597486e7b195ca12f"></a><br></td></tr>
322
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><br class="typebreak">
 
324
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a><br>
323
325
&lt;<a class="el" href="classGio_1_1FileAttributeInfoList.html">FileAttributeInfoList</a>&gt;&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGio_1_1File.html#a0278acd7d09ed292359004defb742b0">query_writable_namespaces</a> ()</td></tr>
324
326
 
325
327
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Obtain the list of attribute namespaces where new attributes can be created by a user.  <a href="#a0278acd7d09ed292359004defb742b0"></a><br></td></tr>
617
619
 
618
620
</div>
619
621
</div><p>
620
 
<a class="anchor" name="8db337b93f3b9b9a6e163477391e6c89"></a><!-- doxytag: member="Gio::File::append_to" ref="8db337b93f3b9b9a6e163477391e6c89" args="(FileCreateFlags flags=FILE_CREATE_NONE)" -->
621
 
<div class="memitem">
622
 
<div class="memproto">
623
 
      <table class="memname">
624
 
        <tr>
625
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileOutputStream.html">FileOutputStream</a>&gt; Gio::File::append_to           </td>
626
 
          <td>(</td>
627
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
628
 
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code>          </td>
629
 
          <td>&nbsp;)&nbsp;</td>
630
 
          <td></td>
631
 
        </tr>
632
 
      </table>
633
 
</div>
634
 
<div class="memdoc">
635
 
 
636
 
<p>
637
 
Gets an output stream for appending data to the file. 
638
 
<p>
639
 
If the file doesn't already exist it is created.<p>
640
 
By default files created are generally readable by everyone, but if you pass FILE_CREATE_PRIVATE in <em>flags</em> the file will be made readable only to the current user, to the level that is supported on the target filesystem.<p>
641
 
Some filesystems don't allow all filenames, and may throw a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with INVALID_FILENAME. If the file is a directory a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with IS_DIRECTORY will be thrown. Other errors are possible too, and depend on what kind of filesystem the file is on. <dl compact><dt><b>Parameters:</b></dt><dd>
642
 
  <table border="0" cellspacing="2" cellpadding="0">
643
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
644
 
  </table>
645
 
</dl>
646
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a>. </dd></dl>
647
 
 
648
 
</div>
649
 
</div><p>
650
 
<a class="anchor" name="91c93ee71eee738690cb551d11df9528"></a><!-- doxytag: member="Gio::File::append_to" ref="91c93ee71eee738690cb551d11df9528" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileCreateFlags flags=FILE_CREATE_NONE)" -->
651
 
<div class="memitem">
652
 
<div class="memproto">
653
 
      <table class="memname">
654
 
        <tr>
655
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileOutputStream.html">FileOutputStream</a>&gt; Gio::File::append_to           </td>
656
 
          <td>(</td>
657
 
          <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>
658
 
          <td class="paramname"> <em>cancellable</em>, </td>
659
 
        </tr>
660
 
        <tr>
661
 
          <td class="paramkey"></td>
662
 
          <td></td>
663
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
664
 
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
665
 
        </tr>
666
 
        <tr>
667
 
          <td></td>
668
 
          <td>)</td>
669
 
          <td></td><td></td><td></td>
670
 
        </tr>
671
 
      </table>
672
 
</div>
673
 
<div class="memdoc">
674
 
 
675
 
<p>
676
 
Gets an output stream for appending data to the file. 
677
 
<p>
678
 
If the file doesn't already exist it is created.<p>
679
 
By default files created are generally readable by everyone, but if you pass FILE_CREATE_PRIVATE in <em>flags</em> the file will be made readable only to the current user, to the level that is supported on the target filesystem.<p>
680
 
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>
681
 
Some filesystems don't allow all filenames, and may throw a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with INVALID_FILENAME. If the file is a directory a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with IS_DIRECTORY will be thrown. Other errors are possible too, and depend on what kind of filesystem the file is on. <dl compact><dt><b>Parameters:</b></dt><dd>
682
 
  <table border="0" cellspacing="2" cellpadding="0">
683
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
684
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td>Optional <a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
685
 
  </table>
686
 
</dl>
687
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a>. </dd></dl>
688
 
 
689
 
</div>
690
 
</div><p>
691
 
<a class="anchor" name="bff3163e9bf8d8208cd0c0e568b777de"></a><!-- doxytag: member="Gio::File::append_to_async" ref="bff3163e9bf8d8208cd0c0e568b777de" args="(const SlotAsyncReady &amp;slot, FileCreateFlags flags=FILE_CREATE_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
692
 
<div class="memitem">
693
 
<div class="memproto">
694
 
      <table class="memname">
695
 
        <tr>
696
 
          <td class="memname">void Gio::File::append_to_async           </td>
697
 
          <td>(</td>
698
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
699
 
          <td class="paramname"> <em>slot</em>, </td>
700
 
        </tr>
701
 
        <tr>
702
 
          <td class="paramkey"></td>
703
 
          <td></td>
704
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
705
 
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code>, </td>
706
 
        </tr>
707
 
        <tr>
708
 
          <td class="paramkey"></td>
709
 
          <td></td>
710
 
          <td class="paramtype">int&nbsp;</td>
711
 
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
712
 
        </tr>
713
 
        <tr>
714
 
          <td></td>
715
 
          <td>)</td>
716
 
          <td></td><td></td><td></td>
717
 
        </tr>
718
 
      </table>
719
 
</div>
720
 
<div class="memdoc">
721
 
 
722
 
<p>
723
 
Asynchronously opens the file for appending. 
724
 
<p>
725
 
For more details, see <a class="el" href="classGio_1_1File.html#91c93ee71eee738690cb551d11df9528" title="Gets an output stream for appending data to the file.">append_to()</a> which is the synchronous version of this call.<p>
726
 
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#cb1f2d32055b8da274ea241c69487dc6" title="Finishes an asynchronous file append operation started with g_file_append_to_async()...">append_to_finish()</a> to get the result of the operation. <dl compact><dt><b>Parameters:</b></dt><dd>
727
 
  <table border="0" cellspacing="2" cellpadding="0">
728
 
    <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>
729
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>a set of FileCreateFlags. </td></tr>
730
 
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
731
 
  </table>
732
 
</dl>
733
 
 
734
 
</div>
735
 
</div><p>
736
 
<a class="anchor" name="1e3dfb193e8f2ab69e24c4370de5335a"></a><!-- doxytag: member="Gio::File::append_to_async" ref="1e3dfb193e8f2ab69e24c4370de5335a" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileCreateFlags flags=FILE_CREATE_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
737
 
<div class="memitem">
738
 
<div class="memproto">
739
 
      <table class="memname">
740
 
        <tr>
741
 
          <td class="memname">void Gio::File::append_to_async           </td>
742
 
          <td>(</td>
743
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
744
 
          <td class="paramname"> <em>slot</em>, </td>
745
 
        </tr>
746
 
        <tr>
747
 
          <td class="paramkey"></td>
748
 
          <td></td>
749
 
          <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>
750
 
          <td class="paramname"> <em>cancellable</em>, </td>
751
 
        </tr>
752
 
        <tr>
753
 
          <td class="paramkey"></td>
754
 
          <td></td>
755
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
756
 
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code>, </td>
757
 
        </tr>
758
 
        <tr>
759
 
          <td class="paramkey"></td>
760
 
          <td></td>
761
 
          <td class="paramtype">int&nbsp;</td>
762
 
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
763
 
        </tr>
764
 
        <tr>
765
 
          <td></td>
766
 
          <td>)</td>
767
 
          <td></td><td></td><td></td>
768
 
        </tr>
769
 
      </table>
770
 
</div>
771
 
<div class="memdoc">
772
 
 
773
 
<p>
774
 
Asynchronously opens the file for appending. 
775
 
<p>
776
 
For more details, see <a class="el" href="classGio_1_1File.html#91c93ee71eee738690cb551d11df9528" title="Gets an output stream for appending data to the file.">append_to()</a> which is the synchronous version of this call.<p>
777
 
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#cb1f2d32055b8da274ea241c69487dc6" title="Finishes an asynchronous file append operation started with g_file_append_to_async()...">append_to_finish()</a> to get the result of the operation. <dl compact><dt><b>Parameters:</b></dt><dd>
778
 
  <table border="0" cellspacing="2" cellpadding="0">
779
 
    <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>
780
 
    <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>
781
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>a set of FileCreateFlags. </td></tr>
782
 
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
783
 
  </table>
784
 
</dl>
785
 
 
786
 
</div>
787
 
</div><p>
788
 
<a class="anchor" name="cb1f2d32055b8da274ea241c69487dc6"></a><!-- doxytag: member="Gio::File::append_to_finish" ref="cb1f2d32055b8da274ea241c69487dc6" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
789
 
<div class="memitem">
790
 
<div class="memproto">
791
 
      <table class="memname">
792
 
        <tr>
793
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileOutputStream.html">FileOutputStream</a>&gt; Gio::File::append_to_finish           </td>
794
 
          <td>(</td>
795
 
          <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>
796
 
          <td class="paramname"> <em>result</em>          </td>
797
 
          <td>&nbsp;)&nbsp;</td>
798
 
          <td></td>
799
 
        </tr>
800
 
      </table>
801
 
</div>
802
 
<div class="memdoc">
803
 
 
804
 
<p>
805
 
Finishes an asynchronous file append operation started with g_file_append_to_async(). 
806
 
<p>
807
 
<dl compact><dt><b>Parameters:</b></dt><dd>
808
 
  <table border="0" cellspacing="2" cellpadding="0">
809
 
    <tr><td valign="top"></td><td valign="top"><em>res</em>&nbsp;</td><td><a class="el" href="classGio_1_1AsyncResult.html" title="Provides a base class for implementing asynchronous function results.">AsyncResult</a>. </td></tr>
810
 
  </table>
811
 
</dl>
812
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A valid <a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a> or <code>0</code> on error. Free the returned object with Glib::object_unref(). </dd></dl>
813
 
 
814
 
</div>
815
 
</div><p>
816
 
<a class="anchor" name="7a6b45bed32567031bc7b48273ad4079"></a><!-- doxytag: member="Gio::File::copy" ref="7a6b45bed32567031bc7b48273ad4079" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, FileCopyFlags flags=FILE_COPY_NONE)" -->
817
 
<div class="memitem">
818
 
<div class="memproto">
819
 
      <table class="memname">
820
 
        <tr>
821
 
          <td class="memname">bool Gio::File::copy           </td>
822
 
          <td>(</td>
823
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
824
 
          <td class="paramname"> <em>destination</em>, </td>
825
 
        </tr>
826
 
        <tr>
827
 
          <td class="paramkey"></td>
828
 
          <td></td>
829
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
830
 
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code></td><td>&nbsp;</td>
831
 
        </tr>
832
 
        <tr>
833
 
          <td></td>
834
 
          <td>)</td>
835
 
          <td></td><td></td><td></td>
836
 
        </tr>
837
 
      </table>
838
 
</div>
839
 
<div class="memdoc">
840
 
 
841
 
<p>
842
 
 
843
 
</div>
844
 
</div><p>
845
 
<a class="anchor" name="1d8159b5b377db174b376b3c09deb7c1"></a><!-- doxytag: member="Gio::File::copy" ref="1d8159b5b377db174b376b3c09deb7c1" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, const SlotFileProgress &amp;slot, FileCopyFlags flags=FILE_COPY_NONE)" -->
846
 
<div class="memitem">
847
 
<div class="memproto">
848
 
      <table class="memname">
849
 
        <tr>
850
 
          <td class="memname">bool Gio::File::copy           </td>
851
 
          <td>(</td>
852
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
853
 
          <td class="paramname"> <em>destination</em>, </td>
854
 
        </tr>
855
 
        <tr>
856
 
          <td class="paramkey"></td>
857
 
          <td></td>
858
 
          <td class="paramtype">const <a class="el" href="classGio_1_1File.html#c5ff32ee99845479d138eee49d92e59c">SlotFileProgress</a>&amp;&nbsp;</td>
859
 
          <td class="paramname"> <em>slot</em>, </td>
860
 
        </tr>
861
 
        <tr>
862
 
          <td class="paramkey"></td>
863
 
          <td></td>
864
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
865
 
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code></td><td>&nbsp;</td>
866
 
        </tr>
867
 
        <tr>
868
 
          <td></td>
869
 
          <td>)</td>
870
 
          <td></td><td></td><td></td>
871
 
        </tr>
872
 
      </table>
873
 
</div>
874
 
<div class="memdoc">
875
 
 
876
 
<p>
877
 
 
878
 
</div>
879
 
</div><p>
880
 
<a class="anchor" name="f9e906ed93069e6adb6d87dae158cad9"></a><!-- doxytag: member="Gio::File::copy" ref="f9e906ed93069e6adb6d87dae158cad9" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, const SlotFileProgress &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileCopyFlags flags=FILE_COPY_NONE)" -->
881
 
<div class="memitem">
882
 
<div class="memproto">
883
 
      <table class="memname">
884
 
        <tr>
885
 
          <td class="memname">bool Gio::File::copy           </td>
886
 
          <td>(</td>
887
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
888
 
          <td class="paramname"> <em>destination</em>, </td>
889
 
        </tr>
890
 
        <tr>
891
 
          <td class="paramkey"></td>
892
 
          <td></td>
893
 
          <td class="paramtype">const <a class="el" href="classGio_1_1File.html#c5ff32ee99845479d138eee49d92e59c">SlotFileProgress</a>&amp;&nbsp;</td>
894
 
          <td class="paramname"> <em>slot</em>, </td>
895
 
        </tr>
896
 
        <tr>
897
 
          <td class="paramkey"></td>
898
 
          <td></td>
899
 
          <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>
900
 
          <td class="paramname"> <em>cancellable</em>, </td>
901
 
        </tr>
902
 
        <tr>
903
 
          <td class="paramkey"></td>
904
 
          <td></td>
905
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
906
 
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code></td><td>&nbsp;</td>
907
 
        </tr>
908
 
        <tr>
909
 
          <td></td>
910
 
          <td>)</td>
911
 
          <td></td><td></td><td></td>
912
 
        </tr>
913
 
      </table>
914
 
</div>
915
 
<div class="memdoc">
916
 
 
917
 
<p>
918
 
Copies the file source to the location specified by destination. 
919
 
<p>
920
 
Can not handle recursive copies of directories. If the flag FILE_COPY_OVERWRITE is specified an already existing destination file is overwritten. If the flag FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks will be copied as symlinks, otherwise the target of the source symlink will be copied.<p>
921
 
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>
922
 
The operation can be monitored via the <em>slot</em> callback.<p>
923
 
If the source file does not exist then a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_FOUND will be thrown, independent on the status of the destination.<p>
924
 
If FILE_COPY_OVERWRITE is not specified and the target exists, then a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with EXISTS will be thrown.<p>
925
 
If trying to overwrite a file over a directory a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with IS_DIRECTORY will be thrown. If trying to overwrite a directory with a directory a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with WOULD_MERGE will be thrown.<p>
926
 
If the source is a directory and the target does not exist, or FILE_COPY_OVERWRITE is specified and the target is a file, then a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with WOULD_RECURSE will be thrown.<p>
927
 
If you are interested in copying the <a class="el" href="classGio_1_1File.html" title="File and directory handling.">Gio::File</a> object itself (not the on-disk file), see <a class="el" href="classGio_1_1File.html#9ea238062cdc317ae982ffae5c226c9b" title="Duplicates a File handle.">File::dup()</a>. 
928
 
</div>
929
 
</div><p>
930
 
<a class="anchor" name="d538a383b8761d04bd36ed1aa1071e50"></a><!-- doxytag: member="Gio::File::copy_async" ref="d538a383b8761d04bd36ed1aa1071e50" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, const SlotAsyncReady &amp;slot_ready, FileCopyFlags flags=FILE_COPY_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
931
 
<div class="memitem">
932
 
<div class="memproto">
933
 
      <table class="memname">
934
 
        <tr>
935
 
          <td class="memname">void Gio::File::copy_async           </td>
936
 
          <td>(</td>
937
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
938
 
          <td class="paramname"> <em>destination</em>, </td>
939
 
        </tr>
940
 
        <tr>
941
 
          <td class="paramkey"></td>
942
 
          <td></td>
943
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
944
 
          <td class="paramname"> <em>slot_ready</em>, </td>
945
 
        </tr>
946
 
        <tr>
947
 
          <td class="paramkey"></td>
948
 
          <td></td>
949
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
950
 
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code>, </td>
951
 
        </tr>
952
 
        <tr>
953
 
          <td class="paramkey"></td>
954
 
          <td></td>
955
 
          <td class="paramtype">int&nbsp;</td>
956
 
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
957
 
        </tr>
958
 
        <tr>
959
 
          <td></td>
960
 
          <td>)</td>
961
 
          <td></td><td></td><td></td>
962
 
        </tr>
963
 
      </table>
964
 
</div>
965
 
<div class="memdoc">
966
 
 
967
 
<p>
968
 
Copies the file to the location specified by <em>destination</em> asynchronously. 
969
 
<p>
970
 
For details of the behaviour, see <a class="el" href="classGio_1_1File.html#f9e906ed93069e6adb6d87dae158cad9" title="Copies the file source to the location specified by destination.">copy()</a>.<p>
971
 
When the operation is finished, <em>slot_ready</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#68294636a2d649c9de53332faee02cf6" title="Finishes copying the file started with g_file_copy_async().">copy_finish()</a> to get the result of the operation.<p>
972
 
<dl compact><dt><b>Parameters:</b></dt><dd>
973
 
  <table border="0" cellspacing="2" cellpadding="0">
974
 
    <tr><td valign="top"></td><td valign="top"><em>destination</em>&nbsp;</td><td>Destination <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> </td></tr>
975
 
    <tr><td valign="top"></td><td valign="top"><em>slot_ready</em>&nbsp;</td><td>A SlotAsyncReady to call when the request is satisfied </td></tr>
976
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>Set of FileCopyFlags </td></tr>
977
 
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request </td></tr>
978
 
  </table>
979
 
</dl>
980
 
 
981
 
</div>
982
 
</div><p>
983
 
<a class="anchor" name="c2b1a85f29bbbe15998c090b3794cbf5"></a><!-- doxytag: member="Gio::File::copy_async" ref="c2b1a85f29bbbe15998c090b3794cbf5" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, const SlotFileProgress &amp;slot_progress, const SlotAsyncReady &amp;slot_ready, FileCopyFlags flags=FILE_COPY_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
984
 
<div class="memitem">
985
 
<div class="memproto">
986
 
      <table class="memname">
987
 
        <tr>
988
 
          <td class="memname">void Gio::File::copy_async           </td>
989
 
          <td>(</td>
990
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
991
 
          <td class="paramname"> <em>destination</em>, </td>
992
 
        </tr>
993
 
        <tr>
994
 
          <td class="paramkey"></td>
995
 
          <td></td>
996
 
          <td class="paramtype">const <a class="el" href="classGio_1_1File.html#c5ff32ee99845479d138eee49d92e59c">SlotFileProgress</a>&amp;&nbsp;</td>
997
 
          <td class="paramname"> <em>slot_progress</em>, </td>
998
 
        </tr>
999
 
        <tr>
1000
 
          <td class="paramkey"></td>
1001
 
          <td></td>
1002
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
1003
 
          <td class="paramname"> <em>slot_ready</em>, </td>
1004
 
        </tr>
1005
 
        <tr>
1006
 
          <td class="paramkey"></td>
1007
 
          <td></td>
1008
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
1009
 
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code>, </td>
1010
 
        </tr>
1011
 
        <tr>
1012
 
          <td class="paramkey"></td>
1013
 
          <td></td>
1014
 
          <td class="paramtype">int&nbsp;</td>
1015
 
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
1016
 
        </tr>
1017
 
        <tr>
1018
 
          <td></td>
1019
 
          <td>)</td>
1020
 
          <td></td><td></td><td></td>
1021
 
        </tr>
1022
 
      </table>
1023
 
</div>
1024
 
<div class="memdoc">
1025
 
 
1026
 
<p>
1027
 
Copies the file to the location specified by <em>destination</em> asynchronously. 
1028
 
<p>
1029
 
For details of the behaviour, see <a class="el" href="classGio_1_1File.html#f9e906ed93069e6adb6d87dae158cad9" title="Copies the file source to the location specified by destination.">copy()</a>.<p>
1030
 
When the operation is finished, <em>slot_ready</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#68294636a2d649c9de53332faee02cf6" title="Finishes copying the file started with g_file_copy_async().">copy_finish()</a> to get the result of the operation.<p>
1031
 
The function specified by <em>slot_progress</em> will be called just like in <a class="el" href="classGio_1_1File.html#f9e906ed93069e6adb6d87dae158cad9" title="Copies the file source to the location specified by destination.">copy()</a>, however the callback will run in the main loop, not in the thread that is doing the I/O operation.<p>
1032
 
<dl compact><dt><b>Parameters:</b></dt><dd>
1033
 
  <table border="0" cellspacing="2" cellpadding="0">
1034
 
    <tr><td valign="top"></td><td valign="top"><em>destination</em>&nbsp;</td><td>Destination <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> </td></tr>
1035
 
    <tr><td valign="top"></td><td valign="top"><em>slot_progress</em>&nbsp;</td><td>The callback slot to be called with progress information </td></tr>
1036
 
    <tr><td valign="top"></td><td valign="top"><em>slot_ready</em>&nbsp;</td><td>A SlotAsyncReady to call when the request is satisfied </td></tr>
1037
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>Set of FileCopyFlags </td></tr>
1038
 
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request </td></tr>
1039
 
  </table>
1040
 
</dl>
1041
 
 
1042
 
</div>
1043
 
</div><p>
1044
 
<a class="anchor" name="5b8ae7393c73a9a1d383a82d61f4ac30"></a><!-- doxytag: member="Gio::File::copy_async" ref="5b8ae7393c73a9a1d383a82d61f4ac30" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, const SlotAsyncReady &amp;slot_ready, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileCopyFlags flags=FILE_COPY_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
1045
 
<div class="memitem">
1046
 
<div class="memproto">
1047
 
      <table class="memname">
1048
 
        <tr>
1049
 
          <td class="memname">void Gio::File::copy_async           </td>
1050
 
          <td>(</td>
1051
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
1052
 
          <td class="paramname"> <em>destination</em>, </td>
1053
 
        </tr>
1054
 
        <tr>
1055
 
          <td class="paramkey"></td>
1056
 
          <td></td>
1057
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
1058
 
          <td class="paramname"> <em>slot_ready</em>, </td>
1059
 
        </tr>
1060
 
        <tr>
1061
 
          <td class="paramkey"></td>
1062
 
          <td></td>
1063
 
          <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>
1064
 
          <td class="paramname"> <em>cancellable</em>, </td>
1065
 
        </tr>
1066
 
        <tr>
1067
 
          <td class="paramkey"></td>
1068
 
          <td></td>
1069
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
1070
 
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code>, </td>
1071
 
        </tr>
1072
 
        <tr>
1073
 
          <td class="paramkey"></td>
1074
 
          <td></td>
1075
 
          <td class="paramtype">int&nbsp;</td>
1076
 
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
1077
 
        </tr>
1078
 
        <tr>
1079
 
          <td></td>
1080
 
          <td>)</td>
1081
 
          <td></td><td></td><td></td>
1082
 
        </tr>
1083
 
      </table>
1084
 
</div>
1085
 
<div class="memdoc">
1086
 
 
1087
 
<p>
1088
 
Copies the file to the location specified by <em>destination</em> asynchronously. 
1089
 
<p>
1090
 
For details of the behaviour, see <a class="el" href="classGio_1_1File.html#f9e906ed93069e6adb6d87dae158cad9" title="Copies the file source to the location specified by destination.">copy()</a>.<p>
1091
 
When the operation is finished, <em>slot_ready</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#68294636a2d649c9de53332faee02cf6" title="Finishes copying the file started with g_file_copy_async().">copy_finish()</a> to get the result of the operation.<p>
1092
 
<dl compact><dt><b>Parameters:</b></dt><dd>
1093
 
  <table border="0" cellspacing="2" cellpadding="0">
1094
 
    <tr><td valign="top"></td><td valign="top"><em>destination</em>&nbsp;</td><td>Destination <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> </td></tr>
1095
 
    <tr><td valign="top"></td><td valign="top"><em>slot_ready</em>&nbsp;</td><td>A SlotAsyncReady to call when the request is satisfied </td></tr>
1096
 
    <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>
1097
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>Set of FileCopyFlags </td></tr>
1098
 
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request </td></tr>
1099
 
  </table>
1100
 
</dl>
1101
 
 
1102
 
</div>
1103
 
</div><p>
1104
 
<a class="anchor" name="1785b7a4780d5d4ba5ae651350e34398"></a><!-- doxytag: member="Gio::File::copy_async" ref="1785b7a4780d5d4ba5ae651350e34398" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, const SlotFileProgress &amp;slot_progress, const SlotAsyncReady &amp;slot_ready, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileCopyFlags flags=FILE_COPY_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
1105
 
<div class="memitem">
1106
 
<div class="memproto">
1107
 
      <table class="memname">
1108
 
        <tr>
1109
 
          <td class="memname">void Gio::File::copy_async           </td>
1110
 
          <td>(</td>
1111
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
1112
 
          <td class="paramname"> <em>destination</em>, </td>
1113
 
        </tr>
1114
 
        <tr>
1115
 
          <td class="paramkey"></td>
1116
 
          <td></td>
1117
 
          <td class="paramtype">const <a class="el" href="classGio_1_1File.html#c5ff32ee99845479d138eee49d92e59c">SlotFileProgress</a>&amp;&nbsp;</td>
1118
 
          <td class="paramname"> <em>slot_progress</em>, </td>
1119
 
        </tr>
1120
 
        <tr>
1121
 
          <td class="paramkey"></td>
1122
 
          <td></td>
1123
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
1124
 
          <td class="paramname"> <em>slot_ready</em>, </td>
1125
 
        </tr>
1126
 
        <tr>
1127
 
          <td class="paramkey"></td>
1128
 
          <td></td>
1129
 
          <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>
1130
 
          <td class="paramname"> <em>cancellable</em>, </td>
1131
 
        </tr>
1132
 
        <tr>
1133
 
          <td class="paramkey"></td>
1134
 
          <td></td>
1135
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
1136
 
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code>, </td>
1137
 
        </tr>
1138
 
        <tr>
1139
 
          <td class="paramkey"></td>
1140
 
          <td></td>
1141
 
          <td class="paramtype">int&nbsp;</td>
1142
 
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
1143
 
        </tr>
1144
 
        <tr>
1145
 
          <td></td>
1146
 
          <td>)</td>
1147
 
          <td></td><td></td><td></td>
1148
 
        </tr>
1149
 
      </table>
1150
 
</div>
1151
 
<div class="memdoc">
1152
 
 
1153
 
<p>
1154
 
Copies the file to the location specified by <em>destination</em> asynchronously. 
1155
 
<p>
1156
 
For details of the behaviour, see <a class="el" href="classGio_1_1File.html#f9e906ed93069e6adb6d87dae158cad9" title="Copies the file source to the location specified by destination.">copy()</a>.<p>
1157
 
When the operation is finished, <em>slot_ready</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#68294636a2d649c9de53332faee02cf6" title="Finishes copying the file started with g_file_copy_async().">copy_finish()</a> to get the result of the operation.<p>
1158
 
The function specified by <em>slot_progress</em> will be called just like in <a class="el" href="classGio_1_1File.html#f9e906ed93069e6adb6d87dae158cad9" title="Copies the file source to the location specified by destination.">copy()</a>, however the callback will run in the main loop, not in the thread that is doing the I/O operation.<p>
1159
 
<dl compact><dt><b>Parameters:</b></dt><dd>
1160
 
  <table border="0" cellspacing="2" cellpadding="0">
1161
 
    <tr><td valign="top"></td><td valign="top"><em>destination</em>&nbsp;</td><td>Destination <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> </td></tr>
1162
 
    <tr><td valign="top"></td><td valign="top"><em>slot_progress</em>&nbsp;</td><td>The callback slot to be called with progress information </td></tr>
1163
 
    <tr><td valign="top"></td><td valign="top"><em>slot_ready</em>&nbsp;</td><td>A SlotAsyncReady to call when the request is satisfied </td></tr>
1164
 
    <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>
1165
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>Set of FileCopyFlags </td></tr>
1166
 
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request </td></tr>
1167
 
  </table>
1168
 
</dl>
1169
 
 
1170
 
</div>
1171
 
</div><p>
1172
 
<a class="anchor" name="05c1101ede98028c9234486eb0434250"></a><!-- doxytag: member="Gio::File::copy_attributes" ref="05c1101ede98028c9234486eb0434250" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, FileCopyFlags flags=FILE_COPY_NONE)" -->
1173
 
<div class="memitem">
1174
 
<div class="memproto">
1175
 
      <table class="memname">
1176
 
        <tr>
1177
 
          <td class="memname">bool Gio::File::copy_attributes           </td>
1178
 
          <td>(</td>
1179
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
1180
 
          <td class="paramname"> <em>destination</em>, </td>
1181
 
        </tr>
1182
 
        <tr>
1183
 
          <td class="paramkey"></td>
1184
 
          <td></td>
1185
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
1186
 
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code></td><td>&nbsp;</td>
1187
 
        </tr>
1188
 
        <tr>
1189
 
          <td></td>
1190
 
          <td>)</td>
1191
 
          <td></td><td></td><td></td>
1192
 
        </tr>
1193
 
      </table>
1194
 
</div>
1195
 
<div class="memdoc">
1196
 
 
1197
 
<p>
1198
 
Copies the file attributes from <em>source</em> to <em>destination</em>. 
1199
 
<p>
1200
 
Normally only a subset of the file attributes are copied, those that are copies in a normal file copy operation (which for instance does not include e.g. mtime). However if FILE_COPY_ALL_METADATA is specified in <em>flags</em>, then all the metadata that is possible to copy is copied.<p>
1201
 
<dl compact><dt><b>Parameters:</b></dt><dd>
1202
 
  <table border="0" cellspacing="2" cellpadding="0">
1203
 
    <tr><td valign="top"></td><td valign="top"><em>destination</em>&nbsp;</td><td>A <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> to copy attributes to. </td></tr>
1204
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileMonitorFlags. </td></tr>
1205
 
  </table>
1206
 
</dl>
1207
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>true if the attributes were copied successfully, false otherwise. </dd></dl>
1208
 
 
1209
 
</div>
1210
 
</div><p>
1211
 
<a class="anchor" name="90726dcf94248d2fddf2e4c8584b7bf0"></a><!-- doxytag: member="Gio::File::copy_attributes" ref="90726dcf94248d2fddf2e4c8584b7bf0" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileCopyFlags flags=FILE_COPY_NONE)" -->
1212
 
<div class="memitem">
1213
 
<div class="memproto">
1214
 
      <table class="memname">
1215
 
        <tr>
1216
 
          <td class="memname">bool Gio::File::copy_attributes           </td>
1217
 
          <td>(</td>
1218
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
1219
 
          <td class="paramname"> <em>destination</em>, </td>
1220
 
        </tr>
1221
 
        <tr>
1222
 
          <td class="paramkey"></td>
1223
 
          <td></td>
1224
 
          <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>
1225
 
          <td class="paramname"> <em>cancellable</em>, </td>
1226
 
        </tr>
1227
 
        <tr>
1228
 
          <td class="paramkey"></td>
1229
 
          <td></td>
1230
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
1231
 
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code></td><td>&nbsp;</td>
1232
 
        </tr>
1233
 
        <tr>
1234
 
          <td></td>
1235
 
          <td>)</td>
1236
 
          <td></td><td></td><td></td>
1237
 
        </tr>
1238
 
      </table>
1239
 
</div>
1240
 
<div class="memdoc">
1241
 
 
1242
 
<p>
1243
 
Copies the file attributes from <em>source</em> to <em>destination</em>. 
1244
 
<p>
1245
 
Normally only a subset of the file attributes are copied, those that are copies in a normal file copy operation (which for instance does not include e.g. mtime). However if FILE_COPY_ALL_METADATA is specified in <em>flags</em>, then all the metadata that is possible to copy is copied.<p>
1246
 
<dl compact><dt><b>Parameters:</b></dt><dd>
1247
 
  <table border="0" cellspacing="2" cellpadding="0">
1248
 
    <tr><td valign="top"></td><td valign="top"><em>destination</em>&nbsp;</td><td>A <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> to copy attributes to. </td></tr>
1249
 
    <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>
1250
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileMonitorFlags. </td></tr>
1251
 
  </table>
1252
 
</dl>
1253
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>true if the attributes were copied successfully, false otherwise. </dd></dl>
1254
 
 
1255
 
</div>
1256
 
</div><p>
1257
 
<a class="anchor" name="68294636a2d649c9de53332faee02cf6"></a><!-- doxytag: member="Gio::File::copy_finish" ref="68294636a2d649c9de53332faee02cf6" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
1258
 
<div class="memitem">
1259
 
<div class="memproto">
1260
 
      <table class="memname">
1261
 
        <tr>
1262
 
          <td class="memname">bool Gio::File::copy_finish           </td>
1263
 
          <td>(</td>
1264
 
          <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>
1265
 
          <td class="paramname"> <em>result</em>          </td>
1266
 
          <td>&nbsp;)&nbsp;</td>
1267
 
          <td></td>
1268
 
        </tr>
1269
 
      </table>
1270
 
</div>
1271
 
<div class="memdoc">
1272
 
 
1273
 
<p>
1274
 
Finishes copying the file started with g_file_copy_async(). 
1275
 
<p>
1276
 
<dl compact><dt><b>Parameters:</b></dt><dd>
1277
 
  <table border="0" cellspacing="2" cellpadding="0">
1278
 
    <tr><td valign="top"></td><td valign="top"><em>res</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>
1279
 
  </table>
1280
 
</dl>
1281
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <code>true</code> on success, <code>false</code> on error. </dd></dl>
1282
 
 
1283
 
</div>
1284
 
</div><p>
1285
 
<a class="anchor" name="5cf2b17b953ccfefb1d13c39bd1be72c"></a><!-- doxytag: member="Gio::File::create_file" ref="5cf2b17b953ccfefb1d13c39bd1be72c" args="(FileCreateFlags flags=FILE_CREATE_NONE)" -->
1286
 
<div class="memitem">
1287
 
<div class="memproto">
1288
 
      <table class="memname">
1289
 
        <tr>
1290
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileOutputStream.html">FileOutputStream</a>&gt; Gio::File::create_file           </td>
1291
 
          <td>(</td>
1292
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
1293
 
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code>          </td>
1294
 
          <td>&nbsp;)&nbsp;</td>
1295
 
          <td></td>
1296
 
        </tr>
1297
 
      </table>
1298
 
</div>
1299
 
<div class="memdoc">
1300
 
 
1301
 
<p>
1302
 
Creates a new file and returns an output stream for writing to it. 
1303
 
<p>
1304
 
The file must not already exists.<p>
1305
 
By default files created are generally readable by everyone, but if you pass FILE_CREATE_PRIVATE in <em>flags</em> the file will be made readable only to the current user, to the level that is supported on the target filesystem.<p>
1306
 
If a file with this name already exists a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with EXISTS will be thrown. If the file is a directory a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with IS_DIRECTORY will be thrown.<p>
1307
 
Some filesystems don't allow all filenames, and may throw a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with INVALID_FILENAME, and if the name is to longa <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with FILENAME_TOO_LONG will be thrown. Other errors are possible too, and depend on what kind of filesystem the file is on.<p>
1308
 
<dl compact><dt><b>Parameters:</b></dt><dd>
1309
 
  <table border="0" cellspacing="2" cellpadding="0">
1310
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>a set of FileCreateFlags. </td></tr>
1311
 
  </table>
1312
 
</dl>
1313
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a> for the newly created file. </dd></dl>
1314
 
 
1315
 
</div>
1316
 
</div><p>
1317
 
<a class="anchor" name="86258e11b2884422819d051c3cfd07a2"></a><!-- doxytag: member="Gio::File::create_file" ref="86258e11b2884422819d051c3cfd07a2" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileCreateFlags flags=FILE_CREATE_NONE)" -->
1318
 
<div class="memitem">
1319
 
<div class="memproto">
1320
 
      <table class="memname">
1321
 
        <tr>
1322
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileOutputStream.html">FileOutputStream</a>&gt; Gio::File::create_file           </td>
1323
 
          <td>(</td>
1324
 
          <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>
1325
 
          <td class="paramname"> <em>cancellable</em>, </td>
1326
 
        </tr>
1327
 
        <tr>
1328
 
          <td class="paramkey"></td>
1329
 
          <td></td>
1330
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
1331
 
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
1332
 
        </tr>
1333
 
        <tr>
1334
 
          <td></td>
1335
 
          <td>)</td>
1336
 
          <td></td><td></td><td></td>
1337
 
        </tr>
1338
 
      </table>
1339
 
</div>
1340
 
<div class="memdoc">
1341
 
 
1342
 
<p>
1343
 
Creates a new file and returns an output stream for writing to it. 
1344
 
<p>
1345
 
The file must not already exists.<p>
1346
 
By default files created are generally readable by everyone, but if you pass FILE_CREATE_PRIVATE in <em>flags</em> the file will be made readable only to the current user, to the level that is supported on the target filesystem.<p>
1347
 
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>
1348
 
If a file with this name already exists a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with EXISTS will be thrown. If the file is a directory a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with IS_DIRECTORY will be thrown.<p>
1349
 
Some filesystems don't allow all filenames, and may throw a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with INVALID_FILENAME, and if the name is to longa <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with FILENAME_TOO_LONG will be thrown. Other errors are possible too, and depend on what kind of filesystem the file is on.<p>
1350
 
<dl compact><dt><b>Parameters:</b></dt><dd>
1351
 
  <table border="0" cellspacing="2" cellpadding="0">
1352
 
    <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>
1353
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>a set of FileCreateFlags. </td></tr>
1354
 
  </table>
1355
 
</dl>
1356
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a> for the newly created file. </dd></dl>
1357
 
 
1358
 
</div>
1359
 
</div><p>
1360
 
<a class="anchor" name="3fe6ed015f3d2bb72aa7aceed8dc7ca1"></a><!-- doxytag: member="Gio::File::create_file_async" ref="3fe6ed015f3d2bb72aa7aceed8dc7ca1" args="(const SlotAsyncReady &amp;slot, FileCreateFlags flags=FILE_CREATE_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
1361
 
<div class="memitem">
1362
 
<div class="memproto">
1363
 
      <table class="memname">
1364
 
        <tr>
1365
 
          <td class="memname">void Gio::File::create_file_async           </td>
1366
 
          <td>(</td>
1367
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
1368
 
          <td class="paramname"> <em>slot</em>, </td>
1369
 
        </tr>
1370
 
        <tr>
1371
 
          <td class="paramkey"></td>
1372
 
          <td></td>
1373
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
1374
 
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code>, </td>
1375
 
        </tr>
1376
 
        <tr>
1377
 
          <td class="paramkey"></td>
1378
 
          <td></td>
1379
 
          <td class="paramtype">int&nbsp;</td>
1380
 
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
1381
 
        </tr>
1382
 
        <tr>
1383
 
          <td></td>
1384
 
          <td>)</td>
1385
 
          <td></td><td></td><td></td>
1386
 
        </tr>
1387
 
      </table>
1388
 
</div>
1389
 
<div class="memdoc">
1390
 
 
1391
 
<p>
1392
 
Asynchronously creates a new file and returns an output stream for writing to it. 
1393
 
<p>
1394
 
The file must not already exist. For more details, see <a class="el" href="classGio_1_1File.html#86258e11b2884422819d051c3cfd07a2" title="Creates a new file and returns an output stream for writing to it.">create_file()</a> which is the synchronous version of this call.<p>
1395
 
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#622b9f7aeaebe2ac53df0574c9c4211a" title="Finishes an asynchronous file create operation started with g_file_create_async()...">create_file_finish()</a> to get the result of the operation.<p>
1396
 
<dl compact><dt><b>Parameters:</b></dt><dd>
1397
 
  <table border="0" cellspacing="2" cellpadding="0">
1398
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>a set of FileCreateFlags. </td></tr>
1399
 
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
1400
 
    <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>
1401
 
  </table>
1402
 
</dl>
1403
 
 
1404
 
</div>
1405
 
</div><p>
1406
 
<a class="anchor" name="e0c42446d37aa466173965b7db1a2053"></a><!-- doxytag: member="Gio::File::create_file_async" ref="e0c42446d37aa466173965b7db1a2053" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileCreateFlags flags=FILE_CREATE_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
1407
 
<div class="memitem">
1408
 
<div class="memproto">
1409
 
      <table class="memname">
1410
 
        <tr>
1411
 
          <td class="memname">void Gio::File::create_file_async           </td>
1412
 
          <td>(</td>
1413
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
1414
 
          <td class="paramname"> <em>slot</em>, </td>
1415
 
        </tr>
1416
 
        <tr>
1417
 
          <td class="paramkey"></td>
1418
 
          <td></td>
1419
 
          <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>
1420
 
          <td class="paramname"> <em>cancellable</em>, </td>
1421
 
        </tr>
1422
 
        <tr>
1423
 
          <td class="paramkey"></td>
1424
 
          <td></td>
1425
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
1426
 
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code>, </td>
1427
 
        </tr>
1428
 
        <tr>
1429
 
          <td class="paramkey"></td>
1430
 
          <td></td>
1431
 
          <td class="paramtype">int&nbsp;</td>
1432
 
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
1433
 
        </tr>
1434
 
        <tr>
1435
 
          <td></td>
1436
 
          <td>)</td>
1437
 
          <td></td><td></td><td></td>
1438
 
        </tr>
1439
 
      </table>
1440
 
</div>
1441
 
<div class="memdoc">
1442
 
 
1443
 
<p>
1444
 
Asynchronously creates a new file and returns an output stream for writing to it. 
1445
 
<p>
1446
 
The file must not already exist. For more details, see <a class="el" href="classGio_1_1File.html#86258e11b2884422819d051c3cfd07a2" title="Creates a new file and returns an output stream for writing to it.">create_file()</a> which is the synchronous version of this call.<p>
1447
 
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#622b9f7aeaebe2ac53df0574c9c4211a" title="Finishes an asynchronous file create operation started with g_file_create_async()...">create_file_finish()</a> to get the result of the operation.<p>
1448
 
<dl compact><dt><b>Parameters:</b></dt><dd>
1449
 
  <table border="0" cellspacing="2" cellpadding="0">
1450
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>a set of FileCreateFlags. </td></tr>
1451
 
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
1452
 
    <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>
1453
 
    <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>
1454
 
  </table>
1455
 
</dl>
1456
 
 
1457
 
</div>
1458
 
</div><p>
1459
 
<a class="anchor" name="622b9f7aeaebe2ac53df0574c9c4211a"></a><!-- doxytag: member="Gio::File::create_file_finish" ref="622b9f7aeaebe2ac53df0574c9c4211a" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
1460
 
<div class="memitem">
1461
 
<div class="memproto">
1462
 
      <table class="memname">
1463
 
        <tr>
1464
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileOutputStream.html">FileOutputStream</a>&gt; Gio::File::create_file_finish           </td>
1465
 
          <td>(</td>
1466
 
          <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>
1467
 
          <td class="paramname"> <em>result</em>          </td>
1468
 
          <td>&nbsp;)&nbsp;</td>
1469
 
          <td></td>
1470
 
        </tr>
1471
 
      </table>
1472
 
</div>
1473
 
<div class="memdoc">
1474
 
 
1475
 
<p>
1476
 
Finishes an asynchronous file create operation started with g_file_create_async(). 
1477
 
<p>
1478
 
<dl compact><dt><b>Parameters:</b></dt><dd>
1479
 
  <table border="0" cellspacing="2" cellpadding="0">
1480
 
    <tr><td valign="top"></td><td valign="top"><em>res</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>
1481
 
  </table>
1482
 
</dl>
1483
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a> or <code>0</code> on error. Free the returned object with Glib::object_unref(). </dd></dl>
1484
 
 
1485
 
</div>
1486
 
</div><p>
1487
 
<a class="anchor" name="b311a1c606b3907865fc8aecd4691de8"></a><!-- doxytag: member="Gio::File::create_for_commandline_arg" ref="b311a1c606b3907865fc8aecd4691de8" args="(const std::string &amp;arg)" -->
1488
 
<div class="memitem">
1489
 
<div class="memproto">
1490
 
      <table class="memname">
1491
 
        <tr>
1492
 
          <td class="memname">static <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt; Gio::File::create_for_commandline_arg           </td>
1493
 
          <td>(</td>
1494
 
          <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>
1495
 
          <td class="paramname"> <em>arg</em>          </td>
1496
 
          <td>&nbsp;)&nbsp;</td>
1497
 
          <td><code> [static]</code></td>
1498
 
        </tr>
1499
 
      </table>
1500
 
</div>
1501
 
<div class="memdoc">
1502
 
 
1503
 
<p>
1504
 
Constructs a <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> for a given argument from the command line. 
1505
 
<p>
1506
 
The value of <em>arg</em> can be either a URI, an absolute path or a relative path resolved relative to the current working directory. This operation never fails, but the returned object might not support any I/O operation if arg points to a malformed path.<p>
1507
 
<dl compact><dt><b>Parameters:</b></dt><dd>
1508
 
  <table border="0" cellspacing="2" cellpadding="0">
1509
 
    <tr><td valign="top"></td><td valign="top"><em>arg</em>&nbsp;</td><td>A string containing a relative or absolute path. </td></tr>
1510
 
  </table>
1511
 
</dl>
1512
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A new instantiation of an appropriate <a class="el" href="classGio_1_1File.html" title="File and directory handling.">Gio::File</a> class. </dd></dl>
1513
 
 
1514
 
</div>
1515
 
</div><p>
1516
 
<a class="anchor" name="7532baa6ce71fe27cfd1e9bba91a3536"></a><!-- doxytag: member="Gio::File::create_for_parse_name" ref="7532baa6ce71fe27cfd1e9bba91a3536" args="(const Glib::ustring &amp;parse_name)" -->
1517
 
<div class="memitem">
1518
 
<div class="memproto">
1519
 
      <table class="memname">
1520
 
        <tr>
1521
 
          <td class="memname">static <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt; Gio::File::create_for_parse_name           </td>
1522
 
          <td>(</td>
1523
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&nbsp;</td>
1524
 
          <td class="paramname"> <em>parse_name</em>          </td>
1525
 
          <td>&nbsp;)&nbsp;</td>
1526
 
          <td><code> [static]</code></td>
1527
 
        </tr>
1528
 
      </table>
1529
 
</div>
1530
 
<div class="memdoc">
1531
 
 
1532
 
<p>
 
622
<a class="anchor" name="96552cfbaf2e5fa3659a1568db8cca91"></a><!-- doxytag: member="Gio::File::gobj" ref="96552cfbaf2e5fa3659a1568db8cca91" args="()" -->
 
623
<div class="memitem">
 
624
<div class="memproto">
 
625
      <table class="memname">
 
626
        <tr>
 
627
          <td class="memname">GFile* Gio::File::gobj           </td>
 
628
          <td>(</td>
 
629
          <td class="paramname">          </td>
 
630
          <td>&nbsp;)&nbsp;</td>
 
631
          <td><code> [inline]</code></td>
 
632
        </tr>
 
633
      </table>
 
634
</div>
 
635
<div class="memdoc">
 
636
 
 
637
<p>
 
638
Provides access to the underlying C GObject. 
 
639
<p>
 
640
 
 
641
<p>Reimplemented from <a class="el" href="classGlib_1_1Interface.html#969e9396f75132a9577428f4fa932d42">Glib::Interface</a>.</p>
 
642
 
 
643
</div>
 
644
</div><p>
 
645
<a class="anchor" name="5437bc648d8b73451e8bee0bc902cfc0"></a><!-- doxytag: member="Gio::File::gobj" ref="5437bc648d8b73451e8bee0bc902cfc0" args="() const " -->
 
646
<div class="memitem">
 
647
<div class="memproto">
 
648
      <table class="memname">
 
649
        <tr>
 
650
          <td class="memname">const GFile* Gio::File::gobj           </td>
 
651
          <td>(</td>
 
652
          <td class="paramname">          </td>
 
653
          <td>&nbsp;)&nbsp;</td>
 
654
          <td> const<code> [inline]</code></td>
 
655
        </tr>
 
656
      </table>
 
657
</div>
 
658
<div class="memdoc">
 
659
 
 
660
<p>
 
661
Provides access to the underlying C GObject. 
 
662
<p>
 
663
 
 
664
<p>Reimplemented from <a class="el" href="classGlib_1_1Interface.html#70a443071a69d3372c2cdd7128a91ed1">Glib::Interface</a>.</p>
1533
665
 
1534
666
</div>
1535
667
</div><p>
1591
723
 
1592
724
</div>
1593
725
</div><p>
 
726
<a class="anchor" name="b311a1c606b3907865fc8aecd4691de8"></a><!-- doxytag: member="Gio::File::create_for_commandline_arg" ref="b311a1c606b3907865fc8aecd4691de8" args="(const std::string &amp;arg)" -->
 
727
<div class="memitem">
 
728
<div class="memproto">
 
729
      <table class="memname">
 
730
        <tr>
 
731
          <td class="memname">static <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt; Gio::File::create_for_commandline_arg           </td>
 
732
          <td>(</td>
 
733
          <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>
 
734
          <td class="paramname"> <em>arg</em>          </td>
 
735
          <td>&nbsp;)&nbsp;</td>
 
736
          <td><code> [static]</code></td>
 
737
        </tr>
 
738
      </table>
 
739
</div>
 
740
<div class="memdoc">
 
741
 
 
742
<p>
 
743
Constructs a <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> for a given argument from the command line. 
 
744
<p>
 
745
The value of <em>arg</em> can be either a URI, an absolute path or a relative path resolved relative to the current working directory. This operation never fails, but the returned object might not support any I/O operation if arg points to a malformed path.<p>
 
746
<dl compact><dt><b>Parameters:</b></dt><dd>
 
747
  <table border="0" cellspacing="2" cellpadding="0">
 
748
    <tr><td valign="top"></td><td valign="top"><em>arg</em>&nbsp;</td><td>A string containing a relative or absolute path. </td></tr>
 
749
  </table>
 
750
</dl>
 
751
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A new instantiation of an appropriate <a class="el" href="classGio_1_1File.html" title="File and directory handling.">Gio::File</a> class. </dd></dl>
 
752
 
 
753
</div>
 
754
</div><p>
 
755
<a class="anchor" name="7532baa6ce71fe27cfd1e9bba91a3536"></a><!-- doxytag: member="Gio::File::create_for_parse_name" ref="7532baa6ce71fe27cfd1e9bba91a3536" args="(const Glib::ustring &amp;parse_name)" -->
 
756
<div class="memitem">
 
757
<div class="memproto">
 
758
      <table class="memname">
 
759
        <tr>
 
760
          <td class="memname">static <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt; Gio::File::create_for_parse_name           </td>
 
761
          <td>(</td>
 
762
          <td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&nbsp;</td>
 
763
          <td class="paramname"> <em>parse_name</em>          </td>
 
764
          <td>&nbsp;)&nbsp;</td>
 
765
          <td><code> [static]</code></td>
 
766
        </tr>
 
767
      </table>
 
768
</div>
 
769
<div class="memdoc">
 
770
 
 
771
<p>
 
772
 
 
773
</div>
 
774
</div><p>
1594
775
<a class="anchor" name="9ea238062cdc317ae982ffae5c226c9b"></a><!-- doxytag: member="Gio::File::dup" ref="9ea238062cdc317ae982ffae5c226c9b" args="() const " -->
1595
776
<div class="memitem">
1596
777
<div class="memproto">
1614
795
 
1615
796
</div>
1616
797
</div><p>
1617
 
<a class="anchor" name="eb28fd505cab23a82c68ff00445b12e7"></a><!-- doxytag: member="Gio::File::eject_mountable" ref="eb28fd505cab23a82c68ff00445b12e7" args="(MountUnmountFlags flags=MOUNT_UNMOUNT_NONE)" -->
1618
 
<div class="memitem">
1619
 
<div class="memproto">
1620
 
      <table class="memname">
1621
 
        <tr>
1622
 
          <td class="memname">void Gio::File::eject_mountable           </td>
1623
 
          <td>(</td>
1624
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g9fa1b6a8eabf8f88e4cf6d611a4cff44">MountUnmountFlags</a>&nbsp;</td>
1625
 
          <td class="paramname"> <em>flags</em> = <code>MOUNT_UNMOUNT_NONE</code>          </td>
1626
 
          <td>&nbsp;)&nbsp;</td>
1627
 
          <td></td>
1628
 
        </tr>
1629
 
      </table>
1630
 
</div>
1631
 
<div class="memdoc">
1632
 
 
1633
 
<p>
1634
 
Starts an asynchronous eject on a mountable. 
1635
 
<p>
1636
 
<dl compact><dt><b>Parameters:</b></dt><dd>
1637
 
  <table border="0" cellspacing="2" cellpadding="0">
1638
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>Flags affecting the operation. </td></tr>
1639
 
  </table>
1640
 
</dl>
1641
 
 
1642
 
</div>
1643
 
</div><p>
1644
 
<a class="anchor" name="d8422a939a634d2248ef6d8658f0fdad"></a><!-- doxytag: member="Gio::File::eject_mountable" ref="d8422a939a634d2248ef6d8658f0fdad" args="(const SlotAsyncReady &amp;slot, MountUnmountFlags flags=MOUNT_UNMOUNT_NONE)" -->
1645
 
<div class="memitem">
1646
 
<div class="memproto">
1647
 
      <table class="memname">
1648
 
        <tr>
1649
 
          <td class="memname">void Gio::File::eject_mountable           </td>
1650
 
          <td>(</td>
1651
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
1652
 
          <td class="paramname"> <em>slot</em>, </td>
1653
 
        </tr>
1654
 
        <tr>
1655
 
          <td class="paramkey"></td>
1656
 
          <td></td>
1657
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g9fa1b6a8eabf8f88e4cf6d611a4cff44">MountUnmountFlags</a>&nbsp;</td>
1658
 
          <td class="paramname"> <em>flags</em> = <code>MOUNT_UNMOUNT_NONE</code></td><td>&nbsp;</td>
1659
 
        </tr>
1660
 
        <tr>
1661
 
          <td></td>
1662
 
          <td>)</td>
1663
 
          <td></td><td></td><td></td>
1664
 
        </tr>
1665
 
      </table>
1666
 
</div>
1667
 
<div class="memdoc">
1668
 
 
1669
 
<p>
1670
 
Starts an asynchronous eject on a mountable. 
1671
 
<p>
1672
 
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#6a5124de7c55e9dc5e85ffcb9d3dd14f" title="Finishes an asynchronous eject operation started by g_file_eject_mountable().">eject_mountable_finish()</a> to get the result of the operation.<p>
1673
 
<dl compact><dt><b>Parameters:</b></dt><dd>
1674
 
  <table border="0" cellspacing="2" cellpadding="0">
1675
 
    <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>
1676
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>Flags affecting the operation. </td></tr>
1677
 
  </table>
1678
 
</dl>
1679
 
 
1680
 
</div>
1681
 
</div><p>
1682
 
<a class="anchor" name="8a8223e3b661f03c7a60ac0f003b916e"></a><!-- doxytag: member="Gio::File::eject_mountable" ref="8a8223e3b661f03c7a60ac0f003b916e" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, MountUnmountFlags flags=MOUNT_UNMOUNT_NONE)" -->
1683
 
<div class="memitem">
1684
 
<div class="memproto">
1685
 
      <table class="memname">
1686
 
        <tr>
1687
 
          <td class="memname">void Gio::File::eject_mountable           </td>
1688
 
          <td>(</td>
1689
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
1690
 
          <td class="paramname"> <em>slot</em>, </td>
1691
 
        </tr>
1692
 
        <tr>
1693
 
          <td class="paramkey"></td>
1694
 
          <td></td>
1695
 
          <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>
1696
 
          <td class="paramname"> <em>cancellable</em>, </td>
1697
 
        </tr>
1698
 
        <tr>
1699
 
          <td class="paramkey"></td>
1700
 
          <td></td>
1701
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g9fa1b6a8eabf8f88e4cf6d611a4cff44">MountUnmountFlags</a>&nbsp;</td>
1702
 
          <td class="paramname"> <em>flags</em> = <code>MOUNT_UNMOUNT_NONE</code></td><td>&nbsp;</td>
1703
 
        </tr>
1704
 
        <tr>
1705
 
          <td></td>
1706
 
          <td>)</td>
1707
 
          <td></td><td></td><td></td>
1708
 
        </tr>
1709
 
      </table>
1710
 
</div>
1711
 
<div class="memdoc">
1712
 
 
1713
 
<p>
1714
 
Starts an asynchronous eject on a mountable. 
1715
 
<p>
1716
 
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>
1717
 
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#6a5124de7c55e9dc5e85ffcb9d3dd14f" title="Finishes an asynchronous eject operation started by g_file_eject_mountable().">eject_mountable_finish()</a> to get the result of the operation.<p>
1718
 
<dl compact><dt><b>Parameters:</b></dt><dd>
1719
 
  <table border="0" cellspacing="2" cellpadding="0">
1720
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>Flags affecting the operation. </td></tr>
1721
 
    <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>
1722
 
    <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>
1723
 
  </table>
1724
 
</dl>
1725
 
 
1726
 
</div>
1727
 
</div><p>
1728
 
<a class="anchor" name="6a5124de7c55e9dc5e85ffcb9d3dd14f"></a><!-- doxytag: member="Gio::File::eject_mountable_finish" ref="6a5124de7c55e9dc5e85ffcb9d3dd14f" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
1729
 
<div class="memitem">
1730
 
<div class="memproto">
1731
 
      <table class="memname">
1732
 
        <tr>
1733
 
          <td class="memname">bool Gio::File::eject_mountable_finish           </td>
1734
 
          <td>(</td>
1735
 
          <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>
1736
 
          <td class="paramname"> <em>result</em>          </td>
1737
 
          <td>&nbsp;)&nbsp;</td>
1738
 
          <td></td>
1739
 
        </tr>
1740
 
      </table>
1741
 
</div>
1742
 
<div class="memdoc">
1743
 
 
1744
 
<p>
1745
 
Finishes an asynchronous eject operation started by g_file_eject_mountable(). 
1746
 
<p>
1747
 
<dl compact><dt><b>Parameters:</b></dt><dd>
1748
 
  <table border="0" cellspacing="2" cellpadding="0">
1749
 
    <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>
1750
 
  </table>
1751
 
</dl>
1752
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>file</em> was ejected successfully. <code>false</code> otherwise. </dd></dl>
1753
 
 
1754
 
</div>
1755
 
</div><p>
1756
 
<a class="anchor" name="c0e293d607499b223f4892fb290ab2d6"></a><!-- doxytag: member="Gio::File::enumerate_children" ref="c0e293d607499b223f4892fb290ab2d6" args="(const std::string &amp;attributes=&quot;*&quot;, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE)" -->
1757
 
<div class="memitem">
1758
 
<div class="memproto">
1759
 
      <table class="memname">
1760
 
        <tr>
1761
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileEnumerator.html">FileEnumerator</a>&gt; Gio::File::enumerate_children           </td>
1762
 
          <td>(</td>
1763
 
          <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>
1764
 
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code>, </td>
1765
 
        </tr>
1766
 
        <tr>
1767
 
          <td class="paramkey"></td>
1768
 
          <td></td>
1769
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
1770
 
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code></td><td>&nbsp;</td>
1771
 
        </tr>
1772
 
        <tr>
1773
 
          <td></td>
1774
 
          <td>)</td>
1775
 
          <td></td><td></td><td></td>
1776
 
        </tr>
1777
 
      </table>
1778
 
</div>
1779
 
<div class="memdoc">
1780
 
 
1781
 
<p>
1782
 
Gets the requested information about the files in a directory. 
1783
 
<p>
1784
 
The result is a <a class="el" href="classGio_1_1FileEnumerator.html" title="Enumerated Files Routines.">FileEnumerator</a> object that will give out <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> objects for all the files in the directory.<p>
1785
 
The <em>attribute</em> value is a string that specifies the file attributes that should be gathered. It is not an error if its not possible to read a particular requested attribute from a file, it just won't be set. <em>attribute</em> should be a comma-separated list of attribute or attribute wildcards. The wildcard "*" means all attributes, and a wildcard like "standard::*" means all attributes in the standard namespace. An example attribute query be "standard::*,owner::user". The standard attributes are availible as defines, like FILE_ATTRIBUTE_STANDARD_NAME.<p>
1786
 
If the file does not exist, a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_FOUND will be thrown. If the file is not a directory, a <a class="el" href="classGlib_1_1FileError.html" title="Exception class for file-related errors.">Glib::FileError</a> with NOTDIR will be thrown. Other errors are possible too.<p>
1787
 
<dl compact><dt><b>Parameters:</b></dt><dd>
1788
 
  <table border="0" cellspacing="2" cellpadding="0">
1789
 
    <tr><td valign="top"></td><td valign="top"><em>attributes</em>&nbsp;</td><td>An attribute query string. </td></tr>
1790
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
1791
 
  </table>
1792
 
</dl>
1793
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileEnumerator.html" title="Enumerated Files Routines.">FileEnumerator</a> if successful. </dd></dl>
1794
 
 
1795
 
</div>
1796
 
</div><p>
1797
 
<a class="anchor" name="68c3afcddc0d4860aa2afb4bf715bb20"></a><!-- doxytag: member="Gio::File::enumerate_children" ref="68c3afcddc0d4860aa2afb4bf715bb20" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, const std::string &amp;attributes=&quot;*&quot;, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE)" -->
1798
 
<div class="memitem">
1799
 
<div class="memproto">
1800
 
      <table class="memname">
1801
 
        <tr>
1802
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileEnumerator.html">FileEnumerator</a>&gt; Gio::File::enumerate_children           </td>
1803
 
          <td>(</td>
1804
 
          <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>
1805
 
          <td class="paramname"> <em>cancellable</em>, </td>
1806
 
        </tr>
1807
 
        <tr>
1808
 
          <td class="paramkey"></td>
1809
 
          <td></td>
1810
 
          <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>
1811
 
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code>, </td>
1812
 
        </tr>
1813
 
        <tr>
1814
 
          <td class="paramkey"></td>
1815
 
          <td></td>
1816
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
1817
 
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code></td><td>&nbsp;</td>
1818
 
        </tr>
1819
 
        <tr>
1820
 
          <td></td>
1821
 
          <td>)</td>
1822
 
          <td></td><td></td><td></td>
1823
 
        </tr>
1824
 
      </table>
1825
 
</div>
1826
 
<div class="memdoc">
1827
 
 
1828
 
<p>
1829
 
Gets the requested information about the files in a directory. 
1830
 
<p>
1831
 
The result is a <a class="el" href="classGio_1_1FileEnumerator.html" title="Enumerated Files Routines.">FileEnumerator</a> object that will give out <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> objects for all the files in the directory.<p>
1832
 
The <em>attribute</em> value is a string that specifies the file attributes that should be gathered. It is not an error if its not possible to read a particular requested attribute from a file, it just won't be set. <em>attribute</em> should be a comma-separated list of attribute or attribute wildcards. The wildcard "*" means all attributes, and a wildcard like "standard::*" means all attributes in the standard namespace. An example attribute query be "standard::*,owner::user". The standard attributes are availible as defines, like FILE_ATTRIBUTE_STANDARD_NAME.<p>
1833
 
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>
1834
 
If the file does not exist, a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_FOUND will be thrown. If the file is not a directory, a <a class="el" href="classGlib_1_1FileError.html" title="Exception class for file-related errors.">Glib::FileError</a> with NOTDIR will be thrown. Other errors are possible too.<p>
1835
 
<dl compact><dt><b>Parameters:</b></dt><dd>
1836
 
  <table border="0" cellspacing="2" cellpadding="0">
1837
 
    <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>
1838
 
    <tr><td valign="top"></td><td valign="top"><em>attributes</em>&nbsp;</td><td>An attribute query string. </td></tr>
1839
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
1840
 
  </table>
1841
 
</dl>
1842
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileEnumerator.html" title="Enumerated Files Routines.">FileEnumerator</a> if successful. </dd></dl>
1843
 
 
1844
 
</div>
1845
 
</div><p>
1846
 
<a class="anchor" name="5b5470cf1c97754a12169201665f1202"></a><!-- doxytag: member="Gio::File::enumerate_children_async" ref="5b5470cf1c97754a12169201665f1202" args="(const SlotAsyncReady &amp;slot, const std::string &amp;attributes=&quot;*&quot;, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
1847
 
<div class="memitem">
1848
 
<div class="memproto">
1849
 
      <table class="memname">
1850
 
        <tr>
1851
 
          <td class="memname">void Gio::File::enumerate_children_async           </td>
1852
 
          <td>(</td>
1853
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
1854
 
          <td class="paramname"> <em>slot</em>, </td>
1855
 
        </tr>
1856
 
        <tr>
1857
 
          <td class="paramkey"></td>
1858
 
          <td></td>
1859
 
          <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>
1860
 
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code>, </td>
1861
 
        </tr>
1862
 
        <tr>
1863
 
          <td class="paramkey"></td>
1864
 
          <td></td>
1865
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
1866
 
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code>, </td>
1867
 
        </tr>
1868
 
        <tr>
1869
 
          <td class="paramkey"></td>
1870
 
          <td></td>
1871
 
          <td class="paramtype">int&nbsp;</td>
1872
 
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
1873
 
        </tr>
1874
 
        <tr>
1875
 
          <td></td>
1876
 
          <td>)</td>
1877
 
          <td></td><td></td><td></td>
1878
 
        </tr>
1879
 
      </table>
1880
 
</div>
1881
 
<div class="memdoc">
1882
 
 
1883
 
<p>
1884
 
Asynchronously gets the requested information about the files in a directory. 
1885
 
<p>
1886
 
The result is a GFileEnumerator object that will give out GFileInfo objects for all the files in the directory.<p>
1887
 
For more details, see <a class="el" href="classGio_1_1File.html#68c3afcddc0d4860aa2afb4bf715bb20" title="Gets the requested information about the files in a directory.">enumerate_children()</a> which is the synchronous version of this call. When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#617a2950448788e68df128c58e068a14" title="Finishes an async enumerate children operation.">enumerate_children_finish()</a> to get the result of the operation.<p>
1888
 
<dl compact><dt><b>Parameters:</b></dt><dd>
1889
 
  <table border="0" cellspacing="2" cellpadding="0">
1890
 
    <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>
1891
 
    <tr><td valign="top"></td><td valign="top"><em>attributes</em>&nbsp;</td><td>An attribute query string. </td></tr>
1892
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
1893
 
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
1894
 
  </table>
1895
 
</dl>
1896
 
 
1897
 
</div>
1898
 
</div><p>
1899
 
<a class="anchor" name="1ead7237b7057d9b15cf5f3065988131"></a><!-- doxytag: member="Gio::File::enumerate_children_async" ref="1ead7237b7057d9b15cf5f3065988131" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, const std::string &amp;attributes=&quot;*&quot;, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
1900
 
<div class="memitem">
1901
 
<div class="memproto">
1902
 
      <table class="memname">
1903
 
        <tr>
1904
 
          <td class="memname">void Gio::File::enumerate_children_async           </td>
1905
 
          <td>(</td>
1906
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
1907
 
          <td class="paramname"> <em>slot</em>, </td>
1908
 
        </tr>
1909
 
        <tr>
1910
 
          <td class="paramkey"></td>
1911
 
          <td></td>
1912
 
          <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>
1913
 
          <td class="paramname"> <em>cancellable</em>, </td>
1914
 
        </tr>
1915
 
        <tr>
1916
 
          <td class="paramkey"></td>
1917
 
          <td></td>
1918
 
          <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>
1919
 
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code>, </td>
1920
 
        </tr>
1921
 
        <tr>
1922
 
          <td class="paramkey"></td>
1923
 
          <td></td>
1924
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
1925
 
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code>, </td>
1926
 
        </tr>
1927
 
        <tr>
1928
 
          <td class="paramkey"></td>
1929
 
          <td></td>
1930
 
          <td class="paramtype">int&nbsp;</td>
1931
 
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
1932
 
        </tr>
1933
 
        <tr>
1934
 
          <td></td>
1935
 
          <td>)</td>
1936
 
          <td></td><td></td><td></td>
1937
 
        </tr>
1938
 
      </table>
1939
 
</div>
1940
 
<div class="memdoc">
1941
 
 
1942
 
<p>
1943
 
Asynchronously gets the requested information about the files in a directory. 
1944
 
<p>
1945
 
The result is a GFileEnumerator object that will give out GFileInfo objects for all the files in the directory.<p>
1946
 
For more details, see <a class="el" href="classGio_1_1File.html#68c3afcddc0d4860aa2afb4bf715bb20" title="Gets the requested information about the files in a directory.">enumerate_children()</a> which is the synchronous version of this call. When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#617a2950448788e68df128c58e068a14" title="Finishes an async enumerate children operation.">enumerate_children_finish()</a> to get the result of the operation.<p>
1947
 
<dl compact><dt><b>Parameters:</b></dt><dd>
1948
 
  <table border="0" cellspacing="2" cellpadding="0">
1949
 
    <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>
1950
 
    <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>
1951
 
    <tr><td valign="top"></td><td valign="top"><em>attributes</em>&nbsp;</td><td>An attribute query string. </td></tr>
1952
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
1953
 
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
1954
 
  </table>
1955
 
</dl>
1956
 
 
1957
 
</div>
1958
 
</div><p>
1959
 
<a class="anchor" name="617a2950448788e68df128c58e068a14"></a><!-- doxytag: member="Gio::File::enumerate_children_finish" ref="617a2950448788e68df128c58e068a14" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
1960
 
<div class="memitem">
1961
 
<div class="memproto">
1962
 
      <table class="memname">
1963
 
        <tr>
1964
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileEnumerator.html">FileEnumerator</a>&gt; Gio::File::enumerate_children_finish           </td>
1965
 
          <td>(</td>
1966
 
          <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>
1967
 
          <td class="paramname"> <em>result</em>          </td>
1968
 
          <td>&nbsp;)&nbsp;</td>
1969
 
          <td></td>
1970
 
        </tr>
1971
 
      </table>
1972
 
</div>
1973
 
<div class="memdoc">
1974
 
 
1975
 
<p>
1976
 
Finishes an async enumerate children operation. 
1977
 
<p>
1978
 
See g_file_enumerate_children_async(). <dl compact><dt><b>Parameters:</b></dt><dd>
1979
 
  <table border="0" cellspacing="2" cellpadding="0">
1980
 
    <tr><td valign="top"></td><td valign="top"><em>res</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>
1981
 
  </table>
1982
 
</dl>
1983
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileEnumerator.html" title="Enumerated Files Routines.">FileEnumerator</a> or <code>0</code> if an error occurred. Free the returned object with Glib::object_unref(). </dd></dl>
 
798
<a class="anchor" name="0320bac72ecc9ced1f894f1af696856f"></a><!-- doxytag: member="Gio::File::hash" ref="0320bac72ecc9ced1f894f1af696856f" args="() const " -->
 
799
<div class="memitem">
 
800
<div class="memproto">
 
801
      <table class="memname">
 
802
        <tr>
 
803
          <td class="memname">guint Gio::File::hash           </td>
 
804
          <td>(</td>
 
805
          <td class="paramname">          </td>
 
806
          <td>&nbsp;)&nbsp;</td>
 
807
          <td> const</td>
 
808
        </tr>
 
809
      </table>
 
810
</div>
 
811
<div class="memdoc">
 
812
 
 
813
<p>
 
814
Creates a hash value for a <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a>. 
 
815
<p>
 
816
This call does no blocking i/o. <dl compact><dt><b>Parameters:</b></dt><dd>
 
817
  <table border="0" cellspacing="2" cellpadding="0">
 
818
    <tr><td valign="top"></td><td valign="top"><em>file</em>&nbsp;</td><td>gconstpointer to a <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a>. </td></tr>
 
819
  </table>
 
820
</dl>
 
821
<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 if <em>file</em> is not a valid <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a>, otherwise an integer that can be used as hash value for the <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a>. This function is intended for easily hashing a <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> to add to a HashTable or similar data structure. </dd></dl>
1984
822
 
1985
823
</div>
1986
824
</div><p>
2013
851
 
2014
852
</div>
2015
853
</div><p>
2016
 
<a class="anchor" name="6eb675267c7ea1c2a0d40e2e754d8333"></a><!-- doxytag: member="Gio::File::find_enclosing_mount" ref="6eb675267c7ea1c2a0d40e2e754d8333" args="()" -->
2017
 
<div class="memitem">
2018
 
<div class="memproto">
2019
 
      <table class="memname">
2020
 
        <tr>
2021
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1Mount.html">Mount</a>&gt; Gio::File::find_enclosing_mount           </td>
2022
 
          <td>(</td>
2023
 
          <td class="paramname">          </td>
2024
 
          <td>&nbsp;)&nbsp;</td>
2025
 
          <td></td>
2026
 
        </tr>
2027
 
      </table>
2028
 
</div>
2029
 
<div class="memdoc">
2030
 
 
2031
 
<p>
2032
 
Gets a <a class="el" href="classGio_1_1Mount.html" title="The Mount interface represents user-visible mounts.">Mount</a> for the <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a>. 
2033
 
<p>
2034
 
If the FileIface for the file does not have a mount (e.g. possibly a remote share), an <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> wtih NOT_FOUND will be thrown and an empty RefPtr will be returned.<p>
2035
 
<dl compact><dt><b>Parameters:</b></dt><dd>
2036
 
  <table border="0" cellspacing="2" cellpadding="0">
2037
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
2038
 
  </table>
2039
 
</dl>
2040
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1Mount.html" title="The Mount interface represents user-visible mounts.">Mount</a> where the file is located. </dd></dl>
2041
 
 
2042
 
</div>
2043
 
</div><p>
2044
 
<a class="anchor" name="45b881926b8d58c49d3baa1f51f2ee5d"></a><!-- doxytag: member="Gio::File::find_enclosing_mount" ref="45b881926b8d58c49d3baa1f51f2ee5d" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
2045
 
<div class="memitem">
2046
 
<div class="memproto">
2047
 
      <table class="memname">
2048
 
        <tr>
2049
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1Mount.html">Mount</a>&gt; Gio::File::find_enclosing_mount           </td>
2050
 
          <td>(</td>
2051
 
          <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>
2052
 
          <td class="paramname"> <em>cancellable</em>          </td>
2053
 
          <td>&nbsp;)&nbsp;</td>
2054
 
          <td></td>
2055
 
        </tr>
2056
 
      </table>
2057
 
</div>
2058
 
<div class="memdoc">
2059
 
 
2060
 
<p>
2061
 
Gets a <a class="el" href="classGio_1_1Mount.html" title="The Mount interface represents user-visible mounts.">Mount</a> for the <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a>. 
2062
 
<p>
2063
 
If the FileIface for <em>file</em> does not have a mount (e.g. possibly a remote share), a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> will be thrown with NOT_FOUND and <code>0</code> will be returned.<p>
2064
 
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
2065
 
  <table border="0" cellspacing="2" cellpadding="0">
2066
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
2067
 
  </table>
2068
 
</dl>
2069
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1Mount.html" title="The Mount interface represents user-visible mounts.">Mount</a> where the <em>file</em> is located or <code>0</code> on error. </dd></dl>
2070
 
 
2071
 
</div>
2072
 
</div><p>
2073
 
<a class="anchor" name="67458be57c5687e7469bc26e2594f4be"></a><!-- doxytag: member="Gio::File::find_enclosing_mount_async" ref="67458be57c5687e7469bc26e2594f4be" args="(const SlotAsyncReady &amp;slot, int io_priority=Glib::PRIORITY_DEFAULT)" -->
2074
 
<div class="memitem">
2075
 
<div class="memproto">
2076
 
      <table class="memname">
2077
 
        <tr>
2078
 
          <td class="memname">void Gio::File::find_enclosing_mount_async           </td>
2079
 
          <td>(</td>
2080
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
2081
 
          <td class="paramname"> <em>slot</em>, </td>
2082
 
        </tr>
2083
 
        <tr>
2084
 
          <td class="paramkey"></td>
2085
 
          <td></td>
2086
 
          <td class="paramtype">int&nbsp;</td>
2087
 
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
2088
 
        </tr>
2089
 
        <tr>
2090
 
          <td></td>
2091
 
          <td>)</td>
2092
 
          <td></td><td></td><td></td>
2093
 
        </tr>
2094
 
      </table>
2095
 
</div>
2096
 
<div class="memdoc">
2097
 
 
2098
 
<p>
2099
 
Asynchronously gets the mount for the file. 
2100
 
<p>
2101
 
For more details, see <a class="el" href="classGio_1_1File.html#6eb675267c7ea1c2a0d40e2e754d8333" title="Gets a Mount for the File.">find_enclosing_mount()</a> which is the synchronous version of this call.<p>
2102
 
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#a12e6222d81179937cdc366f4d315433" title="Finishes an asynchronous find mount request.">find_enclosing_mount_finish()</a> to get the result of the operation.<p>
2103
 
<dl compact><dt><b>Parameters:</b></dt><dd>
2104
 
  <table border="0" cellspacing="2" cellpadding="0">
2105
 
    <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>
2106
 
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
2107
 
  </table>
2108
 
</dl>
2109
 
 
2110
 
</div>
2111
 
</div><p>
2112
 
<a class="anchor" name="78c95d4fa47157f7757b686677dec018"></a><!-- doxytag: member="Gio::File::find_enclosing_mount_async" ref="78c95d4fa47157f7757b686677dec018" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, int io_priority=Glib::PRIORITY_DEFAULT)" -->
2113
 
<div class="memitem">
2114
 
<div class="memproto">
2115
 
      <table class="memname">
2116
 
        <tr>
2117
 
          <td class="memname">void Gio::File::find_enclosing_mount_async           </td>
2118
 
          <td>(</td>
2119
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
2120
 
          <td class="paramname"> <em>slot</em>, </td>
2121
 
        </tr>
2122
 
        <tr>
2123
 
          <td class="paramkey"></td>
2124
 
          <td></td>
2125
 
          <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>
2126
 
          <td class="paramname"> <em>cancellable</em>, </td>
2127
 
        </tr>
2128
 
        <tr>
2129
 
          <td class="paramkey"></td>
2130
 
          <td></td>
2131
 
          <td class="paramtype">int&nbsp;</td>
2132
 
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
2133
 
        </tr>
2134
 
        <tr>
2135
 
          <td></td>
2136
 
          <td>)</td>
2137
 
          <td></td><td></td><td></td>
2138
 
        </tr>
2139
 
      </table>
2140
 
</div>
2141
 
<div class="memdoc">
2142
 
 
2143
 
<p>
2144
 
Asynchronously gets the mount for the file. 
2145
 
<p>
2146
 
For more details, see <a class="el" href="classGio_1_1File.html#6eb675267c7ea1c2a0d40e2e754d8333" title="Gets a Mount for the File.">find_enclosing_mount()</a> which is the synchronous version of this call.<p>
2147
 
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#a12e6222d81179937cdc366f4d315433" title="Finishes an asynchronous find mount request.">find_enclosing_mount_finish()</a> to get the result of the operation.<p>
2148
 
<dl compact><dt><b>Parameters:</b></dt><dd>
2149
 
  <table border="0" cellspacing="2" cellpadding="0">
2150
 
    <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>
2151
 
    <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>
2152
 
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
2153
 
  </table>
2154
 
</dl>
2155
 
 
2156
 
</div>
2157
 
</div><p>
2158
 
<a class="anchor" name="a12e6222d81179937cdc366f4d315433"></a><!-- doxytag: member="Gio::File::find_enclosing_mount_finish" ref="a12e6222d81179937cdc366f4d315433" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
2159
 
<div class="memitem">
2160
 
<div class="memproto">
2161
 
      <table class="memname">
2162
 
        <tr>
2163
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1Mount.html">Mount</a>&gt; Gio::File::find_enclosing_mount_finish           </td>
2164
 
          <td>(</td>
2165
 
          <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>
2166
 
          <td class="paramname"> <em>result</em>          </td>
2167
 
          <td>&nbsp;)&nbsp;</td>
2168
 
          <td></td>
2169
 
        </tr>
2170
 
      </table>
2171
 
</div>
2172
 
<div class="memdoc">
2173
 
 
2174
 
<p>
2175
 
Finishes an asynchronous find mount request. 
2176
 
<p>
2177
 
See g_file_find_enclosing_mount_async(). <dl compact><dt><b>Parameters:</b></dt><dd>
2178
 
  <table border="0" cellspacing="2" cellpadding="0">
2179
 
    <tr><td valign="top"></td><td valign="top"><em>res</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>
2180
 
  </table>
2181
 
</dl>
2182
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><a class="el" href="classGio_1_1Mount.html" title="The Mount interface represents user-visible mounts.">Mount</a> for given <em>file</em> or <code>0</code> on error. Free the returned object with Glib::object_unref(). </dd></dl>
2183
 
 
2184
 
</div>
2185
 
</div><p>
2186
854
<a class="anchor" name="c731bed45bb7fcfd411eb69c49d3b883"></a><!-- doxytag: member="Gio::File::get_basename" ref="c731bed45bb7fcfd411eb69c49d3b883" args="() const " -->
2187
855
<div class="memitem">
2188
856
<div class="memproto">
2207
875
 
2208
876
</div>
2209
877
</div><p>
 
878
<a class="anchor" name="7b3edc7946b681b6db2cdcdad08d2b00"></a><!-- doxytag: member="Gio::File::get_path" ref="7b3edc7946b681b6db2cdcdad08d2b00" args="() const " -->
 
879
<div class="memitem">
 
880
<div class="memproto">
 
881
      <table class="memname">
 
882
        <tr>
 
883
          <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::File::get_path           </td>
 
884
          <td>(</td>
 
885
          <td class="paramname">          </td>
 
886
          <td>&nbsp;)&nbsp;</td>
 
887
          <td> const</td>
 
888
        </tr>
 
889
      </table>
 
890
</div>
 
891
<div class="memdoc">
 
892
 
 
893
<p>
 
894
Gets the local pathname for <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a>, if one exists. 
 
895
<p>
 
896
This call does no blocking i/o. <dl class="return" compact><dt><b>Returns:</b></dt><dd>String containing the File's path, or <code>0</code> if no such path exists. The returned string should be freed with Glib::free() when no longer needed. </dd></dl>
 
897
 
 
898
</div>
 
899
</div><p>
 
900
<a class="anchor" name="2d1313e4a4eb5de034b693ec1cc9fba0"></a><!-- doxytag: member="Gio::File::get_uri" ref="2d1313e4a4eb5de034b693ec1cc9fba0" args="() const " -->
 
901
<div class="memitem">
 
902
<div class="memproto">
 
903
      <table class="memname">
 
904
        <tr>
 
905
          <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::File::get_uri           </td>
 
906
          <td>(</td>
 
907
          <td class="paramname">          </td>
 
908
          <td>&nbsp;)&nbsp;</td>
 
909
          <td> const</td>
 
910
        </tr>
 
911
      </table>
 
912
</div>
 
913
<div class="memdoc">
 
914
 
 
915
<p>
 
916
Gets the URI for the <em>file</em>. 
 
917
<p>
 
918
This call does no blocking i/o. <dl class="return" compact><dt><b>Returns:</b></dt><dd>A string containing the File's URI. The returned string should be freed with Glib::free() when no longer needed. </dd></dl>
 
919
 
 
920
</div>
 
921
</div><p>
 
922
<a class="anchor" name="ea4a78163e3085a35cbaacde9a3a7628"></a><!-- doxytag: member="Gio::File::get_parse_name" ref="ea4a78163e3085a35cbaacde9a3a7628" args="() const " -->
 
923
<div class="memitem">
 
924
<div class="memproto">
 
925
      <table class="memname">
 
926
        <tr>
 
927
          <td class="memname"><a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a> Gio::File::get_parse_name           </td>
 
928
          <td>(</td>
 
929
          <td class="paramname">          </td>
 
930
          <td>&nbsp;)&nbsp;</td>
 
931
          <td> const</td>
 
932
        </tr>
 
933
      </table>
 
934
</div>
 
935
<div class="memdoc">
 
936
 
 
937
<p>
 
938
Gets the parse name of the <em>file</em>. 
 
939
<p>
 
940
A parse name is a UTF-8 string that describes the file such that one can get the <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> back using g_file_parse_name().<p>
 
941
This is generally used to show the <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> as a nice full-pathname kind of string in a user interface, like in a location entry.<p>
 
942
For local files with names that can safely be converted to UTF8 the pathname is used, otherwise the IRI is used (a form of URI that allows UTF8 characters unescaped).<p>
 
943
This call does no blocking i/o. <dl class="return" compact><dt><b>Returns:</b></dt><dd>A string containing the File's parse name. The returned string should be freed with Glib::free() when no longer needed. </dd></dl>
 
944
 
 
945
</div>
 
946
</div><p>
 
947
<a class="anchor" name="f39bbd5013b2dd675911df322e12ff94"></a><!-- doxytag: member="Gio::File::get_parent" ref="f39bbd5013b2dd675911df322e12ff94" args="() const " -->
 
948
<div class="memitem">
 
949
<div class="memproto">
 
950
      <table class="memname">
 
951
        <tr>
 
952
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt; Gio::File::get_parent           </td>
 
953
          <td>(</td>
 
954
          <td class="paramname">          </td>
 
955
          <td>&nbsp;)&nbsp;</td>
 
956
          <td> const</td>
 
957
        </tr>
 
958
      </table>
 
959
</div>
 
960
<div class="memdoc">
 
961
 
 
962
<p>
 
963
Gets the parent directory for the <em>file</em>. 
 
964
<p>
 
965
If the <em>file</em> represents the root directory of the file system, then <code>0</code> will be returned.<p>
 
966
This call does no blocking i/o. <dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> structure to the parent of the given <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> or <code>0</code> if there is no parent. Free the returned object with Glib::object_unref(). </dd></dl>
 
967
 
 
968
</div>
 
969
</div><p>
2210
970
<a class="anchor" name="53c533d6bbeaaadd1b5592cf1e5ef93c"></a><!-- doxytag: member="Gio::File::get_child" ref="53c533d6bbeaaadd1b5592cf1e5ef93c" args="(const std::string &amp;name) const " -->
2211
971
<div class="memitem">
2212
972
<div class="memproto">
2265
1025
 
2266
1026
</div>
2267
1027
</div><p>
2268
 
<a class="anchor" name="f39bbd5013b2dd675911df322e12ff94"></a><!-- doxytag: member="Gio::File::get_parent" ref="f39bbd5013b2dd675911df322e12ff94" args="() const " -->
2269
 
<div class="memitem">
2270
 
<div class="memproto">
2271
 
      <table class="memname">
2272
 
        <tr>
2273
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt; Gio::File::get_parent           </td>
2274
 
          <td>(</td>
2275
 
          <td class="paramname">          </td>
2276
 
          <td>&nbsp;)&nbsp;</td>
2277
 
          <td> const</td>
2278
 
        </tr>
2279
 
      </table>
2280
 
</div>
2281
 
<div class="memdoc">
2282
 
 
2283
 
<p>
2284
 
Gets the parent directory for the <em>file</em>. 
2285
 
<p>
2286
 
If the <em>file</em> represents the root directory of the file system, then <code>0</code> will be returned.<p>
2287
 
This call does no blocking i/o. <dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> structure to the parent of the given <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> or <code>0</code> if there is no parent. Free the returned object with Glib::object_unref(). </dd></dl>
2288
 
 
2289
 
</div>
2290
 
</div><p>
2291
 
<a class="anchor" name="ea4a78163e3085a35cbaacde9a3a7628"></a><!-- doxytag: member="Gio::File::get_parse_name" ref="ea4a78163e3085a35cbaacde9a3a7628" args="() const " -->
2292
 
<div class="memitem">
2293
 
<div class="memproto">
2294
 
      <table class="memname">
2295
 
        <tr>
2296
 
          <td class="memname"><a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a> Gio::File::get_parse_name           </td>
2297
 
          <td>(</td>
2298
 
          <td class="paramname">          </td>
2299
 
          <td>&nbsp;)&nbsp;</td>
2300
 
          <td> const</td>
2301
 
        </tr>
2302
 
      </table>
2303
 
</div>
2304
 
<div class="memdoc">
2305
 
 
2306
 
<p>
2307
 
Gets the parse name of the <em>file</em>. 
2308
 
<p>
2309
 
A parse name is a UTF-8 string that describes the file such that one can get the <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> back using g_file_parse_name().<p>
2310
 
This is generally used to show the <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> as a nice full-pathname kind of string in a user interface, like in a location entry.<p>
2311
 
For local files with names that can safely be converted to UTF8 the pathname is used, otherwise the IRI is used (a form of URI that allows UTF8 characters unescaped).<p>
2312
 
This call does no blocking i/o. <dl class="return" compact><dt><b>Returns:</b></dt><dd>A string containing the File's parse name. The returned string should be freed with Glib::free() when no longer needed. </dd></dl>
2313
 
 
2314
 
</div>
2315
 
</div><p>
2316
 
<a class="anchor" name="7b3edc7946b681b6db2cdcdad08d2b00"></a><!-- doxytag: member="Gio::File::get_path" ref="7b3edc7946b681b6db2cdcdad08d2b00" args="() const " -->
2317
 
<div class="memitem">
2318
 
<div class="memproto">
2319
 
      <table class="memname">
2320
 
        <tr>
2321
 
          <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::File::get_path           </td>
2322
 
          <td>(</td>
2323
 
          <td class="paramname">          </td>
2324
 
          <td>&nbsp;)&nbsp;</td>
2325
 
          <td> const</td>
2326
 
        </tr>
2327
 
      </table>
2328
 
</div>
2329
 
<div class="memdoc">
2330
 
 
2331
 
<p>
2332
 
Gets the local pathname for <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a>, if one exists. 
2333
 
<p>
2334
 
This call does no blocking i/o. <dl class="return" compact><dt><b>Returns:</b></dt><dd>String containing the File's path, or <code>0</code> if no such path exists. The returned string should be freed with Glib::free() when no longer needed. </dd></dl>
2335
 
 
2336
 
</div>
2337
 
</div><p>
2338
 
<a class="anchor" name="464248111fa2bc5df89c620354eb99bb"></a><!-- doxytag: member="Gio::File::get_relative_path" ref="464248111fa2bc5df89c620354eb99bb" args="(const Glib::RefPtr&lt; const File &gt; &amp;descendant) const " -->
2339
 
<div class="memitem">
2340
 
<div class="memproto">
2341
 
      <table class="memname">
2342
 
        <tr>
2343
 
          <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::File::get_relative_path           </td>
2344
 
          <td>(</td>
2345
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;const <a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
2346
 
          <td class="paramname"> <em>descendant</em>          </td>
2347
 
          <td>&nbsp;)&nbsp;</td>
2348
 
          <td> const</td>
2349
 
        </tr>
2350
 
      </table>
2351
 
</div>
2352
 
<div class="memdoc">
2353
 
 
2354
 
<p>
2355
 
Gets the path for <em>descendant</em> relative to <em>parent</em>. 
2356
 
<p>
2357
 
This call does no blocking i/o. <dl compact><dt><b>Parameters:</b></dt><dd>
2358
 
  <table border="0" cellspacing="2" cellpadding="0">
2359
 
    <tr><td valign="top"></td><td valign="top"><em>descendant</em>&nbsp;</td><td>Input <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a>. </td></tr>
2360
 
  </table>
2361
 
</dl>
2362
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>String with the relative path from <em>descendant</em> to <em>parent</em>, or <code>0</code> if <em>descendant</em> doesn't have <em>parent</em> as prefix. The returned string should be freed with Glib::free() when no longer needed. </dd></dl>
2363
 
 
2364
 
</div>
2365
 
</div><p>
2366
 
<a class="anchor" name="2d1313e4a4eb5de034b693ec1cc9fba0"></a><!-- doxytag: member="Gio::File::get_uri" ref="2d1313e4a4eb5de034b693ec1cc9fba0" args="() const " -->
2367
 
<div class="memitem">
2368
 
<div class="memproto">
2369
 
      <table class="memname">
2370
 
        <tr>
2371
 
          <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::File::get_uri           </td>
2372
 
          <td>(</td>
2373
 
          <td class="paramname">          </td>
2374
 
          <td>&nbsp;)&nbsp;</td>
2375
 
          <td> const</td>
2376
 
        </tr>
2377
 
      </table>
2378
 
</div>
2379
 
<div class="memdoc">
2380
 
 
2381
 
<p>
2382
 
Gets the URI for the <em>file</em>. 
2383
 
<p>
2384
 
This call does no blocking i/o. <dl class="return" compact><dt><b>Returns:</b></dt><dd>A string containing the File's URI. The returned string should be freed with Glib::free() when no longer needed. </dd></dl>
2385
 
 
2386
 
</div>
2387
 
</div><p>
2388
 
<a class="anchor" name="eecec6962f955bd72ac5595be37db7a4"></a><!-- doxytag: member="Gio::File::get_uri_scheme" ref="eecec6962f955bd72ac5595be37db7a4" args="() const " -->
2389
 
<div class="memitem">
2390
 
<div class="memproto">
2391
 
      <table class="memname">
2392
 
        <tr>
2393
 
          <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::File::get_uri_scheme           </td>
2394
 
          <td>(</td>
2395
 
          <td class="paramname">          </td>
2396
 
          <td>&nbsp;)&nbsp;</td>
2397
 
          <td> const</td>
2398
 
        </tr>
2399
 
      </table>
2400
 
</div>
2401
 
<div class="memdoc">
2402
 
 
2403
 
<p>
2404
 
Gets the URI scheme for a <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a>. 
2405
 
<p>
2406
 
RFC 3986 decodes the scheme as:<p>
2407
 
URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ]<p>
2408
 
Common schemes include "file", "http", "ftp", etc.<p>
2409
 
This call does no blocking i/o. <dl class="return" compact><dt><b>Returns:</b></dt><dd>A string containing the URI scheme for the given <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a>. The returned string should be freed with Glib::free() when no longer needed. </dd></dl>
2410
 
 
2411
 
</div>
2412
 
</div><p>
2413
 
<a class="anchor" name="5437bc648d8b73451e8bee0bc902cfc0"></a><!-- doxytag: member="Gio::File::gobj" ref="5437bc648d8b73451e8bee0bc902cfc0" args="() const " -->
2414
 
<div class="memitem">
2415
 
<div class="memproto">
2416
 
      <table class="memname">
2417
 
        <tr>
2418
 
          <td class="memname">const GFile* Gio::File::gobj           </td>
2419
 
          <td>(</td>
2420
 
          <td class="paramname">          </td>
2421
 
          <td>&nbsp;)&nbsp;</td>
2422
 
          <td> const<code> [inline]</code></td>
2423
 
        </tr>
2424
 
      </table>
2425
 
</div>
2426
 
<div class="memdoc">
2427
 
 
2428
 
<p>
2429
 
Provides access to the underlying C GObject. 
2430
 
<p>
2431
 
 
2432
 
<p>Reimplemented from <a class="el" href="classGlib_1_1Interface.html#70a443071a69d3372c2cdd7128a91ed1">Glib::Interface</a>.</p>
2433
 
 
2434
 
</div>
2435
 
</div><p>
2436
 
<a class="anchor" name="96552cfbaf2e5fa3659a1568db8cca91"></a><!-- doxytag: member="Gio::File::gobj" ref="96552cfbaf2e5fa3659a1568db8cca91" args="()" -->
2437
 
<div class="memitem">
2438
 
<div class="memproto">
2439
 
      <table class="memname">
2440
 
        <tr>
2441
 
          <td class="memname">GFile* Gio::File::gobj           </td>
2442
 
          <td>(</td>
2443
 
          <td class="paramname">          </td>
2444
 
          <td>&nbsp;)&nbsp;</td>
2445
 
          <td><code> [inline]</code></td>
2446
 
        </tr>
2447
 
      </table>
2448
 
</div>
2449
 
<div class="memdoc">
2450
 
 
2451
 
<p>
2452
 
Provides access to the underlying C GObject. 
2453
 
<p>
2454
 
 
2455
 
<p>Reimplemented from <a class="el" href="classGlib_1_1Interface.html#969e9396f75132a9577428f4fa932d42">Glib::Interface</a>.</p>
2456
 
 
2457
 
</div>
2458
 
</div><p>
2459
1028
<a class="anchor" name="4c40ec88dfc4333f19e939d26a1e0332"></a><!-- doxytag: member="Gio::File::has_prefix" ref="4c40ec88dfc4333f19e939d26a1e0332" args="(const Glib::RefPtr&lt; const File &gt; &amp;prefix) const " -->
2460
1029
<div class="memitem">
2461
1030
<div class="memproto">
2485
1054
 
2486
1055
</div>
2487
1056
</div><p>
 
1057
<a class="anchor" name="464248111fa2bc5df89c620354eb99bb"></a><!-- doxytag: member="Gio::File::get_relative_path" ref="464248111fa2bc5df89c620354eb99bb" args="(const Glib::RefPtr&lt; const File &gt; &amp;descendant) const " -->
 
1058
<div class="memitem">
 
1059
<div class="memproto">
 
1060
      <table class="memname">
 
1061
        <tr>
 
1062
          <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::File::get_relative_path           </td>
 
1063
          <td>(</td>
 
1064
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;const <a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
 
1065
          <td class="paramname"> <em>descendant</em>          </td>
 
1066
          <td>&nbsp;)&nbsp;</td>
 
1067
          <td> const</td>
 
1068
        </tr>
 
1069
      </table>
 
1070
</div>
 
1071
<div class="memdoc">
 
1072
 
 
1073
<p>
 
1074
Gets the path for <em>descendant</em> relative to <em>parent</em>. 
 
1075
<p>
 
1076
This call does no blocking i/o. <dl compact><dt><b>Parameters:</b></dt><dd>
 
1077
  <table border="0" cellspacing="2" cellpadding="0">
 
1078
    <tr><td valign="top"></td><td valign="top"><em>descendant</em>&nbsp;</td><td>Input <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a>. </td></tr>
 
1079
  </table>
 
1080
</dl>
 
1081
<dl class="return" compact><dt><b>Returns:</b></dt><dd>String with the relative path from <em>descendant</em> to <em>parent</em>, or <code>0</code> if <em>descendant</em> doesn't have <em>parent</em> as prefix. The returned string should be freed with Glib::free() when no longer needed. </dd></dl>
 
1082
 
 
1083
</div>
 
1084
</div><p>
 
1085
<a class="anchor" name="c5e286d421c7236df39881f8ce0a4e03"></a><!-- doxytag: member="Gio::File::resolve_relative_path" ref="c5e286d421c7236df39881f8ce0a4e03" args="(const std::string &amp;relative_path) const " -->
 
1086
<div class="memitem">
 
1087
<div class="memproto">
 
1088
      <table class="memname">
 
1089
        <tr>
 
1090
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt; Gio::File::resolve_relative_path           </td>
 
1091
          <td>(</td>
 
1092
          <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>
 
1093
          <td class="paramname"> <em>relative_path</em>          </td>
 
1094
          <td>&nbsp;)&nbsp;</td>
 
1095
          <td> const</td>
 
1096
        </tr>
 
1097
      </table>
 
1098
</div>
 
1099
<div class="memdoc">
 
1100
 
 
1101
<p>
 
1102
Resolves a relative path for <em>file</em> to an absolute path. 
 
1103
<p>
 
1104
This call does no blocking i/o. <dl compact><dt><b>Parameters:</b></dt><dd>
 
1105
  <table border="0" cellspacing="2" cellpadding="0">
 
1106
    <tr><td valign="top"></td><td valign="top"><em>relative_path</em>&nbsp;</td><td>A given relative path string. </td></tr>
 
1107
  </table>
 
1108
</dl>
 
1109
<dl class="return" compact><dt><b>Returns:</b></dt><dd><a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> to the resolved path. <code>0</code> if <em>relative_path</em> is <code>0</code> or if <em>file</em> is invalid. Free the returned object with Glib::object_unref(). </dd></dl>
 
1110
 
 
1111
</div>
 
1112
</div><p>
 
1113
<a class="anchor" name="aa3b910bc9f240d4ebd0efc70979f163"></a><!-- doxytag: member="Gio::File::is_native" ref="aa3b910bc9f240d4ebd0efc70979f163" args="() const " -->
 
1114
<div class="memitem">
 
1115
<div class="memproto">
 
1116
      <table class="memname">
 
1117
        <tr>
 
1118
          <td class="memname">bool Gio::File::is_native           </td>
 
1119
          <td>(</td>
 
1120
          <td class="paramname">          </td>
 
1121
          <td>&nbsp;)&nbsp;</td>
 
1122
          <td> const</td>
 
1123
        </tr>
 
1124
      </table>
 
1125
</div>
 
1126
<div class="memdoc">
 
1127
 
 
1128
<p>
 
1129
Checks to see if a file is native to the platform. 
 
1130
<p>
 
1131
A native file s one expressed in the platform-native filename format, e.g. "C:\Windows" or "/usr/bin/". This does not mean the file is local, as it might be on a locally mounted remote filesystem.<p>
 
1132
On some systems non-native files may be available using the native filesystem via a userspace filesystem (FUSE), in these cases this call will return <code>false</code>, but g_file_get_path() will still return a native path.<p>
 
1133
This call does no blocking i/o. <dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if file is native. </dd></dl>
 
1134
 
 
1135
</div>
 
1136
</div><p>
2488
1137
<a class="anchor" name="90d71529e5b51b9ff73914eaf90be0f1"></a><!-- doxytag: member="Gio::File::has_uri_scheme" ref="90d71529e5b51b9ff73914eaf90be0f1" args="(const std::string &amp;uri_scheme) const " -->
2489
1138
<div class="memitem">
2490
1139
<div class="memproto">
2513
1162
 
2514
1163
</div>
2515
1164
</div><p>
2516
 
<a class="anchor" name="0320bac72ecc9ced1f894f1af696856f"></a><!-- doxytag: member="Gio::File::hash" ref="0320bac72ecc9ced1f894f1af696856f" args="() const " -->
2517
 
<div class="memitem">
2518
 
<div class="memproto">
2519
 
      <table class="memname">
2520
 
        <tr>
2521
 
          <td class="memname">guint Gio::File::hash           </td>
2522
 
          <td>(</td>
2523
 
          <td class="paramname">          </td>
2524
 
          <td>&nbsp;)&nbsp;</td>
2525
 
          <td> const</td>
2526
 
        </tr>
2527
 
      </table>
2528
 
</div>
2529
 
<div class="memdoc">
2530
 
 
2531
 
<p>
2532
 
Creates a hash value for a <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a>. 
2533
 
<p>
2534
 
This call does no blocking i/o. <dl compact><dt><b>Parameters:</b></dt><dd>
2535
 
  <table border="0" cellspacing="2" cellpadding="0">
2536
 
    <tr><td valign="top"></td><td valign="top"><em>file</em>&nbsp;</td><td>gconstpointer to a <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a>. </td></tr>
2537
 
  </table>
2538
 
</dl>
2539
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 if <em>file</em> is not a valid <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a>, otherwise an integer that can be used as hash value for the <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a>. This function is intended for easily hashing a <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> to add to a HashTable or similar data structure. </dd></dl>
2540
 
 
2541
 
</div>
2542
 
</div><p>
2543
 
<a class="anchor" name="aa3b910bc9f240d4ebd0efc70979f163"></a><!-- doxytag: member="Gio::File::is_native" ref="aa3b910bc9f240d4ebd0efc70979f163" args="() const " -->
2544
 
<div class="memitem">
2545
 
<div class="memproto">
2546
 
      <table class="memname">
2547
 
        <tr>
2548
 
          <td class="memname">bool Gio::File::is_native           </td>
2549
 
          <td>(</td>
2550
 
          <td class="paramname">          </td>
2551
 
          <td>&nbsp;)&nbsp;</td>
2552
 
          <td> const</td>
2553
 
        </tr>
2554
 
      </table>
2555
 
</div>
2556
 
<div class="memdoc">
2557
 
 
2558
 
<p>
2559
 
Checks to see if a file is native to the platform. 
2560
 
<p>
2561
 
A native file s one expressed in the platform-native filename format, e.g. "C:\Windows" or "/usr/bin/". This does not mean the file is local, as it might be on a locally mounted remote filesystem.<p>
2562
 
On some systems non-native files may be available using the native filesystem via a userspace filesystem (FUSE), in these cases this call will return <code>false</code>, but g_file_get_path() will still return a native path.<p>
2563
 
This call does no blocking i/o. <dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if file is native. </dd></dl>
2564
 
 
2565
 
</div>
2566
 
</div><p>
2567
 
<a class="anchor" name="77f7781b0ba65bc4e7e613b80b353fd7"></a><!-- doxytag: member="Gio::File::load_contents" ref="77f7781b0ba65bc4e7e613b80b353fd7" args="(char *&amp;contents, gsize &amp;length, std::string &amp;etag_out)" -->
2568
 
<div class="memitem">
2569
 
<div class="memproto">
2570
 
      <table class="memname">
2571
 
        <tr>
2572
 
          <td class="memname">bool Gio::File::load_contents           </td>
2573
 
          <td>(</td>
2574
 
          <td class="paramtype">char *&amp;&nbsp;</td>
2575
 
          <td class="paramname"> <em>contents</em>, </td>
2576
 
        </tr>
2577
 
        <tr>
2578
 
          <td class="paramkey"></td>
2579
 
          <td></td>
2580
 
          <td class="paramtype">gsize &amp;&nbsp;</td>
2581
 
          <td class="paramname"> <em>length</em>, </td>
2582
 
        </tr>
2583
 
        <tr>
2584
 
          <td class="paramkey"></td>
2585
 
          <td></td>
2586
 
          <td class="paramtype"><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>
2587
 
          <td class="paramname"> <em>etag_out</em></td><td>&nbsp;</td>
2588
 
        </tr>
2589
 
        <tr>
2590
 
          <td></td>
2591
 
          <td>)</td>
2592
 
          <td></td><td></td><td></td>
2593
 
        </tr>
2594
 
      </table>
2595
 
</div>
2596
 
<div class="memdoc">
2597
 
 
2598
 
<p>
2599
 
Loads the content of the file into memory, returning the size of the data. 
2600
 
<p>
2601
 
The data is always zero terminated, but this is not included in the resultant <em>length</em>.<p>
2602
 
<dl compact><dt><b>Parameters:</b></dt><dd>
2603
 
  <table border="0" cellspacing="2" cellpadding="0">
2604
 
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>A location to place the contents of the file. </td></tr>
2605
 
    <tr><td valign="top"></td><td valign="top"><em>length</em>&nbsp;</td><td>A location to place the length of the contents of the file. </td></tr>
2606
 
    <tr><td valign="top"></td><td valign="top"><em>etag_out</em>&nbsp;</td><td>A location to place the current entity tag for the file. </td></tr>
2607
 
  </table>
2608
 
</dl>
2609
 
 
2610
 
</div>
2611
 
</div><p>
2612
 
<a class="anchor" name="c53be228d732b34e062a2a57814cdf15"></a><!-- doxytag: member="Gio::File::load_contents" ref="c53be228d732b34e062a2a57814cdf15" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, char *&amp;contents, gsize &amp;length, std::string &amp;etag_out)" -->
2613
 
<div class="memitem">
2614
 
<div class="memproto">
2615
 
      <table class="memname">
2616
 
        <tr>
2617
 
          <td class="memname">bool Gio::File::load_contents           </td>
2618
 
          <td>(</td>
2619
 
          <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>
2620
 
          <td class="paramname"> <em>cancellable</em>, </td>
2621
 
        </tr>
2622
 
        <tr>
2623
 
          <td class="paramkey"></td>
2624
 
          <td></td>
2625
 
          <td class="paramtype">char *&amp;&nbsp;</td>
2626
 
          <td class="paramname"> <em>contents</em>, </td>
2627
 
        </tr>
2628
 
        <tr>
2629
 
          <td class="paramkey"></td>
2630
 
          <td></td>
2631
 
          <td class="paramtype">gsize &amp;&nbsp;</td>
2632
 
          <td class="paramname"> <em>length</em>, </td>
2633
 
        </tr>
2634
 
        <tr>
2635
 
          <td class="paramkey"></td>
2636
 
          <td></td>
2637
 
          <td class="paramtype"><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>
2638
 
          <td class="paramname"> <em>etag_out</em></td><td>&nbsp;</td>
2639
 
        </tr>
2640
 
        <tr>
2641
 
          <td></td>
2642
 
          <td>)</td>
2643
 
          <td></td><td></td><td></td>
2644
 
        </tr>
2645
 
      </table>
2646
 
</div>
2647
 
<div class="memdoc">
2648
 
 
2649
 
<p>
2650
 
Loads the content of the file into memory, returning the size of the data. 
2651
 
<p>
2652
 
The data is always zero terminated, but this is not included in the resultant <em>length</em>.<p>
2653
 
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> exception with CANCELLED will be returned.<p>
2654
 
<dl compact><dt><b>Parameters:</b></dt><dd>
2655
 
  <table border="0" cellspacing="2" cellpadding="0">
2656
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td>A cancellable object. </td></tr>
2657
 
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>A location to place the contents of the file. </td></tr>
2658
 
    <tr><td valign="top"></td><td valign="top"><em>length</em>&nbsp;</td><td>A location to place the length of the contents of the file. </td></tr>
2659
 
    <tr><td valign="top"></td><td valign="top"><em>etag_out</em>&nbsp;</td><td>A location to place the current entity tag for the file. </td></tr>
2660
 
  </table>
2661
 
</dl>
2662
 
 
2663
 
</div>
2664
 
</div><p>
2665
 
<a class="anchor" name="6af7ec98d5543bce07b917b65d7276ce"></a><!-- doxytag: member="Gio::File::load_contents_async" ref="6af7ec98d5543bce07b917b65d7276ce" args="(const SlotAsyncReady &amp;slot)" -->
2666
 
<div class="memitem">
2667
 
<div class="memproto">
2668
 
      <table class="memname">
2669
 
        <tr>
2670
 
          <td class="memname">void Gio::File::load_contents_async           </td>
2671
 
          <td>(</td>
2672
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
2673
 
          <td class="paramname"> <em>slot</em>          </td>
2674
 
          <td>&nbsp;)&nbsp;</td>
2675
 
          <td></td>
2676
 
        </tr>
2677
 
      </table>
2678
 
</div>
2679
 
<div class="memdoc">
2680
 
 
2681
 
<p>
2682
 
Starts an asynchronous load of the file's contents. 
2683
 
<p>
2684
 
For more details, see <a class="el" href="classGio_1_1File.html#c53be228d732b34e062a2a57814cdf15" title="Loads the content of the file into memory, returning the size of the data.">load_contents()</a> which is the synchronous version of this call.<p>
2685
 
When the load operation has completed, the <em>slot</em> will be called. To finish the operation, call <a class="el" href="classGio_1_1File.html#5fd15277ab90bcc57db088be04cac457" title="Finishes an asynchronous load of the file&#39;s contents.">load_contents_finish()</a> with the <a class="el" href="classGio_1_1AsyncResult.html" title="Provides a base class for implementing asynchronous function results.">AsyncResult</a> provided to the <em>slot</em>.<p>
2686
 
<dl compact><dt><b>Parameters:</b></dt><dd>
2687
 
  <table border="0" cellspacing="2" cellpadding="0">
2688
 
    <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>
2689
 
  </table>
2690
 
</dl>
2691
 
 
2692
 
</div>
2693
 
</div><p>
2694
 
<a class="anchor" name="d0e02ebffbaa13036e4636d2118f71a0"></a><!-- doxytag: member="Gio::File::load_contents_async" ref="d0e02ebffbaa13036e4636d2118f71a0" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
2695
 
<div class="memitem">
2696
 
<div class="memproto">
2697
 
      <table class="memname">
2698
 
        <tr>
2699
 
          <td class="memname">void Gio::File::load_contents_async           </td>
2700
 
          <td>(</td>
2701
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
2702
 
          <td class="paramname"> <em>slot</em>, </td>
2703
 
        </tr>
2704
 
        <tr>
2705
 
          <td class="paramkey"></td>
2706
 
          <td></td>
2707
 
          <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>
2708
 
          <td class="paramname"> <em>cancellable</em></td><td>&nbsp;</td>
2709
 
        </tr>
2710
 
        <tr>
2711
 
          <td></td>
2712
 
          <td>)</td>
2713
 
          <td></td><td></td><td></td>
2714
 
        </tr>
2715
 
      </table>
2716
 
</div>
2717
 
<div class="memdoc">
2718
 
 
2719
 
<p>
2720
 
Starts an asynchronous load of the file's contents. 
2721
 
<p>
2722
 
For more details, see <a class="el" href="classGio_1_1File.html#c53be228d732b34e062a2a57814cdf15" title="Loads the content of the file into memory, returning the size of the data.">load_contents()</a> which is the synchronous version of this call.<p>
2723
 
When the load operation has completed, the <em>slot</em> will be called. To finish the operation, call <a class="el" href="classGio_1_1File.html#5fd15277ab90bcc57db088be04cac457" title="Finishes an asynchronous load of the file&#39;s contents.">load_contents_finish()</a> with the <a class="el" href="classGio_1_1AsyncResult.html" title="Provides a base class for implementing asynchronous function results.">AsyncResult</a> provided to the <em>slot</em>.<p>
2724
 
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>
2725
 
<dl compact><dt><b>Parameters:</b></dt><dd>
2726
 
  <table border="0" cellspacing="2" cellpadding="0">
2727
 
    <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>
2728
 
    <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>
2729
 
  </table>
2730
 
</dl>
2731
 
 
2732
 
</div>
2733
 
</div><p>
2734
 
<a class="anchor" name="5fd15277ab90bcc57db088be04cac457"></a><!-- doxytag: member="Gio::File::load_contents_finish" ref="5fd15277ab90bcc57db088be04cac457" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result, char *&amp;contents, gsize &amp;length, std::string &amp;etag_out)" -->
2735
 
<div class="memitem">
2736
 
<div class="memproto">
2737
 
      <table class="memname">
2738
 
        <tr>
2739
 
          <td class="memname">bool Gio::File::load_contents_finish           </td>
2740
 
          <td>(</td>
2741
 
          <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>
2742
 
          <td class="paramname"> <em>result</em>, </td>
2743
 
        </tr>
2744
 
        <tr>
2745
 
          <td class="paramkey"></td>
2746
 
          <td></td>
2747
 
          <td class="paramtype">char *&amp;&nbsp;</td>
2748
 
          <td class="paramname"> <em>contents</em>, </td>
2749
 
        </tr>
2750
 
        <tr>
2751
 
          <td class="paramkey"></td>
2752
 
          <td></td>
2753
 
          <td class="paramtype">gsize &amp;&nbsp;</td>
2754
 
          <td class="paramname"> <em>length</em>, </td>
2755
 
        </tr>
2756
 
        <tr>
2757
 
          <td class="paramkey"></td>
2758
 
          <td></td>
2759
 
          <td class="paramtype"><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>
2760
 
          <td class="paramname"> <em>etag_out</em></td><td>&nbsp;</td>
2761
 
        </tr>
2762
 
        <tr>
2763
 
          <td></td>
2764
 
          <td>)</td>
2765
 
          <td></td><td></td><td></td>
2766
 
        </tr>
2767
 
      </table>
2768
 
</div>
2769
 
<div class="memdoc">
2770
 
 
2771
 
<p>
2772
 
Finishes an asynchronous load of the <em>file's</em> contents. 
2773
 
<p>
2774
 
The contents are placed in <em>contents</em>, and <em>length</em> is set to the size of the <em>contents</em> string. If <em>etag_out</em> is present, it will be set to the new entity tag for the <em>file</em>. <dl compact><dt><b>Parameters:</b></dt><dd>
2775
 
  <table border="0" cellspacing="2" cellpadding="0">
2776
 
    <tr><td valign="top"></td><td valign="top"><em>res</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>
2777
 
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>A location to place the contents of the file. </td></tr>
2778
 
    <tr><td valign="top"></td><td valign="top"><em>length</em>&nbsp;</td><td>A location to place the length of the contents of the file. </td></tr>
2779
 
    <tr><td valign="top"></td><td valign="top"><em>etag_out</em>&nbsp;</td><td>A location to place the current entity tag for the file. </td></tr>
2780
 
  </table>
2781
 
</dl>
2782
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the load was successful. If <code>false</code> and <em>error</em> is present, it will be set appropriately. </dd></dl>
2783
 
 
2784
 
</div>
2785
 
</div><p>
2786
 
<a class="anchor" name="362d71932c0ba8797a8c47b77df1b6d7"></a><!-- doxytag: member="Gio::File::load_partial_contents_async" ref="362d71932c0ba8797a8c47b77df1b6d7" args="(const SlotReadMore &amp;slot_read_more, const SlotAsyncReady &amp;slot_async_ready)" -->
2787
 
<div class="memitem">
2788
 
<div class="memproto">
2789
 
      <table class="memname">
2790
 
        <tr>
2791
 
          <td class="memname">void Gio::File::load_partial_contents_async           </td>
2792
 
          <td>(</td>
2793
 
          <td class="paramtype">const <a class="el" href="classGio_1_1File.html#dd182d22071784fc345adc757b3d687b">SlotReadMore</a>&amp;&nbsp;</td>
2794
 
          <td class="paramname"> <em>slot_read_more</em>, </td>
2795
 
        </tr>
2796
 
        <tr>
2797
 
          <td class="paramkey"></td>
2798
 
          <td></td>
2799
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
2800
 
          <td class="paramname"> <em>slot_async_ready</em></td><td>&nbsp;</td>
2801
 
        </tr>
2802
 
        <tr>
2803
 
          <td></td>
2804
 
          <td>)</td>
2805
 
          <td></td><td></td><td></td>
2806
 
        </tr>
2807
 
      </table>
2808
 
</div>
2809
 
<div class="memdoc">
2810
 
 
2811
 
<p>
2812
 
Reads the partial contents of a file. 
2813
 
<p>
2814
 
The <em>slot_read_more</em> callback slot should be used to stop reading from the file when appropriate. This operation can be finished by <a class="el" href="classGio_1_1File.html#4b323508401d2e6fd2b3ad659f9bb5eb" title="Finishes an asynchronous partial load operation that was started with load_partial_contents_async()...">load_partial_contents_finish()</a>.<p>
2815
 
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>
2816
 
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#4b323508401d2e6fd2b3ad659f9bb5eb" title="Finishes an asynchronous partial load operation that was started with load_partial_contents_async()...">load_partial_contents_finish()</a> to get the result of the operation.<p>
2817
 
<dl compact><dt><b>Parameters:</b></dt><dd>
2818
 
  <table border="0" cellspacing="2" cellpadding="0">
2819
 
    <tr><td valign="top"></td><td valign="top"><em>slot_read_more</em>&nbsp;</td><td>A callback to receive partial data and to specify whether further data should be read. </td></tr>
2820
 
    <tr><td valign="top"></td><td valign="top"><em>slot_async_ready</em>&nbsp;</td><td>A callback slot which will be called when the request is satisfied. </td></tr>
2821
 
  </table>
2822
 
</dl>
2823
 
 
2824
 
</div>
2825
 
</div><p>
2826
 
<a class="anchor" name="0e8d95fcdf7c2aa38f54e90a22d3ab6f"></a><!-- doxytag: member="Gio::File::load_partial_contents_async" ref="0e8d95fcdf7c2aa38f54e90a22d3ab6f" args="(const SlotReadMore &amp;slot_read_more, const SlotAsyncReady &amp;slot_async_ready, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
2827
 
<div class="memitem">
2828
 
<div class="memproto">
2829
 
      <table class="memname">
2830
 
        <tr>
2831
 
          <td class="memname">void Gio::File::load_partial_contents_async           </td>
2832
 
          <td>(</td>
2833
 
          <td class="paramtype">const <a class="el" href="classGio_1_1File.html#dd182d22071784fc345adc757b3d687b">SlotReadMore</a>&amp;&nbsp;</td>
2834
 
          <td class="paramname"> <em>slot_read_more</em>, </td>
2835
 
        </tr>
2836
 
        <tr>
2837
 
          <td class="paramkey"></td>
2838
 
          <td></td>
2839
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
2840
 
          <td class="paramname"> <em>slot_async_ready</em>, </td>
2841
 
        </tr>
2842
 
        <tr>
2843
 
          <td class="paramkey"></td>
2844
 
          <td></td>
2845
 
          <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>
2846
 
          <td class="paramname"> <em>cancellable</em></td><td>&nbsp;</td>
2847
 
        </tr>
2848
 
        <tr>
2849
 
          <td></td>
2850
 
          <td>)</td>
2851
 
          <td></td><td></td><td></td>
2852
 
        </tr>
2853
 
      </table>
2854
 
</div>
2855
 
<div class="memdoc">
2856
 
 
2857
 
<p>
2858
 
Reads the partial contents of a file. 
2859
 
<p>
2860
 
The <em>slot_read_more</em> callback slot should be used to stop reading from the file when appropriate. This operation can be finished by <a class="el" href="classGio_1_1File.html#4b323508401d2e6fd2b3ad659f9bb5eb" title="Finishes an asynchronous partial load operation that was started with load_partial_contents_async()...">load_partial_contents_finish()</a>.<p>
2861
 
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>
2862
 
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#4b323508401d2e6fd2b3ad659f9bb5eb" title="Finishes an asynchronous partial load operation that was started with load_partial_contents_async()...">load_partial_contents_finish()</a> to get the result of the operation.<p>
2863
 
<dl compact><dt><b>Parameters:</b></dt><dd>
2864
 
  <table border="0" cellspacing="2" cellpadding="0">
2865
 
    <tr><td valign="top"></td><td valign="top"><em>slot_read_more</em>&nbsp;</td><td>A callback to receive partial data and to specify whether further data should be read. </td></tr>
2866
 
    <tr><td valign="top"></td><td valign="top"><em>slot_async_ready</em>&nbsp;</td><td>A callback slot which will be called when the request is satisfied. </td></tr>
2867
 
    <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>
2868
 
  </table>
2869
 
</dl>
2870
 
 
2871
 
</div>
2872
 
</div><p>
2873
 
<a class="anchor" name="4b323508401d2e6fd2b3ad659f9bb5eb"></a><!-- doxytag: member="Gio::File::load_partial_contents_finish" ref="4b323508401d2e6fd2b3ad659f9bb5eb" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result, char *&amp;contents, gsize &amp;length, std::string &amp;etag_out)" -->
2874
 
<div class="memitem">
2875
 
<div class="memproto">
2876
 
      <table class="memname">
2877
 
        <tr>
2878
 
          <td class="memname">bool Gio::File::load_partial_contents_finish           </td>
2879
 
          <td>(</td>
2880
 
          <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>
2881
 
          <td class="paramname"> <em>result</em>, </td>
2882
 
        </tr>
2883
 
        <tr>
2884
 
          <td class="paramkey"></td>
2885
 
          <td></td>
2886
 
          <td class="paramtype">char *&amp;&nbsp;</td>
2887
 
          <td class="paramname"> <em>contents</em>, </td>
2888
 
        </tr>
2889
 
        <tr>
2890
 
          <td class="paramkey"></td>
2891
 
          <td></td>
2892
 
          <td class="paramtype">gsize &amp;&nbsp;</td>
2893
 
          <td class="paramname"> <em>length</em>, </td>
2894
 
        </tr>
2895
 
        <tr>
2896
 
          <td class="paramkey"></td>
2897
 
          <td></td>
2898
 
          <td class="paramtype"><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>
2899
 
          <td class="paramname"> <em>etag_out</em></td><td>&nbsp;</td>
2900
 
        </tr>
2901
 
        <tr>
2902
 
          <td></td>
2903
 
          <td>)</td>
2904
 
          <td></td><td></td><td></td>
2905
 
        </tr>
2906
 
      </table>
2907
 
</div>
2908
 
<div class="memdoc">
2909
 
 
2910
 
<p>
2911
 
Finishes an asynchronous partial load operation that was started with <a class="el" href="classGio_1_1File.html#0e8d95fcdf7c2aa38f54e90a22d3ab6f" title="Reads the partial contents of a file.">load_partial_contents_async()</a>. 
2912
 
<p>
2913
 
<dl compact><dt><b>Parameters:</b></dt><dd>
2914
 
  <table border="0" cellspacing="2" cellpadding="0">
2915
 
    <tr><td valign="top"></td><td valign="top"><em>res</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>
2916
 
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>A location to place the contents of the file. </td></tr>
2917
 
    <tr><td valign="top"></td><td valign="top"><em>length</em>&nbsp;</td><td>A location to place the length of the contents of the file. </td></tr>
2918
 
    <tr><td valign="top"></td><td valign="top"><em>etag_out</em>&nbsp;</td><td>A location to place the current entity tag for the file. </td></tr>
2919
 
  </table>
2920
 
</dl>
2921
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the load was successful. If <code>false</code> and <em>error</em> is present, it will be set appropriately. </dd></dl>
2922
 
 
2923
 
</div>
2924
 
</div><p>
2925
 
<a class="anchor" name="a1e9aa5f58a76a8562fd00a13434f554"></a><!-- doxytag: member="Gio::File::make_directory" ref="a1e9aa5f58a76a8562fd00a13434f554" args="()" -->
2926
 
<div class="memitem">
2927
 
<div class="memproto">
2928
 
      <table class="memname">
2929
 
        <tr>
2930
 
          <td class="memname">bool Gio::File::make_directory           </td>
2931
 
          <td>(</td>
2932
 
          <td class="paramname">          </td>
2933
 
          <td>&nbsp;)&nbsp;</td>
2934
 
          <td></td>
2935
 
        </tr>
2936
 
      </table>
2937
 
</div>
2938
 
<div class="memdoc">
2939
 
 
2940
 
<p>
2941
 
Creates a directory. 
2942
 
<p>
2943
 
Note that this will only create a child directory of the immediate parent directory of the path or URI given by the <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a>. To recursively create directories, see <a class="el" href="classGio_1_1File.html#874a487551d49ca62b31a3e5cf32fee6" title="Creates a directory and any parent directories that may not exist, similar to &#39;mkdir...">make_directory_with_parents()</a>. This function will fail if the parent directory does not exist, throwing an exception with IO_ERROR_NOT_FOUND. If the file system doesn't support creating directories, this function will fail, throwing an exception with IO_ERROR_NOT_SUPPORTED.<p>
2944
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> on successful creation, <code>false</code> otherwise. </dd></dl>
2945
 
 
2946
 
</div>
2947
 
</div><p>
2948
 
<a class="anchor" name="bfa05e23e95e77cabac289ab4e294a58"></a><!-- doxytag: member="Gio::File::make_directory" ref="bfa05e23e95e77cabac289ab4e294a58" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
2949
 
<div class="memitem">
2950
 
<div class="memproto">
2951
 
      <table class="memname">
2952
 
        <tr>
2953
 
          <td class="memname">bool Gio::File::make_directory           </td>
2954
 
          <td>(</td>
2955
 
          <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>
2956
 
          <td class="paramname"> <em>cancellable</em>          </td>
2957
 
          <td>&nbsp;)&nbsp;</td>
2958
 
          <td></td>
2959
 
        </tr>
2960
 
      </table>
2961
 
</div>
2962
 
<div class="memdoc">
2963
 
 
2964
 
<p>
2965
 
Creates a directory. 
2966
 
<p>
2967
 
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
2968
 
  <table border="0" cellspacing="2" cellpadding="0">
2969
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
2970
 
  </table>
2971
 
</dl>
2972
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> on successful creation, <code>false</code> otherwise. </dd></dl>
2973
 
 
2974
 
</div>
2975
 
</div><p>
2976
 
<a class="anchor" name="874a487551d49ca62b31a3e5cf32fee6"></a><!-- doxytag: member="Gio::File::make_directory_with_parents" ref="874a487551d49ca62b31a3e5cf32fee6" args="()" -->
2977
 
<div class="memitem">
2978
 
<div class="memproto">
2979
 
      <table class="memname">
2980
 
        <tr>
2981
 
          <td class="memname">bool Gio::File::make_directory_with_parents           </td>
2982
 
          <td>(</td>
2983
 
          <td class="paramname">          </td>
2984
 
          <td>&nbsp;)&nbsp;</td>
2985
 
          <td></td>
2986
 
        </tr>
2987
 
      </table>
2988
 
</div>
2989
 
<div class="memdoc">
2990
 
 
2991
 
<p>
2992
 
Creates a directory and any parent directories that may not exist, similar to 'mkdir -p'. 
2993
 
<p>
2994
 
If the file system does not support creating directories, this function will fail, throwing an exception with IO_ERROR_NOT_SUPPORTED.<p>
2995
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> on successful creation, <code>false</code> otherwise.</dd></dl>
2996
 
<dl compact><dt><b><a class="el" href="newin2p18s.html#_newin2p18s000018">Since glibmm 2.18:</a></b></dt><dd></dd></dl>
2997
 
 
2998
 
</div>
2999
 
</div><p>
3000
 
<a class="anchor" name="fb0b5b094339057b4b15952eb73e08d6"></a><!-- doxytag: member="Gio::File::make_directory_with_parents" ref="fb0b5b094339057b4b15952eb73e08d6" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
3001
 
<div class="memitem">
3002
 
<div class="memproto">
3003
 
      <table class="memname">
3004
 
        <tr>
3005
 
          <td class="memname">bool Gio::File::make_directory_with_parents           </td>
3006
 
          <td>(</td>
3007
 
          <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>
3008
 
          <td class="paramname"> <em>cancellable</em>          </td>
3009
 
          <td>&nbsp;)&nbsp;</td>
3010
 
          <td></td>
3011
 
        </tr>
3012
 
      </table>
3013
 
</div>
3014
 
<div class="memdoc">
3015
 
 
3016
 
<p>
3017
 
Creates a directory and any parent directories that may not exist similar to 'mkdir -p'. 
3018
 
<p>
3019
 
If the file system does not support creating directories, this function will fail, setting <em>error</em> to IO_ERROR_NOT_SUPPORTED.<p>
3020
 
For a local <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> the newly created directories will have the default (current) ownership and permissions of the current process.<p>
3021
 
If <em>cancellable</em> is not <code>0</code>, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error IO_ERROR_CANCELLED will be returned. <dl compact><dt><b>Parameters:</b></dt><dd>
3022
 
  <table border="0" cellspacing="2" cellpadding="0">
3023
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td>Optional <a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object, <code>0</code> to ignore. </td></tr>
3024
 
  </table>
3025
 
</dl>
3026
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if all directories have been successfully created, <code>false</code> otherwise.</dd></dl>
3027
 
<dl compact><dt><b><a class="el" href="newin2p18s.html#_newin2p18s000017">Since glibmm 2.18:</a></b></dt><dd></dd></dl>
3028
 
 
3029
 
</div>
3030
 
</div><p>
3031
 
<a class="anchor" name="8a9a3d060c2675ff9ac1c758f0b2c024"></a><!-- doxytag: member="Gio::File::make_symbolic_link" ref="8a9a3d060c2675ff9ac1c758f0b2c024" args="(const std::string &amp;symlink_value)" -->
3032
 
<div class="memitem">
3033
 
<div class="memproto">
3034
 
      <table class="memname">
3035
 
        <tr>
3036
 
          <td class="memname">bool Gio::File::make_symbolic_link           </td>
3037
 
          <td>(</td>
3038
 
          <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>
3039
 
          <td class="paramname"> <em>symlink_value</em>          </td>
3040
 
          <td>&nbsp;)&nbsp;</td>
3041
 
          <td></td>
3042
 
        </tr>
3043
 
      </table>
3044
 
</div>
3045
 
<div class="memdoc">
3046
 
 
3047
 
<p>
3048
 
Creates a symbolic link. 
3049
 
<p>
3050
 
<dl compact><dt><b>Parameters:</b></dt><dd>
3051
 
  <table border="0" cellspacing="2" cellpadding="0">
3052
 
    <tr><td valign="top"></td><td valign="top"><em>symlink_value</em>&nbsp;</td><td>A string with the value of the new symlink. </td></tr>
3053
 
  </table>
3054
 
</dl>
3055
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> on the creation of a new symlink, <code>false</code> otherwise. </dd></dl>
3056
 
 
3057
 
</div>
3058
 
</div><p>
3059
 
<a class="anchor" name="2709318e1f24dfd0cd498d28f5e1b8fe"></a><!-- doxytag: member="Gio::File::make_symbolic_link" ref="2709318e1f24dfd0cd498d28f5e1b8fe" args="(const std::string &amp;symlink_value, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
3060
 
<div class="memitem">
3061
 
<div class="memproto">
3062
 
      <table class="memname">
3063
 
        <tr>
3064
 
          <td class="memname">bool Gio::File::make_symbolic_link           </td>
3065
 
          <td>(</td>
3066
 
          <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>
3067
 
          <td class="paramname"> <em>symlink_value</em>, </td>
3068
 
        </tr>
3069
 
        <tr>
3070
 
          <td class="paramkey"></td>
3071
 
          <td></td>
3072
 
          <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>
3073
 
          <td class="paramname"> <em>cancellable</em></td><td>&nbsp;</td>
3074
 
        </tr>
3075
 
        <tr>
3076
 
          <td></td>
3077
 
          <td>)</td>
3078
 
          <td></td><td></td><td></td>
3079
 
        </tr>
3080
 
      </table>
3081
 
</div>
3082
 
<div class="memdoc">
3083
 
 
3084
 
<p>
3085
 
Creates a symbolic link. 
3086
 
<p>
3087
 
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
3088
 
  <table border="0" cellspacing="2" cellpadding="0">
3089
 
    <tr><td valign="top"></td><td valign="top"><em>symlink_value</em>&nbsp;</td><td>A string with the value of the new symlink. </td></tr>
3090
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
3091
 
  </table>
3092
 
</dl>
3093
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> on the creation of a new symlink, <code>false</code> otherwise. </dd></dl>
3094
 
 
3095
 
</div>
3096
 
</div><p>
3097
 
<a class="anchor" name="50896969a9de87f810f0bf5e2d3335bd"></a><!-- doxytag: member="Gio::File::monitor" ref="50896969a9de87f810f0bf5e2d3335bd" args="(FileMonitorFlags flags=FILE_MONITOR_NONE)" -->
3098
 
<div class="memitem">
3099
 
<div class="memproto">
3100
 
      <table class="memname">
3101
 
        <tr>
3102
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileMonitor.html">FileMonitor</a>&gt; Gio::File::monitor           </td>
3103
 
          <td>(</td>
3104
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g469f795e9a4dddb2421c0e5568be6649">FileMonitorFlags</a>&nbsp;</td>
3105
 
          <td class="paramname"> <em>flags</em> = <code>FILE_MONITOR_NONE</code>          </td>
3106
 
          <td>&nbsp;)&nbsp;</td>
3107
 
          <td></td>
3108
 
        </tr>
3109
 
      </table>
3110
 
</div>
3111
 
<div class="memdoc">
3112
 
 
3113
 
<p>
3114
 
Obtains a file monitor for the given file. 
3115
 
<p>
3116
 
If no file notification mechanism exists, then regular polling of the file is used.<p>
3117
 
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>
3118
 
<dl compact><dt><b>Parameters:</b></dt><dd>
3119
 
  <table border="0" cellspacing="2" cellpadding="0">
3120
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileMonitorFlags. </td></tr>
3121
 
    <tr><td valign="top"></td><td valign="top"><em>A</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
3122
 
  </table>
3123
 
</dl>
3124
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileMonitor.html" title="Monitors a file or directory for changes.">FileMonitor</a> for the file.</dd></dl>
3125
 
<dl compact><dt><b><a class="el" href="newin2p18s.html#_newin2p18s000020">Since glibmm 2.18:</a></b></dt><dd></dd></dl>
3126
 
 
3127
 
</div>
3128
 
</div><p>
3129
 
<a class="anchor" name="88aacee7bb6f6d968b4383311a9dd002"></a><!-- doxytag: member="Gio::File::monitor" ref="88aacee7bb6f6d968b4383311a9dd002" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileMonitorFlags flags=FILE_MONITOR_NONE)" -->
3130
 
<div class="memitem">
3131
 
<div class="memproto">
3132
 
      <table class="memname">
3133
 
        <tr>
3134
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileMonitor.html">FileMonitor</a>&gt; Gio::File::monitor           </td>
3135
 
          <td>(</td>
3136
 
          <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>
3137
 
          <td class="paramname"> <em>cancellable</em>, </td>
3138
 
        </tr>
3139
 
        <tr>
3140
 
          <td class="paramkey"></td>
3141
 
          <td></td>
3142
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g469f795e9a4dddb2421c0e5568be6649">FileMonitorFlags</a>&nbsp;</td>
3143
 
          <td class="paramname"> <em>flags</em> = <code>FILE_MONITOR_NONE</code></td><td>&nbsp;</td>
3144
 
        </tr>
3145
 
        <tr>
3146
 
          <td></td>
3147
 
          <td>)</td>
3148
 
          <td></td><td></td><td></td>
3149
 
        </tr>
3150
 
      </table>
3151
 
</div>
3152
 
<div class="memdoc">
3153
 
 
3154
 
<p>
3155
 
Obtains a file monitor for the given file. 
3156
 
<p>
3157
 
If no file notification mechanism exists, then regular polling of the file is used.<p>
3158
 
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>
3159
 
<dl compact><dt><b>Parameters:</b></dt><dd>
3160
 
  <table border="0" cellspacing="2" cellpadding="0">
3161
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileMonitorFlags. </td></tr>
3162
 
    <tr><td valign="top"></td><td valign="top"><em>A</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
3163
 
  </table>
3164
 
</dl>
3165
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileMonitor.html" title="Monitors a file or directory for changes.">FileMonitor</a> for the file.</dd></dl>
3166
 
<dl compact><dt><b><a class="el" href="newin2p18s.html#_newin2p18s000019">Since glibmm 2.18:</a></b></dt><dd></dd></dl>
3167
 
 
3168
 
</div>
3169
 
</div><p>
3170
 
<a class="anchor" name="12d36689c1024ff9fc8819f619910a92"></a><!-- doxytag: member="Gio::File::monitor_directory" ref="12d36689c1024ff9fc8819f619910a92" args="(FileMonitorFlags flags=FILE_MONITOR_NONE)" -->
3171
 
<div class="memitem">
3172
 
<div class="memproto">
3173
 
      <table class="memname">
3174
 
        <tr>
3175
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileMonitor.html">FileMonitor</a>&gt; Gio::File::monitor_directory           </td>
3176
 
          <td>(</td>
3177
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g469f795e9a4dddb2421c0e5568be6649">FileMonitorFlags</a>&nbsp;</td>
3178
 
          <td class="paramname"> <em>flags</em> = <code>FILE_MONITOR_NONE</code>          </td>
3179
 
          <td>&nbsp;)&nbsp;</td>
3180
 
          <td></td>
3181
 
        </tr>
3182
 
      </table>
3183
 
</div>
3184
 
<div class="memdoc">
3185
 
 
3186
 
<p>
3187
 
Obtains a directory monitor for the given file. 
3188
 
<p>
3189
 
This may fail if directory monitoring is not supported.<p>
3190
 
<dl compact><dt><b>Parameters:</b></dt><dd>
3191
 
  <table border="0" cellspacing="2" cellpadding="0">
3192
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileMonitorFlags. </td></tr>
3193
 
  </table>
3194
 
</dl>
3195
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileMonitor.html" title="Monitors a file or directory for changes.">FileMonitor</a> for the file. </dd></dl>
3196
 
 
3197
 
</div>
3198
 
</div><p>
3199
 
<a class="anchor" name="a0fa22ffba0ff50779e49ff9d12344e6"></a><!-- doxytag: member="Gio::File::monitor_directory" ref="a0fa22ffba0ff50779e49ff9d12344e6" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileMonitorFlags flags=FILE_MONITOR_NONE)" -->
3200
 
<div class="memitem">
3201
 
<div class="memproto">
3202
 
      <table class="memname">
3203
 
        <tr>
3204
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileMonitor.html">FileMonitor</a>&gt; Gio::File::monitor_directory           </td>
3205
 
          <td>(</td>
3206
 
          <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>
3207
 
          <td class="paramname"> <em>cancellable</em>, </td>
3208
 
        </tr>
3209
 
        <tr>
3210
 
          <td class="paramkey"></td>
3211
 
          <td></td>
3212
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g469f795e9a4dddb2421c0e5568be6649">FileMonitorFlags</a>&nbsp;</td>
3213
 
          <td class="paramname"> <em>flags</em> = <code>FILE_MONITOR_NONE</code></td><td>&nbsp;</td>
3214
 
        </tr>
3215
 
        <tr>
3216
 
          <td></td>
3217
 
          <td>)</td>
3218
 
          <td></td><td></td><td></td>
3219
 
        </tr>
3220
 
      </table>
3221
 
</div>
3222
 
<div class="memdoc">
3223
 
 
3224
 
<p>
3225
 
Obtains a directory monitor for the given file. 
3226
 
<p>
3227
 
This may fail if directory monitoring is not supported.<p>
3228
 
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>
3229
 
<dl compact><dt><b>Parameters:</b></dt><dd>
3230
 
  <table border="0" cellspacing="2" cellpadding="0">
3231
 
    <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>
3232
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileMonitorFlags. </td></tr>
3233
 
  </table>
3234
 
</dl>
3235
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileMonitor.html" title="Monitors a file or directory for changes.">FileMonitor</a> for the file. </dd></dl>
3236
 
 
3237
 
</div>
3238
 
</div><p>
3239
 
<a class="anchor" name="a410183ed3b4a745093383d038d271b9"></a><!-- doxytag: member="Gio::File::monitor_file" ref="a410183ed3b4a745093383d038d271b9" args="(FileMonitorFlags flags=FILE_MONITOR_NONE)" -->
3240
 
<div class="memitem">
3241
 
<div class="memproto">
3242
 
      <table class="memname">
3243
 
        <tr>
3244
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileMonitor.html">FileMonitor</a>&gt; Gio::File::monitor_file           </td>
3245
 
          <td>(</td>
3246
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g469f795e9a4dddb2421c0e5568be6649">FileMonitorFlags</a>&nbsp;</td>
3247
 
          <td class="paramname"> <em>flags</em> = <code>FILE_MONITOR_NONE</code>          </td>
3248
 
          <td>&nbsp;)&nbsp;</td>
3249
 
          <td></td>
3250
 
        </tr>
3251
 
      </table>
3252
 
</div>
3253
 
<div class="memdoc">
3254
 
 
3255
 
<p>
3256
 
Obtains a file monitor for the given file. 
3257
 
<p>
3258
 
If no file notification mechanism exists, then regular polling of the file is used.<p>
3259
 
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>
3260
 
<dl compact><dt><b>Parameters:</b></dt><dd>
3261
 
  <table border="0" cellspacing="2" cellpadding="0">
3262
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileMonitorFlags. </td></tr>
3263
 
    <tr><td valign="top"></td><td valign="top"><em>A</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
3264
 
  </table>
3265
 
</dl>
3266
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileMonitor.html" title="Monitors a file or directory for changes.">FileMonitor</a> for the file. </dd></dl>
3267
 
 
3268
 
</div>
3269
 
</div><p>
3270
 
<a class="anchor" name="b8e14809f330ddd58e628c96921cd987"></a><!-- doxytag: member="Gio::File::monitor_file" ref="b8e14809f330ddd58e628c96921cd987" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileMonitorFlags flags=FILE_MONITOR_NONE)" -->
3271
 
<div class="memitem">
3272
 
<div class="memproto">
3273
 
      <table class="memname">
3274
 
        <tr>
3275
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileMonitor.html">FileMonitor</a>&gt; Gio::File::monitor_file           </td>
3276
 
          <td>(</td>
3277
 
          <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>
3278
 
          <td class="paramname"> <em>cancellable</em>, </td>
3279
 
        </tr>
3280
 
        <tr>
3281
 
          <td class="paramkey"></td>
3282
 
          <td></td>
3283
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g469f795e9a4dddb2421c0e5568be6649">FileMonitorFlags</a>&nbsp;</td>
3284
 
          <td class="paramname"> <em>flags</em> = <code>FILE_MONITOR_NONE</code></td><td>&nbsp;</td>
3285
 
        </tr>
3286
 
        <tr>
3287
 
          <td></td>
3288
 
          <td>)</td>
3289
 
          <td></td><td></td><td></td>
3290
 
        </tr>
3291
 
      </table>
3292
 
</div>
3293
 
<div class="memdoc">
3294
 
 
3295
 
<p>
3296
 
Obtains a file monitor for the given file. 
3297
 
<p>
3298
 
If no file notification mechanism exists, then regular polling of the file is used.<p>
3299
 
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>
3300
 
<dl compact><dt><b>Parameters:</b></dt><dd>
3301
 
  <table border="0" cellspacing="2" cellpadding="0">
3302
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileMonitorFlags. </td></tr>
3303
 
    <tr><td valign="top"></td><td valign="top"><em>A</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
3304
 
  </table>
3305
 
</dl>
3306
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileMonitor.html" title="Monitors a file or directory for changes.">FileMonitor</a> for the file. </dd></dl>
3307
 
 
3308
 
</div>
3309
 
</div><p>
3310
 
<a class="anchor" name="20f8f18876102a5efaa0536bfa71d71c"></a><!-- doxytag: member="Gio::File::mount_enclosing_volume" ref="20f8f18876102a5efaa0536bfa71d71c" args="(MountMountFlags flags=MOUNT_MOUNT_NONE)" -->
3311
 
<div class="memitem">
3312
 
<div class="memproto">
3313
 
      <table class="memname">
3314
 
        <tr>
3315
 
          <td class="memname">void Gio::File::mount_enclosing_volume           </td>
3316
 
          <td>(</td>
3317
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g5484bace25c932fd4c7354259e138814">MountMountFlags</a>&nbsp;</td>
3318
 
          <td class="paramname"> <em>flags</em> = <code>MOUNT_MOUNT_NONE</code>          </td>
3319
 
          <td>&nbsp;)&nbsp;</td>
3320
 
          <td></td>
3321
 
        </tr>
3322
 
      </table>
3323
 
</div>
3324
 
<div class="memdoc">
3325
 
 
3326
 
<p>
3327
 
Starts a <em>mount_operation</em>, mounting the volume that contains the file. 
3328
 
<p>
3329
 
 
3330
 
</div>
3331
 
</div><p>
3332
 
<a class="anchor" name="2172cdcdb683630b719c521bf00b1eb4"></a><!-- doxytag: member="Gio::File::mount_enclosing_volume" ref="2172cdcdb683630b719c521bf00b1eb4" args="(const SlotAsyncReady &amp;slot, MountMountFlags flags=MOUNT_MOUNT_NONE)" -->
3333
 
<div class="memitem">
3334
 
<div class="memproto">
3335
 
      <table class="memname">
3336
 
        <tr>
3337
 
          <td class="memname">void Gio::File::mount_enclosing_volume           </td>
3338
 
          <td>(</td>
3339
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
3340
 
          <td class="paramname"> <em>slot</em>, </td>
3341
 
        </tr>
3342
 
        <tr>
3343
 
          <td class="paramkey"></td>
3344
 
          <td></td>
3345
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g5484bace25c932fd4c7354259e138814">MountMountFlags</a>&nbsp;</td>
3346
 
          <td class="paramname"> <em>flags</em> = <code>MOUNT_MOUNT_NONE</code></td><td>&nbsp;</td>
3347
 
        </tr>
3348
 
        <tr>
3349
 
          <td></td>
3350
 
          <td>)</td>
3351
 
          <td></td><td></td><td></td>
3352
 
        </tr>
3353
 
      </table>
3354
 
</div>
3355
 
<div class="memdoc">
3356
 
 
3357
 
<p>
3358
 
Starts a <em>mount_operation</em>, mounting the volume that contains the file. 
3359
 
<p>
3360
 
When this operation has completed, <em>slot</em> will be called with, and the operation can be finalized with <a class="el" href="classGio_1_1File.html#efd44b1b3467bcc474b345ff98b4aa6d" title="Finishes a mount operation started by g_file_mount_enclosing_volume().">mount_enclosing_volume_finish()</a>.<p>
3361
 
<dl compact><dt><b>Parameters:</b></dt><dd>
3362
 
  <table border="0" cellspacing="2" cellpadding="0">
3363
 
    <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>
3364
 
  </table>
3365
 
</dl>
3366
 
 
3367
 
</div>
3368
 
</div><p>
3369
 
<a class="anchor" name="70fd22116d9c8682433c4bb8cbd764c1"></a><!-- doxytag: member="Gio::File::mount_enclosing_volume" ref="70fd22116d9c8682433c4bb8cbd764c1" args="(const Glib::RefPtr&lt; MountOperation &gt; &amp;mount_operation, const SlotAsyncReady &amp;slot, MountMountFlags flags=MOUNT_MOUNT_NONE)" -->
3370
 
<div class="memitem">
3371
 
<div class="memproto">
3372
 
      <table class="memname">
3373
 
        <tr>
3374
 
          <td class="memname">void Gio::File::mount_enclosing_volume           </td>
3375
 
          <td>(</td>
3376
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1MountOperation.html">MountOperation</a>&gt;&amp;&nbsp;</td>
3377
 
          <td class="paramname"> <em>mount_operation</em>, </td>
3378
 
        </tr>
3379
 
        <tr>
3380
 
          <td class="paramkey"></td>
3381
 
          <td></td>
3382
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
3383
 
          <td class="paramname"> <em>slot</em>, </td>
3384
 
        </tr>
3385
 
        <tr>
3386
 
          <td class="paramkey"></td>
3387
 
          <td></td>
3388
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g5484bace25c932fd4c7354259e138814">MountMountFlags</a>&nbsp;</td>
3389
 
          <td class="paramname"> <em>flags</em> = <code>MOUNT_MOUNT_NONE</code></td><td>&nbsp;</td>
3390
 
        </tr>
3391
 
        <tr>
3392
 
          <td></td>
3393
 
          <td>)</td>
3394
 
          <td></td><td></td><td></td>
3395
 
        </tr>
3396
 
      </table>
3397
 
</div>
3398
 
<div class="memdoc">
3399
 
 
3400
 
<p>
3401
 
Starts a <em>mount_operation</em>, mounting the volume that contains the file. 
3402
 
<p>
3403
 
When this operation has completed, <em>slot</em> will be called with, and the operation can be finalized with <a class="el" href="classGio_1_1File.html#efd44b1b3467bcc474b345ff98b4aa6d" title="Finishes a mount operation started by g_file_mount_enclosing_volume().">mount_enclosing_volume_finish()</a>.<p>
3404
 
<dl compact><dt><b>Parameters:</b></dt><dd>
3405
 
  <table border="0" cellspacing="2" cellpadding="0">
3406
 
    <tr><td valign="top"></td><td valign="top"><em>mount_operation</em>&nbsp;</td><td>A <a class="el" href="classGio_1_1MountOperation.html" title="Authentication methods for mountable locations.">MountOperation</a>. </td></tr>
3407
 
    <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>
3408
 
  </table>
3409
 
</dl>
3410
 
 
3411
 
</div>
3412
 
</div><p>
3413
 
<a class="anchor" name="144aa2de6b696da90a6baffbe959d732"></a><!-- doxytag: member="Gio::File::mount_enclosing_volume" ref="144aa2de6b696da90a6baffbe959d732" args="(const Glib::RefPtr&lt; MountOperation &gt; &amp;mount_operation, const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, MountMountFlags flags=MOUNT_MOUNT_NONE)" -->
3414
 
<div class="memitem">
3415
 
<div class="memproto">
3416
 
      <table class="memname">
3417
 
        <tr>
3418
 
          <td class="memname">void Gio::File::mount_enclosing_volume           </td>
3419
 
          <td>(</td>
3420
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1MountOperation.html">MountOperation</a>&gt;&amp;&nbsp;</td>
3421
 
          <td class="paramname"> <em>mount_operation</em>, </td>
3422
 
        </tr>
3423
 
        <tr>
3424
 
          <td class="paramkey"></td>
3425
 
          <td></td>
3426
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
3427
 
          <td class="paramname"> <em>slot</em>, </td>
3428
 
        </tr>
3429
 
        <tr>
3430
 
          <td class="paramkey"></td>
3431
 
          <td></td>
3432
 
          <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>
3433
 
          <td class="paramname"> <em>cancellable</em>, </td>
3434
 
        </tr>
3435
 
        <tr>
3436
 
          <td class="paramkey"></td>
3437
 
          <td></td>
3438
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g5484bace25c932fd4c7354259e138814">MountMountFlags</a>&nbsp;</td>
3439
 
          <td class="paramname"> <em>flags</em> = <code>MOUNT_MOUNT_NONE</code></td><td>&nbsp;</td>
3440
 
        </tr>
3441
 
        <tr>
3442
 
          <td></td>
3443
 
          <td>)</td>
3444
 
          <td></td><td></td><td></td>
3445
 
        </tr>
3446
 
      </table>
3447
 
</div>
3448
 
<div class="memdoc">
3449
 
 
3450
 
<p>
3451
 
Starts a <em>mount_operation</em>, mounting the volume that contains the file. 
3452
 
<p>
3453
 
When this operation has completed, <em>slot</em> will be called with, and the operation can be finalized with <a class="el" href="classGio_1_1File.html#efd44b1b3467bcc474b345ff98b4aa6d" title="Finishes a mount operation started by g_file_mount_enclosing_volume().">mount_enclosing_volume_finish()</a>.<p>
3454
 
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>
3455
 
<dl compact><dt><b>Parameters:</b></dt><dd>
3456
 
  <table border="0" cellspacing="2" cellpadding="0">
3457
 
    <tr><td valign="top"></td><td valign="top"><em>mount_operation</em>&nbsp;</td><td>A <a class="el" href="classGio_1_1MountOperation.html" title="Authentication methods for mountable locations.">MountOperation</a>. </td></tr>
3458
 
    <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>
3459
 
    <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>
3460
 
  </table>
3461
 
</dl>
3462
 
 
3463
 
</div>
3464
 
</div><p>
3465
 
<a class="anchor" name="efd44b1b3467bcc474b345ff98b4aa6d"></a><!-- doxytag: member="Gio::File::mount_enclosing_volume_finish" ref="efd44b1b3467bcc474b345ff98b4aa6d" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
3466
 
<div class="memitem">
3467
 
<div class="memproto">
3468
 
      <table class="memname">
3469
 
        <tr>
3470
 
          <td class="memname">bool Gio::File::mount_enclosing_volume_finish           </td>
3471
 
          <td>(</td>
3472
 
          <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>
3473
 
          <td class="paramname"> <em>result</em>          </td>
3474
 
          <td>&nbsp;)&nbsp;</td>
3475
 
          <td></td>
3476
 
        </tr>
3477
 
      </table>
3478
 
</div>
3479
 
<div class="memdoc">
3480
 
 
3481
 
<p>
3482
 
Finishes a mount operation started by g_file_mount_enclosing_volume(). 
3483
 
<p>
3484
 
<dl compact><dt><b>Parameters:</b></dt><dd>
3485
 
  <table border="0" cellspacing="2" cellpadding="0">
3486
 
    <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>
3487
 
  </table>
3488
 
</dl>
3489
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if successful. If an error has occurred, this function will return <code>false</code> and set <em>error</em> appropriately if present. </dd></dl>
3490
 
 
3491
 
</div>
3492
 
</div><p>
3493
 
<a class="anchor" name="8501fa88f4aaa8d52c001596960a4572"></a><!-- doxytag: member="Gio::File::mount_mountable" ref="8501fa88f4aaa8d52c001596960a4572" args="(MountMountFlags flags=MOUNT_MOUNT_NONE)" -->
3494
 
<div class="memitem">
3495
 
<div class="memproto">
3496
 
      <table class="memname">
3497
 
        <tr>
3498
 
          <td class="memname">void Gio::File::mount_mountable           </td>
3499
 
          <td>(</td>
3500
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g5484bace25c932fd4c7354259e138814">MountMountFlags</a>&nbsp;</td>
3501
 
          <td class="paramname"> <em>flags</em> = <code>MOUNT_MOUNT_NONE</code>          </td>
3502
 
          <td>&nbsp;)&nbsp;</td>
3503
 
          <td></td>
3504
 
        </tr>
3505
 
      </table>
3506
 
</div>
3507
 
<div class="memdoc">
3508
 
 
3509
 
<p>
3510
 
Mounts a file of type FILE_TYPE_MOUNTABLE without user interaction. 
3511
 
<p>
3512
 
 
3513
 
</div>
3514
 
</div><p>
3515
 
<a class="anchor" name="049e06c3d95b49ad4bff1837ef6d8677"></a><!-- doxytag: member="Gio::File::mount_mountable" ref="049e06c3d95b49ad4bff1837ef6d8677" args="(const SlotAsyncReady &amp;slot, MountMountFlags flags=MOUNT_MOUNT_NONE)" -->
3516
 
<div class="memitem">
3517
 
<div class="memproto">
3518
 
      <table class="memname">
3519
 
        <tr>
3520
 
          <td class="memname">void Gio::File::mount_mountable           </td>
3521
 
          <td>(</td>
3522
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
3523
 
          <td class="paramname"> <em>slot</em>, </td>
3524
 
        </tr>
3525
 
        <tr>
3526
 
          <td class="paramkey"></td>
3527
 
          <td></td>
3528
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g5484bace25c932fd4c7354259e138814">MountMountFlags</a>&nbsp;</td>
3529
 
          <td class="paramname"> <em>flags</em> = <code>MOUNT_MOUNT_NONE</code></td><td>&nbsp;</td>
3530
 
        </tr>
3531
 
        <tr>
3532
 
          <td></td>
3533
 
          <td>)</td>
3534
 
          <td></td><td></td><td></td>
3535
 
        </tr>
3536
 
      </table>
3537
 
</div>
3538
 
<div class="memdoc">
3539
 
 
3540
 
<p>
3541
 
Mounts a file of type FILE_TYPE_MOUNTABLE without user interaction. 
3542
 
<p>
3543
 
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#e15d36a7969c55122b9f85a1690a46e8" title="Finishes a mount operation.">mount_mountable_finish()</a> to get the result of the operation.<p>
3544
 
<dl compact><dt><b>Parameters:</b></dt><dd>
3545
 
  <table border="0" cellspacing="2" cellpadding="0">
3546
 
    <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>
3547
 
  </table>
3548
 
</dl>
3549
 
 
3550
 
</div>
3551
 
</div><p>
3552
 
<a class="anchor" name="c3c29682ef5a50de73dc2c3c3333301c"></a><!-- doxytag: member="Gio::File::mount_mountable" ref="c3c29682ef5a50de73dc2c3c3333301c" args="(const Glib::RefPtr&lt; MountOperation &gt; &amp;mount_operation, const SlotAsyncReady &amp;slot, MountMountFlags flags=MOUNT_MOUNT_NONE)" -->
3553
 
<div class="memitem">
3554
 
<div class="memproto">
3555
 
      <table class="memname">
3556
 
        <tr>
3557
 
          <td class="memname">void Gio::File::mount_mountable           </td>
3558
 
          <td>(</td>
3559
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1MountOperation.html">MountOperation</a>&gt;&amp;&nbsp;</td>
3560
 
          <td class="paramname"> <em>mount_operation</em>, </td>
3561
 
        </tr>
3562
 
        <tr>
3563
 
          <td class="paramkey"></td>
3564
 
          <td></td>
3565
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
3566
 
          <td class="paramname"> <em>slot</em>, </td>
3567
 
        </tr>
3568
 
        <tr>
3569
 
          <td class="paramkey"></td>
3570
 
          <td></td>
3571
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g5484bace25c932fd4c7354259e138814">MountMountFlags</a>&nbsp;</td>
3572
 
          <td class="paramname"> <em>flags</em> = <code>MOUNT_MOUNT_NONE</code></td><td>&nbsp;</td>
3573
 
        </tr>
3574
 
        <tr>
3575
 
          <td></td>
3576
 
          <td>)</td>
3577
 
          <td></td><td></td><td></td>
3578
 
        </tr>
3579
 
      </table>
3580
 
</div>
3581
 
<div class="memdoc">
3582
 
 
3583
 
<p>
3584
 
Mounts a file of type FILE_TYPE_MOUNTABLE. 
3585
 
<p>
3586
 
Using <em>mount_operation</em>, you can request callbacks when, for instance, passwords are needed during authentication.<p>
3587
 
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#e15d36a7969c55122b9f85a1690a46e8" title="Finishes a mount operation.">mount_mountable_finish()</a> to get the result of the operation.<p>
3588
 
<dl compact><dt><b>Parameters:</b></dt><dd>
3589
 
  <table border="0" cellspacing="2" cellpadding="0">
3590
 
    <tr><td valign="top"></td><td valign="top"><em>mount_operation</em>&nbsp;</td><td>A <a class="el" href="classGio_1_1MountOperation.html" title="Authentication methods for mountable locations.">MountOperation</a>. </td></tr>
3591
 
    <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>
3592
 
  </table>
3593
 
</dl>
3594
 
 
3595
 
</div>
3596
 
</div><p>
3597
 
<a class="anchor" name="40c88a403f5d01d722b5900545b6a4fe"></a><!-- doxytag: member="Gio::File::mount_mountable" ref="40c88a403f5d01d722b5900545b6a4fe" args="(const Glib::RefPtr&lt; MountOperation &gt; &amp;mount_operation, const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, MountMountFlags flags=MOUNT_MOUNT_NONE)" -->
3598
 
<div class="memitem">
3599
 
<div class="memproto">
3600
 
      <table class="memname">
3601
 
        <tr>
3602
 
          <td class="memname">void Gio::File::mount_mountable           </td>
3603
 
          <td>(</td>
3604
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1MountOperation.html">MountOperation</a>&gt;&amp;&nbsp;</td>
3605
 
          <td class="paramname"> <em>mount_operation</em>, </td>
3606
 
        </tr>
3607
 
        <tr>
3608
 
          <td class="paramkey"></td>
3609
 
          <td></td>
3610
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
3611
 
          <td class="paramname"> <em>slot</em>, </td>
3612
 
        </tr>
3613
 
        <tr>
3614
 
          <td class="paramkey"></td>
3615
 
          <td></td>
3616
 
          <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>
3617
 
          <td class="paramname"> <em>cancellable</em>, </td>
3618
 
        </tr>
3619
 
        <tr>
3620
 
          <td class="paramkey"></td>
3621
 
          <td></td>
3622
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g5484bace25c932fd4c7354259e138814">MountMountFlags</a>&nbsp;</td>
3623
 
          <td class="paramname"> <em>flags</em> = <code>MOUNT_MOUNT_NONE</code></td><td>&nbsp;</td>
3624
 
        </tr>
3625
 
        <tr>
3626
 
          <td></td>
3627
 
          <td>)</td>
3628
 
          <td></td><td></td><td></td>
3629
 
        </tr>
3630
 
      </table>
3631
 
</div>
3632
 
<div class="memdoc">
3633
 
 
3634
 
<p>
3635
 
Mounts a file of type FILE_TYPE_MOUNTABLE. 
3636
 
<p>
3637
 
Using <em>mount_operation</em>, you can request callbacks when, for instance, passwords are needed during authentication.<p>
3638
 
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>
3639
 
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#e15d36a7969c55122b9f85a1690a46e8" title="Finishes a mount operation.">mount_mountable_finish()</a> to get the result of the operation.<p>
3640
 
<dl compact><dt><b>Parameters:</b></dt><dd>
3641
 
  <table border="0" cellspacing="2" cellpadding="0">
3642
 
    <tr><td valign="top"></td><td valign="top"><em>mount_operation</em>&nbsp;</td><td>A <a class="el" href="classGio_1_1MountOperation.html" title="Authentication methods for mountable locations.">MountOperation</a>. </td></tr>
3643
 
    <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>
3644
 
    <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>
3645
 
  </table>
3646
 
</dl>
3647
 
 
3648
 
</div>
3649
 
</div><p>
3650
 
<a class="anchor" name="e15d36a7969c55122b9f85a1690a46e8"></a><!-- doxytag: member="Gio::File::mount_mountable_finish" ref="e15d36a7969c55122b9f85a1690a46e8" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
3651
 
<div class="memitem">
3652
 
<div class="memproto">
3653
 
      <table class="memname">
3654
 
        <tr>
3655
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt; Gio::File::mount_mountable_finish           </td>
3656
 
          <td>(</td>
3657
 
          <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>
3658
 
          <td class="paramname"> <em>result</em>          </td>
3659
 
          <td>&nbsp;)&nbsp;</td>
3660
 
          <td></td>
3661
 
        </tr>
3662
 
      </table>
3663
 
</div>
3664
 
<div class="memdoc">
3665
 
 
3666
 
<p>
3667
 
Finishes a mount operation. 
3668
 
<p>
3669
 
See g_file_mount_mountable() for details.<p>
3670
 
Finish an asynchronous mount operation that was started with g_file_mount_mountable(). <dl compact><dt><b>Parameters:</b></dt><dd>
3671
 
  <table border="0" cellspacing="2" cellpadding="0">
3672
 
    <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>
3673
 
  </table>
3674
 
</dl>
3675
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> or <code>0</code> on error. Free the returned object with Glib::object_unref(). </dd></dl>
3676
 
 
3677
 
</div>
3678
 
</div><p>
3679
 
<a class="anchor" name="ba1fab56c3a8bea0b7e4d7f7324c5320"></a><!-- doxytag: member="Gio::File::move" ref="ba1fab56c3a8bea0b7e4d7f7324c5320" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, FileCopyFlags flags=FILE_COPY_NONE)" -->
3680
 
<div class="memitem">
3681
 
<div class="memproto">
3682
 
      <table class="memname">
3683
 
        <tr>
3684
 
          <td class="memname">bool Gio::File::move           </td>
3685
 
          <td>(</td>
3686
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
3687
 
          <td class="paramname"> <em>destination</em>, </td>
3688
 
        </tr>
3689
 
        <tr>
3690
 
          <td class="paramkey"></td>
3691
 
          <td></td>
3692
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
3693
 
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code></td><td>&nbsp;</td>
3694
 
        </tr>
3695
 
        <tr>
3696
 
          <td></td>
3697
 
          <td>)</td>
3698
 
          <td></td><td></td><td></td>
3699
 
        </tr>
3700
 
      </table>
3701
 
</div>
3702
 
<div class="memdoc">
3703
 
 
3704
 
<p>
3705
 
 
3706
 
</div>
3707
 
</div><p>
3708
 
<a class="anchor" name="dfb2d8bfed1cb7af50e5e5795ebea732"></a><!-- doxytag: member="Gio::File::move" ref="dfb2d8bfed1cb7af50e5e5795ebea732" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, const SlotFileProgress &amp;slot, FileCopyFlags flags=FILE_COPY_NONE)" -->
3709
 
<div class="memitem">
3710
 
<div class="memproto">
3711
 
      <table class="memname">
3712
 
        <tr>
3713
 
          <td class="memname">bool Gio::File::move           </td>
3714
 
          <td>(</td>
3715
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
3716
 
          <td class="paramname"> <em>destination</em>, </td>
3717
 
        </tr>
3718
 
        <tr>
3719
 
          <td class="paramkey"></td>
3720
 
          <td></td>
3721
 
          <td class="paramtype">const <a class="el" href="classGio_1_1File.html#c5ff32ee99845479d138eee49d92e59c">SlotFileProgress</a>&amp;&nbsp;</td>
3722
 
          <td class="paramname"> <em>slot</em>, </td>
3723
 
        </tr>
3724
 
        <tr>
3725
 
          <td class="paramkey"></td>
3726
 
          <td></td>
3727
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
3728
 
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code></td><td>&nbsp;</td>
3729
 
        </tr>
3730
 
        <tr>
3731
 
          <td></td>
3732
 
          <td>)</td>
3733
 
          <td></td><td></td><td></td>
3734
 
        </tr>
3735
 
      </table>
3736
 
</div>
3737
 
<div class="memdoc">
3738
 
 
3739
 
<p>
3740
 
 
3741
 
</div>
3742
 
</div><p>
3743
 
<a class="anchor" name="51c0d55880178c37dee578fdc723b0f2"></a><!-- doxytag: member="Gio::File::move" ref="51c0d55880178c37dee578fdc723b0f2" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, const SlotFileProgress &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileCopyFlags flags=FILE_COPY_NONE)" -->
3744
 
<div class="memitem">
3745
 
<div class="memproto">
3746
 
      <table class="memname">
3747
 
        <tr>
3748
 
          <td class="memname">bool Gio::File::move           </td>
3749
 
          <td>(</td>
3750
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
3751
 
          <td class="paramname"> <em>destination</em>, </td>
3752
 
        </tr>
3753
 
        <tr>
3754
 
          <td class="paramkey"></td>
3755
 
          <td></td>
3756
 
          <td class="paramtype">const <a class="el" href="classGio_1_1File.html#c5ff32ee99845479d138eee49d92e59c">SlotFileProgress</a>&amp;&nbsp;</td>
3757
 
          <td class="paramname"> <em>slot</em>, </td>
3758
 
        </tr>
3759
 
        <tr>
3760
 
          <td class="paramkey"></td>
3761
 
          <td></td>
3762
 
          <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>
3763
 
          <td class="paramname"> <em>cancellable</em>, </td>
3764
 
        </tr>
3765
 
        <tr>
3766
 
          <td class="paramkey"></td>
3767
 
          <td></td>
3768
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
3769
 
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code></td><td>&nbsp;</td>
3770
 
        </tr>
3771
 
        <tr>
3772
 
          <td></td>
3773
 
          <td>)</td>
3774
 
          <td></td><td></td><td></td>
3775
 
        </tr>
3776
 
      </table>
3777
 
</div>
3778
 
<div class="memdoc">
3779
 
 
3780
 
<p>
3781
 
Tries to move the file or directory source to the location specified by destination. 
3782
 
<p>
3783
 
If native move operations are supported then this is used, otherwise a copy and delete fallback is used. The native implementation may support moving directories (for instance on moves inside the same filesystem), but the fallback code does not.<p>
3784
 
If the flag FILE_COPY_OVERWRITE is specified an already existing destination file is overwritten.<p>
3785
 
If the flag FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks will be copied as symlinks, otherwise the target of the source symlink will be copied.<p>
3786
 
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>
3787
 
The operation can be monitored via the <em>slot</em> callback. If the source file does not exist then a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_FOUND will be thrown, independent on the status of the destination.<p>
3788
 
If G_FILE_COPY_OVERWRITE is not specified and the target exists, then a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with EXISTS will be thrown.<p>
3789
 
If trying to overwrite a file over a directory a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with IS_DIRECTORY will be thrown. If trying to overwrite a directory with a directory a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with WOULD_MERGE will be thrown.<p>
3790
 
If the source is a directory and the target does not exist, or FILE_COPY_OVERWRITE is specified and the target is a file, then a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with WOULD_RECURSE may be thrown (if the native move operation isn't available). 
3791
 
</div>
3792
 
</div><p>
3793
 
<a class="anchor" name="0c0fd0ece2570b6704889df5ee43c283"></a><!-- doxytag: member="Gio::File::query_default_handler" ref="0c0fd0ece2570b6704889df5ee43c283" args="()" -->
3794
 
<div class="memitem">
3795
 
<div class="memproto">
3796
 
      <table class="memname">
3797
 
        <tr>
3798
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1AppInfo.html">AppInfo</a>&gt; Gio::File::query_default_handler           </td>
3799
 
          <td>(</td>
3800
 
          <td class="paramname">          </td>
3801
 
          <td>&nbsp;)&nbsp;</td>
3802
 
          <td></td>
3803
 
        </tr>
3804
 
      </table>
3805
 
</div>
3806
 
<div class="memdoc">
3807
 
 
3808
 
<p>
3809
 
Returns the <a class="el" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch...">AppInfo</a> that is registered as the default application to handle the file specified by the file. 
3810
 
<p>
3811
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch...">AppInfo</a> if the handle was found, or an empty RefPtr if there were errors. </dd></dl>
3812
 
 
3813
 
</div>
3814
 
</div><p>
3815
 
<a class="anchor" name="753546465735b25633b003333b66d05c"></a><!-- doxytag: member="Gio::File::query_default_handler" ref="753546465735b25633b003333b66d05c" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
3816
 
<div class="memitem">
3817
 
<div class="memproto">
3818
 
      <table class="memname">
3819
 
        <tr>
3820
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1AppInfo.html">AppInfo</a>&gt; Gio::File::query_default_handler           </td>
3821
 
          <td>(</td>
3822
 
          <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>
3823
 
          <td class="paramname"> <em>cancellable</em>          </td>
3824
 
          <td>&nbsp;)&nbsp;</td>
3825
 
          <td></td>
3826
 
        </tr>
3827
 
      </table>
3828
 
</div>
3829
 
<div class="memdoc">
3830
 
 
3831
 
<p>
3832
 
Returns: a <a class="el" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch...">AppInfo</a> if the handle was found, <code>0</code> if there were errors. 
3833
 
<p>
3834
 
<dl compact><dt><b>Parameters:</b></dt><dd>
3835
 
  <table border="0" cellspacing="2" cellpadding="0">
3836
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td>Optional <a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object, <code>0</code> to ignore. </td></tr>
3837
 
  </table>
3838
 
</dl>
3839
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch...">AppInfo</a> if the handle was found, <code>0</code> if there were errors. When you are done with it, release it with Glib::object_unref(). </dd></dl>
 
1165
<a class="anchor" name="eecec6962f955bd72ac5595be37db7a4"></a><!-- doxytag: member="Gio::File::get_uri_scheme" ref="eecec6962f955bd72ac5595be37db7a4" args="() const " -->
 
1166
<div class="memitem">
 
1167
<div class="memproto">
 
1168
      <table class="memname">
 
1169
        <tr>
 
1170
          <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::File::get_uri_scheme           </td>
 
1171
          <td>(</td>
 
1172
          <td class="paramname">          </td>
 
1173
          <td>&nbsp;)&nbsp;</td>
 
1174
          <td> const</td>
 
1175
        </tr>
 
1176
      </table>
 
1177
</div>
 
1178
<div class="memdoc">
 
1179
 
 
1180
<p>
 
1181
Gets the URI scheme for a <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a>. 
 
1182
<p>
 
1183
RFC 3986 decodes the scheme as:<p>
 
1184
URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ]<p>
 
1185
Common schemes include "file", "http", "ftp", etc.<p>
 
1186
This call does no blocking i/o. <dl class="return" compact><dt><b>Returns:</b></dt><dd>A string containing the URI scheme for the given <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a>. The returned string should be freed with Glib::free() when no longer needed. </dd></dl>
 
1187
 
 
1188
</div>
 
1189
</div><p>
 
1190
<a class="anchor" name="3ef959c7ad7096846f26eb8b282e3c68"></a><!-- doxytag: member="Gio::File::read" ref="3ef959c7ad7096846f26eb8b282e3c68" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
 
1191
<div class="memitem">
 
1192
<div class="memproto">
 
1193
      <table class="memname">
 
1194
        <tr>
 
1195
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileInputStream.html">FileInputStream</a>&gt; Gio::File::read           </td>
 
1196
          <td>(</td>
 
1197
          <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>
 
1198
          <td class="paramname"> <em>cancellable</em>          </td>
 
1199
          <td>&nbsp;)&nbsp;</td>
 
1200
          <td></td>
 
1201
        </tr>
 
1202
      </table>
 
1203
</div>
 
1204
<div class="memdoc">
 
1205
 
 
1206
<p>
 
1207
Opens a file for reading. 
 
1208
<p>
 
1209
The result is a <a class="el" href="classGio_1_1FileInputStream.html" title="FileInputStream provides input streams that take their content from a file.">FileInputStream</a> that can be used to read the contents of the file.<p>
 
1210
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> will be thrown with CANCELLED.<p>
 
1211
If the file does not exist, a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_FOUND will be thrown. If the file is a directory, a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with IS_DIRECTORY will be thrown. Other errors are possible too, and depend on what kind of filesystem the file is on. <dl compact><dt><b>Parameters:</b></dt><dd>
 
1212
  <table border="0" cellspacing="2" cellpadding="0">
 
1213
    <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>. </td></tr>
 
1214
  </table>
 
1215
</dl>
 
1216
<dl class="return" compact><dt><b>Returns:</b></dt><dd><a class="el" href="classGio_1_1FileInputStream.html" title="FileInputStream provides input streams that take their content from a file.">FileInputStream</a> or <code>0</code> on error. </dd></dl>
 
1217
 
 
1218
</div>
 
1219
</div><p>
 
1220
<a class="anchor" name="0395b3b0b8cec5dc1fd9953e52e5fbc1"></a><!-- doxytag: member="Gio::File::read" ref="0395b3b0b8cec5dc1fd9953e52e5fbc1" args="()" -->
 
1221
<div class="memitem">
 
1222
<div class="memproto">
 
1223
      <table class="memname">
 
1224
        <tr>
 
1225
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileInputStream.html">FileInputStream</a>&gt; Gio::File::read           </td>
 
1226
          <td>(</td>
 
1227
          <td class="paramname">          </td>
 
1228
          <td>&nbsp;)&nbsp;</td>
 
1229
          <td></td>
 
1230
        </tr>
 
1231
      </table>
 
1232
</div>
 
1233
<div class="memdoc">
 
1234
 
 
1235
<p>
 
1236
Opens a file for reading. 
 
1237
<p>
 
1238
The result is a <a class="el" href="classGio_1_1FileInputStream.html" title="FileInputStream provides input streams that take their content from a file.">FileInputStream</a> that can be used to read the contents of the file.<p>
 
1239
If the file does not exist, a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_FOUND will be thrown. If the file is a directory, a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with IS_DIRECTORY will be thrown. Other errors are possible too, and depend on what kind of filesystem the file is on. <dl class="return" compact><dt><b>Returns:</b></dt><dd><a class="el" href="classGio_1_1FileInputStream.html" title="FileInputStream provides input streams that take their content from a file.">FileInputStream</a> or an empty RefPtr on error. </dd></dl>
 
1240
 
 
1241
</div>
 
1242
</div><p>
 
1243
<a class="anchor" name="2826eed0b1e76c3771f6ad5f5b993991"></a><!-- doxytag: member="Gio::File::read_async" ref="2826eed0b1e76c3771f6ad5f5b993991" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, int io_priority=Glib::PRIORITY_DEFAULT)" -->
 
1244
<div class="memitem">
 
1245
<div class="memproto">
 
1246
      <table class="memname">
 
1247
        <tr>
 
1248
          <td class="memname">void Gio::File::read_async           </td>
 
1249
          <td>(</td>
 
1250
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
1251
          <td class="paramname"> <em>slot</em>, </td>
 
1252
        </tr>
 
1253
        <tr>
 
1254
          <td class="paramkey"></td>
 
1255
          <td></td>
 
1256
          <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>
 
1257
          <td class="paramname"> <em>cancellable</em>, </td>
 
1258
        </tr>
 
1259
        <tr>
 
1260
          <td class="paramkey"></td>
 
1261
          <td></td>
 
1262
          <td class="paramtype">int&nbsp;</td>
 
1263
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
 
1264
        </tr>
 
1265
        <tr>
 
1266
          <td></td>
 
1267
          <td>)</td>
 
1268
          <td></td><td></td><td></td>
 
1269
        </tr>
 
1270
      </table>
 
1271
</div>
 
1272
<div class="memdoc">
 
1273
 
 
1274
<p>
 
1275
Asynchronously opens the file for reading. 
 
1276
<p>
 
1277
For more details, see <a class="el" href="classGio_1_1File.html#0395b3b0b8cec5dc1fd9953e52e5fbc1" title="Opens a file for reading.">read()</a> which is the synchronous version of this call. When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#64b10854ad1add1f888ecb19403eb921" title="Finishes an asynchronous file read operation started with g_file_read_async().">read_finish()</a> to get the result of the operation.<p>
 
1278
<dl compact><dt><b>Parameters:</b></dt><dd>
 
1279
  <table border="0" cellspacing="2" cellpadding="0">
 
1280
    <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>
 
1281
    <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>
 
1282
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
 
1283
  </table>
 
1284
</dl>
 
1285
 
 
1286
</div>
 
1287
</div><p>
 
1288
<a class="anchor" name="b451a182a647408e697c9115e66f6194"></a><!-- doxytag: member="Gio::File::read_async" ref="b451a182a647408e697c9115e66f6194" args="(const SlotAsyncReady &amp;slot, int io_priority=Glib::PRIORITY_DEFAULT)" -->
 
1289
<div class="memitem">
 
1290
<div class="memproto">
 
1291
      <table class="memname">
 
1292
        <tr>
 
1293
          <td class="memname">void Gio::File::read_async           </td>
 
1294
          <td>(</td>
 
1295
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
1296
          <td class="paramname"> <em>slot</em>, </td>
 
1297
        </tr>
 
1298
        <tr>
 
1299
          <td class="paramkey"></td>
 
1300
          <td></td>
 
1301
          <td class="paramtype">int&nbsp;</td>
 
1302
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
 
1303
        </tr>
 
1304
        <tr>
 
1305
          <td></td>
 
1306
          <td>)</td>
 
1307
          <td></td><td></td><td></td>
 
1308
        </tr>
 
1309
      </table>
 
1310
</div>
 
1311
<div class="memdoc">
 
1312
 
 
1313
<p>
 
1314
Asynchronously opens the file for reading. 
 
1315
<p>
 
1316
For more details, see <a class="el" href="classGio_1_1File.html#0395b3b0b8cec5dc1fd9953e52e5fbc1" title="Opens a file for reading.">read()</a> which is the synchronous version of this call. When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#64b10854ad1add1f888ecb19403eb921" title="Finishes an asynchronous file read operation started with g_file_read_async().">read_finish()</a> to get the result of the operation.<p>
 
1317
<dl compact><dt><b>Parameters:</b></dt><dd>
 
1318
  <table border="0" cellspacing="2" cellpadding="0">
 
1319
    <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>
 
1320
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
 
1321
  </table>
 
1322
</dl>
 
1323
 
 
1324
</div>
 
1325
</div><p>
 
1326
<a class="anchor" name="64b10854ad1add1f888ecb19403eb921"></a><!-- doxytag: member="Gio::File::read_finish" ref="64b10854ad1add1f888ecb19403eb921" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
 
1327
<div class="memitem">
 
1328
<div class="memproto">
 
1329
      <table class="memname">
 
1330
        <tr>
 
1331
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileInputStream.html">FileInputStream</a>&gt; Gio::File::read_finish           </td>
 
1332
          <td>(</td>
 
1333
          <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>
 
1334
          <td class="paramname"> <em>result</em>          </td>
 
1335
          <td>&nbsp;)&nbsp;</td>
 
1336
          <td></td>
 
1337
        </tr>
 
1338
      </table>
 
1339
</div>
 
1340
<div class="memdoc">
 
1341
 
 
1342
<p>
 
1343
Finishes an asynchronous file read operation started with g_file_read_async(). 
 
1344
<p>
 
1345
<dl compact><dt><b>Parameters:</b></dt><dd>
 
1346
  <table border="0" cellspacing="2" cellpadding="0">
 
1347
    <tr><td valign="top"></td><td valign="top"><em>res</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>
 
1348
  </table>
 
1349
</dl>
 
1350
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileInputStream.html" title="FileInputStream provides input streams that take their content from a file.">FileInputStream</a> or <code>0</code> on error. Free the returned object with Glib::object_unref(). </dd></dl>
 
1351
 
 
1352
</div>
 
1353
</div><p>
 
1354
<a class="anchor" name="91c93ee71eee738690cb551d11df9528"></a><!-- doxytag: member="Gio::File::append_to" ref="91c93ee71eee738690cb551d11df9528" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileCreateFlags flags=FILE_CREATE_NONE)" -->
 
1355
<div class="memitem">
 
1356
<div class="memproto">
 
1357
      <table class="memname">
 
1358
        <tr>
 
1359
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileOutputStream.html">FileOutputStream</a>&gt; Gio::File::append_to           </td>
 
1360
          <td>(</td>
 
1361
          <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>
 
1362
          <td class="paramname"> <em>cancellable</em>, </td>
 
1363
        </tr>
 
1364
        <tr>
 
1365
          <td class="paramkey"></td>
 
1366
          <td></td>
 
1367
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
 
1368
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
 
1369
        </tr>
 
1370
        <tr>
 
1371
          <td></td>
 
1372
          <td>)</td>
 
1373
          <td></td><td></td><td></td>
 
1374
        </tr>
 
1375
      </table>
 
1376
</div>
 
1377
<div class="memdoc">
 
1378
 
 
1379
<p>
 
1380
Gets an output stream for appending data to the file. 
 
1381
<p>
 
1382
If the file doesn't already exist it is created.<p>
 
1383
By default files created are generally readable by everyone, but if you pass FILE_CREATE_PRIVATE in <em>flags</em> the file will be made readable only to the current user, to the level that is supported on the target filesystem.<p>
 
1384
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>
 
1385
Some filesystems don't allow all filenames, and may throw a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with INVALID_FILENAME. If the file is a directory a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with IS_DIRECTORY will be thrown. Other errors are possible too, and depend on what kind of filesystem the file is on. <dl compact><dt><b>Parameters:</b></dt><dd>
 
1386
  <table border="0" cellspacing="2" cellpadding="0">
 
1387
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
 
1388
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td>Optional <a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
 
1389
  </table>
 
1390
</dl>
 
1391
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a>. </dd></dl>
 
1392
 
 
1393
</div>
 
1394
</div><p>
 
1395
<a class="anchor" name="8db337b93f3b9b9a6e163477391e6c89"></a><!-- doxytag: member="Gio::File::append_to" ref="8db337b93f3b9b9a6e163477391e6c89" args="(FileCreateFlags flags=FILE_CREATE_NONE)" -->
 
1396
<div class="memitem">
 
1397
<div class="memproto">
 
1398
      <table class="memname">
 
1399
        <tr>
 
1400
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileOutputStream.html">FileOutputStream</a>&gt; Gio::File::append_to           </td>
 
1401
          <td>(</td>
 
1402
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
 
1403
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code>          </td>
 
1404
          <td>&nbsp;)&nbsp;</td>
 
1405
          <td></td>
 
1406
        </tr>
 
1407
      </table>
 
1408
</div>
 
1409
<div class="memdoc">
 
1410
 
 
1411
<p>
 
1412
Gets an output stream for appending data to the file. 
 
1413
<p>
 
1414
If the file doesn't already exist it is created.<p>
 
1415
By default files created are generally readable by everyone, but if you pass FILE_CREATE_PRIVATE in <em>flags</em> the file will be made readable only to the current user, to the level that is supported on the target filesystem.<p>
 
1416
Some filesystems don't allow all filenames, and may throw a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with INVALID_FILENAME. If the file is a directory a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with IS_DIRECTORY will be thrown. Other errors are possible too, and depend on what kind of filesystem the file is on. <dl compact><dt><b>Parameters:</b></dt><dd>
 
1417
  <table border="0" cellspacing="2" cellpadding="0">
 
1418
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
 
1419
  </table>
 
1420
</dl>
 
1421
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a>. </dd></dl>
 
1422
 
 
1423
</div>
 
1424
</div><p>
 
1425
<a class="anchor" name="86258e11b2884422819d051c3cfd07a2"></a><!-- doxytag: member="Gio::File::create_file" ref="86258e11b2884422819d051c3cfd07a2" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileCreateFlags flags=FILE_CREATE_NONE)" -->
 
1426
<div class="memitem">
 
1427
<div class="memproto">
 
1428
      <table class="memname">
 
1429
        <tr>
 
1430
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileOutputStream.html">FileOutputStream</a>&gt; Gio::File::create_file           </td>
 
1431
          <td>(</td>
 
1432
          <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>
 
1433
          <td class="paramname"> <em>cancellable</em>, </td>
 
1434
        </tr>
 
1435
        <tr>
 
1436
          <td class="paramkey"></td>
 
1437
          <td></td>
 
1438
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
 
1439
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
 
1440
        </tr>
 
1441
        <tr>
 
1442
          <td></td>
 
1443
          <td>)</td>
 
1444
          <td></td><td></td><td></td>
 
1445
        </tr>
 
1446
      </table>
 
1447
</div>
 
1448
<div class="memdoc">
 
1449
 
 
1450
<p>
 
1451
Creates a new file and returns an output stream for writing to it. 
 
1452
<p>
 
1453
The file must not already exists.<p>
 
1454
By default files created are generally readable by everyone, but if you pass FILE_CREATE_PRIVATE in <em>flags</em> the file will be made readable only to the current user, to the level that is supported on the target filesystem.<p>
 
1455
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>
 
1456
If a file with this name already exists a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with EXISTS will be thrown. If the file is a directory a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with IS_DIRECTORY will be thrown.<p>
 
1457
Some filesystems don't allow all filenames, and may throw a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with INVALID_FILENAME, and if the name is to longa <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with FILENAME_TOO_LONG will be thrown. Other errors are possible too, and depend on what kind of filesystem the file is on.<p>
 
1458
<dl compact><dt><b>Parameters:</b></dt><dd>
 
1459
  <table border="0" cellspacing="2" cellpadding="0">
 
1460
    <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>
 
1461
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>a set of FileCreateFlags. </td></tr>
 
1462
  </table>
 
1463
</dl>
 
1464
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a> for the newly created file. </dd></dl>
 
1465
 
 
1466
</div>
 
1467
</div><p>
 
1468
<a class="anchor" name="5cf2b17b953ccfefb1d13c39bd1be72c"></a><!-- doxytag: member="Gio::File::create_file" ref="5cf2b17b953ccfefb1d13c39bd1be72c" args="(FileCreateFlags flags=FILE_CREATE_NONE)" -->
 
1469
<div class="memitem">
 
1470
<div class="memproto">
 
1471
      <table class="memname">
 
1472
        <tr>
 
1473
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileOutputStream.html">FileOutputStream</a>&gt; Gio::File::create_file           </td>
 
1474
          <td>(</td>
 
1475
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
 
1476
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code>          </td>
 
1477
          <td>&nbsp;)&nbsp;</td>
 
1478
          <td></td>
 
1479
        </tr>
 
1480
      </table>
 
1481
</div>
 
1482
<div class="memdoc">
 
1483
 
 
1484
<p>
 
1485
Creates a new file and returns an output stream for writing to it. 
 
1486
<p>
 
1487
The file must not already exists.<p>
 
1488
By default files created are generally readable by everyone, but if you pass FILE_CREATE_PRIVATE in <em>flags</em> the file will be made readable only to the current user, to the level that is supported on the target filesystem.<p>
 
1489
If a file with this name already exists a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with EXISTS will be thrown. If the file is a directory a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with IS_DIRECTORY will be thrown.<p>
 
1490
Some filesystems don't allow all filenames, and may throw a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with INVALID_FILENAME, and if the name is to longa <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with FILENAME_TOO_LONG will be thrown. Other errors are possible too, and depend on what kind of filesystem the file is on.<p>
 
1491
<dl compact><dt><b>Parameters:</b></dt><dd>
 
1492
  <table border="0" cellspacing="2" cellpadding="0">
 
1493
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>a set of FileCreateFlags. </td></tr>
 
1494
  </table>
 
1495
</dl>
 
1496
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a> for the newly created file. </dd></dl>
 
1497
 
 
1498
</div>
 
1499
</div><p>
 
1500
<a class="anchor" name="d7cf0360096504e40f799fde5cc8e9de"></a><!-- doxytag: member="Gio::File::replace" ref="d7cf0360096504e40f799fde5cc8e9de" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, const std::string &amp;etag=std::string(), bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE)" -->
 
1501
<div class="memitem">
 
1502
<div class="memproto">
 
1503
      <table class="memname">
 
1504
        <tr>
 
1505
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileOutputStream.html">FileOutputStream</a>&gt; Gio::File::replace           </td>
 
1506
          <td>(</td>
 
1507
          <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>
 
1508
          <td class="paramname"> <em>cancellable</em>, </td>
 
1509
        </tr>
 
1510
        <tr>
 
1511
          <td class="paramkey"></td>
 
1512
          <td></td>
 
1513
          <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>
 
1514
          <td class="paramname"> <em>etag</em> = <code><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>()</code>, </td>
 
1515
        </tr>
 
1516
        <tr>
 
1517
          <td class="paramkey"></td>
 
1518
          <td></td>
 
1519
          <td class="paramtype">bool&nbsp;</td>
 
1520
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
 
1521
        </tr>
 
1522
        <tr>
 
1523
          <td class="paramkey"></td>
 
1524
          <td></td>
 
1525
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
 
1526
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
 
1527
        </tr>
 
1528
        <tr>
 
1529
          <td></td>
 
1530
          <td>)</td>
 
1531
          <td></td><td></td><td></td>
 
1532
        </tr>
 
1533
      </table>
 
1534
</div>
 
1535
<div class="memdoc">
 
1536
 
 
1537
<p>
 
1538
Returns an output stream for overwriting the file, possibly creating a backup copy of the file first. 
 
1539
<p>
 
1540
This will try to replace the file in the safest way possible so that any errors during the writing will not affect an already existing copy of the file. For instance, for local files it may write to a temporary file and then atomically rename over the destination when the stream is closed.<p>
 
1541
By default files created are generally readable by everyone, but if you pass FILE_CREATE_PRIVATE in <em>flags</em> the file will be made readable only to the current user, to the level that is supported on the target filesystem.<p>
 
1542
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>
 
1543
If you pass in an etag value, then this value is compared to the current entity tag of the file, and if they differ a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with WRONG_ETAG will be thrown. This generally means that the file has been changed since you last read it. You can get the new etag from <a class="el" href="classGio_1_1FileOutputStream.html#8e29de4e67428a79b41180ca27af0a3d" title="Gets the entity tag for the file when it has been written.">FileOutputStream::get_etag()</a> after you've finished writing and closed the <a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a>. When you load a new file you can use <a class="el" href="classGio_1_1FileInputStream.html#e9cf87761484839f4ea53bc33064f189" title="Queries a file input stream the given attributes.">FileInputStream::query_info()</a> to get the etag of the file.<p>
 
1544
If <em>make_backup</em> is true, this function will attempt to make a backup of the current file before overwriting it. If this fails aa <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with CANT_CREATE_BACKUP will be thrown. If you want to replace anyway, try again with <em>make_backup</em> set to false.<p>
 
1545
If the file is a directory a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with IS_DIRECTORY will be thrown, and if the file is some other form of non-regular file then aa <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_REGULAR_FILE will be thrown. Some file systems don't allow all file names, and may throw a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with INVALID_FILENAME, and if the name is to longa <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with FILENAME_TOO_LONG will be thrown. Other errors are possible too, and depend on what kind of filesystem the file is on.<p>
 
1546
<dl compact><dt><b>Parameters:</b></dt><dd>
 
1547
  <table border="0" cellspacing="2" cellpadding="0">
 
1548
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>An optional entity tag for the current Glib::File. </td></tr>
 
1549
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td><code>true</code> if a backup should be created. </td></tr>
 
1550
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
 
1551
  </table>
 
1552
</dl>
 
1553
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a>. </dd></dl>
 
1554
 
 
1555
</div>
 
1556
</div><p>
 
1557
<a class="anchor" name="cf55f9291659566f6fd36271801b013b"></a><!-- doxytag: member="Gio::File::replace" ref="cf55f9291659566f6fd36271801b013b" args="(const std::string &amp;etag=std::string(), bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE)" -->
 
1558
<div class="memitem">
 
1559
<div class="memproto">
 
1560
      <table class="memname">
 
1561
        <tr>
 
1562
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileOutputStream.html">FileOutputStream</a>&gt; Gio::File::replace           </td>
 
1563
          <td>(</td>
 
1564
          <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>
 
1565
          <td class="paramname"> <em>etag</em> = <code><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>()</code>, </td>
 
1566
        </tr>
 
1567
        <tr>
 
1568
          <td class="paramkey"></td>
 
1569
          <td></td>
 
1570
          <td class="paramtype">bool&nbsp;</td>
 
1571
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
 
1572
        </tr>
 
1573
        <tr>
 
1574
          <td class="paramkey"></td>
 
1575
          <td></td>
 
1576
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
 
1577
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
 
1578
        </tr>
 
1579
        <tr>
 
1580
          <td></td>
 
1581
          <td>)</td>
 
1582
          <td></td><td></td><td></td>
 
1583
        </tr>
 
1584
      </table>
 
1585
</div>
 
1586
<div class="memdoc">
 
1587
 
 
1588
<p>
 
1589
Returns an output stream for overwriting the file, possibly creating a backup copy of the file first. 
 
1590
<p>
 
1591
This will try to replace the file in the safest way possible so that any errors during the writing will not affect an already existing copy of the file. For instance, for local files it may write to a temporary file and then atomically rename over the destination when the stream is closed.<p>
 
1592
By default files created are generally readable by everyone, but if you pass FILE_CREATE_PRIVATE in <em>flags</em> the file will be made readable only to the current user, to the level that is supported on the target filesystem.<p>
 
1593
If you pass in an etag value, then this value is compared to the current entity tag of the file, and if they differ a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with WRONG_ETAG will be thrown. This generally means that the file has been changed since you last read it. You can get the new etag from <a class="el" href="classGio_1_1FileOutputStream.html#8e29de4e67428a79b41180ca27af0a3d" title="Gets the entity tag for the file when it has been written.">FileOutputStream::get_etag()</a> after you've finished writing and closed the <a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a>. When you load a new file you can use <a class="el" href="classGio_1_1FileInputStream.html#e9cf87761484839f4ea53bc33064f189" title="Queries a file input stream the given attributes.">FileInputStream::query_info()</a> to get the etag of the file.<p>
 
1594
If <em>make_backup</em> is true, this function will attempt to make a backup of the current file before overwriting it. If this fails aa <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with CANT_CREATE_BACKUP will be thrown. If you want to replace anyway, try again with <em>make_backup</em> set to false.<p>
 
1595
If the file is a directory a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with IS_DIRECTORY will be thrown, and if the file is some other form of non-regular file then aa <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_REGULAR_FILE will be thrown. Some file systems don't allow all file names, and may throw a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with INVALID_FILENAME, and if the name is to longa <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with FILENAME_TOO_LONG will be thrown. Other errors are possible too, and depend on what kind of filesystem the file is on.<p>
 
1596
<dl compact><dt><b>Parameters:</b></dt><dd>
 
1597
  <table border="0" cellspacing="2" cellpadding="0">
 
1598
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>An optional entity tag for the current Glib::File. </td></tr>
 
1599
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td><code>true</code> if a backup should be created. </td></tr>
 
1600
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
 
1601
  </table>
 
1602
</dl>
 
1603
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a>. </dd></dl>
 
1604
 
 
1605
</div>
 
1606
</div><p>
 
1607
<a class="anchor" name="1e3dfb193e8f2ab69e24c4370de5335a"></a><!-- doxytag: member="Gio::File::append_to_async" ref="1e3dfb193e8f2ab69e24c4370de5335a" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileCreateFlags flags=FILE_CREATE_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
 
1608
<div class="memitem">
 
1609
<div class="memproto">
 
1610
      <table class="memname">
 
1611
        <tr>
 
1612
          <td class="memname">void Gio::File::append_to_async           </td>
 
1613
          <td>(</td>
 
1614
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
1615
          <td class="paramname"> <em>slot</em>, </td>
 
1616
        </tr>
 
1617
        <tr>
 
1618
          <td class="paramkey"></td>
 
1619
          <td></td>
 
1620
          <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>
 
1621
          <td class="paramname"> <em>cancellable</em>, </td>
 
1622
        </tr>
 
1623
        <tr>
 
1624
          <td class="paramkey"></td>
 
1625
          <td></td>
 
1626
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
 
1627
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code>, </td>
 
1628
        </tr>
 
1629
        <tr>
 
1630
          <td class="paramkey"></td>
 
1631
          <td></td>
 
1632
          <td class="paramtype">int&nbsp;</td>
 
1633
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
 
1634
        </tr>
 
1635
        <tr>
 
1636
          <td></td>
 
1637
          <td>)</td>
 
1638
          <td></td><td></td><td></td>
 
1639
        </tr>
 
1640
      </table>
 
1641
</div>
 
1642
<div class="memdoc">
 
1643
 
 
1644
<p>
 
1645
Asynchronously opens the file for appending. 
 
1646
<p>
 
1647
For more details, see <a class="el" href="classGio_1_1File.html#91c93ee71eee738690cb551d11df9528" title="Gets an output stream for appending data to the file.">append_to()</a> which is the synchronous version of this call.<p>
 
1648
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#cb1f2d32055b8da274ea241c69487dc6" title="Finishes an asynchronous file append operation started with g_file_append_to_async()...">append_to_finish()</a> to get the result of the operation. <dl compact><dt><b>Parameters:</b></dt><dd>
 
1649
  <table border="0" cellspacing="2" cellpadding="0">
 
1650
    <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>
 
1651
    <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>
 
1652
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>a set of FileCreateFlags. </td></tr>
 
1653
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
 
1654
  </table>
 
1655
</dl>
 
1656
 
 
1657
</div>
 
1658
</div><p>
 
1659
<a class="anchor" name="bff3163e9bf8d8208cd0c0e568b777de"></a><!-- doxytag: member="Gio::File::append_to_async" ref="bff3163e9bf8d8208cd0c0e568b777de" args="(const SlotAsyncReady &amp;slot, FileCreateFlags flags=FILE_CREATE_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
 
1660
<div class="memitem">
 
1661
<div class="memproto">
 
1662
      <table class="memname">
 
1663
        <tr>
 
1664
          <td class="memname">void Gio::File::append_to_async           </td>
 
1665
          <td>(</td>
 
1666
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
1667
          <td class="paramname"> <em>slot</em>, </td>
 
1668
        </tr>
 
1669
        <tr>
 
1670
          <td class="paramkey"></td>
 
1671
          <td></td>
 
1672
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
 
1673
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code>, </td>
 
1674
        </tr>
 
1675
        <tr>
 
1676
          <td class="paramkey"></td>
 
1677
          <td></td>
 
1678
          <td class="paramtype">int&nbsp;</td>
 
1679
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
 
1680
        </tr>
 
1681
        <tr>
 
1682
          <td></td>
 
1683
          <td>)</td>
 
1684
          <td></td><td></td><td></td>
 
1685
        </tr>
 
1686
      </table>
 
1687
</div>
 
1688
<div class="memdoc">
 
1689
 
 
1690
<p>
 
1691
Asynchronously opens the file for appending. 
 
1692
<p>
 
1693
For more details, see <a class="el" href="classGio_1_1File.html#91c93ee71eee738690cb551d11df9528" title="Gets an output stream for appending data to the file.">append_to()</a> which is the synchronous version of this call.<p>
 
1694
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#cb1f2d32055b8da274ea241c69487dc6" title="Finishes an asynchronous file append operation started with g_file_append_to_async()...">append_to_finish()</a> to get the result of the operation. <dl compact><dt><b>Parameters:</b></dt><dd>
 
1695
  <table border="0" cellspacing="2" cellpadding="0">
 
1696
    <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>
 
1697
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>a set of FileCreateFlags. </td></tr>
 
1698
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
 
1699
  </table>
 
1700
</dl>
 
1701
 
 
1702
</div>
 
1703
</div><p>
 
1704
<a class="anchor" name="cb1f2d32055b8da274ea241c69487dc6"></a><!-- doxytag: member="Gio::File::append_to_finish" ref="cb1f2d32055b8da274ea241c69487dc6" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
 
1705
<div class="memitem">
 
1706
<div class="memproto">
 
1707
      <table class="memname">
 
1708
        <tr>
 
1709
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileOutputStream.html">FileOutputStream</a>&gt; Gio::File::append_to_finish           </td>
 
1710
          <td>(</td>
 
1711
          <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>
 
1712
          <td class="paramname"> <em>result</em>          </td>
 
1713
          <td>&nbsp;)&nbsp;</td>
 
1714
          <td></td>
 
1715
        </tr>
 
1716
      </table>
 
1717
</div>
 
1718
<div class="memdoc">
 
1719
 
 
1720
<p>
 
1721
Finishes an asynchronous file append operation started with g_file_append_to_async(). 
 
1722
<p>
 
1723
<dl compact><dt><b>Parameters:</b></dt><dd>
 
1724
  <table border="0" cellspacing="2" cellpadding="0">
 
1725
    <tr><td valign="top"></td><td valign="top"><em>res</em>&nbsp;</td><td><a class="el" href="classGio_1_1AsyncResult.html" title="Provides a base class for implementing asynchronous function results.">AsyncResult</a>. </td></tr>
 
1726
  </table>
 
1727
</dl>
 
1728
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A valid <a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a> or <code>0</code> on error. Free the returned object with Glib::object_unref(). </dd></dl>
 
1729
 
 
1730
</div>
 
1731
</div><p>
 
1732
<a class="anchor" name="e0c42446d37aa466173965b7db1a2053"></a><!-- doxytag: member="Gio::File::create_file_async" ref="e0c42446d37aa466173965b7db1a2053" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileCreateFlags flags=FILE_CREATE_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
 
1733
<div class="memitem">
 
1734
<div class="memproto">
 
1735
      <table class="memname">
 
1736
        <tr>
 
1737
          <td class="memname">void Gio::File::create_file_async           </td>
 
1738
          <td>(</td>
 
1739
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
1740
          <td class="paramname"> <em>slot</em>, </td>
 
1741
        </tr>
 
1742
        <tr>
 
1743
          <td class="paramkey"></td>
 
1744
          <td></td>
 
1745
          <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>
 
1746
          <td class="paramname"> <em>cancellable</em>, </td>
 
1747
        </tr>
 
1748
        <tr>
 
1749
          <td class="paramkey"></td>
 
1750
          <td></td>
 
1751
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
 
1752
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code>, </td>
 
1753
        </tr>
 
1754
        <tr>
 
1755
          <td class="paramkey"></td>
 
1756
          <td></td>
 
1757
          <td class="paramtype">int&nbsp;</td>
 
1758
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
 
1759
        </tr>
 
1760
        <tr>
 
1761
          <td></td>
 
1762
          <td>)</td>
 
1763
          <td></td><td></td><td></td>
 
1764
        </tr>
 
1765
      </table>
 
1766
</div>
 
1767
<div class="memdoc">
 
1768
 
 
1769
<p>
 
1770
Asynchronously creates a new file and returns an output stream for writing to it. 
 
1771
<p>
 
1772
The file must not already exist. For more details, see <a class="el" href="classGio_1_1File.html#86258e11b2884422819d051c3cfd07a2" title="Creates a new file and returns an output stream for writing to it.">create_file()</a> which is the synchronous version of this call.<p>
 
1773
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#622b9f7aeaebe2ac53df0574c9c4211a" title="Finishes an asynchronous file create operation started with g_file_create_async()...">create_file_finish()</a> to get the result of the operation.<p>
 
1774
<dl compact><dt><b>Parameters:</b></dt><dd>
 
1775
  <table border="0" cellspacing="2" cellpadding="0">
 
1776
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>a set of FileCreateFlags. </td></tr>
 
1777
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
 
1778
    <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>
 
1779
    <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>
 
1780
  </table>
 
1781
</dl>
 
1782
 
 
1783
</div>
 
1784
</div><p>
 
1785
<a class="anchor" name="3fe6ed015f3d2bb72aa7aceed8dc7ca1"></a><!-- doxytag: member="Gio::File::create_file_async" ref="3fe6ed015f3d2bb72aa7aceed8dc7ca1" args="(const SlotAsyncReady &amp;slot, FileCreateFlags flags=FILE_CREATE_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
 
1786
<div class="memitem">
 
1787
<div class="memproto">
 
1788
      <table class="memname">
 
1789
        <tr>
 
1790
          <td class="memname">void Gio::File::create_file_async           </td>
 
1791
          <td>(</td>
 
1792
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
1793
          <td class="paramname"> <em>slot</em>, </td>
 
1794
        </tr>
 
1795
        <tr>
 
1796
          <td class="paramkey"></td>
 
1797
          <td></td>
 
1798
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
 
1799
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code>, </td>
 
1800
        </tr>
 
1801
        <tr>
 
1802
          <td class="paramkey"></td>
 
1803
          <td></td>
 
1804
          <td class="paramtype">int&nbsp;</td>
 
1805
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
 
1806
        </tr>
 
1807
        <tr>
 
1808
          <td></td>
 
1809
          <td>)</td>
 
1810
          <td></td><td></td><td></td>
 
1811
        </tr>
 
1812
      </table>
 
1813
</div>
 
1814
<div class="memdoc">
 
1815
 
 
1816
<p>
 
1817
Asynchronously creates a new file and returns an output stream for writing to it. 
 
1818
<p>
 
1819
The file must not already exist. For more details, see <a class="el" href="classGio_1_1File.html#86258e11b2884422819d051c3cfd07a2" title="Creates a new file and returns an output stream for writing to it.">create_file()</a> which is the synchronous version of this call.<p>
 
1820
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#622b9f7aeaebe2ac53df0574c9c4211a" title="Finishes an asynchronous file create operation started with g_file_create_async()...">create_file_finish()</a> to get the result of the operation.<p>
 
1821
<dl compact><dt><b>Parameters:</b></dt><dd>
 
1822
  <table border="0" cellspacing="2" cellpadding="0">
 
1823
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>a set of FileCreateFlags. </td></tr>
 
1824
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
 
1825
    <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>
 
1826
  </table>
 
1827
</dl>
 
1828
 
 
1829
</div>
 
1830
</div><p>
 
1831
<a class="anchor" name="622b9f7aeaebe2ac53df0574c9c4211a"></a><!-- doxytag: member="Gio::File::create_file_finish" ref="622b9f7aeaebe2ac53df0574c9c4211a" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
 
1832
<div class="memitem">
 
1833
<div class="memproto">
 
1834
      <table class="memname">
 
1835
        <tr>
 
1836
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileOutputStream.html">FileOutputStream</a>&gt; Gio::File::create_file_finish           </td>
 
1837
          <td>(</td>
 
1838
          <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>
 
1839
          <td class="paramname"> <em>result</em>          </td>
 
1840
          <td>&nbsp;)&nbsp;</td>
 
1841
          <td></td>
 
1842
        </tr>
 
1843
      </table>
 
1844
</div>
 
1845
<div class="memdoc">
 
1846
 
 
1847
<p>
 
1848
Finishes an asynchronous file create operation started with g_file_create_async(). 
 
1849
<p>
 
1850
<dl compact><dt><b>Parameters:</b></dt><dd>
 
1851
  <table border="0" cellspacing="2" cellpadding="0">
 
1852
    <tr><td valign="top"></td><td valign="top"><em>res</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>
 
1853
  </table>
 
1854
</dl>
 
1855
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a> or <code>0</code> on error. Free the returned object with Glib::object_unref(). </dd></dl>
 
1856
 
 
1857
</div>
 
1858
</div><p>
 
1859
<a class="anchor" name="d777cdaa404a6a668ee8d520299687ce"></a><!-- doxytag: member="Gio::File::replace_async" ref="d777cdaa404a6a668ee8d520299687ce" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, const std::string &amp;etag=std::string(), bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
 
1860
<div class="memitem">
 
1861
<div class="memproto">
 
1862
      <table class="memname">
 
1863
        <tr>
 
1864
          <td class="memname">void Gio::File::replace_async           </td>
 
1865
          <td>(</td>
 
1866
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
1867
          <td class="paramname"> <em>slot</em>, </td>
 
1868
        </tr>
 
1869
        <tr>
 
1870
          <td class="paramkey"></td>
 
1871
          <td></td>
 
1872
          <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>
 
1873
          <td class="paramname"> <em>cancellable</em>, </td>
 
1874
        </tr>
 
1875
        <tr>
 
1876
          <td class="paramkey"></td>
 
1877
          <td></td>
 
1878
          <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>
 
1879
          <td class="paramname"> <em>etag</em> = <code><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>()</code>, </td>
 
1880
        </tr>
 
1881
        <tr>
 
1882
          <td class="paramkey"></td>
 
1883
          <td></td>
 
1884
          <td class="paramtype">bool&nbsp;</td>
 
1885
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
 
1886
        </tr>
 
1887
        <tr>
 
1888
          <td class="paramkey"></td>
 
1889
          <td></td>
 
1890
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
 
1891
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code>, </td>
 
1892
        </tr>
 
1893
        <tr>
 
1894
          <td class="paramkey"></td>
 
1895
          <td></td>
 
1896
          <td class="paramtype">int&nbsp;</td>
 
1897
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
 
1898
        </tr>
 
1899
        <tr>
 
1900
          <td></td>
 
1901
          <td>)</td>
 
1902
          <td></td><td></td><td></td>
 
1903
        </tr>
 
1904
      </table>
 
1905
</div>
 
1906
<div class="memdoc">
 
1907
 
 
1908
<p>
 
1909
Asyncronously overwrites the file, replacing the contents, possibly creating a backup copy of the file first. 
 
1910
<p>
 
1911
For more details, see <a class="el" href="classGio_1_1File.html#d7cf0360096504e40f799fde5cc8e9de" title="Returns an output stream for overwriting the file, possibly creating a backup copy...">replace()</a> which is the synchronous version of this call. When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#b28557d592f2c53df618728cf865e65e" title="Finishes an asynchronous file replace operation started with g_file_replace_async()...">replace_finish()</a> to get the result of the operation.<p>
 
1912
<dl compact><dt><b>Parameters:</b></dt><dd>
 
1913
  <table border="0" cellspacing="2" cellpadding="0">
 
1914
    <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>
 
1915
    <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>
 
1916
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>An entity tag for the current <a class="el" href="classGio_1_1File.html" title="File and directory handling.">Gio::File</a>. </td></tr>
 
1917
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td>true if a backup of the existing file should be made. </td></tr>
 
1918
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
 
1919
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
 
1920
  </table>
 
1921
</dl>
 
1922
 
 
1923
</div>
 
1924
</div><p>
 
1925
<a class="anchor" name="e51e51a2e3a45da4324230b4d5401a58"></a><!-- doxytag: member="Gio::File::replace_async" ref="e51e51a2e3a45da4324230b4d5401a58" args="(const SlotAsyncReady &amp;slot, const std::string &amp;etag=std::string(), bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
 
1926
<div class="memitem">
 
1927
<div class="memproto">
 
1928
      <table class="memname">
 
1929
        <tr>
 
1930
          <td class="memname">void Gio::File::replace_async           </td>
 
1931
          <td>(</td>
 
1932
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
1933
          <td class="paramname"> <em>slot</em>, </td>
 
1934
        </tr>
 
1935
        <tr>
 
1936
          <td class="paramkey"></td>
 
1937
          <td></td>
 
1938
          <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>
 
1939
          <td class="paramname"> <em>etag</em> = <code><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>()</code>, </td>
 
1940
        </tr>
 
1941
        <tr>
 
1942
          <td class="paramkey"></td>
 
1943
          <td></td>
 
1944
          <td class="paramtype">bool&nbsp;</td>
 
1945
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
 
1946
        </tr>
 
1947
        <tr>
 
1948
          <td class="paramkey"></td>
 
1949
          <td></td>
 
1950
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
 
1951
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code>, </td>
 
1952
        </tr>
 
1953
        <tr>
 
1954
          <td class="paramkey"></td>
 
1955
          <td></td>
 
1956
          <td class="paramtype">int&nbsp;</td>
 
1957
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
 
1958
        </tr>
 
1959
        <tr>
 
1960
          <td></td>
 
1961
          <td>)</td>
 
1962
          <td></td><td></td><td></td>
 
1963
        </tr>
 
1964
      </table>
 
1965
</div>
 
1966
<div class="memdoc">
 
1967
 
 
1968
<p>
 
1969
Asyncronously overwrites the file, replacing the contents, possibly creating a backup copy of the file first. 
 
1970
<p>
 
1971
For more details, see <a class="el" href="classGio_1_1File.html#d7cf0360096504e40f799fde5cc8e9de" title="Returns an output stream for overwriting the file, possibly creating a backup copy...">replace()</a> which is the synchronous version of this call. When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#b28557d592f2c53df618728cf865e65e" title="Finishes an asynchronous file replace operation started with g_file_replace_async()...">replace_finish()</a> to get the result of the operation.<p>
 
1972
<dl compact><dt><b>Parameters:</b></dt><dd>
 
1973
  <table border="0" cellspacing="2" cellpadding="0">
 
1974
    <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>
 
1975
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>An entity tag for the current <a class="el" href="classGio_1_1File.html" title="File and directory handling.">Gio::File</a>. </td></tr>
 
1976
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td>true if a backup of the existing file should be made. </td></tr>
 
1977
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
 
1978
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
 
1979
  </table>
 
1980
</dl>
 
1981
 
 
1982
</div>
 
1983
</div><p>
 
1984
<a class="anchor" name="b28557d592f2c53df618728cf865e65e"></a><!-- doxytag: member="Gio::File::replace_finish" ref="b28557d592f2c53df618728cf865e65e" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
 
1985
<div class="memitem">
 
1986
<div class="memproto">
 
1987
      <table class="memname">
 
1988
        <tr>
 
1989
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileOutputStream.html">FileOutputStream</a>&gt; Gio::File::replace_finish           </td>
 
1990
          <td>(</td>
 
1991
          <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>
 
1992
          <td class="paramname"> <em>result</em>          </td>
 
1993
          <td>&nbsp;)&nbsp;</td>
 
1994
          <td></td>
 
1995
        </tr>
 
1996
      </table>
 
1997
</div>
 
1998
<div class="memdoc">
 
1999
 
 
2000
<p>
 
2001
Finishes an asynchronous file replace operation started with g_file_replace_async(). 
 
2002
<p>
 
2003
<dl compact><dt><b>Parameters:</b></dt><dd>
 
2004
  <table border="0" cellspacing="2" cellpadding="0">
 
2005
    <tr><td valign="top"></td><td valign="top"><em>res</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>
 
2006
  </table>
 
2007
</dl>
 
2008
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a>, or <code>0</code> on error. Free the returned object with Glib::object_unref(). </dd></dl>
 
2009
 
 
2010
</div>
 
2011
</div><p>
 
2012
<a class="anchor" name="db25ffdbe571d33e89c9503fe9a20dcd"></a><!-- doxytag: member="Gio::File::query_info" ref="db25ffdbe571d33e89c9503fe9a20dcd" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, const std::string &amp;attributes=&quot;*&quot;, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE) const " -->
 
2013
<div class="memitem">
 
2014
<div class="memproto">
 
2015
      <table class="memname">
 
2016
        <tr>
 
2017
          <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::File::query_info           </td>
 
2018
          <td>(</td>
 
2019
          <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>
 
2020
          <td class="paramname"> <em>cancellable</em>, </td>
 
2021
        </tr>
 
2022
        <tr>
 
2023
          <td class="paramkey"></td>
 
2024
          <td></td>
 
2025
          <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>
 
2026
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code>, </td>
 
2027
        </tr>
 
2028
        <tr>
 
2029
          <td class="paramkey"></td>
 
2030
          <td></td>
 
2031
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
2032
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code></td><td>&nbsp;</td>
 
2033
        </tr>
 
2034
        <tr>
 
2035
          <td></td>
 
2036
          <td>)</td>
 
2037
          <td></td><td></td><td> const</td>
 
2038
        </tr>
 
2039
      </table>
 
2040
</div>
 
2041
<div class="memdoc">
 
2042
 
 
2043
<p>
 
2044
Gets the requested information about the file. 
 
2045
<p>
 
2046
The result is a <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> object that contains key-value attributes (such as the type or size of the file).<p>
 
2047
The <em>attribute</em> value is a string that specifies the file attributes that should be gathered. It is not an error if it's not possible to read a particular requested attribute from a file - it just won't be set. <em>attribute</em> should be a comma-separated list of attribute or attribute wildcards. The wildcard "*" means all attributes, and a wildcard like "standard::*" means all attributes in the standard namespace. An example attribute query be "standard::*,owner::user". The standard attributes are available as defines, like G_FILE_ATTRIBUTE_STANDARD_NAME.<p>
 
2048
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>
 
2049
For symlinks, normally the information about the target of the symlink is returned, rather than information about the symlink itself. However if you pass FILE_QUERY_INFO_NOFOLLOW_SYMLINKS in <em>flags</em> the information about the symlink itself will be returned. Also, for symlinks that point to non-existing files the information about the symlink itself will be returned.<p>
 
2050
If the file does not exist, a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_FOUND will be thrown. Other errors are possible too, and depend on what kind of filesystem the file is on.<p>
 
2051
<dl compact><dt><b>Parameters:</b></dt><dd>
 
2052
  <table border="0" cellspacing="2" cellpadding="0">
 
2053
    <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>
 
2054
    <tr><td valign="top"></td><td valign="top"><em>attributes,:</em>&nbsp;</td><td>An attribute query string. </td></tr>
 
2055
    <tr><td valign="top"></td><td valign="top"><em>flags,:</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
 
2056
  </table>
 
2057
</dl>
 
2058
<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 file, or an empty RefPtr on error. </dd></dl>
 
2059
 
 
2060
</div>
 
2061
</div><p>
 
2062
<a class="anchor" name="4e4b9c07ade255b12e2b43c38c3aba90"></a><!-- doxytag: member="Gio::File::query_info" ref="4e4b9c07ade255b12e2b43c38c3aba90" args="(const std::string &amp;attributes=&quot;*&quot;, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE) const " -->
 
2063
<div class="memitem">
 
2064
<div class="memproto">
 
2065
      <table class="memname">
 
2066
        <tr>
 
2067
          <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::File::query_info           </td>
 
2068
          <td>(</td>
 
2069
          <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>
 
2070
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code>, </td>
 
2071
        </tr>
 
2072
        <tr>
 
2073
          <td class="paramkey"></td>
 
2074
          <td></td>
 
2075
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
2076
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code></td><td>&nbsp;</td>
 
2077
        </tr>
 
2078
        <tr>
 
2079
          <td></td>
 
2080
          <td>)</td>
 
2081
          <td></td><td></td><td> const</td>
 
2082
        </tr>
 
2083
      </table>
 
2084
</div>
 
2085
<div class="memdoc">
 
2086
 
 
2087
<p>
 
2088
Gets the requested information about the file. 
 
2089
<p>
 
2090
The result is a <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> object that contains key-value attributes (such as the type or size of the file).<p>
 
2091
The <em>attribute</em> value is a string that specifies the file attributes that should be gathered. It is not an error if it's not possible to read a particular requested attribute from a file - it just won't be set. <em>attribute</em> should be a comma-separated list of attribute or attribute wildcards. The wildcard "*" means all attributes, and a wildcard like "standard::*" means all attributes in the standard namespace. An example attribute query be "standard::*,owner::user". The standard attributes are available as defines, like G_FILE_ATTRIBUTE_STANDARD_NAME.<p>
 
2092
For symlinks, normally the information about the target of the symlink is returned, rather than information about the symlink itself. However if you pass FILE_QUERY_INFO_NOFOLLOW_SYMLINKS in <em>flags</em> the information about the symlink itself will be returned. Also, for symlinks that point to non-existing files the information about the symlink itself will be returned.<p>
 
2093
If the file does not exist, a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_FOUND will be thrown. Other errors are possible too, and depend on what kind of filesystem the file is on.<p>
 
2094
<dl compact><dt><b>Parameters:</b></dt><dd>
 
2095
  <table border="0" cellspacing="2" cellpadding="0">
 
2096
    <tr><td valign="top"></td><td valign="top"><em>attributes,:</em>&nbsp;</td><td>An attribute query string. </td></tr>
 
2097
    <tr><td valign="top"></td><td valign="top"><em>flags,:</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
 
2098
  </table>
 
2099
</dl>
 
2100
<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 file, or an empty RefPtr on error. </dd></dl>
 
2101
 
 
2102
</div>
 
2103
</div><p>
 
2104
<a class="anchor" name="d8b0a75e0afdb5f6874ea5e304d55ea8"></a><!-- doxytag: member="Gio::File::query_exists" ref="d8b0a75e0afdb5f6874ea5e304d55ea8" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable) const " -->
 
2105
<div class="memitem">
 
2106
<div class="memproto">
 
2107
      <table class="memname">
 
2108
        <tr>
 
2109
          <td class="memname">bool Gio::File::query_exists           </td>
 
2110
          <td>(</td>
 
2111
          <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>
 
2112
          <td class="paramname"> <em>cancellable</em>          </td>
 
2113
          <td>&nbsp;)&nbsp;</td>
 
2114
          <td> const</td>
 
2115
        </tr>
 
2116
      </table>
 
2117
</div>
 
2118
<div class="memdoc">
 
2119
 
 
2120
<p>
 
2121
Utility function to check if a particular file exists. 
 
2122
<p>
 
2123
This is implemented using <a class="el" href="classGio_1_1File.html#db25ffdbe571d33e89c9503fe9a20dcd" title="Gets the requested information about the file.">query_info()</a> and as such does blocking I/O.<p>
 
2124
Note that in many cases it is racy to first check for file existence and then execute something based on the outcome of that, because the file might have been created or removed in between the operations. The general approach to handling that is to not check, but just do the operation and handle the errors as they come.<p>
 
2125
As an example of race-free checking, take the case of reading a file, and if it doesn't exist, creating it. There are two racy versions: read it, and on error create it; and: check if it exists, if not create it. These can both result in two processes creating the file (with perhaps a partially written file as the result). The correct approach is to always try to create the file with File::create() which will either atomically create the file or fail with a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> exception with EXISTS.<p>
 
2126
However, in many cases an existence check is useful in a user interface, for instance to make a menu item sensitive/insensitive, so that you don't have to fool users that something is possible and then just show and error dialog. If you do this, you should make sure to also handle the errors that can happen due to races when you execute the operation. <dl compact><dt><b>Parameters:</b></dt><dd>
 
2127
  <table border="0" cellspacing="2" cellpadding="0">
 
2128
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td>Optional <a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object, <code>0</code> to ignore. </td></tr>
 
2129
  </table>
 
2130
</dl>
 
2131
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the file exists (and can be detected without error), <code>false</code> otherwise (or if cancelled). </dd></dl>
3840
2132
 
3841
2133
</div>
3842
2134
</div><p>
3866
2158
 
3867
2159
</div>
3868
2160
</div><p>
3869
 
<a class="anchor" name="d8b0a75e0afdb5f6874ea5e304d55ea8"></a><!-- doxytag: member="Gio::File::query_exists" ref="d8b0a75e0afdb5f6874ea5e304d55ea8" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable) const " -->
3870
 
<div class="memitem">
3871
 
<div class="memproto">
3872
 
      <table class="memname">
3873
 
        <tr>
3874
 
          <td class="memname">bool Gio::File::query_exists           </td>
3875
 
          <td>(</td>
3876
 
          <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>
3877
 
          <td class="paramname"> <em>cancellable</em>          </td>
3878
 
          <td>&nbsp;)&nbsp;</td>
3879
 
          <td> const</td>
3880
 
        </tr>
3881
 
      </table>
3882
 
</div>
3883
 
<div class="memdoc">
3884
 
 
3885
 
<p>
3886
 
Utility function to check if a particular file exists. 
3887
 
<p>
3888
 
This is implemented using <a class="el" href="classGio_1_1File.html#db25ffdbe571d33e89c9503fe9a20dcd" title="Gets the requested information about the file.">query_info()</a> and as such does blocking I/O.<p>
3889
 
Note that in many cases it is racy to first check for file existence and then execute something based on the outcome of that, because the file might have been created or removed in between the operations. The general approach to handling that is to not check, but just do the operation and handle the errors as they come.<p>
3890
 
As an example of race-free checking, take the case of reading a file, and if it doesn't exist, creating it. There are two racy versions: read it, and on error create it; and: check if it exists, if not create it. These can both result in two processes creating the file (with perhaps a partially written file as the result). The correct approach is to always try to create the file with File::create() which will either atomically create the file or fail with a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> exception with EXISTS.<p>
3891
 
However, in many cases an existence check is useful in a user interface, for instance to make a menu item sensitive/insensitive, so that you don't have to fool users that something is possible and then just show and error dialog. If you do this, you should make sure to also handle the errors that can happen due to races when you execute the operation. <dl compact><dt><b>Parameters:</b></dt><dd>
3892
 
  <table border="0" cellspacing="2" cellpadding="0">
3893
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td>Optional <a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object, <code>0</code> to ignore. </td></tr>
3894
 
  </table>
3895
 
</dl>
3896
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the file exists (and can be detected without error), <code>false</code> otherwise (or if cancelled). </dd></dl>
3897
 
 
3898
 
</div>
3899
 
</div><p>
3900
 
<a class="anchor" name="691a9de5512b870bf358a9b0d292e146"></a><!-- doxytag: member="Gio::File::query_file_type" ref="691a9de5512b870bf358a9b0d292e146" args="(FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE) const " -->
3901
 
<div class="memitem">
3902
 
<div class="memproto">
3903
 
      <table class="memname">
3904
 
        <tr>
3905
 
          <td class="memname"><a class="el" href="group__giommEnums.html#g7dcba95023d74c47bba3fd0a07f8824c">FileType</a> Gio::File::query_file_type           </td>
3906
 
          <td>(</td>
3907
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
3908
 
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code>          </td>
3909
 
          <td>&nbsp;)&nbsp;</td>
3910
 
          <td> const</td>
3911
 
        </tr>
3912
 
      </table>
3913
 
</div>
3914
 
<div class="memdoc">
3915
 
 
3916
 
<p>
3917
 
Utility function to inspect the GFileType of a file. 
3918
 
<p>
3919
 
This is implemented using <a class="el" href="classGio_1_1File.html#db25ffdbe571d33e89c9503fe9a20dcd" title="Gets the requested information about the file.">query_info()</a> and as such does blocking I/O.<p>
3920
 
The primary use case of this method is to check if a file is a regular file, directory, or symlink.<p>
3921
 
<dl compact><dt><b>Parameters:</b></dt><dd>
3922
 
  <table border="0" cellspacing="2" cellpadding="0">
3923
 
    <tr><td valign="top"></td><td valign="top"><em>flags,:</em>&nbsp;</td><td>a set of FileQueryInfoFlags passed to <a class="el" href="classGio_1_1File.html#db25ffdbe571d33e89c9503fe9a20dcd" title="Gets the requested information about the file.">query_info()</a>.  The FileType of the file, or FILE_TYPE_UNKNOWN if the file does not exist.</td></tr>
3924
 
  </table>
3925
 
</dl>
3926
 
<dl compact><dt><b><a class="el" href="newin2p18s.html#_newin2p18s000016">Since glibmm 2.18:</a></b></dt><dd></dd></dl>
3927
 
 
3928
 
</div>
3929
 
</div><p>
3930
2161
<a class="anchor" name="a27c5b271c8f7667ce117cfc6118262e"></a><!-- doxytag: member="Gio::File::query_file_type" ref="a27c5b271c8f7667ce117cfc6118262e" args="(FileQueryInfoFlags flags, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable) const " -->
3931
2162
<div class="memitem">
3932
2163
<div class="memproto">
3967
2198
 
3968
2199
</div>
3969
2200
</div><p>
 
2201
<a class="anchor" name="691a9de5512b870bf358a9b0d292e146"></a><!-- doxytag: member="Gio::File::query_file_type" ref="691a9de5512b870bf358a9b0d292e146" args="(FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE) const " -->
 
2202
<div class="memitem">
 
2203
<div class="memproto">
 
2204
      <table class="memname">
 
2205
        <tr>
 
2206
          <td class="memname"><a class="el" href="group__giommEnums.html#g7dcba95023d74c47bba3fd0a07f8824c">FileType</a> Gio::File::query_file_type           </td>
 
2207
          <td>(</td>
 
2208
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
2209
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code>          </td>
 
2210
          <td>&nbsp;)&nbsp;</td>
 
2211
          <td> const</td>
 
2212
        </tr>
 
2213
      </table>
 
2214
</div>
 
2215
<div class="memdoc">
 
2216
 
 
2217
<p>
 
2218
Utility function to inspect the GFileType of a file. 
 
2219
<p>
 
2220
This is implemented using <a class="el" href="classGio_1_1File.html#db25ffdbe571d33e89c9503fe9a20dcd" title="Gets the requested information about the file.">query_info()</a> and as such does blocking I/O.<p>
 
2221
The primary use case of this method is to check if a file is a regular file, directory, or symlink.<p>
 
2222
<dl compact><dt><b>Parameters:</b></dt><dd>
 
2223
  <table border="0" cellspacing="2" cellpadding="0">
 
2224
    <tr><td valign="top"></td><td valign="top"><em>flags,:</em>&nbsp;</td><td>a set of FileQueryInfoFlags passed to <a class="el" href="classGio_1_1File.html#db25ffdbe571d33e89c9503fe9a20dcd" title="Gets the requested information about the file.">query_info()</a>.  The FileType of the file, or FILE_TYPE_UNKNOWN if the file does not exist.</td></tr>
 
2225
  </table>
 
2226
</dl>
 
2227
<dl compact><dt><b><a class="el" href="newin2p18s.html#_newin2p18s000016">Since glibmm 2.18:</a></b></dt><dd></dd></dl>
 
2228
 
 
2229
</div>
 
2230
</div><p>
 
2231
<a class="anchor" name="7bd60e7864f8954c35e3b0891058e61c"></a><!-- doxytag: member="Gio::File::query_info_async" ref="7bd60e7864f8954c35e3b0891058e61c" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, const std::string &amp;attributes=&quot;*&quot;, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE, int io_priority=Glib::PRIORITY_DEFAULT) const " -->
 
2232
<div class="memitem">
 
2233
<div class="memproto">
 
2234
      <table class="memname">
 
2235
        <tr>
 
2236
          <td class="memname">void Gio::File::query_info_async           </td>
 
2237
          <td>(</td>
 
2238
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
2239
          <td class="paramname"> <em>slot</em>, </td>
 
2240
        </tr>
 
2241
        <tr>
 
2242
          <td class="paramkey"></td>
 
2243
          <td></td>
 
2244
          <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>
 
2245
          <td class="paramname"> <em>cancellable</em>, </td>
 
2246
        </tr>
 
2247
        <tr>
 
2248
          <td class="paramkey"></td>
 
2249
          <td></td>
 
2250
          <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>
 
2251
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code>, </td>
 
2252
        </tr>
 
2253
        <tr>
 
2254
          <td class="paramkey"></td>
 
2255
          <td></td>
 
2256
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
2257
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code>, </td>
 
2258
        </tr>
 
2259
        <tr>
 
2260
          <td class="paramkey"></td>
 
2261
          <td></td>
 
2262
          <td class="paramtype">int&nbsp;</td>
 
2263
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
 
2264
        </tr>
 
2265
        <tr>
 
2266
          <td></td>
 
2267
          <td>)</td>
 
2268
          <td></td><td></td><td> const</td>
 
2269
        </tr>
 
2270
      </table>
 
2271
</div>
 
2272
<div class="memdoc">
 
2273
 
 
2274
<p>
 
2275
Asynchronously gets the requested information about specified file. 
 
2276
<p>
 
2277
The result is a <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> object that contains key-value attributes (such as type or size for the file).<p>
 
2278
For more details, see <a class="el" href="classGio_1_1File.html#db25ffdbe571d33e89c9503fe9a20dcd" title="Gets the requested information about the file.">query_info()</a> which is the synchronous version of this call. When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#fd4ffc3630b41754c177658f2e745357" title="Finishes an asynchronous file info query.">query_info_finish()</a> to get the result of the operation.<p>
 
2279
<dl compact><dt><b>Parameters:</b></dt><dd>
 
2280
  <table border="0" cellspacing="2" cellpadding="0">
 
2281
    <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>
 
2282
    <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>
 
2283
    <tr><td valign="top"></td><td valign="top"><em>attributes</em>&nbsp;</td><td>An attribute query string. </td></tr>
 
2284
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
 
2285
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
 
2286
  </table>
 
2287
</dl>
 
2288
 
 
2289
</div>
 
2290
</div><p>
 
2291
<a class="anchor" name="fcad69d782a971802a8aa85125ac2c8c"></a><!-- doxytag: member="Gio::File::query_info_async" ref="fcad69d782a971802a8aa85125ac2c8c" args="(const SlotAsyncReady &amp;slot, const std::string &amp;attributes=&quot;*&quot;, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE, int io_priority=Glib::PRIORITY_DEFAULT) const " -->
 
2292
<div class="memitem">
 
2293
<div class="memproto">
 
2294
      <table class="memname">
 
2295
        <tr>
 
2296
          <td class="memname">void Gio::File::query_info_async           </td>
 
2297
          <td>(</td>
 
2298
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
2299
          <td class="paramname"> <em>slot</em>, </td>
 
2300
        </tr>
 
2301
        <tr>
 
2302
          <td class="paramkey"></td>
 
2303
          <td></td>
 
2304
          <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>
 
2305
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code>, </td>
 
2306
        </tr>
 
2307
        <tr>
 
2308
          <td class="paramkey"></td>
 
2309
          <td></td>
 
2310
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
2311
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code>, </td>
 
2312
        </tr>
 
2313
        <tr>
 
2314
          <td class="paramkey"></td>
 
2315
          <td></td>
 
2316
          <td class="paramtype">int&nbsp;</td>
 
2317
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
 
2318
        </tr>
 
2319
        <tr>
 
2320
          <td></td>
 
2321
          <td>)</td>
 
2322
          <td></td><td></td><td> const</td>
 
2323
        </tr>
 
2324
      </table>
 
2325
</div>
 
2326
<div class="memdoc">
 
2327
 
 
2328
<p>
 
2329
Asynchronously gets the requested information about specified file. 
 
2330
<p>
 
2331
The result is a <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> object that contains key-value attributes (such as type or size for the file).<p>
 
2332
For more details, see <a class="el" href="classGio_1_1File.html#db25ffdbe571d33e89c9503fe9a20dcd" title="Gets the requested information about the file.">query_info()</a> which is the synchronous version of this call. When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#fd4ffc3630b41754c177658f2e745357" title="Finishes an asynchronous file info query.">query_info_finish()</a> to get the result of the operation.<p>
 
2333
<dl compact><dt><b>Parameters:</b></dt><dd>
 
2334
  <table border="0" cellspacing="2" cellpadding="0">
 
2335
    <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>
 
2336
    <tr><td valign="top"></td><td valign="top"><em>attributes</em>&nbsp;</td><td>An attribute query string. </td></tr>
 
2337
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
 
2338
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
 
2339
  </table>
 
2340
</dl>
 
2341
 
 
2342
</div>
 
2343
</div><p>
 
2344
<a class="anchor" name="fd4ffc3630b41754c177658f2e745357"></a><!-- doxytag: member="Gio::File::query_info_finish" ref="fd4ffc3630b41754c177658f2e745357" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
 
2345
<div class="memitem">
 
2346
<div class="memproto">
 
2347
      <table class="memname">
 
2348
        <tr>
 
2349
          <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::File::query_info_finish           </td>
 
2350
          <td>(</td>
 
2351
          <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>
 
2352
          <td class="paramname"> <em>result</em>          </td>
 
2353
          <td>&nbsp;)&nbsp;</td>
 
2354
          <td></td>
 
2355
        </tr>
 
2356
      </table>
 
2357
</div>
 
2358
<div class="memdoc">
 
2359
 
 
2360
<p>
 
2361
Finishes an asynchronous file info query. 
 
2362
<p>
 
2363
See g_file_query_info_async(). <dl compact><dt><b>Parameters:</b></dt><dd>
 
2364
  <table border="0" cellspacing="2" cellpadding="0">
 
2365
    <tr><td valign="top"></td><td valign="top"><em>res</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>
 
2366
  </table>
 
2367
</dl>
 
2368
<dl class="return" compact><dt><b>Returns:</b></dt><dd><a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> for given <em>file</em> or <code>0</code> on error. Free the returned object with Glib::object_unref(). </dd></dl>
 
2369
 
 
2370
</div>
 
2371
</div><p>
 
2372
<a class="anchor" name="40486bc2f0c8758ef8a705b6b8b57e57"></a><!-- doxytag: member="Gio::File::query_filesystem_info" ref="40486bc2f0c8758ef8a705b6b8b57e57" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, const std::string &amp;attributes=&quot;*&quot;)" -->
 
2373
<div class="memitem">
 
2374
<div class="memproto">
 
2375
      <table class="memname">
 
2376
        <tr>
 
2377
          <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::File::query_filesystem_info           </td>
 
2378
          <td>(</td>
 
2379
          <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>
 
2380
          <td class="paramname"> <em>cancellable</em>, </td>
 
2381
        </tr>
 
2382
        <tr>
 
2383
          <td class="paramkey"></td>
 
2384
          <td></td>
 
2385
          <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>
 
2386
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code></td><td>&nbsp;</td>
 
2387
        </tr>
 
2388
        <tr>
 
2389
          <td></td>
 
2390
          <td>)</td>
 
2391
          <td></td><td></td><td></td>
 
2392
        </tr>
 
2393
      </table>
 
2394
</div>
 
2395
<div class="memdoc">
 
2396
 
 
2397
<p>
 
2398
Similar to <a class="el" href="classGio_1_1File.html#db25ffdbe571d33e89c9503fe9a20dcd" title="Gets the requested information about the file.">query_info()</a>, but obtains information about the filesystem the file is on, rather than the file itself. 
 
2399
<p>
 
2400
For instance the amount of space availible and the type of the filesystem.<p>
 
2401
The <em>attribute</em> value is a string that specifies the file attributes that should be gathered. It is not an error if its not possible to read a particular requested attribute from a file, it just won't be set. <em>attribute</em> should be a comma-separated list of attribute or attribute wildcards. The wildcard "*" means all attributes, and a wildcard like "fs:*" means all attributes in the fs namespace. The standard namespace for filesystem attributes is "fs". Common attributes of interest are FILE_ATTRIBUTE_FILESYSTEM_SIZE (the total size of the filesystem in bytes), FILE_ATTRIBUTE_FILESYSTEM_FREE (number of bytes availible), and FILE_ATTRIBUTE_FILESYSTEM_TYPE (type of the filesystem).<p>
 
2402
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>
 
2403
If the file does not exist, a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_FOUND will be thrown. Other errors are possible too, and depend on what kind of filesystem the file is on. <dl compact><dt><b>Parameters:</b></dt><dd>
 
2404
  <table border="0" cellspacing="2" cellpadding="0">
 
2405
    <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>
 
2406
    <tr><td valign="top"></td><td valign="top"><em>attributes</em>&nbsp;</td><td>An attribute query string. </td></tr>
 
2407
  </table>
 
2408
</dl>
 
2409
<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 if there was an error. </dd></dl>
 
2410
 
 
2411
</div>
 
2412
</div><p>
3970
2413
<a class="anchor" name="c737012f8df97d90e2447d94d30b817d"></a><!-- doxytag: member="Gio::File::query_filesystem_info" ref="c737012f8df97d90e2447d94d30b817d" args="(const std::string &amp;attributes=&quot;*&quot;)" -->
3971
2414
<div class="memitem">
3972
2415
<div class="memproto">
3997
2440
 
3998
2441
</div>
3999
2442
</div><p>
4000
 
<a class="anchor" name="40486bc2f0c8758ef8a705b6b8b57e57"></a><!-- doxytag: member="Gio::File::query_filesystem_info" ref="40486bc2f0c8758ef8a705b6b8b57e57" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, const std::string &amp;attributes=&quot;*&quot;)" -->
4001
 
<div class="memitem">
4002
 
<div class="memproto">
4003
 
      <table class="memname">
4004
 
        <tr>
4005
 
          <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::File::query_filesystem_info           </td>
4006
 
          <td>(</td>
 
2443
<a class="anchor" name="45b881926b8d58c49d3baa1f51f2ee5d"></a><!-- doxytag: member="Gio::File::find_enclosing_mount" ref="45b881926b8d58c49d3baa1f51f2ee5d" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
 
2444
<div class="memitem">
 
2445
<div class="memproto">
 
2446
      <table class="memname">
 
2447
        <tr>
 
2448
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1Mount.html">Mount</a>&gt; Gio::File::find_enclosing_mount           </td>
 
2449
          <td>(</td>
 
2450
          <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>
 
2451
          <td class="paramname"> <em>cancellable</em>          </td>
 
2452
          <td>&nbsp;)&nbsp;</td>
 
2453
          <td></td>
 
2454
        </tr>
 
2455
      </table>
 
2456
</div>
 
2457
<div class="memdoc">
 
2458
 
 
2459
<p>
 
2460
Gets a <a class="el" href="classGio_1_1Mount.html" title="The Mount interface represents user-visible mounts.">Mount</a> for the <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a>. 
 
2461
<p>
 
2462
If the FileIface for <em>file</em> does not have a mount (e.g. possibly a remote share), a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> will be thrown with NOT_FOUND and <code>0</code> will be returned.<p>
 
2463
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
 
2464
  <table border="0" cellspacing="2" cellpadding="0">
 
2465
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
 
2466
  </table>
 
2467
</dl>
 
2468
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1Mount.html" title="The Mount interface represents user-visible mounts.">Mount</a> where the <em>file</em> is located or <code>0</code> on error. </dd></dl>
 
2469
 
 
2470
</div>
 
2471
</div><p>
 
2472
<a class="anchor" name="39184ff9c9437259df4b9a9e2f283a0b"></a><!-- doxytag: member="Gio::File::query_filesystem_info_async" ref="39184ff9c9437259df4b9a9e2f283a0b" 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) const " -->
 
2473
<div class="memitem">
 
2474
<div class="memproto">
 
2475
      <table class="memname">
 
2476
        <tr>
 
2477
          <td class="memname">void Gio::File::query_filesystem_info_async           </td>
 
2478
          <td>(</td>
 
2479
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
2480
          <td class="paramname"> <em>slot</em>, </td>
 
2481
        </tr>
 
2482
        <tr>
 
2483
          <td class="paramkey"></td>
 
2484
          <td></td>
4007
2485
          <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>
4008
2486
          <td class="paramname"> <em>cancellable</em>, </td>
4009
2487
        </tr>
4011
2489
          <td class="paramkey"></td>
4012
2490
          <td></td>
4013
2491
          <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>
4014
 
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code></td><td>&nbsp;</td>
 
2492
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code>, </td>
 
2493
        </tr>
 
2494
        <tr>
 
2495
          <td class="paramkey"></td>
 
2496
          <td></td>
 
2497
          <td class="paramtype">int&nbsp;</td>
 
2498
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
4015
2499
        </tr>
4016
2500
        <tr>
4017
2501
          <td></td>
4018
2502
          <td>)</td>
4019
 
          <td></td><td></td><td></td>
 
2503
          <td></td><td></td><td> const</td>
4020
2504
        </tr>
4021
2505
      </table>
4022
2506
</div>
4023
2507
<div class="memdoc">
4024
2508
 
4025
2509
<p>
4026
 
Similar to <a class="el" href="classGio_1_1File.html#db25ffdbe571d33e89c9503fe9a20dcd" title="Gets the requested information about the file.">query_info()</a>, but obtains information about the filesystem the file is on, rather than the file itself. 
 
2510
Asynchronously gets the requested information about the filesystem that the file is on. 
4027
2511
<p>
4028
 
For instance the amount of space availible and the type of the filesystem.<p>
4029
 
The <em>attribute</em> value is a string that specifies the file attributes that should be gathered. It is not an error if its not possible to read a particular requested attribute from a file, it just won't be set. <em>attribute</em> should be a comma-separated list of attribute or attribute wildcards. The wildcard "*" means all attributes, and a wildcard like "fs:*" means all attributes in the fs namespace. The standard namespace for filesystem attributes is "fs". Common attributes of interest are FILE_ATTRIBUTE_FILESYSTEM_SIZE (the total size of the filesystem in bytes), FILE_ATTRIBUTE_FILESYSTEM_FREE (number of bytes availible), and FILE_ATTRIBUTE_FILESYSTEM_TYPE (type of the filesystem).<p>
4030
 
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>
4031
 
If the file does not exist, a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_FOUND will be thrown. Other errors are possible too, and depend on what kind of filesystem the file is on. <dl compact><dt><b>Parameters:</b></dt><dd>
 
2512
The result is a <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> object that contains key-value attributes (such as type or size for the file).<p>
 
2513
For more details, see <a class="el" href="classGio_1_1File.html#40486bc2f0c8758ef8a705b6b8b57e57" title="Similar to query_info(), but obtains information about the filesystem the file is...">query_filesystem_info()</a> which is the synchronous version of this call.<p>
 
2514
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#fd1159de8f782d918d8d460cddffee5b" title="Finishes an asynchronous filesystem info query.">query_filesystem_info_finish()</a> to get the result of the operation.<p>
 
2515
<dl compact><dt><b>Parameters:</b></dt><dd>
4032
2516
  <table border="0" cellspacing="2" cellpadding="0">
4033
 
    <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>
 
2517
    <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>
 
2518
    <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>
4034
2519
    <tr><td valign="top"></td><td valign="top"><em>attributes</em>&nbsp;</td><td>An attribute query string. </td></tr>
 
2520
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
4035
2521
  </table>
4036
2522
</dl>
4037
 
<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 if there was an error. </dd></dl>
4038
2523
 
4039
2524
</div>
4040
2525
</div><p>
4085
2570
 
4086
2571
</div>
4087
2572
</div><p>
4088
 
<a class="anchor" name="39184ff9c9437259df4b9a9e2f283a0b"></a><!-- doxytag: member="Gio::File::query_filesystem_info_async" ref="39184ff9c9437259df4b9a9e2f283a0b" 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) const " -->
4089
 
<div class="memitem">
4090
 
<div class="memproto">
4091
 
      <table class="memname">
4092
 
        <tr>
4093
 
          <td class="memname">void Gio::File::query_filesystem_info_async           </td>
4094
 
          <td>(</td>
4095
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
4096
 
          <td class="paramname"> <em>slot</em>, </td>
4097
 
        </tr>
4098
 
        <tr>
4099
 
          <td class="paramkey"></td>
4100
 
          <td></td>
4101
 
          <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>
4102
 
          <td class="paramname"> <em>cancellable</em>, </td>
4103
 
        </tr>
4104
 
        <tr>
4105
 
          <td class="paramkey"></td>
4106
 
          <td></td>
4107
 
          <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>
4108
 
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code>, </td>
4109
 
        </tr>
4110
 
        <tr>
4111
 
          <td class="paramkey"></td>
4112
 
          <td></td>
4113
 
          <td class="paramtype">int&nbsp;</td>
4114
 
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
4115
 
        </tr>
4116
 
        <tr>
4117
 
          <td></td>
4118
 
          <td>)</td>
4119
 
          <td></td><td></td><td> const</td>
4120
 
        </tr>
4121
 
      </table>
4122
 
</div>
4123
 
<div class="memdoc">
4124
 
 
4125
 
<p>
4126
 
Asynchronously gets the requested information about the filesystem that the file is on. 
4127
 
<p>
4128
 
The result is a <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> object that contains key-value attributes (such as type or size for the file).<p>
4129
 
For more details, see <a class="el" href="classGio_1_1File.html#40486bc2f0c8758ef8a705b6b8b57e57" title="Similar to query_info(), but obtains information about the filesystem the file is...">query_filesystem_info()</a> which is the synchronous version of this call.<p>
4130
 
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#fd1159de8f782d918d8d460cddffee5b" title="Finishes an asynchronous filesystem info query.">query_filesystem_info_finish()</a> to get the result of the operation.<p>
4131
 
<dl compact><dt><b>Parameters:</b></dt><dd>
4132
 
  <table border="0" cellspacing="2" cellpadding="0">
4133
 
    <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>
4134
 
    <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>
4135
 
    <tr><td valign="top"></td><td valign="top"><em>attributes</em>&nbsp;</td><td>An attribute query string. </td></tr>
4136
 
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
4137
 
  </table>
4138
 
</dl>
4139
 
 
4140
 
</div>
4141
 
</div><p>
4142
2573
<a class="anchor" name="fd1159de8f782d918d8d460cddffee5b"></a><!-- doxytag: member="Gio::File::query_filesystem_info_finish" ref="fd1159de8f782d918d8d460cddffee5b" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
4143
2574
<div class="memitem">
4144
2575
<div class="memproto">
4167
2598
 
4168
2599
</div>
4169
2600
</div><p>
4170
 
<a class="anchor" name="4e4b9c07ade255b12e2b43c38c3aba90"></a><!-- doxytag: member="Gio::File::query_info" ref="4e4b9c07ade255b12e2b43c38c3aba90" args="(const std::string &amp;attributes=&quot;*&quot;, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE) const " -->
4171
 
<div class="memitem">
4172
 
<div class="memproto">
4173
 
      <table class="memname">
4174
 
        <tr>
4175
 
          <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::File::query_info           </td>
4176
 
          <td>(</td>
4177
 
          <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>
4178
 
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code>, </td>
4179
 
        </tr>
4180
 
        <tr>
4181
 
          <td class="paramkey"></td>
4182
 
          <td></td>
4183
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
4184
 
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code></td><td>&nbsp;</td>
4185
 
        </tr>
4186
 
        <tr>
4187
 
          <td></td>
4188
 
          <td>)</td>
4189
 
          <td></td><td></td><td> const</td>
4190
 
        </tr>
4191
 
      </table>
4192
 
</div>
4193
 
<div class="memdoc">
4194
 
 
4195
 
<p>
4196
 
Gets the requested information about the file. 
4197
 
<p>
4198
 
The result is a <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> object that contains key-value attributes (such as the type or size of the file).<p>
4199
 
The <em>attribute</em> value is a string that specifies the file attributes that should be gathered. It is not an error if it's not possible to read a particular requested attribute from a file - it just won't be set. <em>attribute</em> should be a comma-separated list of attribute or attribute wildcards. The wildcard "*" means all attributes, and a wildcard like "standard::*" means all attributes in the standard namespace. An example attribute query be "standard::*,owner::user". The standard attributes are available as defines, like G_FILE_ATTRIBUTE_STANDARD_NAME.<p>
4200
 
For symlinks, normally the information about the target of the symlink is returned, rather than information about the symlink itself. However if you pass FILE_QUERY_INFO_NOFOLLOW_SYMLINKS in <em>flags</em> the information about the symlink itself will be returned. Also, for symlinks that point to non-existing files the information about the symlink itself will be returned.<p>
4201
 
If the file does not exist, a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_FOUND will be thrown. Other errors are possible too, and depend on what kind of filesystem the file is on.<p>
4202
 
<dl compact><dt><b>Parameters:</b></dt><dd>
4203
 
  <table border="0" cellspacing="2" cellpadding="0">
4204
 
    <tr><td valign="top"></td><td valign="top"><em>attributes,:</em>&nbsp;</td><td>An attribute query string. </td></tr>
4205
 
    <tr><td valign="top"></td><td valign="top"><em>flags,:</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
4206
 
  </table>
4207
 
</dl>
4208
 
<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 file, or an empty RefPtr on error. </dd></dl>
4209
 
 
4210
 
</div>
4211
 
</div><p>
4212
 
<a class="anchor" name="db25ffdbe571d33e89c9503fe9a20dcd"></a><!-- doxytag: member="Gio::File::query_info" ref="db25ffdbe571d33e89c9503fe9a20dcd" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, const std::string &amp;attributes=&quot;*&quot;, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE) const " -->
4213
 
<div class="memitem">
4214
 
<div class="memproto">
4215
 
      <table class="memname">
4216
 
        <tr>
4217
 
          <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::File::query_info           </td>
4218
 
          <td>(</td>
4219
 
          <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>
4220
 
          <td class="paramname"> <em>cancellable</em>, </td>
4221
 
        </tr>
4222
 
        <tr>
4223
 
          <td class="paramkey"></td>
4224
 
          <td></td>
4225
 
          <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>
4226
 
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code>, </td>
4227
 
        </tr>
4228
 
        <tr>
4229
 
          <td class="paramkey"></td>
4230
 
          <td></td>
4231
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
4232
 
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code></td><td>&nbsp;</td>
4233
 
        </tr>
4234
 
        <tr>
4235
 
          <td></td>
4236
 
          <td>)</td>
4237
 
          <td></td><td></td><td> const</td>
4238
 
        </tr>
4239
 
      </table>
4240
 
</div>
4241
 
<div class="memdoc">
4242
 
 
4243
 
<p>
4244
 
Gets the requested information about the file. 
4245
 
<p>
4246
 
The result is a <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> object that contains key-value attributes (such as the type or size of the file).<p>
4247
 
The <em>attribute</em> value is a string that specifies the file attributes that should be gathered. It is not an error if it's not possible to read a particular requested attribute from a file - it just won't be set. <em>attribute</em> should be a comma-separated list of attribute or attribute wildcards. The wildcard "*" means all attributes, and a wildcard like "standard::*" means all attributes in the standard namespace. An example attribute query be "standard::*,owner::user". The standard attributes are available as defines, like G_FILE_ATTRIBUTE_STANDARD_NAME.<p>
4248
 
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>
4249
 
For symlinks, normally the information about the target of the symlink is returned, rather than information about the symlink itself. However if you pass FILE_QUERY_INFO_NOFOLLOW_SYMLINKS in <em>flags</em> the information about the symlink itself will be returned. Also, for symlinks that point to non-existing files the information about the symlink itself will be returned.<p>
4250
 
If the file does not exist, a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_FOUND will be thrown. Other errors are possible too, and depend on what kind of filesystem the file is on.<p>
4251
 
<dl compact><dt><b>Parameters:</b></dt><dd>
4252
 
  <table border="0" cellspacing="2" cellpadding="0">
4253
 
    <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>
4254
 
    <tr><td valign="top"></td><td valign="top"><em>attributes,:</em>&nbsp;</td><td>An attribute query string. </td></tr>
4255
 
    <tr><td valign="top"></td><td valign="top"><em>flags,:</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
4256
 
  </table>
4257
 
</dl>
4258
 
<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 file, or an empty RefPtr on error. </dd></dl>
4259
 
 
4260
 
</div>
4261
 
</div><p>
4262
 
<a class="anchor" name="fcad69d782a971802a8aa85125ac2c8c"></a><!-- doxytag: member="Gio::File::query_info_async" ref="fcad69d782a971802a8aa85125ac2c8c" args="(const SlotAsyncReady &amp;slot, const std::string &amp;attributes=&quot;*&quot;, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE, int io_priority=Glib::PRIORITY_DEFAULT) const " -->
4263
 
<div class="memitem">
4264
 
<div class="memproto">
4265
 
      <table class="memname">
4266
 
        <tr>
4267
 
          <td class="memname">void Gio::File::query_info_async           </td>
4268
 
          <td>(</td>
4269
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
4270
 
          <td class="paramname"> <em>slot</em>, </td>
4271
 
        </tr>
4272
 
        <tr>
4273
 
          <td class="paramkey"></td>
4274
 
          <td></td>
4275
 
          <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>
4276
 
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code>, </td>
4277
 
        </tr>
4278
 
        <tr>
4279
 
          <td class="paramkey"></td>
4280
 
          <td></td>
4281
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
4282
 
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code>, </td>
4283
 
        </tr>
4284
 
        <tr>
4285
 
          <td class="paramkey"></td>
4286
 
          <td></td>
4287
 
          <td class="paramtype">int&nbsp;</td>
4288
 
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
4289
 
        </tr>
4290
 
        <tr>
4291
 
          <td></td>
4292
 
          <td>)</td>
4293
 
          <td></td><td></td><td> const</td>
4294
 
        </tr>
4295
 
      </table>
4296
 
</div>
4297
 
<div class="memdoc">
4298
 
 
4299
 
<p>
4300
 
Asynchronously gets the requested information about specified file. 
4301
 
<p>
4302
 
The result is a <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> object that contains key-value attributes (such as type or size for the file).<p>
4303
 
For more details, see <a class="el" href="classGio_1_1File.html#db25ffdbe571d33e89c9503fe9a20dcd" title="Gets the requested information about the file.">query_info()</a> which is the synchronous version of this call. When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#fd4ffc3630b41754c177658f2e745357" title="Finishes an asynchronous file info query.">query_info_finish()</a> to get the result of the operation.<p>
4304
 
<dl compact><dt><b>Parameters:</b></dt><dd>
4305
 
  <table border="0" cellspacing="2" cellpadding="0">
4306
 
    <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>
4307
 
    <tr><td valign="top"></td><td valign="top"><em>attributes</em>&nbsp;</td><td>An attribute query string. </td></tr>
4308
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
4309
 
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
4310
 
  </table>
4311
 
</dl>
4312
 
 
4313
 
</div>
4314
 
</div><p>
4315
 
<a class="anchor" name="7bd60e7864f8954c35e3b0891058e61c"></a><!-- doxytag: member="Gio::File::query_info_async" ref="7bd60e7864f8954c35e3b0891058e61c" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, const std::string &amp;attributes=&quot;*&quot;, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE, int io_priority=Glib::PRIORITY_DEFAULT) const " -->
4316
 
<div class="memitem">
4317
 
<div class="memproto">
4318
 
      <table class="memname">
4319
 
        <tr>
4320
 
          <td class="memname">void Gio::File::query_info_async           </td>
4321
 
          <td>(</td>
4322
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
4323
 
          <td class="paramname"> <em>slot</em>, </td>
4324
 
        </tr>
4325
 
        <tr>
4326
 
          <td class="paramkey"></td>
4327
 
          <td></td>
4328
 
          <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>
4329
 
          <td class="paramname"> <em>cancellable</em>, </td>
4330
 
        </tr>
4331
 
        <tr>
4332
 
          <td class="paramkey"></td>
4333
 
          <td></td>
4334
 
          <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>
4335
 
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code>, </td>
4336
 
        </tr>
4337
 
        <tr>
4338
 
          <td class="paramkey"></td>
4339
 
          <td></td>
4340
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
4341
 
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code>, </td>
4342
 
        </tr>
4343
 
        <tr>
4344
 
          <td class="paramkey"></td>
4345
 
          <td></td>
4346
 
          <td class="paramtype">int&nbsp;</td>
4347
 
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
4348
 
        </tr>
4349
 
        <tr>
4350
 
          <td></td>
4351
 
          <td>)</td>
4352
 
          <td></td><td></td><td> const</td>
4353
 
        </tr>
4354
 
      </table>
4355
 
</div>
4356
 
<div class="memdoc">
4357
 
 
4358
 
<p>
4359
 
Asynchronously gets the requested information about specified file. 
4360
 
<p>
4361
 
The result is a <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> object that contains key-value attributes (such as type or size for the file).<p>
4362
 
For more details, see <a class="el" href="classGio_1_1File.html#db25ffdbe571d33e89c9503fe9a20dcd" title="Gets the requested information about the file.">query_info()</a> which is the synchronous version of this call. When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#fd4ffc3630b41754c177658f2e745357" title="Finishes an asynchronous file info query.">query_info_finish()</a> to get the result of the operation.<p>
4363
 
<dl compact><dt><b>Parameters:</b></dt><dd>
4364
 
  <table border="0" cellspacing="2" cellpadding="0">
4365
 
    <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>
4366
 
    <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>
4367
 
    <tr><td valign="top"></td><td valign="top"><em>attributes</em>&nbsp;</td><td>An attribute query string. </td></tr>
4368
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
4369
 
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
4370
 
  </table>
4371
 
</dl>
4372
 
 
4373
 
</div>
4374
 
</div><p>
4375
 
<a class="anchor" name="fd4ffc3630b41754c177658f2e745357"></a><!-- doxytag: member="Gio::File::query_info_finish" ref="fd4ffc3630b41754c177658f2e745357" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
4376
 
<div class="memitem">
4377
 
<div class="memproto">
4378
 
      <table class="memname">
4379
 
        <tr>
4380
 
          <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::File::query_info_finish           </td>
4381
 
          <td>(</td>
4382
 
          <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>
4383
 
          <td class="paramname"> <em>result</em>          </td>
4384
 
          <td>&nbsp;)&nbsp;</td>
4385
 
          <td></td>
4386
 
        </tr>
4387
 
      </table>
4388
 
</div>
4389
 
<div class="memdoc">
4390
 
 
4391
 
<p>
4392
 
Finishes an asynchronous file info query. 
4393
 
<p>
4394
 
See g_file_query_info_async(). <dl compact><dt><b>Parameters:</b></dt><dd>
4395
 
  <table border="0" cellspacing="2" cellpadding="0">
4396
 
    <tr><td valign="top"></td><td valign="top"><em>res</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>
4397
 
  </table>
4398
 
</dl>
4399
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> for given <em>file</em> or <code>0</code> on error. Free the returned object with Glib::object_unref(). </dd></dl>
4400
 
 
4401
 
</div>
4402
 
</div><p>
4403
 
<a class="anchor" name="1ae03d0652bcfbad2f47409b8f815bc4"></a><!-- doxytag: member="Gio::File::query_settable_attributes" ref="1ae03d0652bcfbad2f47409b8f815bc4" args="()" -->
4404
 
<div class="memitem">
4405
 
<div class="memproto">
4406
 
      <table class="memname">
4407
 
        <tr>
4408
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileAttributeInfoList.html">FileAttributeInfoList</a>&gt; Gio::File::query_settable_attributes           </td>
4409
 
          <td>(</td>
4410
 
          <td class="paramname">          </td>
4411
 
          <td>&nbsp;)&nbsp;</td>
4412
 
          <td></td>
4413
 
        </tr>
4414
 
      </table>
4415
 
</div>
4416
 
<div class="memdoc">
4417
 
 
4418
 
<p>
4419
 
Obtain the list of settable attributes for the file. 
4420
 
<p>
4421
 
Returns: a <a class="el" href="classGio_1_1FileAttributeInfoList.html" title="Key-Value paired file attributes.">FileAttributeInfoList</a> describing the settable attributes. <dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileAttributeInfoList.html" title="Key-Value paired file attributes.">FileAttributeInfoList</a> describing the settable attributes. </dd></dl>
4422
 
 
4423
 
</div>
4424
 
</div><p>
4425
 
<a class="anchor" name="4a543339b58cff6a7e5ddd840df0e69e"></a><!-- doxytag: member="Gio::File::query_settable_attributes" ref="4a543339b58cff6a7e5ddd840df0e69e" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
4426
 
<div class="memitem">
4427
 
<div class="memproto">
4428
 
      <table class="memname">
4429
 
        <tr>
4430
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileAttributeInfoList.html">FileAttributeInfoList</a>&gt; Gio::File::query_settable_attributes           </td>
4431
 
          <td>(</td>
4432
 
          <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>
4433
 
          <td class="paramname"> <em>cancellable</em>          </td>
4434
 
          <td>&nbsp;)&nbsp;</td>
4435
 
          <td></td>
4436
 
        </tr>
4437
 
      </table>
4438
 
</div>
4439
 
<div class="memdoc">
4440
 
 
4441
 
<p>
4442
 
Obtain the list of settable attributes for the file. 
4443
 
<p>
4444
 
Returns: a <a class="el" href="classGio_1_1FileAttributeInfoList.html" title="Key-Value paired file attributes.">FileAttributeInfoList</a> describing the settable attributes. <dl compact><dt><b>Parameters:</b></dt><dd>
4445
 
  <table border="0" cellspacing="2" cellpadding="0">
4446
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td>Optional <a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object, <code>0</code> to ignore. </td></tr>
4447
 
  </table>
4448
 
</dl>
4449
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileAttributeInfoList.html" title="Key-Value paired file attributes.">FileAttributeInfoList</a> describing the settable attributes. When you are done with it, release it with g_file_attribute_info_list_unref(). </dd></dl>
4450
 
 
4451
 
</div>
4452
 
</div><p>
4453
 
<a class="anchor" name="a0278acd7d09ed292359004defb742b0"></a><!-- doxytag: member="Gio::File::query_writable_namespaces" ref="a0278acd7d09ed292359004defb742b0" args="()" -->
4454
 
<div class="memitem">
4455
 
<div class="memproto">
4456
 
      <table class="memname">
4457
 
        <tr>
4458
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileAttributeInfoList.html">FileAttributeInfoList</a>&gt; Gio::File::query_writable_namespaces           </td>
4459
 
          <td>(</td>
4460
 
          <td class="paramname">          </td>
4461
 
          <td>&nbsp;)&nbsp;</td>
4462
 
          <td></td>
4463
 
        </tr>
4464
 
      </table>
4465
 
</div>
4466
 
<div class="memdoc">
4467
 
 
4468
 
<p>
4469
 
Obtain the list of attribute namespaces where new attributes can be created by a user. 
4470
 
<p>
4471
 
An example of this is extended attributes (in the "xattr" namespace).<p>
4472
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileAttributeInfoList.html" title="Key-Value paired file attributes.">FileAttributeInfoList</a> describing the writable namespaces. </dd></dl>
4473
 
 
4474
 
</div>
4475
 
</div><p>
4476
 
<a class="anchor" name="f5c7463b92e2887597486e7b195ca12f"></a><!-- doxytag: member="Gio::File::query_writable_namespaces" ref="f5c7463b92e2887597486e7b195ca12f" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
4477
 
<div class="memitem">
4478
 
<div class="memproto">
4479
 
      <table class="memname">
4480
 
        <tr>
4481
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileAttributeInfoList.html">FileAttributeInfoList</a>&gt; Gio::File::query_writable_namespaces           </td>
4482
 
          <td>(</td>
4483
 
          <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>
4484
 
          <td class="paramname"> <em>cancellable</em>          </td>
4485
 
          <td>&nbsp;)&nbsp;</td>
4486
 
          <td></td>
4487
 
        </tr>
4488
 
      </table>
4489
 
</div>
4490
 
<div class="memdoc">
4491
 
 
4492
 
<p>
4493
 
Obtain the list of attribute namespaces where new attributes can be created by a user. 
4494
 
<p>
4495
 
An example of this is extended attributes (in the "xattr" namespace).<p>
4496
 
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
4497
 
  <table border="0" cellspacing="2" cellpadding="0">
4498
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
4499
 
  </table>
4500
 
</dl>
4501
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileAttributeInfoList.html" title="Key-Value paired file attributes.">FileAttributeInfoList</a> describing the writable namespaces. When you are done with it, release it with g_file_attribute_info_list_unref(). </dd></dl>
4502
 
 
4503
 
</div>
4504
 
</div><p>
4505
 
<a class="anchor" name="0395b3b0b8cec5dc1fd9953e52e5fbc1"></a><!-- doxytag: member="Gio::File::read" ref="0395b3b0b8cec5dc1fd9953e52e5fbc1" args="()" -->
4506
 
<div class="memitem">
4507
 
<div class="memproto">
4508
 
      <table class="memname">
4509
 
        <tr>
4510
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileInputStream.html">FileInputStream</a>&gt; Gio::File::read           </td>
4511
 
          <td>(</td>
4512
 
          <td class="paramname">          </td>
4513
 
          <td>&nbsp;)&nbsp;</td>
4514
 
          <td></td>
4515
 
        </tr>
4516
 
      </table>
4517
 
</div>
4518
 
<div class="memdoc">
4519
 
 
4520
 
<p>
4521
 
Opens a file for reading. 
4522
 
<p>
4523
 
The result is a <a class="el" href="classGio_1_1FileInputStream.html" title="FileInputStream provides input streams that take their content from a file.">FileInputStream</a> that can be used to read the contents of the file.<p>
4524
 
If the file does not exist, a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_FOUND will be thrown. If the file is a directory, a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with IS_DIRECTORY will be thrown. Other errors are possible too, and depend on what kind of filesystem the file is on. <dl class="return" compact><dt><b>Returns:</b></dt><dd><a class="el" href="classGio_1_1FileInputStream.html" title="FileInputStream provides input streams that take their content from a file.">FileInputStream</a> or an empty RefPtr on error. </dd></dl>
4525
 
 
4526
 
</div>
4527
 
</div><p>
4528
 
<a class="anchor" name="3ef959c7ad7096846f26eb8b282e3c68"></a><!-- doxytag: member="Gio::File::read" ref="3ef959c7ad7096846f26eb8b282e3c68" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
4529
 
<div class="memitem">
4530
 
<div class="memproto">
4531
 
      <table class="memname">
4532
 
        <tr>
4533
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileInputStream.html">FileInputStream</a>&gt; Gio::File::read           </td>
4534
 
          <td>(</td>
4535
 
          <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>
4536
 
          <td class="paramname"> <em>cancellable</em>          </td>
4537
 
          <td>&nbsp;)&nbsp;</td>
4538
 
          <td></td>
4539
 
        </tr>
4540
 
      </table>
4541
 
</div>
4542
 
<div class="memdoc">
4543
 
 
4544
 
<p>
4545
 
Opens a file for reading. 
4546
 
<p>
4547
 
The result is a <a class="el" href="classGio_1_1FileInputStream.html" title="FileInputStream provides input streams that take their content from a file.">FileInputStream</a> that can be used to read the contents of the file.<p>
4548
 
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> will be thrown with CANCELLED.<p>
4549
 
If the file does not exist, a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_FOUND will be thrown. If the file is a directory, a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with IS_DIRECTORY will be thrown. Other errors are possible too, and depend on what kind of filesystem the file is on. <dl compact><dt><b>Parameters:</b></dt><dd>
4550
 
  <table border="0" cellspacing="2" cellpadding="0">
4551
 
    <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>. </td></tr>
4552
 
  </table>
4553
 
</dl>
4554
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><a class="el" href="classGio_1_1FileInputStream.html" title="FileInputStream provides input streams that take their content from a file.">FileInputStream</a> or <code>0</code> on error. </dd></dl>
4555
 
 
4556
 
</div>
4557
 
</div><p>
4558
 
<a class="anchor" name="b451a182a647408e697c9115e66f6194"></a><!-- doxytag: member="Gio::File::read_async" ref="b451a182a647408e697c9115e66f6194" args="(const SlotAsyncReady &amp;slot, int io_priority=Glib::PRIORITY_DEFAULT)" -->
4559
 
<div class="memitem">
4560
 
<div class="memproto">
4561
 
      <table class="memname">
4562
 
        <tr>
4563
 
          <td class="memname">void Gio::File::read_async           </td>
4564
 
          <td>(</td>
4565
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
4566
 
          <td class="paramname"> <em>slot</em>, </td>
4567
 
        </tr>
4568
 
        <tr>
4569
 
          <td class="paramkey"></td>
4570
 
          <td></td>
4571
 
          <td class="paramtype">int&nbsp;</td>
4572
 
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
4573
 
        </tr>
4574
 
        <tr>
4575
 
          <td></td>
4576
 
          <td>)</td>
4577
 
          <td></td><td></td><td></td>
4578
 
        </tr>
4579
 
      </table>
4580
 
</div>
4581
 
<div class="memdoc">
4582
 
 
4583
 
<p>
4584
 
Asynchronously opens the file for reading. 
4585
 
<p>
4586
 
For more details, see <a class="el" href="classGio_1_1File.html#0395b3b0b8cec5dc1fd9953e52e5fbc1" title="Opens a file for reading.">read()</a> which is the synchronous version of this call. When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#64b10854ad1add1f888ecb19403eb921" title="Finishes an asynchronous file read operation started with g_file_read_async().">read_finish()</a> to get the result of the operation.<p>
4587
 
<dl compact><dt><b>Parameters:</b></dt><dd>
4588
 
  <table border="0" cellspacing="2" cellpadding="0">
4589
 
    <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>
4590
 
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
4591
 
  </table>
4592
 
</dl>
4593
 
 
4594
 
</div>
4595
 
</div><p>
4596
 
<a class="anchor" name="2826eed0b1e76c3771f6ad5f5b993991"></a><!-- doxytag: member="Gio::File::read_async" ref="2826eed0b1e76c3771f6ad5f5b993991" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, int io_priority=Glib::PRIORITY_DEFAULT)" -->
4597
 
<div class="memitem">
4598
 
<div class="memproto">
4599
 
      <table class="memname">
4600
 
        <tr>
4601
 
          <td class="memname">void Gio::File::read_async           </td>
4602
 
          <td>(</td>
4603
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
4604
 
          <td class="paramname"> <em>slot</em>, </td>
4605
 
        </tr>
4606
 
        <tr>
4607
 
          <td class="paramkey"></td>
4608
 
          <td></td>
4609
 
          <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>
4610
 
          <td class="paramname"> <em>cancellable</em>, </td>
4611
 
        </tr>
4612
 
        <tr>
4613
 
          <td class="paramkey"></td>
4614
 
          <td></td>
4615
 
          <td class="paramtype">int&nbsp;</td>
4616
 
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
4617
 
        </tr>
4618
 
        <tr>
4619
 
          <td></td>
4620
 
          <td>)</td>
4621
 
          <td></td><td></td><td></td>
4622
 
        </tr>
4623
 
      </table>
4624
 
</div>
4625
 
<div class="memdoc">
4626
 
 
4627
 
<p>
4628
 
Asynchronously opens the file for reading. 
4629
 
<p>
4630
 
For more details, see <a class="el" href="classGio_1_1File.html#0395b3b0b8cec5dc1fd9953e52e5fbc1" title="Opens a file for reading.">read()</a> which is the synchronous version of this call. When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#64b10854ad1add1f888ecb19403eb921" title="Finishes an asynchronous file read operation started with g_file_read_async().">read_finish()</a> to get the result of the operation.<p>
4631
 
<dl compact><dt><b>Parameters:</b></dt><dd>
4632
 
  <table border="0" cellspacing="2" cellpadding="0">
4633
 
    <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>
4634
 
    <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>
4635
 
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
4636
 
  </table>
4637
 
</dl>
4638
 
 
4639
 
</div>
4640
 
</div><p>
4641
 
<a class="anchor" name="64b10854ad1add1f888ecb19403eb921"></a><!-- doxytag: member="Gio::File::read_finish" ref="64b10854ad1add1f888ecb19403eb921" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
4642
 
<div class="memitem">
4643
 
<div class="memproto">
4644
 
      <table class="memname">
4645
 
        <tr>
4646
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileInputStream.html">FileInputStream</a>&gt; Gio::File::read_finish           </td>
4647
 
          <td>(</td>
4648
 
          <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>
4649
 
          <td class="paramname"> <em>result</em>          </td>
4650
 
          <td>&nbsp;)&nbsp;</td>
4651
 
          <td></td>
4652
 
        </tr>
4653
 
      </table>
4654
 
</div>
4655
 
<div class="memdoc">
4656
 
 
4657
 
<p>
4658
 
Finishes an asynchronous file read operation started with g_file_read_async(). 
4659
 
<p>
4660
 
<dl compact><dt><b>Parameters:</b></dt><dd>
4661
 
  <table border="0" cellspacing="2" cellpadding="0">
4662
 
    <tr><td valign="top"></td><td valign="top"><em>res</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>
4663
 
  </table>
4664
 
</dl>
4665
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileInputStream.html" title="FileInputStream provides input streams that take their content from a file.">FileInputStream</a> or <code>0</code> on error. Free the returned object with Glib::object_unref(). </dd></dl>
4666
 
 
4667
 
</div>
4668
 
</div><p>
4669
 
<a class="anchor" name="14f34508dea523cbf889b7193e513ca4"></a><!-- doxytag: member="Gio::File::remove" ref="14f34508dea523cbf889b7193e513ca4" args="()" -->
4670
 
<div class="memitem">
4671
 
<div class="memproto">
4672
 
      <table class="memname">
4673
 
        <tr>
4674
 
          <td class="memname">bool Gio::File::remove           </td>
4675
 
          <td>(</td>
4676
 
          <td class="paramname">          </td>
4677
 
          <td>&nbsp;)&nbsp;</td>
4678
 
          <td></td>
4679
 
        </tr>
4680
 
      </table>
4681
 
</div>
4682
 
<div class="memdoc">
4683
 
 
4684
 
<p>
4685
 
Deletes a file. 
4686
 
<p>
4687
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the file was deleted. <code>false</code> otherwise. </dd></dl>
4688
 
 
4689
 
</div>
4690
 
</div><p>
4691
 
<a class="anchor" name="ded971b0cf84801f6684ad4bd5dc66c5"></a><!-- doxytag: member="Gio::File::remove" ref="ded971b0cf84801f6684ad4bd5dc66c5" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
4692
 
<div class="memitem">
4693
 
<div class="memproto">
4694
 
      <table class="memname">
4695
 
        <tr>
4696
 
          <td class="memname">bool Gio::File::remove           </td>
4697
 
          <td>(</td>
4698
 
          <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>
4699
 
          <td class="paramname"> <em>cancellable</em>          </td>
4700
 
          <td>&nbsp;)&nbsp;</td>
4701
 
          <td></td>
4702
 
        </tr>
4703
 
      </table>
4704
 
</div>
4705
 
<div class="memdoc">
4706
 
 
4707
 
<p>
4708
 
Deletes a file. 
4709
 
<p>
4710
 
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
4711
 
  <table border="0" cellspacing="2" cellpadding="0">
4712
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
4713
 
  </table>
4714
 
</dl>
4715
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the file was deleted. <code>false</code> otherwise. </dd></dl>
4716
 
 
4717
 
</div>
4718
 
</div><p>
4719
 
<a class="anchor" name="cf55f9291659566f6fd36271801b013b"></a><!-- doxytag: member="Gio::File::replace" ref="cf55f9291659566f6fd36271801b013b" args="(const std::string &amp;etag=std::string(), bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE)" -->
4720
 
<div class="memitem">
4721
 
<div class="memproto">
4722
 
      <table class="memname">
4723
 
        <tr>
4724
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileOutputStream.html">FileOutputStream</a>&gt; Gio::File::replace           </td>
4725
 
          <td>(</td>
4726
 
          <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>
4727
 
          <td class="paramname"> <em>etag</em> = <code><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>()</code>, </td>
4728
 
        </tr>
4729
 
        <tr>
4730
 
          <td class="paramkey"></td>
4731
 
          <td></td>
4732
 
          <td class="paramtype">bool&nbsp;</td>
4733
 
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
4734
 
        </tr>
4735
 
        <tr>
4736
 
          <td class="paramkey"></td>
4737
 
          <td></td>
4738
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
4739
 
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
4740
 
        </tr>
4741
 
        <tr>
4742
 
          <td></td>
4743
 
          <td>)</td>
4744
 
          <td></td><td></td><td></td>
4745
 
        </tr>
4746
 
      </table>
4747
 
</div>
4748
 
<div class="memdoc">
4749
 
 
4750
 
<p>
4751
 
Returns an output stream for overwriting the file, possibly creating a backup copy of the file first. 
4752
 
<p>
4753
 
This will try to replace the file in the safest way possible so that any errors during the writing will not affect an already existing copy of the file. For instance, for local files it may write to a temporary file and then atomically rename over the destination when the stream is closed.<p>
4754
 
By default files created are generally readable by everyone, but if you pass FILE_CREATE_PRIVATE in <em>flags</em> the file will be made readable only to the current user, to the level that is supported on the target filesystem.<p>
4755
 
If you pass in an etag value, then this value is compared to the current entity tag of the file, and if they differ a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with WRONG_ETAG will be thrown. This generally means that the file has been changed since you last read it. You can get the new etag from <a class="el" href="classGio_1_1FileOutputStream.html#8e29de4e67428a79b41180ca27af0a3d" title="Gets the entity tag for the file when it has been written.">FileOutputStream::get_etag()</a> after you've finished writing and closed the <a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a>. When you load a new file you can use <a class="el" href="classGio_1_1FileInputStream.html#e9cf87761484839f4ea53bc33064f189" title="Queries a file input stream the given attributes.">FileInputStream::query_info()</a> to get the etag of the file.<p>
4756
 
If <em>make_backup</em> is true, this function will attempt to make a backup of the current file before overwriting it. If this fails aa <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with CANT_CREATE_BACKUP will be thrown. If you want to replace anyway, try again with <em>make_backup</em> set to false.<p>
4757
 
If the file is a directory a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with IS_DIRECTORY will be thrown, and if the file is some other form of non-regular file then aa <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_REGULAR_FILE will be thrown. Some file systems don't allow all file names, and may throw a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with INVALID_FILENAME, and if the name is to longa <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with FILENAME_TOO_LONG will be thrown. Other errors are possible too, and depend on what kind of filesystem the file is on.<p>
4758
 
<dl compact><dt><b>Parameters:</b></dt><dd>
4759
 
  <table border="0" cellspacing="2" cellpadding="0">
4760
 
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>An optional entity tag for the current Glib::File. </td></tr>
4761
 
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td><code>true</code> if a backup should be created. </td></tr>
4762
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
4763
 
  </table>
4764
 
</dl>
4765
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a>. </dd></dl>
4766
 
 
4767
 
</div>
4768
 
</div><p>
4769
 
<a class="anchor" name="d7cf0360096504e40f799fde5cc8e9de"></a><!-- doxytag: member="Gio::File::replace" ref="d7cf0360096504e40f799fde5cc8e9de" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, const std::string &amp;etag=std::string(), bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE)" -->
4770
 
<div class="memitem">
4771
 
<div class="memproto">
4772
 
      <table class="memname">
4773
 
        <tr>
4774
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileOutputStream.html">FileOutputStream</a>&gt; Gio::File::replace           </td>
4775
 
          <td>(</td>
4776
 
          <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>
4777
 
          <td class="paramname"> <em>cancellable</em>, </td>
4778
 
        </tr>
4779
 
        <tr>
4780
 
          <td class="paramkey"></td>
4781
 
          <td></td>
4782
 
          <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>
4783
 
          <td class="paramname"> <em>etag</em> = <code><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>()</code>, </td>
4784
 
        </tr>
4785
 
        <tr>
4786
 
          <td class="paramkey"></td>
4787
 
          <td></td>
4788
 
          <td class="paramtype">bool&nbsp;</td>
4789
 
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
4790
 
        </tr>
4791
 
        <tr>
4792
 
          <td class="paramkey"></td>
4793
 
          <td></td>
4794
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
4795
 
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
4796
 
        </tr>
4797
 
        <tr>
4798
 
          <td></td>
4799
 
          <td>)</td>
4800
 
          <td></td><td></td><td></td>
4801
 
        </tr>
4802
 
      </table>
4803
 
</div>
4804
 
<div class="memdoc">
4805
 
 
4806
 
<p>
4807
 
Returns an output stream for overwriting the file, possibly creating a backup copy of the file first. 
4808
 
<p>
4809
 
This will try to replace the file in the safest way possible so that any errors during the writing will not affect an already existing copy of the file. For instance, for local files it may write to a temporary file and then atomically rename over the destination when the stream is closed.<p>
4810
 
By default files created are generally readable by everyone, but if you pass FILE_CREATE_PRIVATE in <em>flags</em> the file will be made readable only to the current user, to the level that is supported on the target filesystem.<p>
4811
 
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>
4812
 
If you pass in an etag value, then this value is compared to the current entity tag of the file, and if they differ a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with WRONG_ETAG will be thrown. This generally means that the file has been changed since you last read it. You can get the new etag from <a class="el" href="classGio_1_1FileOutputStream.html#8e29de4e67428a79b41180ca27af0a3d" title="Gets the entity tag for the file when it has been written.">FileOutputStream::get_etag()</a> after you've finished writing and closed the <a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a>. When you load a new file you can use <a class="el" href="classGio_1_1FileInputStream.html#e9cf87761484839f4ea53bc33064f189" title="Queries a file input stream the given attributes.">FileInputStream::query_info()</a> to get the etag of the file.<p>
4813
 
If <em>make_backup</em> is true, this function will attempt to make a backup of the current file before overwriting it. If this fails aa <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with CANT_CREATE_BACKUP will be thrown. If you want to replace anyway, try again with <em>make_backup</em> set to false.<p>
4814
 
If the file is a directory a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with IS_DIRECTORY will be thrown, and if the file is some other form of non-regular file then aa <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_REGULAR_FILE will be thrown. Some file systems don't allow all file names, and may throw a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with INVALID_FILENAME, and if the name is to longa <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with FILENAME_TOO_LONG will be thrown. Other errors are possible too, and depend on what kind of filesystem the file is on.<p>
4815
 
<dl compact><dt><b>Parameters:</b></dt><dd>
4816
 
  <table border="0" cellspacing="2" cellpadding="0">
4817
 
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>An optional entity tag for the current Glib::File. </td></tr>
4818
 
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td><code>true</code> if a backup should be created. </td></tr>
4819
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
4820
 
  </table>
4821
 
</dl>
4822
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a>. </dd></dl>
4823
 
 
4824
 
</div>
4825
 
</div><p>
4826
 
<a class="anchor" name="e51e51a2e3a45da4324230b4d5401a58"></a><!-- doxytag: member="Gio::File::replace_async" ref="e51e51a2e3a45da4324230b4d5401a58" args="(const SlotAsyncReady &amp;slot, const std::string &amp;etag=std::string(), bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
4827
 
<div class="memitem">
4828
 
<div class="memproto">
4829
 
      <table class="memname">
4830
 
        <tr>
4831
 
          <td class="memname">void Gio::File::replace_async           </td>
4832
 
          <td>(</td>
4833
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
4834
 
          <td class="paramname"> <em>slot</em>, </td>
4835
 
        </tr>
4836
 
        <tr>
4837
 
          <td class="paramkey"></td>
4838
 
          <td></td>
4839
 
          <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>
4840
 
          <td class="paramname"> <em>etag</em> = <code><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>()</code>, </td>
4841
 
        </tr>
4842
 
        <tr>
4843
 
          <td class="paramkey"></td>
4844
 
          <td></td>
4845
 
          <td class="paramtype">bool&nbsp;</td>
4846
 
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
4847
 
        </tr>
4848
 
        <tr>
4849
 
          <td class="paramkey"></td>
4850
 
          <td></td>
4851
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
4852
 
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code>, </td>
4853
 
        </tr>
4854
 
        <tr>
4855
 
          <td class="paramkey"></td>
4856
 
          <td></td>
4857
 
          <td class="paramtype">int&nbsp;</td>
4858
 
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
4859
 
        </tr>
4860
 
        <tr>
4861
 
          <td></td>
4862
 
          <td>)</td>
4863
 
          <td></td><td></td><td></td>
4864
 
        </tr>
4865
 
      </table>
4866
 
</div>
4867
 
<div class="memdoc">
4868
 
 
4869
 
<p>
4870
 
Asyncronously overwrites the file, replacing the contents, possibly creating a backup copy of the file first. 
4871
 
<p>
4872
 
For more details, see <a class="el" href="classGio_1_1File.html#d7cf0360096504e40f799fde5cc8e9de" title="Returns an output stream for overwriting the file, possibly creating a backup copy...">replace()</a> which is the synchronous version of this call. When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#b28557d592f2c53df618728cf865e65e" title="Finishes an asynchronous file replace operation started with g_file_replace_async()...">replace_finish()</a> to get the result of the operation.<p>
4873
 
<dl compact><dt><b>Parameters:</b></dt><dd>
4874
 
  <table border="0" cellspacing="2" cellpadding="0">
4875
 
    <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>
4876
 
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>An entity tag for the current <a class="el" href="classGio_1_1File.html" title="File and directory handling.">Gio::File</a>. </td></tr>
4877
 
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td>true if a backup of the existing file should be made. </td></tr>
4878
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
4879
 
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
4880
 
  </table>
4881
 
</dl>
4882
 
 
4883
 
</div>
4884
 
</div><p>
4885
 
<a class="anchor" name="d777cdaa404a6a668ee8d520299687ce"></a><!-- doxytag: member="Gio::File::replace_async" ref="d777cdaa404a6a668ee8d520299687ce" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, const std::string &amp;etag=std::string(), bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
4886
 
<div class="memitem">
4887
 
<div class="memproto">
4888
 
      <table class="memname">
4889
 
        <tr>
4890
 
          <td class="memname">void Gio::File::replace_async           </td>
4891
 
          <td>(</td>
4892
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
4893
 
          <td class="paramname"> <em>slot</em>, </td>
4894
 
        </tr>
4895
 
        <tr>
4896
 
          <td class="paramkey"></td>
4897
 
          <td></td>
4898
 
          <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>
4899
 
          <td class="paramname"> <em>cancellable</em>, </td>
4900
 
        </tr>
4901
 
        <tr>
4902
 
          <td class="paramkey"></td>
4903
 
          <td></td>
4904
 
          <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>
4905
 
          <td class="paramname"> <em>etag</em> = <code><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>()</code>, </td>
4906
 
        </tr>
4907
 
        <tr>
4908
 
          <td class="paramkey"></td>
4909
 
          <td></td>
4910
 
          <td class="paramtype">bool&nbsp;</td>
4911
 
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
4912
 
        </tr>
4913
 
        <tr>
4914
 
          <td class="paramkey"></td>
4915
 
          <td></td>
4916
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
4917
 
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code>, </td>
4918
 
        </tr>
4919
 
        <tr>
4920
 
          <td class="paramkey"></td>
4921
 
          <td></td>
4922
 
          <td class="paramtype">int&nbsp;</td>
4923
 
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
4924
 
        </tr>
4925
 
        <tr>
4926
 
          <td></td>
4927
 
          <td>)</td>
4928
 
          <td></td><td></td><td></td>
4929
 
        </tr>
4930
 
      </table>
4931
 
</div>
4932
 
<div class="memdoc">
4933
 
 
4934
 
<p>
4935
 
Asyncronously overwrites the file, replacing the contents, possibly creating a backup copy of the file first. 
4936
 
<p>
4937
 
For more details, see <a class="el" href="classGio_1_1File.html#d7cf0360096504e40f799fde5cc8e9de" title="Returns an output stream for overwriting the file, possibly creating a backup copy...">replace()</a> which is the synchronous version of this call. When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#b28557d592f2c53df618728cf865e65e" title="Finishes an asynchronous file replace operation started with g_file_replace_async()...">replace_finish()</a> to get the result of the operation.<p>
4938
 
<dl compact><dt><b>Parameters:</b></dt><dd>
4939
 
  <table border="0" cellspacing="2" cellpadding="0">
4940
 
    <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>
4941
 
    <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>
4942
 
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>An entity tag for the current <a class="el" href="classGio_1_1File.html" title="File and directory handling.">Gio::File</a>. </td></tr>
4943
 
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td>true if a backup of the existing file should be made. </td></tr>
4944
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
4945
 
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
4946
 
  </table>
4947
 
</dl>
4948
 
 
4949
 
</div>
4950
 
</div><p>
4951
 
<a class="anchor" name="af33a17461ff4f70fed06818e364f617"></a><!-- doxytag: member="Gio::File::replace_contents" ref="af33a17461ff4f70fed06818e364f617" args="(const std::string &amp;contents, const std::string &amp;etag, std::string &amp;new_etag, bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE)" -->
4952
 
<div class="memitem">
4953
 
<div class="memproto">
4954
 
      <table class="memname">
4955
 
        <tr>
4956
 
          <td class="memname">void Gio::File::replace_contents           </td>
4957
 
          <td>(</td>
4958
 
          <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>
4959
 
          <td class="paramname"> <em>contents</em>, </td>
4960
 
        </tr>
4961
 
        <tr>
4962
 
          <td class="paramkey"></td>
4963
 
          <td></td>
4964
 
          <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>
4965
 
          <td class="paramname"> <em>etag</em>, </td>
4966
 
        </tr>
4967
 
        <tr>
4968
 
          <td class="paramkey"></td>
4969
 
          <td></td>
4970
 
          <td class="paramtype"><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>
4971
 
          <td class="paramname"> <em>new_etag</em>, </td>
4972
 
        </tr>
4973
 
        <tr>
4974
 
          <td class="paramkey"></td>
4975
 
          <td></td>
4976
 
          <td class="paramtype">bool&nbsp;</td>
4977
 
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
4978
 
        </tr>
4979
 
        <tr>
4980
 
          <td class="paramkey"></td>
4981
 
          <td></td>
4982
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
4983
 
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
4984
 
        </tr>
4985
 
        <tr>
4986
 
          <td></td>
4987
 
          <td>)</td>
4988
 
          <td></td><td></td><td></td>
4989
 
        </tr>
4990
 
      </table>
4991
 
</div>
4992
 
<div class="memdoc">
4993
 
 
4994
 
<p>
4995
 
Replaces the contents of the file with <em>contents</em>. 
4996
 
<p>
4997
 
If <em>etag</em> is specified (not an empty string) any existing file must have that etag, or a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with WRONG_ETAG will be thrown.<p>
4998
 
If <em>make_backup</em> is <code>true</code>, this function will attempt to make a backup of the file.<p>
4999
 
The returned <em>new_etag</em> can be used to verify that the file hasn't changed the next time it is saved over. <dl compact><dt><b>Parameters:</b></dt><dd>
5000
 
  <table border="0" cellspacing="2" cellpadding="0">
5001
 
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>A string containing the new contents for the file. </td></tr>
5002
 
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>The old entity tag for the document. </td></tr>
5003
 
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td><code>true</code> if a backup should be created. </td></tr>
5004
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
5005
 
    <tr><td valign="top"></td><td valign="top"><em>new_etag</em>&nbsp;</td><td>A location to a new entity tag for the document. </td></tr>
5006
 
  </table>
5007
 
</dl>
5008
 
 
5009
 
</div>
5010
 
</div><p>
5011
 
<a class="anchor" name="23126b43cd262b63c0e458c3a4d0b65c"></a><!-- doxytag: member="Gio::File::replace_contents" ref="23126b43cd262b63c0e458c3a4d0b65c" args="(const std::string &amp;contents, const std::string &amp;etag, std::string &amp;new_etag, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE)" -->
5012
 
<div class="memitem">
5013
 
<div class="memproto">
5014
 
      <table class="memname">
5015
 
        <tr>
5016
 
          <td class="memname">void Gio::File::replace_contents           </td>
5017
 
          <td>(</td>
5018
 
          <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>
5019
 
          <td class="paramname"> <em>contents</em>, </td>
5020
 
        </tr>
5021
 
        <tr>
5022
 
          <td class="paramkey"></td>
5023
 
          <td></td>
5024
 
          <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>
5025
 
          <td class="paramname"> <em>etag</em>, </td>
5026
 
        </tr>
5027
 
        <tr>
5028
 
          <td class="paramkey"></td>
5029
 
          <td></td>
5030
 
          <td class="paramtype"><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>
5031
 
          <td class="paramname"> <em>new_etag</em>, </td>
5032
 
        </tr>
5033
 
        <tr>
5034
 
          <td class="paramkey"></td>
5035
 
          <td></td>
5036
 
          <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>
5037
 
          <td class="paramname"> <em>cancellable</em>, </td>
5038
 
        </tr>
5039
 
        <tr>
5040
 
          <td class="paramkey"></td>
5041
 
          <td></td>
5042
 
          <td class="paramtype">bool&nbsp;</td>
5043
 
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
5044
 
        </tr>
5045
 
        <tr>
5046
 
          <td class="paramkey"></td>
5047
 
          <td></td>
5048
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
5049
 
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
5050
 
        </tr>
5051
 
        <tr>
5052
 
          <td></td>
5053
 
          <td>)</td>
5054
 
          <td></td><td></td><td></td>
5055
 
        </tr>
5056
 
      </table>
5057
 
</div>
5058
 
<div class="memdoc">
5059
 
 
5060
 
<p>
5061
 
Replaces the contents of the file with <em>contents</em>. 
5062
 
<p>
5063
 
If <em>etag</em> is specified (not an empty string) any existing file must have that etag, or a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with WRONG_ETAG will be thrown.<p>
5064
 
If <em>make_backup</em> is <code>true</code>, this function will attempt to make a backup of the file.<p>
5065
 
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>
5066
 
The returned <em>new_etag</em> can be used to verify that the file hasn't changed the next time it is saved over. <dl compact><dt><b>Parameters:</b></dt><dd>
5067
 
  <table border="0" cellspacing="2" cellpadding="0">
5068
 
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>A string containing the new contents for the file. </td></tr>
5069
 
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>The old entity tag for the document. </td></tr>
5070
 
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td><code>true</code> if a backup should be created. </td></tr>
5071
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
5072
 
    <tr><td valign="top"></td><td valign="top"><em>new_etag</em>&nbsp;</td><td>A location to a new entity tag for the document. </td></tr>
5073
 
    <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>
5074
 
  </table>
5075
 
</dl>
5076
 
 
5077
 
</div>
5078
 
</div><p>
5079
 
<a class="anchor" name="e7febf1f0f3b4b9efca9fae469082846"></a><!-- doxytag: member="Gio::File::replace_contents" ref="e7febf1f0f3b4b9efca9fae469082846" args="(const char *contents, gsize length, const std::string &amp;etag, std::string &amp;new_etag, bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE)" -->
5080
 
<div class="memitem">
5081
 
<div class="memproto">
5082
 
      <table class="memname">
5083
 
        <tr>
5084
 
          <td class="memname">void Gio::File::replace_contents           </td>
5085
 
          <td>(</td>
5086
 
          <td class="paramtype">const char *&nbsp;</td>
5087
 
          <td class="paramname"> <em>contents</em>, </td>
5088
 
        </tr>
5089
 
        <tr>
5090
 
          <td class="paramkey"></td>
5091
 
          <td></td>
5092
 
          <td class="paramtype">gsize&nbsp;</td>
5093
 
          <td class="paramname"> <em>length</em>, </td>
5094
 
        </tr>
5095
 
        <tr>
5096
 
          <td class="paramkey"></td>
5097
 
          <td></td>
5098
 
          <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>
5099
 
          <td class="paramname"> <em>etag</em>, </td>
5100
 
        </tr>
5101
 
        <tr>
5102
 
          <td class="paramkey"></td>
5103
 
          <td></td>
5104
 
          <td class="paramtype"><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>
5105
 
          <td class="paramname"> <em>new_etag</em>, </td>
5106
 
        </tr>
5107
 
        <tr>
5108
 
          <td class="paramkey"></td>
5109
 
          <td></td>
5110
 
          <td class="paramtype">bool&nbsp;</td>
5111
 
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
5112
 
        </tr>
5113
 
        <tr>
5114
 
          <td class="paramkey"></td>
5115
 
          <td></td>
5116
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
5117
 
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
5118
 
        </tr>
5119
 
        <tr>
5120
 
          <td></td>
5121
 
          <td>)</td>
5122
 
          <td></td><td></td><td></td>
5123
 
        </tr>
5124
 
      </table>
5125
 
</div>
5126
 
<div class="memdoc">
5127
 
 
5128
 
<p>
5129
 
Replaces the contents of the file with <em>contents</em> of <em>length</em> bytes. 
5130
 
<p>
5131
 
If <em>etag</em> is specified (not an empty string) any existing file must have that etag, or a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with WRONG_ETAG will be thrown.<p>
5132
 
If <em>make_backup</em> is <code>true</code>, this function will attempt to make a backup of the file.<p>
5133
 
The returned <em>new_etag</em> can be used to verify that the file hasn't changed the next time it is saved over. <dl compact><dt><b>Parameters:</b></dt><dd>
5134
 
  <table border="0" cellspacing="2" cellpadding="0">
5135
 
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>A string containing the new contents for the file. </td></tr>
5136
 
    <tr><td valign="top"></td><td valign="top"><em>length</em>&nbsp;</td><td>The length of <em>contents</em> in bytes. </td></tr>
5137
 
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>The old entity tag for the document. </td></tr>
5138
 
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td><code>true</code> if a backup should be created. </td></tr>
5139
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
5140
 
    <tr><td valign="top"></td><td valign="top"><em>new_etag</em>&nbsp;</td><td>A location to a new entity tag for the document. </td></tr>
5141
 
  </table>
5142
 
</dl>
5143
 
 
5144
 
</div>
5145
 
</div><p>
5146
 
<a class="anchor" name="f10deca1d5c5d1f650d3b182624330dc"></a><!-- doxytag: member="Gio::File::replace_contents" ref="f10deca1d5c5d1f650d3b182624330dc" args="(const char *contents, gsize length, const std::string &amp;etag, std::string &amp;new_etag, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE)" -->
5147
 
<div class="memitem">
5148
 
<div class="memproto">
5149
 
      <table class="memname">
5150
 
        <tr>
5151
 
          <td class="memname">void Gio::File::replace_contents           </td>
5152
 
          <td>(</td>
5153
 
          <td class="paramtype">const char *&nbsp;</td>
5154
 
          <td class="paramname"> <em>contents</em>, </td>
5155
 
        </tr>
5156
 
        <tr>
5157
 
          <td class="paramkey"></td>
5158
 
          <td></td>
5159
 
          <td class="paramtype">gsize&nbsp;</td>
5160
 
          <td class="paramname"> <em>length</em>, </td>
5161
 
        </tr>
5162
 
        <tr>
5163
 
          <td class="paramkey"></td>
5164
 
          <td></td>
5165
 
          <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>
5166
 
          <td class="paramname"> <em>etag</em>, </td>
5167
 
        </tr>
5168
 
        <tr>
5169
 
          <td class="paramkey"></td>
5170
 
          <td></td>
5171
 
          <td class="paramtype"><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>
5172
 
          <td class="paramname"> <em>new_etag</em>, </td>
5173
 
        </tr>
5174
 
        <tr>
5175
 
          <td class="paramkey"></td>
5176
 
          <td></td>
5177
 
          <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>
5178
 
          <td class="paramname"> <em>cancellable</em>, </td>
5179
 
        </tr>
5180
 
        <tr>
5181
 
          <td class="paramkey"></td>
5182
 
          <td></td>
5183
 
          <td class="paramtype">bool&nbsp;</td>
5184
 
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
5185
 
        </tr>
5186
 
        <tr>
5187
 
          <td class="paramkey"></td>
5188
 
          <td></td>
5189
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
5190
 
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
5191
 
        </tr>
5192
 
        <tr>
5193
 
          <td></td>
5194
 
          <td>)</td>
5195
 
          <td></td><td></td><td></td>
5196
 
        </tr>
5197
 
      </table>
5198
 
</div>
5199
 
<div class="memdoc">
5200
 
 
5201
 
<p>
5202
 
Replaces the contents of the file with <em>contents</em> of <em>length</em> bytes. 
5203
 
<p>
5204
 
If <em>etag</em> is specified (not an empty string) any existing file must have that etag, or a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with WRONG_ETAG will be thrown.<p>
5205
 
If <em>make_backup</em> is <code>true</code>, this function will attempt to make a backup of the file.<p>
5206
 
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>
5207
 
The returned <em>new_etag</em> can be used to verify that the file hasn't changed the next time it is saved over. <dl compact><dt><b>Parameters:</b></dt><dd>
5208
 
  <table border="0" cellspacing="2" cellpadding="0">
5209
 
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>A string containing the new contents for the file. </td></tr>
5210
 
    <tr><td valign="top"></td><td valign="top"><em>length</em>&nbsp;</td><td>The length of <em>contents</em> in bytes. </td></tr>
5211
 
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>The old entity tag for the document. </td></tr>
5212
 
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td><code>true</code> if a backup should be created. </td></tr>
5213
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
5214
 
    <tr><td valign="top"></td><td valign="top"><em>new_etag</em>&nbsp;</td><td>A location to a new entity tag for the document. </td></tr>
5215
 
    <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>
5216
 
  </table>
5217
 
</dl>
5218
 
 
5219
 
</div>
5220
 
</div><p>
5221
 
<a class="anchor" name="6fc86aab90620881899a701c2b2775cb"></a><!-- doxytag: member="Gio::File::replace_contents_async" ref="6fc86aab90620881899a701c2b2775cb" args="(const SlotAsyncReady &amp;slot, const std::string &amp;contents, const std::string &amp;etag, bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE)" -->
5222
 
<div class="memitem">
5223
 
<div class="memproto">
5224
 
      <table class="memname">
5225
 
        <tr>
5226
 
          <td class="memname">void Gio::File::replace_contents_async           </td>
5227
 
          <td>(</td>
5228
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
5229
 
          <td class="paramname"> <em>slot</em>, </td>
5230
 
        </tr>
5231
 
        <tr>
5232
 
          <td class="paramkey"></td>
5233
 
          <td></td>
5234
 
          <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>
5235
 
          <td class="paramname"> <em>contents</em>, </td>
5236
 
        </tr>
5237
 
        <tr>
5238
 
          <td class="paramkey"></td>
5239
 
          <td></td>
5240
 
          <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>
5241
 
          <td class="paramname"> <em>etag</em>, </td>
5242
 
        </tr>
5243
 
        <tr>
5244
 
          <td class="paramkey"></td>
5245
 
          <td></td>
5246
 
          <td class="paramtype">bool&nbsp;</td>
5247
 
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
5248
 
        </tr>
5249
 
        <tr>
5250
 
          <td class="paramkey"></td>
5251
 
          <td></td>
5252
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
5253
 
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
5254
 
        </tr>
5255
 
        <tr>
5256
 
          <td></td>
5257
 
          <td>)</td>
5258
 
          <td></td><td></td><td></td>
5259
 
        </tr>
5260
 
      </table>
5261
 
</div>
5262
 
<div class="memdoc">
5263
 
 
5264
 
<p>
5265
 
Starts an asynchronous replacement of the file with the given <em>contents</em>. 
5266
 
<p>
5267
 
<em>etag</em> will replace the document's current entity tag.<p>
5268
 
When this operation has completed, <em>slot</em> will be called and the operation can be finalized with <a class="el" href="classGio_1_1File.html#f019065c5503c7f47d778c20f8e5de32" title="Finishes an asynchronous replace of the given file .">replace_contents_finish()</a>.<p>
5269
 
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>
5270
 
If <em>make_backup</em> is true, this function will attempt to make a backup of the file.<p>
5271
 
<dl compact><dt><b>Parameters:</b></dt><dd>
5272
 
  <table border="0" cellspacing="2" cellpadding="0">
5273
 
    <tr><td valign="top"></td><td valign="top"><em>slot,:</em>&nbsp;</td><td>A callback to call when the request is satisfied. </td></tr>
5274
 
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>String of contents to replace the file with. </td></tr>
5275
 
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>a new entity tag for the file. </td></tr>
5276
 
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td>true if a backup should be created. </td></tr>
5277
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
5278
 
  </table>
5279
 
</dl>
5280
 
 
5281
 
</div>
5282
 
</div><p>
5283
 
<a class="anchor" name="380d6ce6362fc05e0e18ff1b881ceac7"></a><!-- doxytag: member="Gio::File::replace_contents_async" ref="380d6ce6362fc05e0e18ff1b881ceac7" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, const std::string &amp;contents, const std::string &amp;etag, bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE)" -->
5284
 
<div class="memitem">
5285
 
<div class="memproto">
5286
 
      <table class="memname">
5287
 
        <tr>
5288
 
          <td class="memname">void Gio::File::replace_contents_async           </td>
5289
 
          <td>(</td>
5290
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
5291
 
          <td class="paramname"> <em>slot</em>, </td>
5292
 
        </tr>
5293
 
        <tr>
5294
 
          <td class="paramkey"></td>
5295
 
          <td></td>
5296
 
          <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>
5297
 
          <td class="paramname"> <em>cancellable</em>, </td>
5298
 
        </tr>
5299
 
        <tr>
5300
 
          <td class="paramkey"></td>
5301
 
          <td></td>
5302
 
          <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>
5303
 
          <td class="paramname"> <em>contents</em>, </td>
5304
 
        </tr>
5305
 
        <tr>
5306
 
          <td class="paramkey"></td>
5307
 
          <td></td>
5308
 
          <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>
5309
 
          <td class="paramname"> <em>etag</em>, </td>
5310
 
        </tr>
5311
 
        <tr>
5312
 
          <td class="paramkey"></td>
5313
 
          <td></td>
5314
 
          <td class="paramtype">bool&nbsp;</td>
5315
 
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
5316
 
        </tr>
5317
 
        <tr>
5318
 
          <td class="paramkey"></td>
5319
 
          <td></td>
5320
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
5321
 
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
5322
 
        </tr>
5323
 
        <tr>
5324
 
          <td></td>
5325
 
          <td>)</td>
5326
 
          <td></td><td></td><td></td>
5327
 
        </tr>
5328
 
      </table>
5329
 
</div>
5330
 
<div class="memdoc">
5331
 
 
5332
 
<p>
5333
 
Starts an asynchronous replacement of the file with the given <em>contents</em> of <em>length</em> bytes. 
5334
 
<p>
5335
 
<em>etag</em> will replace the document's current entity tag.<p>
5336
 
When this operation has completed, <em>slot</em> will be called and the operation can be finalized with <a class="el" href="classGio_1_1File.html#f019065c5503c7f47d778c20f8e5de32" title="Finishes an asynchronous replace of the given file .">replace_contents_finish()</a>.<p>
5337
 
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>
5338
 
If <em>make_backup</em> is true, this function will attempt to make a backup of the file.<p>
5339
 
<dl compact><dt><b>Parameters:</b></dt><dd>
5340
 
  <table border="0" cellspacing="2" cellpadding="0">
5341
 
    <tr><td valign="top"></td><td valign="top"><em>slot,:</em>&nbsp;</td><td>A callback to call when the request is satisfied. </td></tr>
5342
 
    <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>
5343
 
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>String of contents to replace the file with. </td></tr>
5344
 
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>a new entity tag for the file. </td></tr>
5345
 
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td>true if a backup should be created. </td></tr>
5346
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
5347
 
  </table>
5348
 
</dl>
5349
 
 
5350
 
</div>
5351
 
</div><p>
5352
 
<a class="anchor" name="9a1c445e84124e16294974a73f2f1bbb"></a><!-- doxytag: member="Gio::File::replace_contents_async" ref="9a1c445e84124e16294974a73f2f1bbb" args="(const SlotAsyncReady &amp;slot, const char *contents, gsize length, const std::string &amp;etag, bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE)" -->
5353
 
<div class="memitem">
5354
 
<div class="memproto">
5355
 
      <table class="memname">
5356
 
        <tr>
5357
 
          <td class="memname">void Gio::File::replace_contents_async           </td>
5358
 
          <td>(</td>
5359
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
5360
 
          <td class="paramname"> <em>slot</em>, </td>
5361
 
        </tr>
5362
 
        <tr>
5363
 
          <td class="paramkey"></td>
5364
 
          <td></td>
5365
 
          <td class="paramtype">const char *&nbsp;</td>
5366
 
          <td class="paramname"> <em>contents</em>, </td>
5367
 
        </tr>
5368
 
        <tr>
5369
 
          <td class="paramkey"></td>
5370
 
          <td></td>
5371
 
          <td class="paramtype">gsize&nbsp;</td>
5372
 
          <td class="paramname"> <em>length</em>, </td>
5373
 
        </tr>
5374
 
        <tr>
5375
 
          <td class="paramkey"></td>
5376
 
          <td></td>
5377
 
          <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>
5378
 
          <td class="paramname"> <em>etag</em>, </td>
5379
 
        </tr>
5380
 
        <tr>
5381
 
          <td class="paramkey"></td>
5382
 
          <td></td>
5383
 
          <td class="paramtype">bool&nbsp;</td>
5384
 
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
5385
 
        </tr>
5386
 
        <tr>
5387
 
          <td class="paramkey"></td>
5388
 
          <td></td>
5389
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
5390
 
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
5391
 
        </tr>
5392
 
        <tr>
5393
 
          <td></td>
5394
 
          <td>)</td>
5395
 
          <td></td><td></td><td></td>
5396
 
        </tr>
5397
 
      </table>
5398
 
</div>
5399
 
<div class="memdoc">
5400
 
 
5401
 
<p>
5402
 
Starts an asynchronous replacement of the file with the given <em>contents</em> of <em>length</em> bytes. 
5403
 
<p>
5404
 
<em>etag</em> will replace the document's current entity tag.<p>
5405
 
When this operation has completed, <em>slot</em> will be called and the operation can be finalized with <a class="el" href="classGio_1_1File.html#f019065c5503c7f47d778c20f8e5de32" title="Finishes an asynchronous replace of the given file .">replace_contents_finish()</a>.<p>
5406
 
If <em>make_backup</em> is true, this function will attempt to make a backup of the file.<p>
5407
 
<dl compact><dt><b>Parameters:</b></dt><dd>
5408
 
  <table border="0" cellspacing="2" cellpadding="0">
5409
 
    <tr><td valign="top"></td><td valign="top"><em>slot,:</em>&nbsp;</td><td>A callback to call when the request is satisfied. </td></tr>
5410
 
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>String of contents to replace the file with. </td></tr>
5411
 
    <tr><td valign="top"></td><td valign="top"><em>length</em>&nbsp;</td><td>The length of <em>contents</em> in bytes. </td></tr>
5412
 
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>a new entity tag for the file. </td></tr>
5413
 
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td>true if a backup should be created. </td></tr>
5414
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
5415
 
  </table>
5416
 
</dl>
5417
 
 
5418
 
</div>
5419
 
</div><p>
5420
 
<a class="anchor" name="d33b24a7942429157f47379f4353378c"></a><!-- doxytag: member="Gio::File::replace_contents_async" ref="d33b24a7942429157f47379f4353378c" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, const char *contents, gsize length, const std::string &amp;etag, bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE)" -->
5421
 
<div class="memitem">
5422
 
<div class="memproto">
5423
 
      <table class="memname">
5424
 
        <tr>
5425
 
          <td class="memname">void Gio::File::replace_contents_async           </td>
5426
 
          <td>(</td>
5427
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
5428
 
          <td class="paramname"> <em>slot</em>, </td>
5429
 
        </tr>
5430
 
        <tr>
5431
 
          <td class="paramkey"></td>
5432
 
          <td></td>
5433
 
          <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>
5434
 
          <td class="paramname"> <em>cancellable</em>, </td>
5435
 
        </tr>
5436
 
        <tr>
5437
 
          <td class="paramkey"></td>
5438
 
          <td></td>
5439
 
          <td class="paramtype">const char *&nbsp;</td>
5440
 
          <td class="paramname"> <em>contents</em>, </td>
5441
 
        </tr>
5442
 
        <tr>
5443
 
          <td class="paramkey"></td>
5444
 
          <td></td>
5445
 
          <td class="paramtype">gsize&nbsp;</td>
5446
 
          <td class="paramname"> <em>length</em>, </td>
5447
 
        </tr>
5448
 
        <tr>
5449
 
          <td class="paramkey"></td>
5450
 
          <td></td>
5451
 
          <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>
5452
 
          <td class="paramname"> <em>etag</em>, </td>
5453
 
        </tr>
5454
 
        <tr>
5455
 
          <td class="paramkey"></td>
5456
 
          <td></td>
5457
 
          <td class="paramtype">bool&nbsp;</td>
5458
 
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
5459
 
        </tr>
5460
 
        <tr>
5461
 
          <td class="paramkey"></td>
5462
 
          <td></td>
5463
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
5464
 
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
5465
 
        </tr>
5466
 
        <tr>
5467
 
          <td></td>
5468
 
          <td>)</td>
5469
 
          <td></td><td></td><td></td>
5470
 
        </tr>
5471
 
      </table>
5472
 
</div>
5473
 
<div class="memdoc">
5474
 
 
5475
 
<p>
5476
 
Starts an asynchronous replacement of the file with the given <em>contents</em> of <em>length</em> bytes. 
5477
 
<p>
5478
 
<em>etag</em> will replace the document's current entity tag.<p>
5479
 
When this operation has completed, <em>slot</em> will be called and the operation can be finalized with <a class="el" href="classGio_1_1File.html#f019065c5503c7f47d778c20f8e5de32" title="Finishes an asynchronous replace of the given file .">replace_contents_finish()</a>.<p>
5480
 
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>
5481
 
If <em>make_backup</em> is true, this function will attempt to make a backup of the file.<p>
5482
 
<dl compact><dt><b>Parameters:</b></dt><dd>
5483
 
  <table border="0" cellspacing="2" cellpadding="0">
5484
 
    <tr><td valign="top"></td><td valign="top"><em>slot,:</em>&nbsp;</td><td>A callback to call when the request is satisfied. </td></tr>
5485
 
    <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>
5486
 
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>String of contents to replace the file with. </td></tr>
5487
 
    <tr><td valign="top"></td><td valign="top"><em>length</em>&nbsp;</td><td>The length of <em>contents</em> in bytes. </td></tr>
5488
 
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>a new entity tag for the file. </td></tr>
5489
 
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td>true if a backup should be created. </td></tr>
5490
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
5491
 
  </table>
5492
 
</dl>
5493
 
 
5494
 
</div>
5495
 
</div><p>
5496
 
<a class="anchor" name="f0372ffd3f535f39b7e48c0483e4c1f4"></a><!-- doxytag: member="Gio::File::replace_contents_finish" ref="f0372ffd3f535f39b7e48c0483e4c1f4" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
5497
 
<div class="memitem">
5498
 
<div class="memproto">
5499
 
      <table class="memname">
5500
 
        <tr>
5501
 
          <td class="memname">void Gio::File::replace_contents_finish           </td>
5502
 
          <td>(</td>
5503
 
          <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>
5504
 
          <td class="paramname"> <em>result</em>          </td>
5505
 
          <td>&nbsp;)&nbsp;</td>
5506
 
          <td></td>
5507
 
        </tr>
5508
 
      </table>
5509
 
</div>
5510
 
<div class="memdoc">
5511
 
 
5512
 
<p>
5513
 
Finishes an asynchronous replace of the given file . 
5514
 
<p>
5515
 
See <a class="el" href="classGio_1_1File.html#d33b24a7942429157f47379f4353378c" title="Starts an asynchronous replacement of the file with the given contents of length...">replace_contents_async()</a>. Sets <em>new_etag</em> to the new entity tag for the document. <dl compact><dt><b>Parameters:</b></dt><dd>
5516
 
  <table border="0" cellspacing="2" cellpadding="0">
5517
 
    <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>. for the document. </td></tr>
5518
 
  </table>
5519
 
</dl>
5520
 
 
5521
 
</div>
5522
 
</div><p>
5523
 
<a class="anchor" name="f019065c5503c7f47d778c20f8e5de32"></a><!-- doxytag: member="Gio::File::replace_contents_finish" ref="f019065c5503c7f47d778c20f8e5de32" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result, std::string &amp;etag)" -->
5524
 
<div class="memitem">
5525
 
<div class="memproto">
5526
 
      <table class="memname">
5527
 
        <tr>
5528
 
          <td class="memname">void Gio::File::replace_contents_finish           </td>
5529
 
          <td>(</td>
5530
 
          <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>
5531
 
          <td class="paramname"> <em>result</em>, </td>
5532
 
        </tr>
5533
 
        <tr>
5534
 
          <td class="paramkey"></td>
5535
 
          <td></td>
5536
 
          <td class="paramtype"><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>
5537
 
          <td class="paramname"> <em>etag</em></td><td>&nbsp;</td>
5538
 
        </tr>
5539
 
        <tr>
5540
 
          <td></td>
5541
 
          <td>)</td>
5542
 
          <td></td><td></td><td></td>
5543
 
        </tr>
5544
 
      </table>
5545
 
</div>
5546
 
<div class="memdoc">
5547
 
 
5548
 
<p>
5549
 
Finishes an asynchronous replace of the given file . 
5550
 
<p>
5551
 
See <a class="el" href="classGio_1_1File.html#d33b24a7942429157f47379f4353378c" title="Starts an asynchronous replacement of the file with the given contents of length...">replace_contents_async()</a>. Sets <em>new_etag</em> to the new entity tag for the document. <dl compact><dt><b>Parameters:</b></dt><dd>
5552
 
  <table border="0" cellspacing="2" cellpadding="0">
5553
 
    <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>
5554
 
    <tr><td valign="top"></td><td valign="top"><em>new_etag</em>&nbsp;</td><td>A location of a new entity tag for the document. </td></tr>
5555
 
  </table>
5556
 
</dl>
5557
 
 
5558
 
</div>
5559
 
</div><p>
5560
 
<a class="anchor" name="b28557d592f2c53df618728cf865e65e"></a><!-- doxytag: member="Gio::File::replace_finish" ref="b28557d592f2c53df618728cf865e65e" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
5561
 
<div class="memitem">
5562
 
<div class="memproto">
5563
 
      <table class="memname">
5564
 
        <tr>
5565
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileOutputStream.html">FileOutputStream</a>&gt; Gio::File::replace_finish           </td>
5566
 
          <td>(</td>
5567
 
          <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>
5568
 
          <td class="paramname"> <em>result</em>          </td>
5569
 
          <td>&nbsp;)&nbsp;</td>
5570
 
          <td></td>
5571
 
        </tr>
5572
 
      </table>
5573
 
</div>
5574
 
<div class="memdoc">
5575
 
 
5576
 
<p>
5577
 
Finishes an asynchronous file replace operation started with g_file_replace_async(). 
5578
 
<p>
5579
 
<dl compact><dt><b>Parameters:</b></dt><dd>
5580
 
  <table border="0" cellspacing="2" cellpadding="0">
5581
 
    <tr><td valign="top"></td><td valign="top"><em>res</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>
5582
 
  </table>
5583
 
</dl>
5584
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileOutputStream.html" title="FileOutputStream provides output streams that write their content to a file.">FileOutputStream</a>, or <code>0</code> on error. Free the returned object with Glib::object_unref(). </dd></dl>
5585
 
 
5586
 
</div>
5587
 
</div><p>
5588
 
<a class="anchor" name="c5e286d421c7236df39881f8ce0a4e03"></a><!-- doxytag: member="Gio::File::resolve_relative_path" ref="c5e286d421c7236df39881f8ce0a4e03" args="(const std::string &amp;relative_path) const " -->
5589
 
<div class="memitem">
5590
 
<div class="memproto">
5591
 
      <table class="memname">
5592
 
        <tr>
5593
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt; Gio::File::resolve_relative_path           </td>
5594
 
          <td>(</td>
5595
 
          <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>
5596
 
          <td class="paramname"> <em>relative_path</em>          </td>
5597
 
          <td>&nbsp;)&nbsp;</td>
5598
 
          <td> const</td>
5599
 
        </tr>
5600
 
      </table>
5601
 
</div>
5602
 
<div class="memdoc">
5603
 
 
5604
 
<p>
5605
 
Resolves a relative path for <em>file</em> to an absolute path. 
5606
 
<p>
5607
 
This call does no blocking i/o. <dl compact><dt><b>Parameters:</b></dt><dd>
5608
 
  <table border="0" cellspacing="2" cellpadding="0">
5609
 
    <tr><td valign="top"></td><td valign="top"><em>relative_path</em>&nbsp;</td><td>A given relative path string. </td></tr>
5610
 
  </table>
5611
 
</dl>
5612
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> to the resolved path. <code>0</code> if <em>relative_path</em> is <code>0</code> or if <em>file</em> is invalid. Free the returned object with Glib::object_unref(). </dd></dl>
5613
 
 
5614
 
</div>
5615
 
</div><p>
5616
 
<a class="anchor" name="09f574259052186e1b516bdcbe696710"></a><!-- doxytag: member="Gio::File::set_attribute_byte_string" ref="09f574259052186e1b516bdcbe696710" args="(const std::string &amp;attribute, const std::string &amp;value, FileQueryInfoFlags flags)" -->
5617
 
<div class="memitem">
5618
 
<div class="memproto">
5619
 
      <table class="memname">
5620
 
        <tr>
5621
 
          <td class="memname">bool Gio::File::set_attribute_byte_string           </td>
5622
 
          <td>(</td>
5623
 
          <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>
5624
 
          <td class="paramname"> <em>attribute</em>, </td>
5625
 
        </tr>
5626
 
        <tr>
5627
 
          <td class="paramkey"></td>
5628
 
          <td></td>
5629
 
          <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>
5630
 
          <td class="paramname"> <em>value</em>, </td>
5631
 
        </tr>
5632
 
        <tr>
5633
 
          <td class="paramkey"></td>
5634
 
          <td></td>
5635
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
5636
 
          <td class="paramname"> <em>flags</em></td><td>&nbsp;</td>
5637
 
        </tr>
5638
 
        <tr>
5639
 
          <td></td>
5640
 
          <td>)</td>
5641
 
          <td></td><td></td><td></td>
5642
 
        </tr>
5643
 
      </table>
5644
 
</div>
5645
 
<div class="memdoc">
5646
 
 
5647
 
<p>
5648
 
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_BYTE_STRING to <em>value</em>. 
5649
 
<p>
5650
 
If <em>attribute</em> is of a different type, this operation will fail, returning <code>false</code>.<p>
5651
 
<dl compact><dt><b>Parameters:</b></dt><dd>
5652
 
  <table border="0" cellspacing="2" cellpadding="0">
5653
 
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
5654
 
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A string containing the attribute's new value. </td></tr>
5655
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A FileQueryInfoFlags. </td></tr>
5656
 
  </table>
5657
 
</dl>
5658
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set to <em>value</em> in the <em>file</em>, <code>false</code> otherwise. </dd></dl>
5659
 
 
5660
 
</div>
5661
 
</div><p>
5662
 
<a class="anchor" name="4f4373b8694c346a6908195f1f2644f3"></a><!-- doxytag: member="Gio::File::set_attribute_byte_string" ref="4f4373b8694c346a6908195f1f2644f3" args="(const std::string &amp;attribute, const std::string &amp;value, FileQueryInfoFlags flags, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
5663
 
<div class="memitem">
5664
 
<div class="memproto">
5665
 
      <table class="memname">
5666
 
        <tr>
5667
 
          <td class="memname">bool Gio::File::set_attribute_byte_string           </td>
5668
 
          <td>(</td>
5669
 
          <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>
5670
 
          <td class="paramname"> <em>attribute</em>, </td>
5671
 
        </tr>
5672
 
        <tr>
5673
 
          <td class="paramkey"></td>
5674
 
          <td></td>
5675
 
          <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>
5676
 
          <td class="paramname"> <em>value</em>, </td>
5677
 
        </tr>
5678
 
        <tr>
5679
 
          <td class="paramkey"></td>
5680
 
          <td></td>
5681
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
5682
 
          <td class="paramname"> <em>flags</em>, </td>
5683
 
        </tr>
5684
 
        <tr>
5685
 
          <td class="paramkey"></td>
5686
 
          <td></td>
5687
 
          <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>
5688
 
          <td class="paramname"> <em>cancellable</em></td><td>&nbsp;</td>
5689
 
        </tr>
5690
 
        <tr>
5691
 
          <td></td>
5692
 
          <td>)</td>
5693
 
          <td></td><td></td><td></td>
5694
 
        </tr>
5695
 
      </table>
5696
 
</div>
5697
 
<div class="memdoc">
5698
 
 
5699
 
<p>
5700
 
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_BYTE_STRING to <em>value</em>. 
5701
 
<p>
5702
 
If <em>attribute</em> is of a different type, this operation will fail, returning <code>false</code>.<p>
5703
 
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
5704
 
  <table border="0" cellspacing="2" cellpadding="0">
5705
 
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
5706
 
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A string containing the attribute's new value. </td></tr>
5707
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A FileQueryInfoFlags. </td></tr>
5708
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
5709
 
  </table>
5710
 
</dl>
5711
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set to <em>value</em> in the <em>file</em>, <code>false</code> otherwise. </dd></dl>
5712
 
 
5713
 
</div>
5714
 
</div><p>
5715
 
<a class="anchor" name="4a707084a3c0a963548a21d17d0ec0b5"></a><!-- doxytag: member="Gio::File::set_attribute_int32" ref="4a707084a3c0a963548a21d17d0ec0b5" args="(const std::string &amp;attribute, gint32 value, FileQueryInfoFlags flags)" -->
5716
 
<div class="memitem">
5717
 
<div class="memproto">
5718
 
      <table class="memname">
5719
 
        <tr>
5720
 
          <td class="memname">bool Gio::File::set_attribute_int32           </td>
5721
 
          <td>(</td>
5722
 
          <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>
5723
 
          <td class="paramname"> <em>attribute</em>, </td>
5724
 
        </tr>
5725
 
        <tr>
5726
 
          <td class="paramkey"></td>
5727
 
          <td></td>
5728
 
          <td class="paramtype">gint32&nbsp;</td>
5729
 
          <td class="paramname"> <em>value</em>, </td>
5730
 
        </tr>
5731
 
        <tr>
5732
 
          <td class="paramkey"></td>
5733
 
          <td></td>
5734
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
5735
 
          <td class="paramname"> <em>flags</em></td><td>&nbsp;</td>
5736
 
        </tr>
5737
 
        <tr>
5738
 
          <td></td>
5739
 
          <td>)</td>
5740
 
          <td></td><td></td><td></td>
5741
 
        </tr>
5742
 
      </table>
5743
 
</div>
5744
 
<div class="memdoc">
5745
 
 
5746
 
<p>
5747
 
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_INT32 to <em>value</em>. 
5748
 
<p>
5749
 
If <em>attribute</em> is of a different type, this operation will fail.<p>
5750
 
<dl compact><dt><b>Parameters:</b></dt><dd>
5751
 
  <table border="0" cellspacing="2" cellpadding="0">
5752
 
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
5753
 
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A gint32 containing the attribute's new value. </td></tr>
5754
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A FileQueryInfoFlags. </td></tr>
5755
 
  </table>
5756
 
</dl>
5757
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set to <em>value</em> in the <em>file</em>, <code>false</code> otherwise. </dd></dl>
5758
 
 
5759
 
</div>
5760
 
</div><p>
5761
 
<a class="anchor" name="b0290ecba7b06ccf7736e2292708667e"></a><!-- doxytag: member="Gio::File::set_attribute_int32" ref="b0290ecba7b06ccf7736e2292708667e" args="(const std::string &amp;attribute, gint32 value, FileQueryInfoFlags flags, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
5762
 
<div class="memitem">
5763
 
<div class="memproto">
5764
 
      <table class="memname">
5765
 
        <tr>
5766
 
          <td class="memname">bool Gio::File::set_attribute_int32           </td>
5767
 
          <td>(</td>
5768
 
          <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>
5769
 
          <td class="paramname"> <em>attribute</em>, </td>
5770
 
        </tr>
5771
 
        <tr>
5772
 
          <td class="paramkey"></td>
5773
 
          <td></td>
5774
 
          <td class="paramtype">gint32&nbsp;</td>
5775
 
          <td class="paramname"> <em>value</em>, </td>
5776
 
        </tr>
5777
 
        <tr>
5778
 
          <td class="paramkey"></td>
5779
 
          <td></td>
5780
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
5781
 
          <td class="paramname"> <em>flags</em>, </td>
5782
 
        </tr>
5783
 
        <tr>
5784
 
          <td class="paramkey"></td>
5785
 
          <td></td>
5786
 
          <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>
5787
 
          <td class="paramname"> <em>cancellable</em></td><td>&nbsp;</td>
5788
 
        </tr>
5789
 
        <tr>
5790
 
          <td></td>
5791
 
          <td>)</td>
5792
 
          <td></td><td></td><td></td>
5793
 
        </tr>
5794
 
      </table>
5795
 
</div>
5796
 
<div class="memdoc">
5797
 
 
5798
 
<p>
5799
 
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_INT32 to <em>value</em>. 
5800
 
<p>
5801
 
If <em>attribute</em> is of a different type, this operation will fail.<p>
5802
 
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
5803
 
  <table border="0" cellspacing="2" cellpadding="0">
5804
 
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
5805
 
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A gint32 containing the attribute's new value. </td></tr>
5806
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A FileQueryInfoFlags. </td></tr>
5807
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
5808
 
  </table>
5809
 
</dl>
5810
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set to <em>value</em> in the <em>file</em>, <code>false</code> otherwise. </dd></dl>
5811
 
 
5812
 
</div>
5813
 
</div><p>
5814
 
<a class="anchor" name="4477b0063110951b26c855696ec34802"></a><!-- doxytag: member="Gio::File::set_attribute_int64" ref="4477b0063110951b26c855696ec34802" args="(const std::string &amp;attribute, gint64 value, FileQueryInfoFlags flags)" -->
5815
 
<div class="memitem">
5816
 
<div class="memproto">
5817
 
      <table class="memname">
5818
 
        <tr>
5819
 
          <td class="memname">bool Gio::File::set_attribute_int64           </td>
5820
 
          <td>(</td>
5821
 
          <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>
5822
 
          <td class="paramname"> <em>attribute</em>, </td>
5823
 
        </tr>
5824
 
        <tr>
5825
 
          <td class="paramkey"></td>
5826
 
          <td></td>
5827
 
          <td class="paramtype">gint64&nbsp;</td>
5828
 
          <td class="paramname"> <em>value</em>, </td>
5829
 
        </tr>
5830
 
        <tr>
5831
 
          <td class="paramkey"></td>
5832
 
          <td></td>
5833
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
5834
 
          <td class="paramname"> <em>flags</em></td><td>&nbsp;</td>
5835
 
        </tr>
5836
 
        <tr>
5837
 
          <td></td>
5838
 
          <td>)</td>
5839
 
          <td></td><td></td><td></td>
5840
 
        </tr>
5841
 
      </table>
5842
 
</div>
5843
 
<div class="memdoc">
5844
 
 
5845
 
<p>
5846
 
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_INT64 to <em>value</em>. 
5847
 
<p>
5848
 
If <em>attribute</em> is of a different type, this operation will fail.<p>
5849
 
<dl compact><dt><b>Parameters:</b></dt><dd>
5850
 
  <table border="0" cellspacing="2" cellpadding="0">
5851
 
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
5852
 
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A guint64 containing the attribute's new value. </td></tr>
5853
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A FileQueryInfoFlags. </td></tr>
5854
 
  </table>
5855
 
</dl>
5856
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set, <code>false</code> otherwise. </dd></dl>
5857
 
 
5858
 
</div>
5859
 
</div><p>
5860
 
<a class="anchor" name="111d73a2d003e5a5a4c5f86c7c3d2fb7"></a><!-- doxytag: member="Gio::File::set_attribute_int64" ref="111d73a2d003e5a5a4c5f86c7c3d2fb7" args="(const std::string &amp;attribute, gint64 value, FileQueryInfoFlags flags, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
5861
 
<div class="memitem">
5862
 
<div class="memproto">
5863
 
      <table class="memname">
5864
 
        <tr>
5865
 
          <td class="memname">bool Gio::File::set_attribute_int64           </td>
5866
 
          <td>(</td>
5867
 
          <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>
5868
 
          <td class="paramname"> <em>attribute</em>, </td>
5869
 
        </tr>
5870
 
        <tr>
5871
 
          <td class="paramkey"></td>
5872
 
          <td></td>
5873
 
          <td class="paramtype">gint64&nbsp;</td>
5874
 
          <td class="paramname"> <em>value</em>, </td>
5875
 
        </tr>
5876
 
        <tr>
5877
 
          <td class="paramkey"></td>
5878
 
          <td></td>
5879
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
5880
 
          <td class="paramname"> <em>flags</em>, </td>
5881
 
        </tr>
5882
 
        <tr>
5883
 
          <td class="paramkey"></td>
5884
 
          <td></td>
5885
 
          <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>
5886
 
          <td class="paramname"> <em>cancellable</em></td><td>&nbsp;</td>
5887
 
        </tr>
5888
 
        <tr>
5889
 
          <td></td>
5890
 
          <td>)</td>
5891
 
          <td></td><td></td><td></td>
5892
 
        </tr>
5893
 
      </table>
5894
 
</div>
5895
 
<div class="memdoc">
5896
 
 
5897
 
<p>
5898
 
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_INT64 to <em>value</em>. 
5899
 
<p>
5900
 
If <em>attribute</em> is of a different type, this operation will fail.<p>
5901
 
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
5902
 
  <table border="0" cellspacing="2" cellpadding="0">
5903
 
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
5904
 
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A guint64 containing the attribute's new value. </td></tr>
5905
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A FileQueryInfoFlags. </td></tr>
5906
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
5907
 
  </table>
5908
 
</dl>
5909
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set, <code>false</code> otherwise. </dd></dl>
5910
 
 
5911
 
</div>
5912
 
</div><p>
5913
 
<a class="anchor" name="75fa7e1a44e97a910d232f2b4ab4bfdd"></a><!-- doxytag: member="Gio::File::set_attribute_string" ref="75fa7e1a44e97a910d232f2b4ab4bfdd" args="(const std::string &amp;attribute, const std::string &amp;value, FileQueryInfoFlags flags)" -->
5914
 
<div class="memitem">
5915
 
<div class="memproto">
5916
 
      <table class="memname">
5917
 
        <tr>
5918
 
          <td class="memname">bool Gio::File::set_attribute_string           </td>
5919
 
          <td>(</td>
5920
 
          <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>
5921
 
          <td class="paramname"> <em>attribute</em>, </td>
5922
 
        </tr>
5923
 
        <tr>
5924
 
          <td class="paramkey"></td>
5925
 
          <td></td>
5926
 
          <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>
5927
 
          <td class="paramname"> <em>value</em>, </td>
5928
 
        </tr>
5929
 
        <tr>
5930
 
          <td class="paramkey"></td>
5931
 
          <td></td>
5932
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
5933
 
          <td class="paramname"> <em>flags</em></td><td>&nbsp;</td>
5934
 
        </tr>
5935
 
        <tr>
5936
 
          <td></td>
5937
 
          <td>)</td>
5938
 
          <td></td><td></td><td></td>
5939
 
        </tr>
5940
 
      </table>
5941
 
</div>
5942
 
<div class="memdoc">
5943
 
 
5944
 
<p>
5945
 
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_STRING to <em>value</em>. 
5946
 
<p>
5947
 
If <em>attribute</em> is of a different type, this operation will fail.<p>
5948
 
<dl compact><dt><b>Parameters:</b></dt><dd>
5949
 
  <table border="0" cellspacing="2" cellpadding="0">
5950
 
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
5951
 
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A string containing the attribute's value. </td></tr>
5952
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>FileQueryInfoFlags. </td></tr>
5953
 
  </table>
5954
 
</dl>
5955
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set, <code>false</code> otherwise. </dd></dl>
5956
 
 
5957
 
</div>
5958
 
</div><p>
5959
 
<a class="anchor" name="5ce5f43fd5e2836ac1989a54d3233ff6"></a><!-- doxytag: member="Gio::File::set_attribute_string" ref="5ce5f43fd5e2836ac1989a54d3233ff6" args="(const std::string &amp;attribute, const std::string &amp;value, FileQueryInfoFlags flags, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
5960
 
<div class="memitem">
5961
 
<div class="memproto">
5962
 
      <table class="memname">
5963
 
        <tr>
5964
 
          <td class="memname">bool Gio::File::set_attribute_string           </td>
5965
 
          <td>(</td>
5966
 
          <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>
5967
 
          <td class="paramname"> <em>attribute</em>, </td>
5968
 
        </tr>
5969
 
        <tr>
5970
 
          <td class="paramkey"></td>
5971
 
          <td></td>
5972
 
          <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>
5973
 
          <td class="paramname"> <em>value</em>, </td>
5974
 
        </tr>
5975
 
        <tr>
5976
 
          <td class="paramkey"></td>
5977
 
          <td></td>
5978
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
5979
 
          <td class="paramname"> <em>flags</em>, </td>
5980
 
        </tr>
5981
 
        <tr>
5982
 
          <td class="paramkey"></td>
5983
 
          <td></td>
5984
 
          <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>
5985
 
          <td class="paramname"> <em>cancellable</em></td><td>&nbsp;</td>
5986
 
        </tr>
5987
 
        <tr>
5988
 
          <td></td>
5989
 
          <td>)</td>
5990
 
          <td></td><td></td><td></td>
5991
 
        </tr>
5992
 
      </table>
5993
 
</div>
5994
 
<div class="memdoc">
5995
 
 
5996
 
<p>
5997
 
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_STRING to <em>value</em>. 
5998
 
<p>
5999
 
If <em>attribute</em> is of a different type, this operation will fail.<p>
6000
 
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
6001
 
  <table border="0" cellspacing="2" cellpadding="0">
6002
 
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
6003
 
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A string containing the attribute's value. </td></tr>
6004
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>FileQueryInfoFlags. </td></tr>
6005
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
6006
 
  </table>
6007
 
</dl>
6008
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set, <code>false</code> otherwise. </dd></dl>
6009
 
 
6010
 
</div>
6011
 
</div><p>
6012
 
<a class="anchor" name="7f769f140143f2e96a7587a10b6792a9"></a><!-- doxytag: member="Gio::File::set_attribute_uint32" ref="7f769f140143f2e96a7587a10b6792a9" args="(const std::string &amp;attribute, guint32 value, FileQueryInfoFlags flags)" -->
6013
 
<div class="memitem">
6014
 
<div class="memproto">
6015
 
      <table class="memname">
6016
 
        <tr>
6017
 
          <td class="memname">bool Gio::File::set_attribute_uint32           </td>
6018
 
          <td>(</td>
6019
 
          <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>
6020
 
          <td class="paramname"> <em>attribute</em>, </td>
6021
 
        </tr>
6022
 
        <tr>
6023
 
          <td class="paramkey"></td>
6024
 
          <td></td>
6025
 
          <td class="paramtype">guint32&nbsp;</td>
6026
 
          <td class="paramname"> <em>value</em>, </td>
6027
 
        </tr>
6028
 
        <tr>
6029
 
          <td class="paramkey"></td>
6030
 
          <td></td>
6031
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
6032
 
          <td class="paramname"> <em>flags</em></td><td>&nbsp;</td>
6033
 
        </tr>
6034
 
        <tr>
6035
 
          <td></td>
6036
 
          <td>)</td>
6037
 
          <td></td><td></td><td></td>
6038
 
        </tr>
6039
 
      </table>
6040
 
</div>
6041
 
<div class="memdoc">
6042
 
 
6043
 
<p>
6044
 
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_UINT32 to <em>value</em>. 
6045
 
<p>
6046
 
If <em>attribute</em> is of a different type, this operation will fail.<p>
6047
 
<dl compact><dt><b>Parameters:</b></dt><dd>
6048
 
  <table border="0" cellspacing="2" cellpadding="0">
6049
 
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
6050
 
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A guint32 containing the attribute's new value. </td></tr>
6051
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A FileQueryInfoFlags. </td></tr>
6052
 
  </table>
6053
 
</dl>
6054
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set to <em>value</em> in the <em>file</em>, <code>false</code> otherwise. </dd></dl>
6055
 
 
6056
 
</div>
6057
 
</div><p>
6058
 
<a class="anchor" name="e53b0f4d2214e050a290c8e35cac0f27"></a><!-- doxytag: member="Gio::File::set_attribute_uint32" ref="e53b0f4d2214e050a290c8e35cac0f27" args="(const std::string &amp;attribute, guint32 value, FileQueryInfoFlags flags, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
6059
 
<div class="memitem">
6060
 
<div class="memproto">
6061
 
      <table class="memname">
6062
 
        <tr>
6063
 
          <td class="memname">bool Gio::File::set_attribute_uint32           </td>
6064
 
          <td>(</td>
6065
 
          <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>
6066
 
          <td class="paramname"> <em>attribute</em>, </td>
6067
 
        </tr>
6068
 
        <tr>
6069
 
          <td class="paramkey"></td>
6070
 
          <td></td>
6071
 
          <td class="paramtype">guint32&nbsp;</td>
6072
 
          <td class="paramname"> <em>value</em>, </td>
6073
 
        </tr>
6074
 
        <tr>
6075
 
          <td class="paramkey"></td>
6076
 
          <td></td>
6077
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
6078
 
          <td class="paramname"> <em>flags</em>, </td>
6079
 
        </tr>
6080
 
        <tr>
6081
 
          <td class="paramkey"></td>
6082
 
          <td></td>
6083
 
          <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>
6084
 
          <td class="paramname"> <em>cancellable</em></td><td>&nbsp;</td>
6085
 
        </tr>
6086
 
        <tr>
6087
 
          <td></td>
6088
 
          <td>)</td>
6089
 
          <td></td><td></td><td></td>
6090
 
        </tr>
6091
 
      </table>
6092
 
</div>
6093
 
<div class="memdoc">
6094
 
 
6095
 
<p>
6096
 
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_UINT32 to <em>value</em>. 
6097
 
<p>
6098
 
If <em>attribute</em> is of a different type, this operation will fail.<p>
6099
 
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
6100
 
  <table border="0" cellspacing="2" cellpadding="0">
6101
 
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
6102
 
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A guint32 containing the attribute's new value. </td></tr>
6103
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A FileQueryInfoFlags. </td></tr>
6104
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
6105
 
  </table>
6106
 
</dl>
6107
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set to <em>value</em> in the <em>file</em>, <code>false</code> otherwise. </dd></dl>
6108
 
 
6109
 
</div>
6110
 
</div><p>
6111
 
<a class="anchor" name="4aa77b3580df88cfd3d7231af78155c7"></a><!-- doxytag: member="Gio::File::set_attribute_uint64" ref="4aa77b3580df88cfd3d7231af78155c7" args="(const std::string &amp;attribute, guint64 value, FileQueryInfoFlags flags)" -->
6112
 
<div class="memitem">
6113
 
<div class="memproto">
6114
 
      <table class="memname">
6115
 
        <tr>
6116
 
          <td class="memname">bool Gio::File::set_attribute_uint64           </td>
6117
 
          <td>(</td>
6118
 
          <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>
6119
 
          <td class="paramname"> <em>attribute</em>, </td>
6120
 
        </tr>
6121
 
        <tr>
6122
 
          <td class="paramkey"></td>
6123
 
          <td></td>
6124
 
          <td class="paramtype">guint64&nbsp;</td>
6125
 
          <td class="paramname"> <em>value</em>, </td>
6126
 
        </tr>
6127
 
        <tr>
6128
 
          <td class="paramkey"></td>
6129
 
          <td></td>
6130
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
6131
 
          <td class="paramname"> <em>flags</em></td><td>&nbsp;</td>
6132
 
        </tr>
6133
 
        <tr>
6134
 
          <td></td>
6135
 
          <td>)</td>
6136
 
          <td></td><td></td><td></td>
6137
 
        </tr>
6138
 
      </table>
6139
 
</div>
6140
 
<div class="memdoc">
6141
 
 
6142
 
<p>
6143
 
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_UINT64 to <em>value</em>. 
6144
 
<p>
6145
 
If <em>attribute</em> is of a different type, this operation will fail.<p>
6146
 
<dl compact><dt><b>Parameters:</b></dt><dd>
6147
 
  <table border="0" cellspacing="2" cellpadding="0">
6148
 
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
6149
 
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A guint64 containing the attribute's new value. </td></tr>
6150
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A FileQueryInfoFlags. </td></tr>
6151
 
  </table>
6152
 
</dl>
6153
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set to <em>value</em> in the <em>file</em>, <code>false</code> otherwise. </dd></dl>
6154
 
 
6155
 
</div>
6156
 
</div><p>
6157
 
<a class="anchor" name="48638081fd7af772a39af59a558b17f7"></a><!-- doxytag: member="Gio::File::set_attribute_uint64" ref="48638081fd7af772a39af59a558b17f7" args="(const std::string &amp;attribute, guint64 value, FileQueryInfoFlags flags, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
6158
 
<div class="memitem">
6159
 
<div class="memproto">
6160
 
      <table class="memname">
6161
 
        <tr>
6162
 
          <td class="memname">bool Gio::File::set_attribute_uint64           </td>
6163
 
          <td>(</td>
6164
 
          <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>
6165
 
          <td class="paramname"> <em>attribute</em>, </td>
6166
 
        </tr>
6167
 
        <tr>
6168
 
          <td class="paramkey"></td>
6169
 
          <td></td>
6170
 
          <td class="paramtype">guint64&nbsp;</td>
6171
 
          <td class="paramname"> <em>value</em>, </td>
6172
 
        </tr>
6173
 
        <tr>
6174
 
          <td class="paramkey"></td>
6175
 
          <td></td>
6176
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
6177
 
          <td class="paramname"> <em>flags</em>, </td>
6178
 
        </tr>
6179
 
        <tr>
6180
 
          <td class="paramkey"></td>
6181
 
          <td></td>
6182
 
          <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>
6183
 
          <td class="paramname"> <em>cancellable</em></td><td>&nbsp;</td>
6184
 
        </tr>
6185
 
        <tr>
6186
 
          <td></td>
6187
 
          <td>)</td>
6188
 
          <td></td><td></td><td></td>
6189
 
        </tr>
6190
 
      </table>
6191
 
</div>
6192
 
<div class="memdoc">
6193
 
 
6194
 
<p>
6195
 
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_UINT64 to <em>value</em>. 
6196
 
<p>
6197
 
If <em>attribute</em> is of a different type, this operation will fail.<p>
6198
 
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
6199
 
  <table border="0" cellspacing="2" cellpadding="0">
6200
 
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
6201
 
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A guint64 containing the attribute's new value. </td></tr>
6202
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A FileQueryInfoFlags. </td></tr>
6203
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
6204
 
  </table>
6205
 
</dl>
6206
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set to <em>value</em> in the <em>file</em>, <code>false</code> otherwise. </dd></dl>
6207
 
 
6208
 
</div>
6209
 
</div><p>
6210
 
<a class="anchor" name="61317a1980318537aa8ada7bb8cc2390"></a><!-- doxytag: member="Gio::File::set_attributes_async" ref="61317a1980318537aa8ada7bb8cc2390" args="(const Glib::RefPtr&lt; FileInfo &gt; &amp;info, const SlotAsyncReady &amp;slot, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
6211
 
<div class="memitem">
6212
 
<div class="memproto">
6213
 
      <table class="memname">
6214
 
        <tr>
6215
 
          <td class="memname">void Gio::File::set_attributes_async           </td>
6216
 
          <td>(</td>
6217
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileInfo.html">FileInfo</a>&gt;&amp;&nbsp;</td>
6218
 
          <td class="paramname"> <em>info</em>, </td>
6219
 
        </tr>
6220
 
        <tr>
6221
 
          <td class="paramkey"></td>
6222
 
          <td></td>
6223
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
6224
 
          <td class="paramname"> <em>slot</em>, </td>
6225
 
        </tr>
6226
 
        <tr>
6227
 
          <td class="paramkey"></td>
6228
 
          <td></td>
6229
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
6230
 
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code>, </td>
6231
 
        </tr>
6232
 
        <tr>
6233
 
          <td class="paramkey"></td>
6234
 
          <td></td>
6235
 
          <td class="paramtype">int&nbsp;</td>
6236
 
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
6237
 
        </tr>
6238
 
        <tr>
6239
 
          <td></td>
6240
 
          <td>)</td>
6241
 
          <td></td><td></td><td></td>
6242
 
        </tr>
6243
 
      </table>
6244
 
</div>
6245
 
<div class="memdoc">
6246
 
 
6247
 
<p>
6248
 
Asynchronously sets the attributes of file with info. 
6249
 
<p>
6250
 
For more details, see <a class="el" href="classGio_1_1File.html#69d9e40a85b96809abc5189b34e8d9b7" title="Tries to set all attributes in the FileInfo on the target values, not stopping on...">set_attributes_from_info()</a> which is the synchronous version of this call. When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#efd45aed7b975b6e204e67927de2817a">set_attributes_finish()</a> to get the result of the operation.<p>
6251
 
<dl compact><dt><b>Parameters:</b></dt><dd>
6252
 
  <table border="0" cellspacing="2" cellpadding="0">
6253
 
    <tr><td valign="top"></td><td valign="top"><em>info</em>&nbsp;</td><td>A <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a>. </td></tr>
6254
 
    <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>
6255
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
6256
 
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
6257
 
  </table>
6258
 
</dl>
6259
 
 
6260
 
</div>
6261
 
</div><p>
6262
 
<a class="anchor" name="14165fba9bf7d91448c3207407ae50c2"></a><!-- doxytag: member="Gio::File::set_attributes_async" ref="14165fba9bf7d91448c3207407ae50c2" args="(const Glib::RefPtr&lt; FileInfo &gt; &amp;info, const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
6263
 
<div class="memitem">
6264
 
<div class="memproto">
6265
 
      <table class="memname">
6266
 
        <tr>
6267
 
          <td class="memname">void Gio::File::set_attributes_async           </td>
6268
 
          <td>(</td>
6269
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileInfo.html">FileInfo</a>&gt;&amp;&nbsp;</td>
6270
 
          <td class="paramname"> <em>info</em>, </td>
6271
 
        </tr>
6272
 
        <tr>
6273
 
          <td class="paramkey"></td>
6274
 
          <td></td>
6275
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
6276
 
          <td class="paramname"> <em>slot</em>, </td>
6277
 
        </tr>
6278
 
        <tr>
6279
 
          <td class="paramkey"></td>
6280
 
          <td></td>
6281
 
          <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>
6282
 
          <td class="paramname"> <em>cancellable</em>, </td>
6283
 
        </tr>
6284
 
        <tr>
6285
 
          <td class="paramkey"></td>
6286
 
          <td></td>
6287
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
6288
 
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code>, </td>
6289
 
        </tr>
6290
 
        <tr>
6291
 
          <td class="paramkey"></td>
6292
 
          <td></td>
6293
 
          <td class="paramtype">int&nbsp;</td>
6294
 
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
6295
 
        </tr>
6296
 
        <tr>
6297
 
          <td></td>
6298
 
          <td>)</td>
6299
 
          <td></td><td></td><td></td>
6300
 
        </tr>
6301
 
      </table>
6302
 
</div>
6303
 
<div class="memdoc">
6304
 
 
6305
 
<p>
6306
 
Asynchronously sets the attributes of file with info. 
6307
 
<p>
6308
 
For more details, see <a class="el" href="classGio_1_1File.html#69d9e40a85b96809abc5189b34e8d9b7" title="Tries to set all attributes in the FileInfo on the target values, not stopping on...">set_attributes_from_info()</a> which is the synchronous version of this call. When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#efd45aed7b975b6e204e67927de2817a">set_attributes_finish()</a> to get the result of the operation.<p>
6309
 
<dl compact><dt><b>Parameters:</b></dt><dd>
6310
 
  <table border="0" cellspacing="2" cellpadding="0">
6311
 
    <tr><td valign="top"></td><td valign="top"><em>info</em>&nbsp;</td><td>A <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a>. </td></tr>
6312
 
    <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>
6313
 
    <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>
6314
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
6315
 
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
6316
 
  </table>
6317
 
</dl>
6318
 
 
6319
 
</div>
6320
 
</div><p>
6321
 
<a class="anchor" name="efd45aed7b975b6e204e67927de2817a"></a><!-- doxytag: member="Gio::File::set_attributes_finish" ref="efd45aed7b975b6e204e67927de2817a" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result, const Glib::RefPtr&lt; FileInfo &gt; &amp;info)" -->
6322
 
<div class="memitem">
6323
 
<div class="memproto">
6324
 
      <table class="memname">
6325
 
        <tr>
6326
 
          <td class="memname">bool Gio::File::set_attributes_finish           </td>
6327
 
          <td>(</td>
6328
 
          <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>
6329
 
          <td class="paramname"> <em>result</em>, </td>
6330
 
        </tr>
6331
 
        <tr>
6332
 
          <td class="paramkey"></td>
6333
 
          <td></td>
6334
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileInfo.html">FileInfo</a>&gt;&amp;&nbsp;</td>
6335
 
          <td class="paramname"> <em>info</em></td><td>&nbsp;</td>
6336
 
        </tr>
6337
 
        <tr>
6338
 
          <td></td>
6339
 
          <td>)</td>
6340
 
          <td></td><td></td><td></td>
6341
 
        </tr>
6342
 
      </table>
6343
 
</div>
6344
 
<div class="memdoc">
6345
 
 
6346
 
<p>
6347
 
 
6348
 
</div>
6349
 
</div><p>
6350
 
<a class="anchor" name="e9f6975ffef28f0d7145601a99de0903"></a><!-- doxytag: member="Gio::File::set_attributes_from_info" ref="e9f6975ffef28f0d7145601a99de0903" args="(const Glib::RefPtr&lt; FileInfo &gt; &amp;info, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE)" -->
6351
 
<div class="memitem">
6352
 
<div class="memproto">
6353
 
      <table class="memname">
6354
 
        <tr>
6355
 
          <td class="memname">bool Gio::File::set_attributes_from_info           </td>
6356
 
          <td>(</td>
6357
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileInfo.html">FileInfo</a>&gt;&amp;&nbsp;</td>
6358
 
          <td class="paramname"> <em>info</em>, </td>
6359
 
        </tr>
6360
 
        <tr>
6361
 
          <td class="paramkey"></td>
6362
 
          <td></td>
6363
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
6364
 
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code></td><td>&nbsp;</td>
6365
 
        </tr>
6366
 
        <tr>
6367
 
          <td></td>
6368
 
          <td>)</td>
6369
 
          <td></td><td></td><td></td>
6370
 
        </tr>
6371
 
      </table>
6372
 
</div>
6373
 
<div class="memdoc">
6374
 
 
6375
 
<p>
6376
 
Tries to set all attributes in the <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> on the target values, not stopping on the first error. 
6377
 
<p>
6378
 
If there is any error during this operation then a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> will be thrown. <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Error</a> on particular fields are flagged by setting the "status" field in the attribute value to FILE_ATTRIBUTE_STATUS_ERROR_SETTING, which means you can also detect further errors.<p>
6379
 
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>
6380
 
<dl compact><dt><b>Parameters:</b></dt><dd>
6381
 
  <table border="0" cellspacing="2" cellpadding="0">
6382
 
    <tr><td valign="top"></td><td valign="top"><em>info</em>&nbsp;</td><td>A <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a>. </td></tr>
6383
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
6384
 
  </table>
6385
 
</dl>
6386
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if there was any error, <code>false</code> otherwise. </dd></dl>
6387
 
 
6388
 
</div>
6389
 
</div><p>
6390
 
<a class="anchor" name="69d9e40a85b96809abc5189b34e8d9b7"></a><!-- doxytag: member="Gio::File::set_attributes_from_info" ref="69d9e40a85b96809abc5189b34e8d9b7" args="(const Glib::RefPtr&lt; FileInfo &gt; &amp;info, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE)" -->
6391
 
<div class="memitem">
6392
 
<div class="memproto">
6393
 
      <table class="memname">
6394
 
        <tr>
6395
 
          <td class="memname">bool Gio::File::set_attributes_from_info           </td>
6396
 
          <td>(</td>
6397
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileInfo.html">FileInfo</a>&gt;&amp;&nbsp;</td>
6398
 
          <td class="paramname"> <em>info</em>, </td>
6399
 
        </tr>
6400
 
        <tr>
6401
 
          <td class="paramkey"></td>
6402
 
          <td></td>
6403
 
          <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>
6404
 
          <td class="paramname"> <em>cancellable</em>, </td>
6405
 
        </tr>
6406
 
        <tr>
6407
 
          <td class="paramkey"></td>
6408
 
          <td></td>
6409
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
6410
 
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code></td><td>&nbsp;</td>
6411
 
        </tr>
6412
 
        <tr>
6413
 
          <td></td>
6414
 
          <td>)</td>
6415
 
          <td></td><td></td><td></td>
6416
 
        </tr>
6417
 
      </table>
6418
 
</div>
6419
 
<div class="memdoc">
6420
 
 
6421
 
<p>
6422
 
Tries to set all attributes in the <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> on the target values, not stopping on the first error. 
6423
 
<p>
6424
 
If there is any error during this operation then a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> will be thrown. <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Error</a> on particular fields are flagged by setting the "status" field in the attribute value to FILE_ATTRIBUTE_STATUS_ERROR_SETTING, which means you can also detect further errors.<p>
6425
 
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>
6426
 
<dl compact><dt><b>Parameters:</b></dt><dd>
6427
 
  <table border="0" cellspacing="2" cellpadding="0">
6428
 
    <tr><td valign="top"></td><td valign="top"><em>info</em>&nbsp;</td><td>A <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a>. </td></tr>
6429
 
    <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>
6430
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
6431
 
  </table>
6432
 
</dl>
6433
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if there was any error, <code>false</code> otherwise. </dd></dl>
 
2601
<a class="anchor" name="6eb675267c7ea1c2a0d40e2e754d8333"></a><!-- doxytag: member="Gio::File::find_enclosing_mount" ref="6eb675267c7ea1c2a0d40e2e754d8333" args="()" -->
 
2602
<div class="memitem">
 
2603
<div class="memproto">
 
2604
      <table class="memname">
 
2605
        <tr>
 
2606
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1Mount.html">Mount</a>&gt; Gio::File::find_enclosing_mount           </td>
 
2607
          <td>(</td>
 
2608
          <td class="paramname">          </td>
 
2609
          <td>&nbsp;)&nbsp;</td>
 
2610
          <td></td>
 
2611
        </tr>
 
2612
      </table>
 
2613
</div>
 
2614
<div class="memdoc">
 
2615
 
 
2616
<p>
 
2617
Gets a <a class="el" href="classGio_1_1Mount.html" title="The Mount interface represents user-visible mounts.">Mount</a> for the <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a>. 
 
2618
<p>
 
2619
If the FileIface for the file does not have a mount (e.g. possibly a remote share), an <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> wtih NOT_FOUND will be thrown and an empty RefPtr will be returned.<p>
 
2620
<dl compact><dt><b>Parameters:</b></dt><dd>
 
2621
  <table border="0" cellspacing="2" cellpadding="0">
 
2622
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
 
2623
  </table>
 
2624
</dl>
 
2625
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1Mount.html" title="The Mount interface represents user-visible mounts.">Mount</a> where the file is located. </dd></dl>
 
2626
 
 
2627
</div>
 
2628
</div><p>
 
2629
<a class="anchor" name="78c95d4fa47157f7757b686677dec018"></a><!-- doxytag: member="Gio::File::find_enclosing_mount_async" ref="78c95d4fa47157f7757b686677dec018" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, int io_priority=Glib::PRIORITY_DEFAULT)" -->
 
2630
<div class="memitem">
 
2631
<div class="memproto">
 
2632
      <table class="memname">
 
2633
        <tr>
 
2634
          <td class="memname">void Gio::File::find_enclosing_mount_async           </td>
 
2635
          <td>(</td>
 
2636
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
2637
          <td class="paramname"> <em>slot</em>, </td>
 
2638
        </tr>
 
2639
        <tr>
 
2640
          <td class="paramkey"></td>
 
2641
          <td></td>
 
2642
          <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>
 
2643
          <td class="paramname"> <em>cancellable</em>, </td>
 
2644
        </tr>
 
2645
        <tr>
 
2646
          <td class="paramkey"></td>
 
2647
          <td></td>
 
2648
          <td class="paramtype">int&nbsp;</td>
 
2649
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
 
2650
        </tr>
 
2651
        <tr>
 
2652
          <td></td>
 
2653
          <td>)</td>
 
2654
          <td></td><td></td><td></td>
 
2655
        </tr>
 
2656
      </table>
 
2657
</div>
 
2658
<div class="memdoc">
 
2659
 
 
2660
<p>
 
2661
Asynchronously gets the mount for the file. 
 
2662
<p>
 
2663
For more details, see <a class="el" href="classGio_1_1File.html#6eb675267c7ea1c2a0d40e2e754d8333" title="Gets a Mount for the File.">find_enclosing_mount()</a> which is the synchronous version of this call.<p>
 
2664
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#a12e6222d81179937cdc366f4d315433" title="Finishes an asynchronous find mount request.">find_enclosing_mount_finish()</a> to get the result of the operation.<p>
 
2665
<dl compact><dt><b>Parameters:</b></dt><dd>
 
2666
  <table border="0" cellspacing="2" cellpadding="0">
 
2667
    <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>
 
2668
    <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>
 
2669
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
 
2670
  </table>
 
2671
</dl>
 
2672
 
 
2673
</div>
 
2674
</div><p>
 
2675
<a class="anchor" name="67458be57c5687e7469bc26e2594f4be"></a><!-- doxytag: member="Gio::File::find_enclosing_mount_async" ref="67458be57c5687e7469bc26e2594f4be" args="(const SlotAsyncReady &amp;slot, int io_priority=Glib::PRIORITY_DEFAULT)" -->
 
2676
<div class="memitem">
 
2677
<div class="memproto">
 
2678
      <table class="memname">
 
2679
        <tr>
 
2680
          <td class="memname">void Gio::File::find_enclosing_mount_async           </td>
 
2681
          <td>(</td>
 
2682
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
2683
          <td class="paramname"> <em>slot</em>, </td>
 
2684
        </tr>
 
2685
        <tr>
 
2686
          <td class="paramkey"></td>
 
2687
          <td></td>
 
2688
          <td class="paramtype">int&nbsp;</td>
 
2689
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
 
2690
        </tr>
 
2691
        <tr>
 
2692
          <td></td>
 
2693
          <td>)</td>
 
2694
          <td></td><td></td><td></td>
 
2695
        </tr>
 
2696
      </table>
 
2697
</div>
 
2698
<div class="memdoc">
 
2699
 
 
2700
<p>
 
2701
Asynchronously gets the mount for the file. 
 
2702
<p>
 
2703
For more details, see <a class="el" href="classGio_1_1File.html#6eb675267c7ea1c2a0d40e2e754d8333" title="Gets a Mount for the File.">find_enclosing_mount()</a> which is the synchronous version of this call.<p>
 
2704
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#a12e6222d81179937cdc366f4d315433" title="Finishes an asynchronous find mount request.">find_enclosing_mount_finish()</a> to get the result of the operation.<p>
 
2705
<dl compact><dt><b>Parameters:</b></dt><dd>
 
2706
  <table border="0" cellspacing="2" cellpadding="0">
 
2707
    <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>
 
2708
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
 
2709
  </table>
 
2710
</dl>
 
2711
 
 
2712
</div>
 
2713
</div><p>
 
2714
<a class="anchor" name="a12e6222d81179937cdc366f4d315433"></a><!-- doxytag: member="Gio::File::find_enclosing_mount_finish" ref="a12e6222d81179937cdc366f4d315433" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
 
2715
<div class="memitem">
 
2716
<div class="memproto">
 
2717
      <table class="memname">
 
2718
        <tr>
 
2719
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1Mount.html">Mount</a>&gt; Gio::File::find_enclosing_mount_finish           </td>
 
2720
          <td>(</td>
 
2721
          <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>
 
2722
          <td class="paramname"> <em>result</em>          </td>
 
2723
          <td>&nbsp;)&nbsp;</td>
 
2724
          <td></td>
 
2725
        </tr>
 
2726
      </table>
 
2727
</div>
 
2728
<div class="memdoc">
 
2729
 
 
2730
<p>
 
2731
Finishes an asynchronous find mount request. 
 
2732
<p>
 
2733
See g_file_find_enclosing_mount_async(). <dl compact><dt><b>Parameters:</b></dt><dd>
 
2734
  <table border="0" cellspacing="2" cellpadding="0">
 
2735
    <tr><td valign="top"></td><td valign="top"><em>res</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>
 
2736
  </table>
 
2737
</dl>
 
2738
<dl class="return" compact><dt><b>Returns:</b></dt><dd><a class="el" href="classGio_1_1Mount.html" title="The Mount interface represents user-visible mounts.">Mount</a> for given <em>file</em> or <code>0</code> on error. Free the returned object with Glib::object_unref(). </dd></dl>
 
2739
 
 
2740
</div>
 
2741
</div><p>
 
2742
<a class="anchor" name="68c3afcddc0d4860aa2afb4bf715bb20"></a><!-- doxytag: member="Gio::File::enumerate_children" ref="68c3afcddc0d4860aa2afb4bf715bb20" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, const std::string &amp;attributes=&quot;*&quot;, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE)" -->
 
2743
<div class="memitem">
 
2744
<div class="memproto">
 
2745
      <table class="memname">
 
2746
        <tr>
 
2747
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileEnumerator.html">FileEnumerator</a>&gt; Gio::File::enumerate_children           </td>
 
2748
          <td>(</td>
 
2749
          <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>
 
2750
          <td class="paramname"> <em>cancellable</em>, </td>
 
2751
        </tr>
 
2752
        <tr>
 
2753
          <td class="paramkey"></td>
 
2754
          <td></td>
 
2755
          <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>
 
2756
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code>, </td>
 
2757
        </tr>
 
2758
        <tr>
 
2759
          <td class="paramkey"></td>
 
2760
          <td></td>
 
2761
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
2762
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code></td><td>&nbsp;</td>
 
2763
        </tr>
 
2764
        <tr>
 
2765
          <td></td>
 
2766
          <td>)</td>
 
2767
          <td></td><td></td><td></td>
 
2768
        </tr>
 
2769
      </table>
 
2770
</div>
 
2771
<div class="memdoc">
 
2772
 
 
2773
<p>
 
2774
Gets the requested information about the files in a directory. 
 
2775
<p>
 
2776
The result is a <a class="el" href="classGio_1_1FileEnumerator.html" title="Enumerated Files Routines.">FileEnumerator</a> object that will give out <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> objects for all the files in the directory.<p>
 
2777
The <em>attribute</em> value is a string that specifies the file attributes that should be gathered. It is not an error if its not possible to read a particular requested attribute from a file, it just won't be set. <em>attribute</em> should be a comma-separated list of attribute or attribute wildcards. The wildcard "*" means all attributes, and a wildcard like "standard::*" means all attributes in the standard namespace. An example attribute query be "standard::*,owner::user". The standard attributes are availible as defines, like FILE_ATTRIBUTE_STANDARD_NAME.<p>
 
2778
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>
 
2779
If the file does not exist, a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_FOUND will be thrown. If the file is not a directory, a <a class="el" href="classGlib_1_1FileError.html" title="Exception class for file-related errors.">Glib::FileError</a> with NOTDIR will be thrown. Other errors are possible too.<p>
 
2780
<dl compact><dt><b>Parameters:</b></dt><dd>
 
2781
  <table border="0" cellspacing="2" cellpadding="0">
 
2782
    <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>
 
2783
    <tr><td valign="top"></td><td valign="top"><em>attributes</em>&nbsp;</td><td>An attribute query string. </td></tr>
 
2784
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
 
2785
  </table>
 
2786
</dl>
 
2787
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileEnumerator.html" title="Enumerated Files Routines.">FileEnumerator</a> if successful. </dd></dl>
 
2788
 
 
2789
</div>
 
2790
</div><p>
 
2791
<a class="anchor" name="c0e293d607499b223f4892fb290ab2d6"></a><!-- doxytag: member="Gio::File::enumerate_children" ref="c0e293d607499b223f4892fb290ab2d6" args="(const std::string &amp;attributes=&quot;*&quot;, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE)" -->
 
2792
<div class="memitem">
 
2793
<div class="memproto">
 
2794
      <table class="memname">
 
2795
        <tr>
 
2796
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileEnumerator.html">FileEnumerator</a>&gt; Gio::File::enumerate_children           </td>
 
2797
          <td>(</td>
 
2798
          <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>
 
2799
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code>, </td>
 
2800
        </tr>
 
2801
        <tr>
 
2802
          <td class="paramkey"></td>
 
2803
          <td></td>
 
2804
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
2805
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code></td><td>&nbsp;</td>
 
2806
        </tr>
 
2807
        <tr>
 
2808
          <td></td>
 
2809
          <td>)</td>
 
2810
          <td></td><td></td><td></td>
 
2811
        </tr>
 
2812
      </table>
 
2813
</div>
 
2814
<div class="memdoc">
 
2815
 
 
2816
<p>
 
2817
Gets the requested information about the files in a directory. 
 
2818
<p>
 
2819
The result is a <a class="el" href="classGio_1_1FileEnumerator.html" title="Enumerated Files Routines.">FileEnumerator</a> object that will give out <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> objects for all the files in the directory.<p>
 
2820
The <em>attribute</em> value is a string that specifies the file attributes that should be gathered. It is not an error if its not possible to read a particular requested attribute from a file, it just won't be set. <em>attribute</em> should be a comma-separated list of attribute or attribute wildcards. The wildcard "*" means all attributes, and a wildcard like "standard::*" means all attributes in the standard namespace. An example attribute query be "standard::*,owner::user". The standard attributes are availible as defines, like FILE_ATTRIBUTE_STANDARD_NAME.<p>
 
2821
If the file does not exist, a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_FOUND will be thrown. If the file is not a directory, a <a class="el" href="classGlib_1_1FileError.html" title="Exception class for file-related errors.">Glib::FileError</a> with NOTDIR will be thrown. Other errors are possible too.<p>
 
2822
<dl compact><dt><b>Parameters:</b></dt><dd>
 
2823
  <table border="0" cellspacing="2" cellpadding="0">
 
2824
    <tr><td valign="top"></td><td valign="top"><em>attributes</em>&nbsp;</td><td>An attribute query string. </td></tr>
 
2825
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
 
2826
  </table>
 
2827
</dl>
 
2828
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileEnumerator.html" title="Enumerated Files Routines.">FileEnumerator</a> if successful. </dd></dl>
 
2829
 
 
2830
</div>
 
2831
</div><p>
 
2832
<a class="anchor" name="1ead7237b7057d9b15cf5f3065988131"></a><!-- doxytag: member="Gio::File::enumerate_children_async" ref="1ead7237b7057d9b15cf5f3065988131" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, const std::string &amp;attributes=&quot;*&quot;, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
 
2833
<div class="memitem">
 
2834
<div class="memproto">
 
2835
      <table class="memname">
 
2836
        <tr>
 
2837
          <td class="memname">void Gio::File::enumerate_children_async           </td>
 
2838
          <td>(</td>
 
2839
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
2840
          <td class="paramname"> <em>slot</em>, </td>
 
2841
        </tr>
 
2842
        <tr>
 
2843
          <td class="paramkey"></td>
 
2844
          <td></td>
 
2845
          <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>
 
2846
          <td class="paramname"> <em>cancellable</em>, </td>
 
2847
        </tr>
 
2848
        <tr>
 
2849
          <td class="paramkey"></td>
 
2850
          <td></td>
 
2851
          <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>
 
2852
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code>, </td>
 
2853
        </tr>
 
2854
        <tr>
 
2855
          <td class="paramkey"></td>
 
2856
          <td></td>
 
2857
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
2858
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code>, </td>
 
2859
        </tr>
 
2860
        <tr>
 
2861
          <td class="paramkey"></td>
 
2862
          <td></td>
 
2863
          <td class="paramtype">int&nbsp;</td>
 
2864
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
 
2865
        </tr>
 
2866
        <tr>
 
2867
          <td></td>
 
2868
          <td>)</td>
 
2869
          <td></td><td></td><td></td>
 
2870
        </tr>
 
2871
      </table>
 
2872
</div>
 
2873
<div class="memdoc">
 
2874
 
 
2875
<p>
 
2876
Asynchronously gets the requested information about the files in a directory. 
 
2877
<p>
 
2878
The result is a GFileEnumerator object that will give out GFileInfo objects for all the files in the directory.<p>
 
2879
For more details, see <a class="el" href="classGio_1_1File.html#68c3afcddc0d4860aa2afb4bf715bb20" title="Gets the requested information about the files in a directory.">enumerate_children()</a> which is the synchronous version of this call. When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#617a2950448788e68df128c58e068a14" title="Finishes an async enumerate children operation.">enumerate_children_finish()</a> to get the result of the operation.<p>
 
2880
<dl compact><dt><b>Parameters:</b></dt><dd>
 
2881
  <table border="0" cellspacing="2" cellpadding="0">
 
2882
    <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>
 
2883
    <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>
 
2884
    <tr><td valign="top"></td><td valign="top"><em>attributes</em>&nbsp;</td><td>An attribute query string. </td></tr>
 
2885
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
 
2886
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
 
2887
  </table>
 
2888
</dl>
 
2889
 
 
2890
</div>
 
2891
</div><p>
 
2892
<a class="anchor" name="5b5470cf1c97754a12169201665f1202"></a><!-- doxytag: member="Gio::File::enumerate_children_async" ref="5b5470cf1c97754a12169201665f1202" args="(const SlotAsyncReady &amp;slot, const std::string &amp;attributes=&quot;*&quot;, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
 
2893
<div class="memitem">
 
2894
<div class="memproto">
 
2895
      <table class="memname">
 
2896
        <tr>
 
2897
          <td class="memname">void Gio::File::enumerate_children_async           </td>
 
2898
          <td>(</td>
 
2899
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
2900
          <td class="paramname"> <em>slot</em>, </td>
 
2901
        </tr>
 
2902
        <tr>
 
2903
          <td class="paramkey"></td>
 
2904
          <td></td>
 
2905
          <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>
 
2906
          <td class="paramname"> <em>attributes</em> = <code>&quot;*&quot;</code>, </td>
 
2907
        </tr>
 
2908
        <tr>
 
2909
          <td class="paramkey"></td>
 
2910
          <td></td>
 
2911
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
2912
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code>, </td>
 
2913
        </tr>
 
2914
        <tr>
 
2915
          <td class="paramkey"></td>
 
2916
          <td></td>
 
2917
          <td class="paramtype">int&nbsp;</td>
 
2918
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
 
2919
        </tr>
 
2920
        <tr>
 
2921
          <td></td>
 
2922
          <td>)</td>
 
2923
          <td></td><td></td><td></td>
 
2924
        </tr>
 
2925
      </table>
 
2926
</div>
 
2927
<div class="memdoc">
 
2928
 
 
2929
<p>
 
2930
Asynchronously gets the requested information about the files in a directory. 
 
2931
<p>
 
2932
The result is a GFileEnumerator object that will give out GFileInfo objects for all the files in the directory.<p>
 
2933
For more details, see <a class="el" href="classGio_1_1File.html#68c3afcddc0d4860aa2afb4bf715bb20" title="Gets the requested information about the files in a directory.">enumerate_children()</a> which is the synchronous version of this call. When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#617a2950448788e68df128c58e068a14" title="Finishes an async enumerate children operation.">enumerate_children_finish()</a> to get the result of the operation.<p>
 
2934
<dl compact><dt><b>Parameters:</b></dt><dd>
 
2935
  <table border="0" cellspacing="2" cellpadding="0">
 
2936
    <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>
 
2937
    <tr><td valign="top"></td><td valign="top"><em>attributes</em>&nbsp;</td><td>An attribute query string. </td></tr>
 
2938
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
 
2939
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
 
2940
  </table>
 
2941
</dl>
 
2942
 
 
2943
</div>
 
2944
</div><p>
 
2945
<a class="anchor" name="617a2950448788e68df128c58e068a14"></a><!-- doxytag: member="Gio::File::enumerate_children_finish" ref="617a2950448788e68df128c58e068a14" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
 
2946
<div class="memitem">
 
2947
<div class="memproto">
 
2948
      <table class="memname">
 
2949
        <tr>
 
2950
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileEnumerator.html">FileEnumerator</a>&gt; Gio::File::enumerate_children_finish           </td>
 
2951
          <td>(</td>
 
2952
          <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>
 
2953
          <td class="paramname"> <em>result</em>          </td>
 
2954
          <td>&nbsp;)&nbsp;</td>
 
2955
          <td></td>
 
2956
        </tr>
 
2957
      </table>
 
2958
</div>
 
2959
<div class="memdoc">
 
2960
 
 
2961
<p>
 
2962
Finishes an async enumerate children operation. 
 
2963
<p>
 
2964
See g_file_enumerate_children_async(). <dl compact><dt><b>Parameters:</b></dt><dd>
 
2965
  <table border="0" cellspacing="2" cellpadding="0">
 
2966
    <tr><td valign="top"></td><td valign="top"><em>res</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>
 
2967
  </table>
 
2968
</dl>
 
2969
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileEnumerator.html" title="Enumerated Files Routines.">FileEnumerator</a> or <code>0</code> if an error occurred. Free the returned object with Glib::object_unref(). </dd></dl>
 
2970
 
 
2971
</div>
 
2972
</div><p>
 
2973
<a class="anchor" name="3dd75810d7c9ebafac398288f5afc018"></a><!-- doxytag: member="Gio::File::set_display_name" ref="3dd75810d7c9ebafac398288f5afc018" args="(const Glib::ustring &amp;display_name, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
 
2974
<div class="memitem">
 
2975
<div class="memproto">
 
2976
      <table class="memname">
 
2977
        <tr>
 
2978
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt; Gio::File::set_display_name           </td>
 
2979
          <td>(</td>
 
2980
          <td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&nbsp;</td>
 
2981
          <td class="paramname"> <em>display_name</em>, </td>
 
2982
        </tr>
 
2983
        <tr>
 
2984
          <td class="paramkey"></td>
 
2985
          <td></td>
 
2986
          <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>
 
2987
          <td class="paramname"> <em>cancellable</em></td><td>&nbsp;</td>
 
2988
        </tr>
 
2989
        <tr>
 
2990
          <td></td>
 
2991
          <td>)</td>
 
2992
          <td></td><td></td><td></td>
 
2993
        </tr>
 
2994
      </table>
 
2995
</div>
 
2996
<div class="memdoc">
 
2997
 
 
2998
<p>
 
2999
Renames <em>file</em> to the specified display name. 
 
3000
<p>
 
3001
The display name is converted from UTF8 to the correct encoding for the target filesystem if possible and the <em>file</em> is renamed to this.<p>
 
3002
If you want to implement a rename operation in the user interface the edit name (FILE_ATTRIBUTE_STANDARD_EDIT_NAME) should be used as the initial value in the rename widget, and then the result after editing should be passed to g_file_set_display_name().<p>
 
3003
On success the resulting converted filename is returned.<p>
 
3004
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
 
3005
  <table border="0" cellspacing="2" cellpadding="0">
 
3006
    <tr><td valign="top"></td><td valign="top"><em>display_name</em>&nbsp;</td><td>A string. </td></tr>
 
3007
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
 
3008
  </table>
 
3009
</dl>
 
3010
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> specifying what <em>file</em> was renamed to, or <code>0</code> if there was an error. </dd></dl>
6434
3011
 
6435
3012
</div>
6436
3013
</div><p>
6466
3043
 
6467
3044
</div>
6468
3045
</div><p>
6469
 
<a class="anchor" name="3dd75810d7c9ebafac398288f5afc018"></a><!-- doxytag: member="Gio::File::set_display_name" ref="3dd75810d7c9ebafac398288f5afc018" args="(const Glib::ustring &amp;display_name, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
 
3046
<a class="anchor" name="0ac539d7758b9c0de809f8c83e0bba79"></a><!-- doxytag: member="Gio::File::set_display_name_async" ref="0ac539d7758b9c0de809f8c83e0bba79" args="(const Glib::ustring &amp;display_name, const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, int io_priority=Glib::PRIORITY_DEFAULT)" -->
6470
3047
<div class="memitem">
6471
3048
<div class="memproto">
6472
3049
      <table class="memname">
6473
3050
        <tr>
6474
 
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt; Gio::File::set_display_name           </td>
 
3051
          <td class="memname">void Gio::File::set_display_name_async           </td>
6475
3052
          <td>(</td>
6476
3053
          <td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&nbsp;</td>
6477
3054
          <td class="paramname"> <em>display_name</em>, </td>
6479
3056
        <tr>
6480
3057
          <td class="paramkey"></td>
6481
3058
          <td></td>
 
3059
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
3060
          <td class="paramname"> <em>slot</em>, </td>
 
3061
        </tr>
 
3062
        <tr>
 
3063
          <td class="paramkey"></td>
 
3064
          <td></td>
6482
3065
          <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>
6483
 
          <td class="paramname"> <em>cancellable</em></td><td>&nbsp;</td>
 
3066
          <td class="paramname"> <em>cancellable</em>, </td>
 
3067
        </tr>
 
3068
        <tr>
 
3069
          <td class="paramkey"></td>
 
3070
          <td></td>
 
3071
          <td class="paramtype">int&nbsp;</td>
 
3072
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
6484
3073
        </tr>
6485
3074
        <tr>
6486
3075
          <td></td>
6492
3081
<div class="memdoc">
6493
3082
 
6494
3083
<p>
6495
 
Renames <em>file</em> to the specified display name. 
 
3084
Asynchronously sets the display name for a given <a class="el" href="classGio_1_1File.html" title="File and directory handling.">Gio::File</a>. 
6496
3085
<p>
6497
 
The display name is converted from UTF8 to the correct encoding for the target filesystem if possible and the <em>file</em> is renamed to this.<p>
6498
 
If you want to implement a rename operation in the user interface the edit name (FILE_ATTRIBUTE_STANDARD_EDIT_NAME) should be used as the initial value in the rename widget, and then the result after editing should be passed to g_file_set_display_name().<p>
6499
 
On success the resulting converted filename is returned.<p>
6500
 
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
 
3086
For the synchronous version of this function, see <a class="el" href="classGio_1_1File.html#3dd75810d7c9ebafac398288f5afc018" title="Renames file to the specified display name.">set_display_name()</a>. When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#101b555723233014c0185dd505303f0a" title="Finishes setting a display name started with g_file_set_display_name_async().">set_display_name_finish()</a> to get the result of the operation.<p>
 
3087
<dl compact><dt><b>Parameters:</b></dt><dd>
6501
3088
  <table border="0" cellspacing="2" cellpadding="0">
6502
3089
    <tr><td valign="top"></td><td valign="top"><em>display_name</em>&nbsp;</td><td>A string. </td></tr>
6503
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
 
3090
    <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>
 
3091
    <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>
 
3092
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
6504
3093
  </table>
6505
3094
</dl>
6506
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> specifying what <em>file</em> was renamed to, or <code>0</code> if there was an error. </dd></dl>
6507
3095
 
6508
3096
</div>
6509
3097
</div><p>
6552
3140
 
6553
3141
</div>
6554
3142
</div><p>
6555
 
<a class="anchor" name="0ac539d7758b9c0de809f8c83e0bba79"></a><!-- doxytag: member="Gio::File::set_display_name_async" ref="0ac539d7758b9c0de809f8c83e0bba79" args="(const Glib::ustring &amp;display_name, const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, int io_priority=Glib::PRIORITY_DEFAULT)" -->
6556
 
<div class="memitem">
6557
 
<div class="memproto">
6558
 
      <table class="memname">
6559
 
        <tr>
6560
 
          <td class="memname">void Gio::File::set_display_name_async           </td>
6561
 
          <td>(</td>
6562
 
          <td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>&amp;&nbsp;</td>
6563
 
          <td class="paramname"> <em>display_name</em>, </td>
6564
 
        </tr>
6565
 
        <tr>
6566
 
          <td class="paramkey"></td>
6567
 
          <td></td>
6568
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
6569
 
          <td class="paramname"> <em>slot</em>, </td>
6570
 
        </tr>
6571
 
        <tr>
6572
 
          <td class="paramkey"></td>
6573
 
          <td></td>
6574
 
          <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>
6575
 
          <td class="paramname"> <em>cancellable</em>, </td>
6576
 
        </tr>
6577
 
        <tr>
6578
 
          <td class="paramkey"></td>
6579
 
          <td></td>
6580
 
          <td class="paramtype">int&nbsp;</td>
6581
 
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
6582
 
        </tr>
6583
 
        <tr>
6584
 
          <td></td>
6585
 
          <td>)</td>
6586
 
          <td></td><td></td><td></td>
6587
 
        </tr>
6588
 
      </table>
6589
 
</div>
6590
 
<div class="memdoc">
6591
 
 
6592
 
<p>
6593
 
Asynchronously sets the display name for a given <a class="el" href="classGio_1_1File.html" title="File and directory handling.">Gio::File</a>. 
6594
 
<p>
6595
 
For the synchronous version of this function, see <a class="el" href="classGio_1_1File.html#3dd75810d7c9ebafac398288f5afc018" title="Renames file to the specified display name.">set_display_name()</a>. When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#101b555723233014c0185dd505303f0a" title="Finishes setting a display name started with g_file_set_display_name_async().">set_display_name_finish()</a> to get the result of the operation.<p>
6596
 
<dl compact><dt><b>Parameters:</b></dt><dd>
6597
 
  <table border="0" cellspacing="2" cellpadding="0">
6598
 
    <tr><td valign="top"></td><td valign="top"><em>display_name</em>&nbsp;</td><td>A string. </td></tr>
6599
 
    <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>
6600
 
    <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>
6601
 
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
6602
 
  </table>
6603
 
</dl>
6604
 
 
6605
 
</div>
6606
 
</div><p>
6607
3143
<a class="anchor" name="101b555723233014c0185dd505303f0a"></a><!-- doxytag: member="Gio::File::set_display_name_finish" ref="101b555723233014c0185dd505303f0a" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
6608
3144
<div class="memitem">
6609
3145
<div class="memproto">
6632
3168
 
6633
3169
</div>
6634
3170
</div><p>
 
3171
<a class="anchor" name="ded971b0cf84801f6684ad4bd5dc66c5"></a><!-- doxytag: member="Gio::File::remove" ref="ded971b0cf84801f6684ad4bd5dc66c5" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
 
3172
<div class="memitem">
 
3173
<div class="memproto">
 
3174
      <table class="memname">
 
3175
        <tr>
 
3176
          <td class="memname">bool Gio::File::remove           </td>
 
3177
          <td>(</td>
 
3178
          <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>
 
3179
          <td class="paramname"> <em>cancellable</em>          </td>
 
3180
          <td>&nbsp;)&nbsp;</td>
 
3181
          <td></td>
 
3182
        </tr>
 
3183
      </table>
 
3184
</div>
 
3185
<div class="memdoc">
 
3186
 
 
3187
<p>
 
3188
Deletes a file. 
 
3189
<p>
 
3190
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
 
3191
  <table border="0" cellspacing="2" cellpadding="0">
 
3192
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
 
3193
  </table>
 
3194
</dl>
 
3195
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the file was deleted. <code>false</code> otherwise. </dd></dl>
 
3196
 
 
3197
</div>
 
3198
</div><p>
 
3199
<a class="anchor" name="14f34508dea523cbf889b7193e513ca4"></a><!-- doxytag: member="Gio::File::remove" ref="14f34508dea523cbf889b7193e513ca4" args="()" -->
 
3200
<div class="memitem">
 
3201
<div class="memproto">
 
3202
      <table class="memname">
 
3203
        <tr>
 
3204
          <td class="memname">bool Gio::File::remove           </td>
 
3205
          <td>(</td>
 
3206
          <td class="paramname">          </td>
 
3207
          <td>&nbsp;)&nbsp;</td>
 
3208
          <td></td>
 
3209
        </tr>
 
3210
      </table>
 
3211
</div>
 
3212
<div class="memdoc">
 
3213
 
 
3214
<p>
 
3215
Deletes a file. 
 
3216
<p>
 
3217
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the file was deleted. <code>false</code> otherwise. </dd></dl>
 
3218
 
 
3219
</div>
 
3220
</div><p>
 
3221
<a class="anchor" name="cae5ecd962e832cf8d538877f4118da8"></a><!-- doxytag: member="Gio::File::trash" ref="cae5ecd962e832cf8d538877f4118da8" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
 
3222
<div class="memitem">
 
3223
<div class="memproto">
 
3224
      <table class="memname">
 
3225
        <tr>
 
3226
          <td class="memname">bool Gio::File::trash           </td>
 
3227
          <td>(</td>
 
3228
          <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>
 
3229
          <td class="paramname"> <em>cancellable</em>          </td>
 
3230
          <td>&nbsp;)&nbsp;</td>
 
3231
          <td></td>
 
3232
        </tr>
 
3233
      </table>
 
3234
</div>
 
3235
<div class="memdoc">
 
3236
 
 
3237
<p>
 
3238
Sends <em>file</em> to the "Trashcan", if possible. 
 
3239
<p>
 
3240
This is similar to deleting it, but the user can recover it before emptying the trashcan. Not all file systems support trashing, so this call can throw a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_SUPPORTED.<p>
 
3241
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
 
3242
  <table border="0" cellspacing="2" cellpadding="0">
 
3243
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
 
3244
  </table>
 
3245
</dl>
 
3246
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> on successful trash, <code>false</code> otherwise. </dd></dl>
 
3247
 
 
3248
</div>
 
3249
</div><p>
6635
3250
<a class="anchor" name="1925736f9af338eaf9942468b4d6d65e"></a><!-- doxytag: member="Gio::File::trash" ref="1925736f9af338eaf9942468b4d6d65e" args="()" -->
6636
3251
<div class="memitem">
6637
3252
<div class="memproto">
6655
3270
 
6656
3271
</div>
6657
3272
</div><p>
6658
 
<a class="anchor" name="cae5ecd962e832cf8d538877f4118da8"></a><!-- doxytag: member="Gio::File::trash" ref="cae5ecd962e832cf8d538877f4118da8" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
6659
 
<div class="memitem">
6660
 
<div class="memproto">
6661
 
      <table class="memname">
6662
 
        <tr>
6663
 
          <td class="memname">bool Gio::File::trash           </td>
6664
 
          <td>(</td>
6665
 
          <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>
6666
 
          <td class="paramname"> <em>cancellable</em>          </td>
6667
 
          <td>&nbsp;)&nbsp;</td>
6668
 
          <td></td>
6669
 
        </tr>
6670
 
      </table>
6671
 
</div>
6672
 
<div class="memdoc">
6673
 
 
6674
 
<p>
6675
 
Sends <em>file</em> to the "Trashcan", if possible. 
6676
 
<p>
6677
 
This is similar to deleting it, but the user can recover it before emptying the trashcan. Not all file systems support trashing, so this call can throw a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_SUPPORTED.<p>
6678
 
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
6679
 
  <table border="0" cellspacing="2" cellpadding="0">
6680
 
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
6681
 
  </table>
6682
 
</dl>
6683
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> on successful trash, <code>false</code> otherwise. </dd></dl>
 
3273
<a class="anchor" name="f9e906ed93069e6adb6d87dae158cad9"></a><!-- doxytag: member="Gio::File::copy" ref="f9e906ed93069e6adb6d87dae158cad9" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, const SlotFileProgress &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileCopyFlags flags=FILE_COPY_NONE)" -->
 
3274
<div class="memitem">
 
3275
<div class="memproto">
 
3276
      <table class="memname">
 
3277
        <tr>
 
3278
          <td class="memname">bool Gio::File::copy           </td>
 
3279
          <td>(</td>
 
3280
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
 
3281
          <td class="paramname"> <em>destination</em>, </td>
 
3282
        </tr>
 
3283
        <tr>
 
3284
          <td class="paramkey"></td>
 
3285
          <td></td>
 
3286
          <td class="paramtype">const <a class="el" href="classGio_1_1File.html#c5ff32ee99845479d138eee49d92e59c">SlotFileProgress</a>&amp;&nbsp;</td>
 
3287
          <td class="paramname"> <em>slot</em>, </td>
 
3288
        </tr>
 
3289
        <tr>
 
3290
          <td class="paramkey"></td>
 
3291
          <td></td>
 
3292
          <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>
 
3293
          <td class="paramname"> <em>cancellable</em>, </td>
 
3294
        </tr>
 
3295
        <tr>
 
3296
          <td class="paramkey"></td>
 
3297
          <td></td>
 
3298
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
 
3299
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code></td><td>&nbsp;</td>
 
3300
        </tr>
 
3301
        <tr>
 
3302
          <td></td>
 
3303
          <td>)</td>
 
3304
          <td></td><td></td><td></td>
 
3305
        </tr>
 
3306
      </table>
 
3307
</div>
 
3308
<div class="memdoc">
 
3309
 
 
3310
<p>
 
3311
Copies the file source to the location specified by destination. 
 
3312
<p>
 
3313
Can not handle recursive copies of directories. If the flag FILE_COPY_OVERWRITE is specified an already existing destination file is overwritten. If the flag FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks will be copied as symlinks, otherwise the target of the source symlink will be copied.<p>
 
3314
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>
 
3315
The operation can be monitored via the <em>slot</em> callback.<p>
 
3316
If the source file does not exist then a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_FOUND will be thrown, independent on the status of the destination.<p>
 
3317
If FILE_COPY_OVERWRITE is not specified and the target exists, then a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with EXISTS will be thrown.<p>
 
3318
If trying to overwrite a file over a directory a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with IS_DIRECTORY will be thrown. If trying to overwrite a directory with a directory a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with WOULD_MERGE will be thrown.<p>
 
3319
If the source is a directory and the target does not exist, or FILE_COPY_OVERWRITE is specified and the target is a file, then a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with WOULD_RECURSE will be thrown.<p>
 
3320
If you are interested in copying the <a class="el" href="classGio_1_1File.html" title="File and directory handling.">Gio::File</a> object itself (not the on-disk file), see <a class="el" href="classGio_1_1File.html#9ea238062cdc317ae982ffae5c226c9b" title="Duplicates a File handle.">File::dup()</a>. 
 
3321
</div>
 
3322
</div><p>
 
3323
<a class="anchor" name="1d8159b5b377db174b376b3c09deb7c1"></a><!-- doxytag: member="Gio::File::copy" ref="1d8159b5b377db174b376b3c09deb7c1" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, const SlotFileProgress &amp;slot, FileCopyFlags flags=FILE_COPY_NONE)" -->
 
3324
<div class="memitem">
 
3325
<div class="memproto">
 
3326
      <table class="memname">
 
3327
        <tr>
 
3328
          <td class="memname">bool Gio::File::copy           </td>
 
3329
          <td>(</td>
 
3330
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
 
3331
          <td class="paramname"> <em>destination</em>, </td>
 
3332
        </tr>
 
3333
        <tr>
 
3334
          <td class="paramkey"></td>
 
3335
          <td></td>
 
3336
          <td class="paramtype">const <a class="el" href="classGio_1_1File.html#c5ff32ee99845479d138eee49d92e59c">SlotFileProgress</a>&amp;&nbsp;</td>
 
3337
          <td class="paramname"> <em>slot</em>, </td>
 
3338
        </tr>
 
3339
        <tr>
 
3340
          <td class="paramkey"></td>
 
3341
          <td></td>
 
3342
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
 
3343
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code></td><td>&nbsp;</td>
 
3344
        </tr>
 
3345
        <tr>
 
3346
          <td></td>
 
3347
          <td>)</td>
 
3348
          <td></td><td></td><td></td>
 
3349
        </tr>
 
3350
      </table>
 
3351
</div>
 
3352
<div class="memdoc">
 
3353
 
 
3354
<p>
 
3355
 
 
3356
</div>
 
3357
</div><p>
 
3358
<a class="anchor" name="7a6b45bed32567031bc7b48273ad4079"></a><!-- doxytag: member="Gio::File::copy" ref="7a6b45bed32567031bc7b48273ad4079" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, FileCopyFlags flags=FILE_COPY_NONE)" -->
 
3359
<div class="memitem">
 
3360
<div class="memproto">
 
3361
      <table class="memname">
 
3362
        <tr>
 
3363
          <td class="memname">bool Gio::File::copy           </td>
 
3364
          <td>(</td>
 
3365
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
 
3366
          <td class="paramname"> <em>destination</em>, </td>
 
3367
        </tr>
 
3368
        <tr>
 
3369
          <td class="paramkey"></td>
 
3370
          <td></td>
 
3371
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
 
3372
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code></td><td>&nbsp;</td>
 
3373
        </tr>
 
3374
        <tr>
 
3375
          <td></td>
 
3376
          <td>)</td>
 
3377
          <td></td><td></td><td></td>
 
3378
        </tr>
 
3379
      </table>
 
3380
</div>
 
3381
<div class="memdoc">
 
3382
 
 
3383
<p>
 
3384
 
 
3385
</div>
 
3386
</div><p>
 
3387
<a class="anchor" name="1785b7a4780d5d4ba5ae651350e34398"></a><!-- doxytag: member="Gio::File::copy_async" ref="1785b7a4780d5d4ba5ae651350e34398" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, const SlotFileProgress &amp;slot_progress, const SlotAsyncReady &amp;slot_ready, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileCopyFlags flags=FILE_COPY_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
 
3388
<div class="memitem">
 
3389
<div class="memproto">
 
3390
      <table class="memname">
 
3391
        <tr>
 
3392
          <td class="memname">void Gio::File::copy_async           </td>
 
3393
          <td>(</td>
 
3394
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
 
3395
          <td class="paramname"> <em>destination</em>, </td>
 
3396
        </tr>
 
3397
        <tr>
 
3398
          <td class="paramkey"></td>
 
3399
          <td></td>
 
3400
          <td class="paramtype">const <a class="el" href="classGio_1_1File.html#c5ff32ee99845479d138eee49d92e59c">SlotFileProgress</a>&amp;&nbsp;</td>
 
3401
          <td class="paramname"> <em>slot_progress</em>, </td>
 
3402
        </tr>
 
3403
        <tr>
 
3404
          <td class="paramkey"></td>
 
3405
          <td></td>
 
3406
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
3407
          <td class="paramname"> <em>slot_ready</em>, </td>
 
3408
        </tr>
 
3409
        <tr>
 
3410
          <td class="paramkey"></td>
 
3411
          <td></td>
 
3412
          <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>
 
3413
          <td class="paramname"> <em>cancellable</em>, </td>
 
3414
        </tr>
 
3415
        <tr>
 
3416
          <td class="paramkey"></td>
 
3417
          <td></td>
 
3418
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
 
3419
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code>, </td>
 
3420
        </tr>
 
3421
        <tr>
 
3422
          <td class="paramkey"></td>
 
3423
          <td></td>
 
3424
          <td class="paramtype">int&nbsp;</td>
 
3425
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
 
3426
        </tr>
 
3427
        <tr>
 
3428
          <td></td>
 
3429
          <td>)</td>
 
3430
          <td></td><td></td><td></td>
 
3431
        </tr>
 
3432
      </table>
 
3433
</div>
 
3434
<div class="memdoc">
 
3435
 
 
3436
<p>
 
3437
Copies the file to the location specified by <em>destination</em> asynchronously. 
 
3438
<p>
 
3439
For details of the behaviour, see <a class="el" href="classGio_1_1File.html#f9e906ed93069e6adb6d87dae158cad9" title="Copies the file source to the location specified by destination.">copy()</a>.<p>
 
3440
When the operation is finished, <em>slot_ready</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#68294636a2d649c9de53332faee02cf6" title="Finishes copying the file started with g_file_copy_async().">copy_finish()</a> to get the result of the operation.<p>
 
3441
The function specified by <em>slot_progress</em> will be called just like in <a class="el" href="classGio_1_1File.html#f9e906ed93069e6adb6d87dae158cad9" title="Copies the file source to the location specified by destination.">copy()</a>, however the callback will run in the main loop, not in the thread that is doing the I/O operation.<p>
 
3442
<dl compact><dt><b>Parameters:</b></dt><dd>
 
3443
  <table border="0" cellspacing="2" cellpadding="0">
 
3444
    <tr><td valign="top"></td><td valign="top"><em>destination</em>&nbsp;</td><td>Destination <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> </td></tr>
 
3445
    <tr><td valign="top"></td><td valign="top"><em>slot_progress</em>&nbsp;</td><td>The callback slot to be called with progress information </td></tr>
 
3446
    <tr><td valign="top"></td><td valign="top"><em>slot_ready</em>&nbsp;</td><td>A SlotAsyncReady to call when the request is satisfied </td></tr>
 
3447
    <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>
 
3448
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>Set of FileCopyFlags </td></tr>
 
3449
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request </td></tr>
 
3450
  </table>
 
3451
</dl>
 
3452
 
 
3453
</div>
 
3454
</div><p>
 
3455
<a class="anchor" name="5b8ae7393c73a9a1d383a82d61f4ac30"></a><!-- doxytag: member="Gio::File::copy_async" ref="5b8ae7393c73a9a1d383a82d61f4ac30" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, const SlotAsyncReady &amp;slot_ready, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileCopyFlags flags=FILE_COPY_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
 
3456
<div class="memitem">
 
3457
<div class="memproto">
 
3458
      <table class="memname">
 
3459
        <tr>
 
3460
          <td class="memname">void Gio::File::copy_async           </td>
 
3461
          <td>(</td>
 
3462
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
 
3463
          <td class="paramname"> <em>destination</em>, </td>
 
3464
        </tr>
 
3465
        <tr>
 
3466
          <td class="paramkey"></td>
 
3467
          <td></td>
 
3468
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
3469
          <td class="paramname"> <em>slot_ready</em>, </td>
 
3470
        </tr>
 
3471
        <tr>
 
3472
          <td class="paramkey"></td>
 
3473
          <td></td>
 
3474
          <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>
 
3475
          <td class="paramname"> <em>cancellable</em>, </td>
 
3476
        </tr>
 
3477
        <tr>
 
3478
          <td class="paramkey"></td>
 
3479
          <td></td>
 
3480
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
 
3481
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code>, </td>
 
3482
        </tr>
 
3483
        <tr>
 
3484
          <td class="paramkey"></td>
 
3485
          <td></td>
 
3486
          <td class="paramtype">int&nbsp;</td>
 
3487
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
 
3488
        </tr>
 
3489
        <tr>
 
3490
          <td></td>
 
3491
          <td>)</td>
 
3492
          <td></td><td></td><td></td>
 
3493
        </tr>
 
3494
      </table>
 
3495
</div>
 
3496
<div class="memdoc">
 
3497
 
 
3498
<p>
 
3499
Copies the file to the location specified by <em>destination</em> asynchronously. 
 
3500
<p>
 
3501
For details of the behaviour, see <a class="el" href="classGio_1_1File.html#f9e906ed93069e6adb6d87dae158cad9" title="Copies the file source to the location specified by destination.">copy()</a>.<p>
 
3502
When the operation is finished, <em>slot_ready</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#68294636a2d649c9de53332faee02cf6" title="Finishes copying the file started with g_file_copy_async().">copy_finish()</a> to get the result of the operation.<p>
 
3503
<dl compact><dt><b>Parameters:</b></dt><dd>
 
3504
  <table border="0" cellspacing="2" cellpadding="0">
 
3505
    <tr><td valign="top"></td><td valign="top"><em>destination</em>&nbsp;</td><td>Destination <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> </td></tr>
 
3506
    <tr><td valign="top"></td><td valign="top"><em>slot_ready</em>&nbsp;</td><td>A SlotAsyncReady to call when the request is satisfied </td></tr>
 
3507
    <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>
 
3508
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>Set of FileCopyFlags </td></tr>
 
3509
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request </td></tr>
 
3510
  </table>
 
3511
</dl>
 
3512
 
 
3513
</div>
 
3514
</div><p>
 
3515
<a class="anchor" name="c2b1a85f29bbbe15998c090b3794cbf5"></a><!-- doxytag: member="Gio::File::copy_async" ref="c2b1a85f29bbbe15998c090b3794cbf5" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, const SlotFileProgress &amp;slot_progress, const SlotAsyncReady &amp;slot_ready, FileCopyFlags flags=FILE_COPY_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
 
3516
<div class="memitem">
 
3517
<div class="memproto">
 
3518
      <table class="memname">
 
3519
        <tr>
 
3520
          <td class="memname">void Gio::File::copy_async           </td>
 
3521
          <td>(</td>
 
3522
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
 
3523
          <td class="paramname"> <em>destination</em>, </td>
 
3524
        </tr>
 
3525
        <tr>
 
3526
          <td class="paramkey"></td>
 
3527
          <td></td>
 
3528
          <td class="paramtype">const <a class="el" href="classGio_1_1File.html#c5ff32ee99845479d138eee49d92e59c">SlotFileProgress</a>&amp;&nbsp;</td>
 
3529
          <td class="paramname"> <em>slot_progress</em>, </td>
 
3530
        </tr>
 
3531
        <tr>
 
3532
          <td class="paramkey"></td>
 
3533
          <td></td>
 
3534
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
3535
          <td class="paramname"> <em>slot_ready</em>, </td>
 
3536
        </tr>
 
3537
        <tr>
 
3538
          <td class="paramkey"></td>
 
3539
          <td></td>
 
3540
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
 
3541
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code>, </td>
 
3542
        </tr>
 
3543
        <tr>
 
3544
          <td class="paramkey"></td>
 
3545
          <td></td>
 
3546
          <td class="paramtype">int&nbsp;</td>
 
3547
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
 
3548
        </tr>
 
3549
        <tr>
 
3550
          <td></td>
 
3551
          <td>)</td>
 
3552
          <td></td><td></td><td></td>
 
3553
        </tr>
 
3554
      </table>
 
3555
</div>
 
3556
<div class="memdoc">
 
3557
 
 
3558
<p>
 
3559
Copies the file to the location specified by <em>destination</em> asynchronously. 
 
3560
<p>
 
3561
For details of the behaviour, see <a class="el" href="classGio_1_1File.html#f9e906ed93069e6adb6d87dae158cad9" title="Copies the file source to the location specified by destination.">copy()</a>.<p>
 
3562
When the operation is finished, <em>slot_ready</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#68294636a2d649c9de53332faee02cf6" title="Finishes copying the file started with g_file_copy_async().">copy_finish()</a> to get the result of the operation.<p>
 
3563
The function specified by <em>slot_progress</em> will be called just like in <a class="el" href="classGio_1_1File.html#f9e906ed93069e6adb6d87dae158cad9" title="Copies the file source to the location specified by destination.">copy()</a>, however the callback will run in the main loop, not in the thread that is doing the I/O operation.<p>
 
3564
<dl compact><dt><b>Parameters:</b></dt><dd>
 
3565
  <table border="0" cellspacing="2" cellpadding="0">
 
3566
    <tr><td valign="top"></td><td valign="top"><em>destination</em>&nbsp;</td><td>Destination <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> </td></tr>
 
3567
    <tr><td valign="top"></td><td valign="top"><em>slot_progress</em>&nbsp;</td><td>The callback slot to be called with progress information </td></tr>
 
3568
    <tr><td valign="top"></td><td valign="top"><em>slot_ready</em>&nbsp;</td><td>A SlotAsyncReady to call when the request is satisfied </td></tr>
 
3569
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>Set of FileCopyFlags </td></tr>
 
3570
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request </td></tr>
 
3571
  </table>
 
3572
</dl>
 
3573
 
 
3574
</div>
 
3575
</div><p>
 
3576
<a class="anchor" name="d538a383b8761d04bd36ed1aa1071e50"></a><!-- doxytag: member="Gio::File::copy_async" ref="d538a383b8761d04bd36ed1aa1071e50" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, const SlotAsyncReady &amp;slot_ready, FileCopyFlags flags=FILE_COPY_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
 
3577
<div class="memitem">
 
3578
<div class="memproto">
 
3579
      <table class="memname">
 
3580
        <tr>
 
3581
          <td class="memname">void Gio::File::copy_async           </td>
 
3582
          <td>(</td>
 
3583
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
 
3584
          <td class="paramname"> <em>destination</em>, </td>
 
3585
        </tr>
 
3586
        <tr>
 
3587
          <td class="paramkey"></td>
 
3588
          <td></td>
 
3589
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
3590
          <td class="paramname"> <em>slot_ready</em>, </td>
 
3591
        </tr>
 
3592
        <tr>
 
3593
          <td class="paramkey"></td>
 
3594
          <td></td>
 
3595
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
 
3596
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code>, </td>
 
3597
        </tr>
 
3598
        <tr>
 
3599
          <td class="paramkey"></td>
 
3600
          <td></td>
 
3601
          <td class="paramtype">int&nbsp;</td>
 
3602
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
 
3603
        </tr>
 
3604
        <tr>
 
3605
          <td></td>
 
3606
          <td>)</td>
 
3607
          <td></td><td></td><td></td>
 
3608
        </tr>
 
3609
      </table>
 
3610
</div>
 
3611
<div class="memdoc">
 
3612
 
 
3613
<p>
 
3614
Copies the file to the location specified by <em>destination</em> asynchronously. 
 
3615
<p>
 
3616
For details of the behaviour, see <a class="el" href="classGio_1_1File.html#f9e906ed93069e6adb6d87dae158cad9" title="Copies the file source to the location specified by destination.">copy()</a>.<p>
 
3617
When the operation is finished, <em>slot_ready</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#68294636a2d649c9de53332faee02cf6" title="Finishes copying the file started with g_file_copy_async().">copy_finish()</a> to get the result of the operation.<p>
 
3618
<dl compact><dt><b>Parameters:</b></dt><dd>
 
3619
  <table border="0" cellspacing="2" cellpadding="0">
 
3620
    <tr><td valign="top"></td><td valign="top"><em>destination</em>&nbsp;</td><td>Destination <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> </td></tr>
 
3621
    <tr><td valign="top"></td><td valign="top"><em>slot_ready</em>&nbsp;</td><td>A SlotAsyncReady to call when the request is satisfied </td></tr>
 
3622
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>Set of FileCopyFlags </td></tr>
 
3623
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request </td></tr>
 
3624
  </table>
 
3625
</dl>
 
3626
 
 
3627
</div>
 
3628
</div><p>
 
3629
<a class="anchor" name="68294636a2d649c9de53332faee02cf6"></a><!-- doxytag: member="Gio::File::copy_finish" ref="68294636a2d649c9de53332faee02cf6" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
 
3630
<div class="memitem">
 
3631
<div class="memproto">
 
3632
      <table class="memname">
 
3633
        <tr>
 
3634
          <td class="memname">bool Gio::File::copy_finish           </td>
 
3635
          <td>(</td>
 
3636
          <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>
 
3637
          <td class="paramname"> <em>result</em>          </td>
 
3638
          <td>&nbsp;)&nbsp;</td>
 
3639
          <td></td>
 
3640
        </tr>
 
3641
      </table>
 
3642
</div>
 
3643
<div class="memdoc">
 
3644
 
 
3645
<p>
 
3646
Finishes copying the file started with g_file_copy_async(). 
 
3647
<p>
 
3648
<dl compact><dt><b>Parameters:</b></dt><dd>
 
3649
  <table border="0" cellspacing="2" cellpadding="0">
 
3650
    <tr><td valign="top"></td><td valign="top"><em>res</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>
 
3651
  </table>
 
3652
</dl>
 
3653
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <code>true</code> on success, <code>false</code> on error. </dd></dl>
 
3654
 
 
3655
</div>
 
3656
</div><p>
 
3657
<a class="anchor" name="51c0d55880178c37dee578fdc723b0f2"></a><!-- doxytag: member="Gio::File::move" ref="51c0d55880178c37dee578fdc723b0f2" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, const SlotFileProgress &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileCopyFlags flags=FILE_COPY_NONE)" -->
 
3658
<div class="memitem">
 
3659
<div class="memproto">
 
3660
      <table class="memname">
 
3661
        <tr>
 
3662
          <td class="memname">bool Gio::File::move           </td>
 
3663
          <td>(</td>
 
3664
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
 
3665
          <td class="paramname"> <em>destination</em>, </td>
 
3666
        </tr>
 
3667
        <tr>
 
3668
          <td class="paramkey"></td>
 
3669
          <td></td>
 
3670
          <td class="paramtype">const <a class="el" href="classGio_1_1File.html#c5ff32ee99845479d138eee49d92e59c">SlotFileProgress</a>&amp;&nbsp;</td>
 
3671
          <td class="paramname"> <em>slot</em>, </td>
 
3672
        </tr>
 
3673
        <tr>
 
3674
          <td class="paramkey"></td>
 
3675
          <td></td>
 
3676
          <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>
 
3677
          <td class="paramname"> <em>cancellable</em>, </td>
 
3678
        </tr>
 
3679
        <tr>
 
3680
          <td class="paramkey"></td>
 
3681
          <td></td>
 
3682
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
 
3683
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code></td><td>&nbsp;</td>
 
3684
        </tr>
 
3685
        <tr>
 
3686
          <td></td>
 
3687
          <td>)</td>
 
3688
          <td></td><td></td><td></td>
 
3689
        </tr>
 
3690
      </table>
 
3691
</div>
 
3692
<div class="memdoc">
 
3693
 
 
3694
<p>
 
3695
Tries to move the file or directory source to the location specified by destination. 
 
3696
<p>
 
3697
If native move operations are supported then this is used, otherwise a copy and delete fallback is used. The native implementation may support moving directories (for instance on moves inside the same filesystem), but the fallback code does not.<p>
 
3698
If the flag FILE_COPY_OVERWRITE is specified an already existing destination file is overwritten.<p>
 
3699
If the flag FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks will be copied as symlinks, otherwise the target of the source symlink will be copied.<p>
 
3700
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>
 
3701
The operation can be monitored via the <em>slot</em> callback. If the source file does not exist then a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with NOT_FOUND will be thrown, independent on the status of the destination.<p>
 
3702
If G_FILE_COPY_OVERWRITE is not specified and the target exists, then a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with EXISTS will be thrown.<p>
 
3703
If trying to overwrite a file over a directory a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with IS_DIRECTORY will be thrown. If trying to overwrite a directory with a directory a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with WOULD_MERGE will be thrown.<p>
 
3704
If the source is a directory and the target does not exist, or FILE_COPY_OVERWRITE is specified and the target is a file, then a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with WOULD_RECURSE may be thrown (if the native move operation isn't available). 
 
3705
</div>
 
3706
</div><p>
 
3707
<a class="anchor" name="dfb2d8bfed1cb7af50e5e5795ebea732"></a><!-- doxytag: member="Gio::File::move" ref="dfb2d8bfed1cb7af50e5e5795ebea732" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, const SlotFileProgress &amp;slot, FileCopyFlags flags=FILE_COPY_NONE)" -->
 
3708
<div class="memitem">
 
3709
<div class="memproto">
 
3710
      <table class="memname">
 
3711
        <tr>
 
3712
          <td class="memname">bool Gio::File::move           </td>
 
3713
          <td>(</td>
 
3714
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
 
3715
          <td class="paramname"> <em>destination</em>, </td>
 
3716
        </tr>
 
3717
        <tr>
 
3718
          <td class="paramkey"></td>
 
3719
          <td></td>
 
3720
          <td class="paramtype">const <a class="el" href="classGio_1_1File.html#c5ff32ee99845479d138eee49d92e59c">SlotFileProgress</a>&amp;&nbsp;</td>
 
3721
          <td class="paramname"> <em>slot</em>, </td>
 
3722
        </tr>
 
3723
        <tr>
 
3724
          <td class="paramkey"></td>
 
3725
          <td></td>
 
3726
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
 
3727
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code></td><td>&nbsp;</td>
 
3728
        </tr>
 
3729
        <tr>
 
3730
          <td></td>
 
3731
          <td>)</td>
 
3732
          <td></td><td></td><td></td>
 
3733
        </tr>
 
3734
      </table>
 
3735
</div>
 
3736
<div class="memdoc">
 
3737
 
 
3738
<p>
 
3739
 
 
3740
</div>
 
3741
</div><p>
 
3742
<a class="anchor" name="ba1fab56c3a8bea0b7e4d7f7324c5320"></a><!-- doxytag: member="Gio::File::move" ref="ba1fab56c3a8bea0b7e4d7f7324c5320" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, FileCopyFlags flags=FILE_COPY_NONE)" -->
 
3743
<div class="memitem">
 
3744
<div class="memproto">
 
3745
      <table class="memname">
 
3746
        <tr>
 
3747
          <td class="memname">bool Gio::File::move           </td>
 
3748
          <td>(</td>
 
3749
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
 
3750
          <td class="paramname"> <em>destination</em>, </td>
 
3751
        </tr>
 
3752
        <tr>
 
3753
          <td class="paramkey"></td>
 
3754
          <td></td>
 
3755
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
 
3756
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code></td><td>&nbsp;</td>
 
3757
        </tr>
 
3758
        <tr>
 
3759
          <td></td>
 
3760
          <td>)</td>
 
3761
          <td></td><td></td><td></td>
 
3762
        </tr>
 
3763
      </table>
 
3764
</div>
 
3765
<div class="memdoc">
 
3766
 
 
3767
<p>
 
3768
 
 
3769
</div>
 
3770
</div><p>
 
3771
<a class="anchor" name="bfa05e23e95e77cabac289ab4e294a58"></a><!-- doxytag: member="Gio::File::make_directory" ref="bfa05e23e95e77cabac289ab4e294a58" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
 
3772
<div class="memitem">
 
3773
<div class="memproto">
 
3774
      <table class="memname">
 
3775
        <tr>
 
3776
          <td class="memname">bool Gio::File::make_directory           </td>
 
3777
          <td>(</td>
 
3778
          <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>
 
3779
          <td class="paramname"> <em>cancellable</em>          </td>
 
3780
          <td>&nbsp;)&nbsp;</td>
 
3781
          <td></td>
 
3782
        </tr>
 
3783
      </table>
 
3784
</div>
 
3785
<div class="memdoc">
 
3786
 
 
3787
<p>
 
3788
Creates a directory. 
 
3789
<p>
 
3790
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
 
3791
  <table border="0" cellspacing="2" cellpadding="0">
 
3792
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
 
3793
  </table>
 
3794
</dl>
 
3795
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> on successful creation, <code>false</code> otherwise. </dd></dl>
 
3796
 
 
3797
</div>
 
3798
</div><p>
 
3799
<a class="anchor" name="a1e9aa5f58a76a8562fd00a13434f554"></a><!-- doxytag: member="Gio::File::make_directory" ref="a1e9aa5f58a76a8562fd00a13434f554" args="()" -->
 
3800
<div class="memitem">
 
3801
<div class="memproto">
 
3802
      <table class="memname">
 
3803
        <tr>
 
3804
          <td class="memname">bool Gio::File::make_directory           </td>
 
3805
          <td>(</td>
 
3806
          <td class="paramname">          </td>
 
3807
          <td>&nbsp;)&nbsp;</td>
 
3808
          <td></td>
 
3809
        </tr>
 
3810
      </table>
 
3811
</div>
 
3812
<div class="memdoc">
 
3813
 
 
3814
<p>
 
3815
Creates a directory. 
 
3816
<p>
 
3817
Note that this will only create a child directory of the immediate parent directory of the path or URI given by the <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a>. To recursively create directories, see <a class="el" href="classGio_1_1File.html#874a487551d49ca62b31a3e5cf32fee6" title="Creates a directory and any parent directories that may not exist, similar to &#39;mkdir...">make_directory_with_parents()</a>. This function will fail if the parent directory does not exist, throwing an exception with IO_ERROR_NOT_FOUND. If the file system doesn't support creating directories, this function will fail, throwing an exception with IO_ERROR_NOT_SUPPORTED.<p>
 
3818
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> on successful creation, <code>false</code> otherwise. </dd></dl>
 
3819
 
 
3820
</div>
 
3821
</div><p>
 
3822
<a class="anchor" name="fb0b5b094339057b4b15952eb73e08d6"></a><!-- doxytag: member="Gio::File::make_directory_with_parents" ref="fb0b5b094339057b4b15952eb73e08d6" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
 
3823
<div class="memitem">
 
3824
<div class="memproto">
 
3825
      <table class="memname">
 
3826
        <tr>
 
3827
          <td class="memname">bool Gio::File::make_directory_with_parents           </td>
 
3828
          <td>(</td>
 
3829
          <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>
 
3830
          <td class="paramname"> <em>cancellable</em>          </td>
 
3831
          <td>&nbsp;)&nbsp;</td>
 
3832
          <td></td>
 
3833
        </tr>
 
3834
      </table>
 
3835
</div>
 
3836
<div class="memdoc">
 
3837
 
 
3838
<p>
 
3839
Creates a directory and any parent directories that may not exist similar to 'mkdir -p'. 
 
3840
<p>
 
3841
If the file system does not support creating directories, this function will fail, setting <em>error</em> to IO_ERROR_NOT_SUPPORTED.<p>
 
3842
For a local <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> the newly created directories will have the default (current) ownership and permissions of the current process.<p>
 
3843
If <em>cancellable</em> is not <code>0</code>, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error IO_ERROR_CANCELLED will be returned. <dl compact><dt><b>Parameters:</b></dt><dd>
 
3844
  <table border="0" cellspacing="2" cellpadding="0">
 
3845
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td>Optional <a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object, <code>0</code> to ignore. </td></tr>
 
3846
  </table>
 
3847
</dl>
 
3848
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if all directories have been successfully created, <code>false</code> otherwise.</dd></dl>
 
3849
<dl compact><dt><b><a class="el" href="newin2p18s.html#_newin2p18s000017">Since glibmm 2.18:</a></b></dt><dd></dd></dl>
 
3850
 
 
3851
</div>
 
3852
</div><p>
 
3853
<a class="anchor" name="874a487551d49ca62b31a3e5cf32fee6"></a><!-- doxytag: member="Gio::File::make_directory_with_parents" ref="874a487551d49ca62b31a3e5cf32fee6" args="()" -->
 
3854
<div class="memitem">
 
3855
<div class="memproto">
 
3856
      <table class="memname">
 
3857
        <tr>
 
3858
          <td class="memname">bool Gio::File::make_directory_with_parents           </td>
 
3859
          <td>(</td>
 
3860
          <td class="paramname">          </td>
 
3861
          <td>&nbsp;)&nbsp;</td>
 
3862
          <td></td>
 
3863
        </tr>
 
3864
      </table>
 
3865
</div>
 
3866
<div class="memdoc">
 
3867
 
 
3868
<p>
 
3869
Creates a directory and any parent directories that may not exist, similar to 'mkdir -p'. 
 
3870
<p>
 
3871
If the file system does not support creating directories, this function will fail, throwing an exception with IO_ERROR_NOT_SUPPORTED.<p>
 
3872
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> on successful creation, <code>false</code> otherwise.</dd></dl>
 
3873
<dl compact><dt><b><a class="el" href="newin2p18s.html#_newin2p18s000018">Since glibmm 2.18:</a></b></dt><dd></dd></dl>
 
3874
 
 
3875
</div>
 
3876
</div><p>
 
3877
<a class="anchor" name="2709318e1f24dfd0cd498d28f5e1b8fe"></a><!-- doxytag: member="Gio::File::make_symbolic_link" ref="2709318e1f24dfd0cd498d28f5e1b8fe" args="(const std::string &amp;symlink_value, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
 
3878
<div class="memitem">
 
3879
<div class="memproto">
 
3880
      <table class="memname">
 
3881
        <tr>
 
3882
          <td class="memname">bool Gio::File::make_symbolic_link           </td>
 
3883
          <td>(</td>
 
3884
          <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>
 
3885
          <td class="paramname"> <em>symlink_value</em>, </td>
 
3886
        </tr>
 
3887
        <tr>
 
3888
          <td class="paramkey"></td>
 
3889
          <td></td>
 
3890
          <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>
 
3891
          <td class="paramname"> <em>cancellable</em></td><td>&nbsp;</td>
 
3892
        </tr>
 
3893
        <tr>
 
3894
          <td></td>
 
3895
          <td>)</td>
 
3896
          <td></td><td></td><td></td>
 
3897
        </tr>
 
3898
      </table>
 
3899
</div>
 
3900
<div class="memdoc">
 
3901
 
 
3902
<p>
 
3903
Creates a symbolic link. 
 
3904
<p>
 
3905
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
 
3906
  <table border="0" cellspacing="2" cellpadding="0">
 
3907
    <tr><td valign="top"></td><td valign="top"><em>symlink_value</em>&nbsp;</td><td>A string with the value of the new symlink. </td></tr>
 
3908
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
 
3909
  </table>
 
3910
</dl>
 
3911
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> on the creation of a new symlink, <code>false</code> otherwise. </dd></dl>
 
3912
 
 
3913
</div>
 
3914
</div><p>
 
3915
<a class="anchor" name="8a9a3d060c2675ff9ac1c758f0b2c024"></a><!-- doxytag: member="Gio::File::make_symbolic_link" ref="8a9a3d060c2675ff9ac1c758f0b2c024" args="(const std::string &amp;symlink_value)" -->
 
3916
<div class="memitem">
 
3917
<div class="memproto">
 
3918
      <table class="memname">
 
3919
        <tr>
 
3920
          <td class="memname">bool Gio::File::make_symbolic_link           </td>
 
3921
          <td>(</td>
 
3922
          <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>
 
3923
          <td class="paramname"> <em>symlink_value</em>          </td>
 
3924
          <td>&nbsp;)&nbsp;</td>
 
3925
          <td></td>
 
3926
        </tr>
 
3927
      </table>
 
3928
</div>
 
3929
<div class="memdoc">
 
3930
 
 
3931
<p>
 
3932
Creates a symbolic link. 
 
3933
<p>
 
3934
<dl compact><dt><b>Parameters:</b></dt><dd>
 
3935
  <table border="0" cellspacing="2" cellpadding="0">
 
3936
    <tr><td valign="top"></td><td valign="top"><em>symlink_value</em>&nbsp;</td><td>A string with the value of the new symlink. </td></tr>
 
3937
  </table>
 
3938
</dl>
 
3939
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> on the creation of a new symlink, <code>false</code> otherwise. </dd></dl>
 
3940
 
 
3941
</div>
 
3942
</div><p>
 
3943
<a class="anchor" name="4a543339b58cff6a7e5ddd840df0e69e"></a><!-- doxytag: member="Gio::File::query_settable_attributes" ref="4a543339b58cff6a7e5ddd840df0e69e" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
 
3944
<div class="memitem">
 
3945
<div class="memproto">
 
3946
      <table class="memname">
 
3947
        <tr>
 
3948
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileAttributeInfoList.html">FileAttributeInfoList</a>&gt; Gio::File::query_settable_attributes           </td>
 
3949
          <td>(</td>
 
3950
          <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>
 
3951
          <td class="paramname"> <em>cancellable</em>          </td>
 
3952
          <td>&nbsp;)&nbsp;</td>
 
3953
          <td></td>
 
3954
        </tr>
 
3955
      </table>
 
3956
</div>
 
3957
<div class="memdoc">
 
3958
 
 
3959
<p>
 
3960
Obtain the list of settable attributes for the file. 
 
3961
<p>
 
3962
Returns: a <a class="el" href="classGio_1_1FileAttributeInfoList.html" title="Key-Value paired file attributes.">FileAttributeInfoList</a> describing the settable attributes. <dl compact><dt><b>Parameters:</b></dt><dd>
 
3963
  <table border="0" cellspacing="2" cellpadding="0">
 
3964
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td>Optional <a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object, <code>0</code> to ignore. </td></tr>
 
3965
  </table>
 
3966
</dl>
 
3967
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileAttributeInfoList.html" title="Key-Value paired file attributes.">FileAttributeInfoList</a> describing the settable attributes. When you are done with it, release it with g_file_attribute_info_list_unref(). </dd></dl>
 
3968
 
 
3969
</div>
 
3970
</div><p>
 
3971
<a class="anchor" name="1ae03d0652bcfbad2f47409b8f815bc4"></a><!-- doxytag: member="Gio::File::query_settable_attributes" ref="1ae03d0652bcfbad2f47409b8f815bc4" args="()" -->
 
3972
<div class="memitem">
 
3973
<div class="memproto">
 
3974
      <table class="memname">
 
3975
        <tr>
 
3976
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileAttributeInfoList.html">FileAttributeInfoList</a>&gt; Gio::File::query_settable_attributes           </td>
 
3977
          <td>(</td>
 
3978
          <td class="paramname">          </td>
 
3979
          <td>&nbsp;)&nbsp;</td>
 
3980
          <td></td>
 
3981
        </tr>
 
3982
      </table>
 
3983
</div>
 
3984
<div class="memdoc">
 
3985
 
 
3986
<p>
 
3987
Obtain the list of settable attributes for the file. 
 
3988
<p>
 
3989
Returns: a <a class="el" href="classGio_1_1FileAttributeInfoList.html" title="Key-Value paired file attributes.">FileAttributeInfoList</a> describing the settable attributes. <dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileAttributeInfoList.html" title="Key-Value paired file attributes.">FileAttributeInfoList</a> describing the settable attributes. </dd></dl>
 
3990
 
 
3991
</div>
 
3992
</div><p>
 
3993
<a class="anchor" name="f5c7463b92e2887597486e7b195ca12f"></a><!-- doxytag: member="Gio::File::query_writable_namespaces" ref="f5c7463b92e2887597486e7b195ca12f" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
 
3994
<div class="memitem">
 
3995
<div class="memproto">
 
3996
      <table class="memname">
 
3997
        <tr>
 
3998
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileAttributeInfoList.html">FileAttributeInfoList</a>&gt; Gio::File::query_writable_namespaces           </td>
 
3999
          <td>(</td>
 
4000
          <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>
 
4001
          <td class="paramname"> <em>cancellable</em>          </td>
 
4002
          <td>&nbsp;)&nbsp;</td>
 
4003
          <td></td>
 
4004
        </tr>
 
4005
      </table>
 
4006
</div>
 
4007
<div class="memdoc">
 
4008
 
 
4009
<p>
 
4010
Obtain the list of attribute namespaces where new attributes can be created by a user. 
 
4011
<p>
 
4012
An example of this is extended attributes (in the "xattr" namespace).<p>
 
4013
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
 
4014
  <table border="0" cellspacing="2" cellpadding="0">
 
4015
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
 
4016
  </table>
 
4017
</dl>
 
4018
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileAttributeInfoList.html" title="Key-Value paired file attributes.">FileAttributeInfoList</a> describing the writable namespaces. When you are done with it, release it with g_file_attribute_info_list_unref(). </dd></dl>
 
4019
 
 
4020
</div>
 
4021
</div><p>
 
4022
<a class="anchor" name="a0278acd7d09ed292359004defb742b0"></a><!-- doxytag: member="Gio::File::query_writable_namespaces" ref="a0278acd7d09ed292359004defb742b0" args="()" -->
 
4023
<div class="memitem">
 
4024
<div class="memproto">
 
4025
      <table class="memname">
 
4026
        <tr>
 
4027
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileAttributeInfoList.html">FileAttributeInfoList</a>&gt; Gio::File::query_writable_namespaces           </td>
 
4028
          <td>(</td>
 
4029
          <td class="paramname">          </td>
 
4030
          <td>&nbsp;)&nbsp;</td>
 
4031
          <td></td>
 
4032
        </tr>
 
4033
      </table>
 
4034
</div>
 
4035
<div class="memdoc">
 
4036
 
 
4037
<p>
 
4038
Obtain the list of attribute namespaces where new attributes can be created by a user. 
 
4039
<p>
 
4040
An example of this is extended attributes (in the "xattr" namespace).<p>
 
4041
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileAttributeInfoList.html" title="Key-Value paired file attributes.">FileAttributeInfoList</a> describing the writable namespaces. </dd></dl>
 
4042
 
 
4043
</div>
 
4044
</div><p>
 
4045
<a class="anchor" name="69d9e40a85b96809abc5189b34e8d9b7"></a><!-- doxytag: member="Gio::File::set_attributes_from_info" ref="69d9e40a85b96809abc5189b34e8d9b7" args="(const Glib::RefPtr&lt; FileInfo &gt; &amp;info, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE)" -->
 
4046
<div class="memitem">
 
4047
<div class="memproto">
 
4048
      <table class="memname">
 
4049
        <tr>
 
4050
          <td class="memname">bool Gio::File::set_attributes_from_info           </td>
 
4051
          <td>(</td>
 
4052
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileInfo.html">FileInfo</a>&gt;&amp;&nbsp;</td>
 
4053
          <td class="paramname"> <em>info</em>, </td>
 
4054
        </tr>
 
4055
        <tr>
 
4056
          <td class="paramkey"></td>
 
4057
          <td></td>
 
4058
          <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>
 
4059
          <td class="paramname"> <em>cancellable</em>, </td>
 
4060
        </tr>
 
4061
        <tr>
 
4062
          <td class="paramkey"></td>
 
4063
          <td></td>
 
4064
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
4065
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code></td><td>&nbsp;</td>
 
4066
        </tr>
 
4067
        <tr>
 
4068
          <td></td>
 
4069
          <td>)</td>
 
4070
          <td></td><td></td><td></td>
 
4071
        </tr>
 
4072
      </table>
 
4073
</div>
 
4074
<div class="memdoc">
 
4075
 
 
4076
<p>
 
4077
Tries to set all attributes in the <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> on the target values, not stopping on the first error. 
 
4078
<p>
 
4079
If there is any error during this operation then a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> will be thrown. <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Error</a> on particular fields are flagged by setting the "status" field in the attribute value to FILE_ATTRIBUTE_STATUS_ERROR_SETTING, which means you can also detect further errors.<p>
 
4080
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>
 
4081
<dl compact><dt><b>Parameters:</b></dt><dd>
 
4082
  <table border="0" cellspacing="2" cellpadding="0">
 
4083
    <tr><td valign="top"></td><td valign="top"><em>info</em>&nbsp;</td><td>A <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a>. </td></tr>
 
4084
    <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>
 
4085
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
 
4086
  </table>
 
4087
</dl>
 
4088
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if there was any error, <code>false</code> otherwise. </dd></dl>
 
4089
 
 
4090
</div>
 
4091
</div><p>
 
4092
<a class="anchor" name="e9f6975ffef28f0d7145601a99de0903"></a><!-- doxytag: member="Gio::File::set_attributes_from_info" ref="e9f6975ffef28f0d7145601a99de0903" args="(const Glib::RefPtr&lt; FileInfo &gt; &amp;info, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE)" -->
 
4093
<div class="memitem">
 
4094
<div class="memproto">
 
4095
      <table class="memname">
 
4096
        <tr>
 
4097
          <td class="memname">bool Gio::File::set_attributes_from_info           </td>
 
4098
          <td>(</td>
 
4099
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileInfo.html">FileInfo</a>&gt;&amp;&nbsp;</td>
 
4100
          <td class="paramname"> <em>info</em>, </td>
 
4101
        </tr>
 
4102
        <tr>
 
4103
          <td class="paramkey"></td>
 
4104
          <td></td>
 
4105
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
4106
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code></td><td>&nbsp;</td>
 
4107
        </tr>
 
4108
        <tr>
 
4109
          <td></td>
 
4110
          <td>)</td>
 
4111
          <td></td><td></td><td></td>
 
4112
        </tr>
 
4113
      </table>
 
4114
</div>
 
4115
<div class="memdoc">
 
4116
 
 
4117
<p>
 
4118
Tries to set all attributes in the <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a> on the target values, not stopping on the first error. 
 
4119
<p>
 
4120
If there is any error during this operation then a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> will be thrown. <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Error</a> on particular fields are flagged by setting the "status" field in the attribute value to FILE_ATTRIBUTE_STATUS_ERROR_SETTING, which means you can also detect further errors.<p>
 
4121
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>
 
4122
<dl compact><dt><b>Parameters:</b></dt><dd>
 
4123
  <table border="0" cellspacing="2" cellpadding="0">
 
4124
    <tr><td valign="top"></td><td valign="top"><em>info</em>&nbsp;</td><td>A <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a>. </td></tr>
 
4125
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
 
4126
  </table>
 
4127
</dl>
 
4128
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if there was any error, <code>false</code> otherwise. </dd></dl>
 
4129
 
 
4130
</div>
 
4131
</div><p>
 
4132
<a class="anchor" name="14165fba9bf7d91448c3207407ae50c2"></a><!-- doxytag: member="Gio::File::set_attributes_async" ref="14165fba9bf7d91448c3207407ae50c2" args="(const Glib::RefPtr&lt; FileInfo &gt; &amp;info, const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
 
4133
<div class="memitem">
 
4134
<div class="memproto">
 
4135
      <table class="memname">
 
4136
        <tr>
 
4137
          <td class="memname">void Gio::File::set_attributes_async           </td>
 
4138
          <td>(</td>
 
4139
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileInfo.html">FileInfo</a>&gt;&amp;&nbsp;</td>
 
4140
          <td class="paramname"> <em>info</em>, </td>
 
4141
        </tr>
 
4142
        <tr>
 
4143
          <td class="paramkey"></td>
 
4144
          <td></td>
 
4145
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
4146
          <td class="paramname"> <em>slot</em>, </td>
 
4147
        </tr>
 
4148
        <tr>
 
4149
          <td class="paramkey"></td>
 
4150
          <td></td>
 
4151
          <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>
 
4152
          <td class="paramname"> <em>cancellable</em>, </td>
 
4153
        </tr>
 
4154
        <tr>
 
4155
          <td class="paramkey"></td>
 
4156
          <td></td>
 
4157
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
4158
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code>, </td>
 
4159
        </tr>
 
4160
        <tr>
 
4161
          <td class="paramkey"></td>
 
4162
          <td></td>
 
4163
          <td class="paramtype">int&nbsp;</td>
 
4164
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
 
4165
        </tr>
 
4166
        <tr>
 
4167
          <td></td>
 
4168
          <td>)</td>
 
4169
          <td></td><td></td><td></td>
 
4170
        </tr>
 
4171
      </table>
 
4172
</div>
 
4173
<div class="memdoc">
 
4174
 
 
4175
<p>
 
4176
Asynchronously sets the attributes of file with info. 
 
4177
<p>
 
4178
For more details, see <a class="el" href="classGio_1_1File.html#69d9e40a85b96809abc5189b34e8d9b7" title="Tries to set all attributes in the FileInfo on the target values, not stopping on...">set_attributes_from_info()</a> which is the synchronous version of this call. When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#efd45aed7b975b6e204e67927de2817a">set_attributes_finish()</a> to get the result of the operation.<p>
 
4179
<dl compact><dt><b>Parameters:</b></dt><dd>
 
4180
  <table border="0" cellspacing="2" cellpadding="0">
 
4181
    <tr><td valign="top"></td><td valign="top"><em>info</em>&nbsp;</td><td>A <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a>. </td></tr>
 
4182
    <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>
 
4183
    <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>
 
4184
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
 
4185
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
 
4186
  </table>
 
4187
</dl>
 
4188
 
 
4189
</div>
 
4190
</div><p>
 
4191
<a class="anchor" name="61317a1980318537aa8ada7bb8cc2390"></a><!-- doxytag: member="Gio::File::set_attributes_async" ref="61317a1980318537aa8ada7bb8cc2390" args="(const Glib::RefPtr&lt; FileInfo &gt; &amp;info, const SlotAsyncReady &amp;slot, FileQueryInfoFlags flags=FILE_QUERY_INFO_NONE, int io_priority=Glib::PRIORITY_DEFAULT)" -->
 
4192
<div class="memitem">
 
4193
<div class="memproto">
 
4194
      <table class="memname">
 
4195
        <tr>
 
4196
          <td class="memname">void Gio::File::set_attributes_async           </td>
 
4197
          <td>(</td>
 
4198
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileInfo.html">FileInfo</a>&gt;&amp;&nbsp;</td>
 
4199
          <td class="paramname"> <em>info</em>, </td>
 
4200
        </tr>
 
4201
        <tr>
 
4202
          <td class="paramkey"></td>
 
4203
          <td></td>
 
4204
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
4205
          <td class="paramname"> <em>slot</em>, </td>
 
4206
        </tr>
 
4207
        <tr>
 
4208
          <td class="paramkey"></td>
 
4209
          <td></td>
 
4210
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
4211
          <td class="paramname"> <em>flags</em> = <code>FILE_QUERY_INFO_NONE</code>, </td>
 
4212
        </tr>
 
4213
        <tr>
 
4214
          <td class="paramkey"></td>
 
4215
          <td></td>
 
4216
          <td class="paramtype">int&nbsp;</td>
 
4217
          <td class="paramname"> <em>io_priority</em> = <code>Glib::PRIORITY_DEFAULT</code></td><td>&nbsp;</td>
 
4218
        </tr>
 
4219
        <tr>
 
4220
          <td></td>
 
4221
          <td>)</td>
 
4222
          <td></td><td></td><td></td>
 
4223
        </tr>
 
4224
      </table>
 
4225
</div>
 
4226
<div class="memdoc">
 
4227
 
 
4228
<p>
 
4229
Asynchronously sets the attributes of file with info. 
 
4230
<p>
 
4231
For more details, see <a class="el" href="classGio_1_1File.html#69d9e40a85b96809abc5189b34e8d9b7" title="Tries to set all attributes in the FileInfo on the target values, not stopping on...">set_attributes_from_info()</a> which is the synchronous version of this call. When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#efd45aed7b975b6e204e67927de2817a">set_attributes_finish()</a> to get the result of the operation.<p>
 
4232
<dl compact><dt><b>Parameters:</b></dt><dd>
 
4233
  <table border="0" cellspacing="2" cellpadding="0">
 
4234
    <tr><td valign="top"></td><td valign="top"><em>info</em>&nbsp;</td><td>A <a class="el" href="classGio_1_1FileInfo.html" title="FileInfo implements methods for getting information that all files should contain...">FileInfo</a>. </td></tr>
 
4235
    <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>
 
4236
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileQueryInfoFlags. </td></tr>
 
4237
    <tr><td valign="top"></td><td valign="top"><em>io_priority</em>&nbsp;</td><td>The I/O priority of the request. </td></tr>
 
4238
  </table>
 
4239
</dl>
 
4240
 
 
4241
</div>
 
4242
</div><p>
 
4243
<a class="anchor" name="efd45aed7b975b6e204e67927de2817a"></a><!-- doxytag: member="Gio::File::set_attributes_finish" ref="efd45aed7b975b6e204e67927de2817a" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result, const Glib::RefPtr&lt; FileInfo &gt; &amp;info)" -->
 
4244
<div class="memitem">
 
4245
<div class="memproto">
 
4246
      <table class="memname">
 
4247
        <tr>
 
4248
          <td class="memname">bool Gio::File::set_attributes_finish           </td>
 
4249
          <td>(</td>
 
4250
          <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>
 
4251
          <td class="paramname"> <em>result</em>, </td>
 
4252
        </tr>
 
4253
        <tr>
 
4254
          <td class="paramkey"></td>
 
4255
          <td></td>
 
4256
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileInfo.html">FileInfo</a>&gt;&amp;&nbsp;</td>
 
4257
          <td class="paramname"> <em>info</em></td><td>&nbsp;</td>
 
4258
        </tr>
 
4259
        <tr>
 
4260
          <td></td>
 
4261
          <td>)</td>
 
4262
          <td></td><td></td><td></td>
 
4263
        </tr>
 
4264
      </table>
 
4265
</div>
 
4266
<div class="memdoc">
 
4267
 
 
4268
<p>
 
4269
 
 
4270
</div>
 
4271
</div><p>
 
4272
<a class="anchor" name="5ce5f43fd5e2836ac1989a54d3233ff6"></a><!-- doxytag: member="Gio::File::set_attribute_string" ref="5ce5f43fd5e2836ac1989a54d3233ff6" args="(const std::string &amp;attribute, const std::string &amp;value, FileQueryInfoFlags flags, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
 
4273
<div class="memitem">
 
4274
<div class="memproto">
 
4275
      <table class="memname">
 
4276
        <tr>
 
4277
          <td class="memname">bool Gio::File::set_attribute_string           </td>
 
4278
          <td>(</td>
 
4279
          <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>
 
4280
          <td class="paramname"> <em>attribute</em>, </td>
 
4281
        </tr>
 
4282
        <tr>
 
4283
          <td class="paramkey"></td>
 
4284
          <td></td>
 
4285
          <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>
 
4286
          <td class="paramname"> <em>value</em>, </td>
 
4287
        </tr>
 
4288
        <tr>
 
4289
          <td class="paramkey"></td>
 
4290
          <td></td>
 
4291
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
4292
          <td class="paramname"> <em>flags</em>, </td>
 
4293
        </tr>
 
4294
        <tr>
 
4295
          <td class="paramkey"></td>
 
4296
          <td></td>
 
4297
          <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>
 
4298
          <td class="paramname"> <em>cancellable</em></td><td>&nbsp;</td>
 
4299
        </tr>
 
4300
        <tr>
 
4301
          <td></td>
 
4302
          <td>)</td>
 
4303
          <td></td><td></td><td></td>
 
4304
        </tr>
 
4305
      </table>
 
4306
</div>
 
4307
<div class="memdoc">
 
4308
 
 
4309
<p>
 
4310
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_STRING to <em>value</em>. 
 
4311
<p>
 
4312
If <em>attribute</em> is of a different type, this operation will fail.<p>
 
4313
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
 
4314
  <table border="0" cellspacing="2" cellpadding="0">
 
4315
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
 
4316
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A string containing the attribute's value. </td></tr>
 
4317
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>FileQueryInfoFlags. </td></tr>
 
4318
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
 
4319
  </table>
 
4320
</dl>
 
4321
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set, <code>false</code> otherwise. </dd></dl>
 
4322
 
 
4323
</div>
 
4324
</div><p>
 
4325
<a class="anchor" name="75fa7e1a44e97a910d232f2b4ab4bfdd"></a><!-- doxytag: member="Gio::File::set_attribute_string" ref="75fa7e1a44e97a910d232f2b4ab4bfdd" args="(const std::string &amp;attribute, const std::string &amp;value, FileQueryInfoFlags flags)" -->
 
4326
<div class="memitem">
 
4327
<div class="memproto">
 
4328
      <table class="memname">
 
4329
        <tr>
 
4330
          <td class="memname">bool Gio::File::set_attribute_string           </td>
 
4331
          <td>(</td>
 
4332
          <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>
 
4333
          <td class="paramname"> <em>attribute</em>, </td>
 
4334
        </tr>
 
4335
        <tr>
 
4336
          <td class="paramkey"></td>
 
4337
          <td></td>
 
4338
          <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>
 
4339
          <td class="paramname"> <em>value</em>, </td>
 
4340
        </tr>
 
4341
        <tr>
 
4342
          <td class="paramkey"></td>
 
4343
          <td></td>
 
4344
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
4345
          <td class="paramname"> <em>flags</em></td><td>&nbsp;</td>
 
4346
        </tr>
 
4347
        <tr>
 
4348
          <td></td>
 
4349
          <td>)</td>
 
4350
          <td></td><td></td><td></td>
 
4351
        </tr>
 
4352
      </table>
 
4353
</div>
 
4354
<div class="memdoc">
 
4355
 
 
4356
<p>
 
4357
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_STRING to <em>value</em>. 
 
4358
<p>
 
4359
If <em>attribute</em> is of a different type, this operation will fail.<p>
 
4360
<dl compact><dt><b>Parameters:</b></dt><dd>
 
4361
  <table border="0" cellspacing="2" cellpadding="0">
 
4362
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
 
4363
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A string containing the attribute's value. </td></tr>
 
4364
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>FileQueryInfoFlags. </td></tr>
 
4365
  </table>
 
4366
</dl>
 
4367
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set, <code>false</code> otherwise. </dd></dl>
 
4368
 
 
4369
</div>
 
4370
</div><p>
 
4371
<a class="anchor" name="4f4373b8694c346a6908195f1f2644f3"></a><!-- doxytag: member="Gio::File::set_attribute_byte_string" ref="4f4373b8694c346a6908195f1f2644f3" args="(const std::string &amp;attribute, const std::string &amp;value, FileQueryInfoFlags flags, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
 
4372
<div class="memitem">
 
4373
<div class="memproto">
 
4374
      <table class="memname">
 
4375
        <tr>
 
4376
          <td class="memname">bool Gio::File::set_attribute_byte_string           </td>
 
4377
          <td>(</td>
 
4378
          <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>
 
4379
          <td class="paramname"> <em>attribute</em>, </td>
 
4380
        </tr>
 
4381
        <tr>
 
4382
          <td class="paramkey"></td>
 
4383
          <td></td>
 
4384
          <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>
 
4385
          <td class="paramname"> <em>value</em>, </td>
 
4386
        </tr>
 
4387
        <tr>
 
4388
          <td class="paramkey"></td>
 
4389
          <td></td>
 
4390
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
4391
          <td class="paramname"> <em>flags</em>, </td>
 
4392
        </tr>
 
4393
        <tr>
 
4394
          <td class="paramkey"></td>
 
4395
          <td></td>
 
4396
          <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>
 
4397
          <td class="paramname"> <em>cancellable</em></td><td>&nbsp;</td>
 
4398
        </tr>
 
4399
        <tr>
 
4400
          <td></td>
 
4401
          <td>)</td>
 
4402
          <td></td><td></td><td></td>
 
4403
        </tr>
 
4404
      </table>
 
4405
</div>
 
4406
<div class="memdoc">
 
4407
 
 
4408
<p>
 
4409
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_BYTE_STRING to <em>value</em>. 
 
4410
<p>
 
4411
If <em>attribute</em> is of a different type, this operation will fail, returning <code>false</code>.<p>
 
4412
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
 
4413
  <table border="0" cellspacing="2" cellpadding="0">
 
4414
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
 
4415
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A string containing the attribute's new value. </td></tr>
 
4416
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A FileQueryInfoFlags. </td></tr>
 
4417
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
 
4418
  </table>
 
4419
</dl>
 
4420
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set to <em>value</em> in the <em>file</em>, <code>false</code> otherwise. </dd></dl>
 
4421
 
 
4422
</div>
 
4423
</div><p>
 
4424
<a class="anchor" name="09f574259052186e1b516bdcbe696710"></a><!-- doxytag: member="Gio::File::set_attribute_byte_string" ref="09f574259052186e1b516bdcbe696710" args="(const std::string &amp;attribute, const std::string &amp;value, FileQueryInfoFlags flags)" -->
 
4425
<div class="memitem">
 
4426
<div class="memproto">
 
4427
      <table class="memname">
 
4428
        <tr>
 
4429
          <td class="memname">bool Gio::File::set_attribute_byte_string           </td>
 
4430
          <td>(</td>
 
4431
          <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>
 
4432
          <td class="paramname"> <em>attribute</em>, </td>
 
4433
        </tr>
 
4434
        <tr>
 
4435
          <td class="paramkey"></td>
 
4436
          <td></td>
 
4437
          <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>
 
4438
          <td class="paramname"> <em>value</em>, </td>
 
4439
        </tr>
 
4440
        <tr>
 
4441
          <td class="paramkey"></td>
 
4442
          <td></td>
 
4443
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
4444
          <td class="paramname"> <em>flags</em></td><td>&nbsp;</td>
 
4445
        </tr>
 
4446
        <tr>
 
4447
          <td></td>
 
4448
          <td>)</td>
 
4449
          <td></td><td></td><td></td>
 
4450
        </tr>
 
4451
      </table>
 
4452
</div>
 
4453
<div class="memdoc">
 
4454
 
 
4455
<p>
 
4456
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_BYTE_STRING to <em>value</em>. 
 
4457
<p>
 
4458
If <em>attribute</em> is of a different type, this operation will fail, returning <code>false</code>.<p>
 
4459
<dl compact><dt><b>Parameters:</b></dt><dd>
 
4460
  <table border="0" cellspacing="2" cellpadding="0">
 
4461
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
 
4462
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A string containing the attribute's new value. </td></tr>
 
4463
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A FileQueryInfoFlags. </td></tr>
 
4464
  </table>
 
4465
</dl>
 
4466
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set to <em>value</em> in the <em>file</em>, <code>false</code> otherwise. </dd></dl>
 
4467
 
 
4468
</div>
 
4469
</div><p>
 
4470
<a class="anchor" name="e53b0f4d2214e050a290c8e35cac0f27"></a><!-- doxytag: member="Gio::File::set_attribute_uint32" ref="e53b0f4d2214e050a290c8e35cac0f27" args="(const std::string &amp;attribute, guint32 value, FileQueryInfoFlags flags, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
 
4471
<div class="memitem">
 
4472
<div class="memproto">
 
4473
      <table class="memname">
 
4474
        <tr>
 
4475
          <td class="memname">bool Gio::File::set_attribute_uint32           </td>
 
4476
          <td>(</td>
 
4477
          <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>
 
4478
          <td class="paramname"> <em>attribute</em>, </td>
 
4479
        </tr>
 
4480
        <tr>
 
4481
          <td class="paramkey"></td>
 
4482
          <td></td>
 
4483
          <td class="paramtype">guint32&nbsp;</td>
 
4484
          <td class="paramname"> <em>value</em>, </td>
 
4485
        </tr>
 
4486
        <tr>
 
4487
          <td class="paramkey"></td>
 
4488
          <td></td>
 
4489
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
4490
          <td class="paramname"> <em>flags</em>, </td>
 
4491
        </tr>
 
4492
        <tr>
 
4493
          <td class="paramkey"></td>
 
4494
          <td></td>
 
4495
          <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>
 
4496
          <td class="paramname"> <em>cancellable</em></td><td>&nbsp;</td>
 
4497
        </tr>
 
4498
        <tr>
 
4499
          <td></td>
 
4500
          <td>)</td>
 
4501
          <td></td><td></td><td></td>
 
4502
        </tr>
 
4503
      </table>
 
4504
</div>
 
4505
<div class="memdoc">
 
4506
 
 
4507
<p>
 
4508
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_UINT32 to <em>value</em>. 
 
4509
<p>
 
4510
If <em>attribute</em> is of a different type, this operation will fail.<p>
 
4511
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
 
4512
  <table border="0" cellspacing="2" cellpadding="0">
 
4513
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
 
4514
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A guint32 containing the attribute's new value. </td></tr>
 
4515
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A FileQueryInfoFlags. </td></tr>
 
4516
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
 
4517
  </table>
 
4518
</dl>
 
4519
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set to <em>value</em> in the <em>file</em>, <code>false</code> otherwise. </dd></dl>
 
4520
 
 
4521
</div>
 
4522
</div><p>
 
4523
<a class="anchor" name="7f769f140143f2e96a7587a10b6792a9"></a><!-- doxytag: member="Gio::File::set_attribute_uint32" ref="7f769f140143f2e96a7587a10b6792a9" args="(const std::string &amp;attribute, guint32 value, FileQueryInfoFlags flags)" -->
 
4524
<div class="memitem">
 
4525
<div class="memproto">
 
4526
      <table class="memname">
 
4527
        <tr>
 
4528
          <td class="memname">bool Gio::File::set_attribute_uint32           </td>
 
4529
          <td>(</td>
 
4530
          <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>
 
4531
          <td class="paramname"> <em>attribute</em>, </td>
 
4532
        </tr>
 
4533
        <tr>
 
4534
          <td class="paramkey"></td>
 
4535
          <td></td>
 
4536
          <td class="paramtype">guint32&nbsp;</td>
 
4537
          <td class="paramname"> <em>value</em>, </td>
 
4538
        </tr>
 
4539
        <tr>
 
4540
          <td class="paramkey"></td>
 
4541
          <td></td>
 
4542
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
4543
          <td class="paramname"> <em>flags</em></td><td>&nbsp;</td>
 
4544
        </tr>
 
4545
        <tr>
 
4546
          <td></td>
 
4547
          <td>)</td>
 
4548
          <td></td><td></td><td></td>
 
4549
        </tr>
 
4550
      </table>
 
4551
</div>
 
4552
<div class="memdoc">
 
4553
 
 
4554
<p>
 
4555
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_UINT32 to <em>value</em>. 
 
4556
<p>
 
4557
If <em>attribute</em> is of a different type, this operation will fail.<p>
 
4558
<dl compact><dt><b>Parameters:</b></dt><dd>
 
4559
  <table border="0" cellspacing="2" cellpadding="0">
 
4560
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
 
4561
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A guint32 containing the attribute's new value. </td></tr>
 
4562
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A FileQueryInfoFlags. </td></tr>
 
4563
  </table>
 
4564
</dl>
 
4565
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set to <em>value</em> in the <em>file</em>, <code>false</code> otherwise. </dd></dl>
 
4566
 
 
4567
</div>
 
4568
</div><p>
 
4569
<a class="anchor" name="b0290ecba7b06ccf7736e2292708667e"></a><!-- doxytag: member="Gio::File::set_attribute_int32" ref="b0290ecba7b06ccf7736e2292708667e" args="(const std::string &amp;attribute, gint32 value, FileQueryInfoFlags flags, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
 
4570
<div class="memitem">
 
4571
<div class="memproto">
 
4572
      <table class="memname">
 
4573
        <tr>
 
4574
          <td class="memname">bool Gio::File::set_attribute_int32           </td>
 
4575
          <td>(</td>
 
4576
          <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>
 
4577
          <td class="paramname"> <em>attribute</em>, </td>
 
4578
        </tr>
 
4579
        <tr>
 
4580
          <td class="paramkey"></td>
 
4581
          <td></td>
 
4582
          <td class="paramtype">gint32&nbsp;</td>
 
4583
          <td class="paramname"> <em>value</em>, </td>
 
4584
        </tr>
 
4585
        <tr>
 
4586
          <td class="paramkey"></td>
 
4587
          <td></td>
 
4588
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
4589
          <td class="paramname"> <em>flags</em>, </td>
 
4590
        </tr>
 
4591
        <tr>
 
4592
          <td class="paramkey"></td>
 
4593
          <td></td>
 
4594
          <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>
 
4595
          <td class="paramname"> <em>cancellable</em></td><td>&nbsp;</td>
 
4596
        </tr>
 
4597
        <tr>
 
4598
          <td></td>
 
4599
          <td>)</td>
 
4600
          <td></td><td></td><td></td>
 
4601
        </tr>
 
4602
      </table>
 
4603
</div>
 
4604
<div class="memdoc">
 
4605
 
 
4606
<p>
 
4607
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_INT32 to <em>value</em>. 
 
4608
<p>
 
4609
If <em>attribute</em> is of a different type, this operation will fail.<p>
 
4610
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
 
4611
  <table border="0" cellspacing="2" cellpadding="0">
 
4612
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
 
4613
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A gint32 containing the attribute's new value. </td></tr>
 
4614
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A FileQueryInfoFlags. </td></tr>
 
4615
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
 
4616
  </table>
 
4617
</dl>
 
4618
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set to <em>value</em> in the <em>file</em>, <code>false</code> otherwise. </dd></dl>
 
4619
 
 
4620
</div>
 
4621
</div><p>
 
4622
<a class="anchor" name="4a707084a3c0a963548a21d17d0ec0b5"></a><!-- doxytag: member="Gio::File::set_attribute_int32" ref="4a707084a3c0a963548a21d17d0ec0b5" args="(const std::string &amp;attribute, gint32 value, FileQueryInfoFlags flags)" -->
 
4623
<div class="memitem">
 
4624
<div class="memproto">
 
4625
      <table class="memname">
 
4626
        <tr>
 
4627
          <td class="memname">bool Gio::File::set_attribute_int32           </td>
 
4628
          <td>(</td>
 
4629
          <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>
 
4630
          <td class="paramname"> <em>attribute</em>, </td>
 
4631
        </tr>
 
4632
        <tr>
 
4633
          <td class="paramkey"></td>
 
4634
          <td></td>
 
4635
          <td class="paramtype">gint32&nbsp;</td>
 
4636
          <td class="paramname"> <em>value</em>, </td>
 
4637
        </tr>
 
4638
        <tr>
 
4639
          <td class="paramkey"></td>
 
4640
          <td></td>
 
4641
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
4642
          <td class="paramname"> <em>flags</em></td><td>&nbsp;</td>
 
4643
        </tr>
 
4644
        <tr>
 
4645
          <td></td>
 
4646
          <td>)</td>
 
4647
          <td></td><td></td><td></td>
 
4648
        </tr>
 
4649
      </table>
 
4650
</div>
 
4651
<div class="memdoc">
 
4652
 
 
4653
<p>
 
4654
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_INT32 to <em>value</em>. 
 
4655
<p>
 
4656
If <em>attribute</em> is of a different type, this operation will fail.<p>
 
4657
<dl compact><dt><b>Parameters:</b></dt><dd>
 
4658
  <table border="0" cellspacing="2" cellpadding="0">
 
4659
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
 
4660
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A gint32 containing the attribute's new value. </td></tr>
 
4661
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A FileQueryInfoFlags. </td></tr>
 
4662
  </table>
 
4663
</dl>
 
4664
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set to <em>value</em> in the <em>file</em>, <code>false</code> otherwise. </dd></dl>
 
4665
 
 
4666
</div>
 
4667
</div><p>
 
4668
<a class="anchor" name="48638081fd7af772a39af59a558b17f7"></a><!-- doxytag: member="Gio::File::set_attribute_uint64" ref="48638081fd7af772a39af59a558b17f7" args="(const std::string &amp;attribute, guint64 value, FileQueryInfoFlags flags, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
 
4669
<div class="memitem">
 
4670
<div class="memproto">
 
4671
      <table class="memname">
 
4672
        <tr>
 
4673
          <td class="memname">bool Gio::File::set_attribute_uint64           </td>
 
4674
          <td>(</td>
 
4675
          <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>
 
4676
          <td class="paramname"> <em>attribute</em>, </td>
 
4677
        </tr>
 
4678
        <tr>
 
4679
          <td class="paramkey"></td>
 
4680
          <td></td>
 
4681
          <td class="paramtype">guint64&nbsp;</td>
 
4682
          <td class="paramname"> <em>value</em>, </td>
 
4683
        </tr>
 
4684
        <tr>
 
4685
          <td class="paramkey"></td>
 
4686
          <td></td>
 
4687
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
4688
          <td class="paramname"> <em>flags</em>, </td>
 
4689
        </tr>
 
4690
        <tr>
 
4691
          <td class="paramkey"></td>
 
4692
          <td></td>
 
4693
          <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>
 
4694
          <td class="paramname"> <em>cancellable</em></td><td>&nbsp;</td>
 
4695
        </tr>
 
4696
        <tr>
 
4697
          <td></td>
 
4698
          <td>)</td>
 
4699
          <td></td><td></td><td></td>
 
4700
        </tr>
 
4701
      </table>
 
4702
</div>
 
4703
<div class="memdoc">
 
4704
 
 
4705
<p>
 
4706
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_UINT64 to <em>value</em>. 
 
4707
<p>
 
4708
If <em>attribute</em> is of a different type, this operation will fail.<p>
 
4709
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
 
4710
  <table border="0" cellspacing="2" cellpadding="0">
 
4711
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
 
4712
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A guint64 containing the attribute's new value. </td></tr>
 
4713
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A FileQueryInfoFlags. </td></tr>
 
4714
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
 
4715
  </table>
 
4716
</dl>
 
4717
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set to <em>value</em> in the <em>file</em>, <code>false</code> otherwise. </dd></dl>
 
4718
 
 
4719
</div>
 
4720
</div><p>
 
4721
<a class="anchor" name="4aa77b3580df88cfd3d7231af78155c7"></a><!-- doxytag: member="Gio::File::set_attribute_uint64" ref="4aa77b3580df88cfd3d7231af78155c7" args="(const std::string &amp;attribute, guint64 value, FileQueryInfoFlags flags)" -->
 
4722
<div class="memitem">
 
4723
<div class="memproto">
 
4724
      <table class="memname">
 
4725
        <tr>
 
4726
          <td class="memname">bool Gio::File::set_attribute_uint64           </td>
 
4727
          <td>(</td>
 
4728
          <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>
 
4729
          <td class="paramname"> <em>attribute</em>, </td>
 
4730
        </tr>
 
4731
        <tr>
 
4732
          <td class="paramkey"></td>
 
4733
          <td></td>
 
4734
          <td class="paramtype">guint64&nbsp;</td>
 
4735
          <td class="paramname"> <em>value</em>, </td>
 
4736
        </tr>
 
4737
        <tr>
 
4738
          <td class="paramkey"></td>
 
4739
          <td></td>
 
4740
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
4741
          <td class="paramname"> <em>flags</em></td><td>&nbsp;</td>
 
4742
        </tr>
 
4743
        <tr>
 
4744
          <td></td>
 
4745
          <td>)</td>
 
4746
          <td></td><td></td><td></td>
 
4747
        </tr>
 
4748
      </table>
 
4749
</div>
 
4750
<div class="memdoc">
 
4751
 
 
4752
<p>
 
4753
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_UINT64 to <em>value</em>. 
 
4754
<p>
 
4755
If <em>attribute</em> is of a different type, this operation will fail.<p>
 
4756
<dl compact><dt><b>Parameters:</b></dt><dd>
 
4757
  <table border="0" cellspacing="2" cellpadding="0">
 
4758
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
 
4759
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A guint64 containing the attribute's new value. </td></tr>
 
4760
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A FileQueryInfoFlags. </td></tr>
 
4761
  </table>
 
4762
</dl>
 
4763
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set to <em>value</em> in the <em>file</em>, <code>false</code> otherwise. </dd></dl>
 
4764
 
 
4765
</div>
 
4766
</div><p>
 
4767
<a class="anchor" name="111d73a2d003e5a5a4c5f86c7c3d2fb7"></a><!-- doxytag: member="Gio::File::set_attribute_int64" ref="111d73a2d003e5a5a4c5f86c7c3d2fb7" args="(const std::string &amp;attribute, gint64 value, FileQueryInfoFlags flags, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
 
4768
<div class="memitem">
 
4769
<div class="memproto">
 
4770
      <table class="memname">
 
4771
        <tr>
 
4772
          <td class="memname">bool Gio::File::set_attribute_int64           </td>
 
4773
          <td>(</td>
 
4774
          <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>
 
4775
          <td class="paramname"> <em>attribute</em>, </td>
 
4776
        </tr>
 
4777
        <tr>
 
4778
          <td class="paramkey"></td>
 
4779
          <td></td>
 
4780
          <td class="paramtype">gint64&nbsp;</td>
 
4781
          <td class="paramname"> <em>value</em>, </td>
 
4782
        </tr>
 
4783
        <tr>
 
4784
          <td class="paramkey"></td>
 
4785
          <td></td>
 
4786
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
4787
          <td class="paramname"> <em>flags</em>, </td>
 
4788
        </tr>
 
4789
        <tr>
 
4790
          <td class="paramkey"></td>
 
4791
          <td></td>
 
4792
          <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>
 
4793
          <td class="paramname"> <em>cancellable</em></td><td>&nbsp;</td>
 
4794
        </tr>
 
4795
        <tr>
 
4796
          <td></td>
 
4797
          <td>)</td>
 
4798
          <td></td><td></td><td></td>
 
4799
        </tr>
 
4800
      </table>
 
4801
</div>
 
4802
<div class="memdoc">
 
4803
 
 
4804
<p>
 
4805
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_INT64 to <em>value</em>. 
 
4806
<p>
 
4807
If <em>attribute</em> is of a different type, this operation will fail.<p>
 
4808
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> will be thrown with CANCELLED. <dl compact><dt><b>Parameters:</b></dt><dd>
 
4809
  <table border="0" cellspacing="2" cellpadding="0">
 
4810
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
 
4811
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A guint64 containing the attribute's new value. </td></tr>
 
4812
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A FileQueryInfoFlags. </td></tr>
 
4813
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
 
4814
  </table>
 
4815
</dl>
 
4816
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set, <code>false</code> otherwise. </dd></dl>
 
4817
 
 
4818
</div>
 
4819
</div><p>
 
4820
<a class="anchor" name="4477b0063110951b26c855696ec34802"></a><!-- doxytag: member="Gio::File::set_attribute_int64" ref="4477b0063110951b26c855696ec34802" args="(const std::string &amp;attribute, gint64 value, FileQueryInfoFlags flags)" -->
 
4821
<div class="memitem">
 
4822
<div class="memproto">
 
4823
      <table class="memname">
 
4824
        <tr>
 
4825
          <td class="memname">bool Gio::File::set_attribute_int64           </td>
 
4826
          <td>(</td>
 
4827
          <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>
 
4828
          <td class="paramname"> <em>attribute</em>, </td>
 
4829
        </tr>
 
4830
        <tr>
 
4831
          <td class="paramkey"></td>
 
4832
          <td></td>
 
4833
          <td class="paramtype">gint64&nbsp;</td>
 
4834
          <td class="paramname"> <em>value</em>, </td>
 
4835
        </tr>
 
4836
        <tr>
 
4837
          <td class="paramkey"></td>
 
4838
          <td></td>
 
4839
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g2cb7bdea61353f0999607785abd032c0">FileQueryInfoFlags</a>&nbsp;</td>
 
4840
          <td class="paramname"> <em>flags</em></td><td>&nbsp;</td>
 
4841
        </tr>
 
4842
        <tr>
 
4843
          <td></td>
 
4844
          <td>)</td>
 
4845
          <td></td><td></td><td></td>
 
4846
        </tr>
 
4847
      </table>
 
4848
</div>
 
4849
<div class="memdoc">
 
4850
 
 
4851
<p>
 
4852
Sets <em>attribute</em> of type FILE_ATTRIBUTE_TYPE_INT64 to <em>value</em>. 
 
4853
<p>
 
4854
If <em>attribute</em> is of a different type, this operation will fail.<p>
 
4855
<dl compact><dt><b>Parameters:</b></dt><dd>
 
4856
  <table border="0" cellspacing="2" cellpadding="0">
 
4857
    <tr><td valign="top"></td><td valign="top"><em>attribute</em>&nbsp;</td><td>A string containing the attribute's name. </td></tr>
 
4858
    <tr><td valign="top"></td><td valign="top"><em>value</em>&nbsp;</td><td>A guint64 containing the attribute's new value. </td></tr>
 
4859
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A FileQueryInfoFlags. </td></tr>
 
4860
  </table>
 
4861
</dl>
 
4862
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>attribute</em> was successfully set, <code>false</code> otherwise. </dd></dl>
 
4863
 
 
4864
</div>
 
4865
</div><p>
 
4866
<a class="anchor" name="144aa2de6b696da90a6baffbe959d732"></a><!-- doxytag: member="Gio::File::mount_enclosing_volume" ref="144aa2de6b696da90a6baffbe959d732" args="(const Glib::RefPtr&lt; MountOperation &gt; &amp;mount_operation, const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, MountMountFlags flags=MOUNT_MOUNT_NONE)" -->
 
4867
<div class="memitem">
 
4868
<div class="memproto">
 
4869
      <table class="memname">
 
4870
        <tr>
 
4871
          <td class="memname">void Gio::File::mount_enclosing_volume           </td>
 
4872
          <td>(</td>
 
4873
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1MountOperation.html">MountOperation</a>&gt;&amp;&nbsp;</td>
 
4874
          <td class="paramname"> <em>mount_operation</em>, </td>
 
4875
        </tr>
 
4876
        <tr>
 
4877
          <td class="paramkey"></td>
 
4878
          <td></td>
 
4879
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
4880
          <td class="paramname"> <em>slot</em>, </td>
 
4881
        </tr>
 
4882
        <tr>
 
4883
          <td class="paramkey"></td>
 
4884
          <td></td>
 
4885
          <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>
 
4886
          <td class="paramname"> <em>cancellable</em>, </td>
 
4887
        </tr>
 
4888
        <tr>
 
4889
          <td class="paramkey"></td>
 
4890
          <td></td>
 
4891
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g5484bace25c932fd4c7354259e138814">MountMountFlags</a>&nbsp;</td>
 
4892
          <td class="paramname"> <em>flags</em> = <code>MOUNT_MOUNT_NONE</code></td><td>&nbsp;</td>
 
4893
        </tr>
 
4894
        <tr>
 
4895
          <td></td>
 
4896
          <td>)</td>
 
4897
          <td></td><td></td><td></td>
 
4898
        </tr>
 
4899
      </table>
 
4900
</div>
 
4901
<div class="memdoc">
 
4902
 
 
4903
<p>
 
4904
Starts a <em>mount_operation</em>, mounting the volume that contains the file. 
 
4905
<p>
 
4906
When this operation has completed, <em>slot</em> will be called with, and the operation can be finalized with <a class="el" href="classGio_1_1File.html#efd44b1b3467bcc474b345ff98b4aa6d" title="Finishes a mount operation started by g_file_mount_enclosing_volume().">mount_enclosing_volume_finish()</a>.<p>
 
4907
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>
 
4908
<dl compact><dt><b>Parameters:</b></dt><dd>
 
4909
  <table border="0" cellspacing="2" cellpadding="0">
 
4910
    <tr><td valign="top"></td><td valign="top"><em>mount_operation</em>&nbsp;</td><td>A <a class="el" href="classGio_1_1MountOperation.html" title="Authentication methods for mountable locations.">MountOperation</a>. </td></tr>
 
4911
    <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>
 
4912
    <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>
 
4913
  </table>
 
4914
</dl>
 
4915
 
 
4916
</div>
 
4917
</div><p>
 
4918
<a class="anchor" name="70fd22116d9c8682433c4bb8cbd764c1"></a><!-- doxytag: member="Gio::File::mount_enclosing_volume" ref="70fd22116d9c8682433c4bb8cbd764c1" args="(const Glib::RefPtr&lt; MountOperation &gt; &amp;mount_operation, const SlotAsyncReady &amp;slot, MountMountFlags flags=MOUNT_MOUNT_NONE)" -->
 
4919
<div class="memitem">
 
4920
<div class="memproto">
 
4921
      <table class="memname">
 
4922
        <tr>
 
4923
          <td class="memname">void Gio::File::mount_enclosing_volume           </td>
 
4924
          <td>(</td>
 
4925
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1MountOperation.html">MountOperation</a>&gt;&amp;&nbsp;</td>
 
4926
          <td class="paramname"> <em>mount_operation</em>, </td>
 
4927
        </tr>
 
4928
        <tr>
 
4929
          <td class="paramkey"></td>
 
4930
          <td></td>
 
4931
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
4932
          <td class="paramname"> <em>slot</em>, </td>
 
4933
        </tr>
 
4934
        <tr>
 
4935
          <td class="paramkey"></td>
 
4936
          <td></td>
 
4937
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g5484bace25c932fd4c7354259e138814">MountMountFlags</a>&nbsp;</td>
 
4938
          <td class="paramname"> <em>flags</em> = <code>MOUNT_MOUNT_NONE</code></td><td>&nbsp;</td>
 
4939
        </tr>
 
4940
        <tr>
 
4941
          <td></td>
 
4942
          <td>)</td>
 
4943
          <td></td><td></td><td></td>
 
4944
        </tr>
 
4945
      </table>
 
4946
</div>
 
4947
<div class="memdoc">
 
4948
 
 
4949
<p>
 
4950
Starts a <em>mount_operation</em>, mounting the volume that contains the file. 
 
4951
<p>
 
4952
When this operation has completed, <em>slot</em> will be called with, and the operation can be finalized with <a class="el" href="classGio_1_1File.html#efd44b1b3467bcc474b345ff98b4aa6d" title="Finishes a mount operation started by g_file_mount_enclosing_volume().">mount_enclosing_volume_finish()</a>.<p>
 
4953
<dl compact><dt><b>Parameters:</b></dt><dd>
 
4954
  <table border="0" cellspacing="2" cellpadding="0">
 
4955
    <tr><td valign="top"></td><td valign="top"><em>mount_operation</em>&nbsp;</td><td>A <a class="el" href="classGio_1_1MountOperation.html" title="Authentication methods for mountable locations.">MountOperation</a>. </td></tr>
 
4956
    <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>
 
4957
  </table>
 
4958
</dl>
 
4959
 
 
4960
</div>
 
4961
</div><p>
 
4962
<a class="anchor" name="2172cdcdb683630b719c521bf00b1eb4"></a><!-- doxytag: member="Gio::File::mount_enclosing_volume" ref="2172cdcdb683630b719c521bf00b1eb4" args="(const SlotAsyncReady &amp;slot, MountMountFlags flags=MOUNT_MOUNT_NONE)" -->
 
4963
<div class="memitem">
 
4964
<div class="memproto">
 
4965
      <table class="memname">
 
4966
        <tr>
 
4967
          <td class="memname">void Gio::File::mount_enclosing_volume           </td>
 
4968
          <td>(</td>
 
4969
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
4970
          <td class="paramname"> <em>slot</em>, </td>
 
4971
        </tr>
 
4972
        <tr>
 
4973
          <td class="paramkey"></td>
 
4974
          <td></td>
 
4975
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g5484bace25c932fd4c7354259e138814">MountMountFlags</a>&nbsp;</td>
 
4976
          <td class="paramname"> <em>flags</em> = <code>MOUNT_MOUNT_NONE</code></td><td>&nbsp;</td>
 
4977
        </tr>
 
4978
        <tr>
 
4979
          <td></td>
 
4980
          <td>)</td>
 
4981
          <td></td><td></td><td></td>
 
4982
        </tr>
 
4983
      </table>
 
4984
</div>
 
4985
<div class="memdoc">
 
4986
 
 
4987
<p>
 
4988
Starts a <em>mount_operation</em>, mounting the volume that contains the file. 
 
4989
<p>
 
4990
When this operation has completed, <em>slot</em> will be called with, and the operation can be finalized with <a class="el" href="classGio_1_1File.html#efd44b1b3467bcc474b345ff98b4aa6d" title="Finishes a mount operation started by g_file_mount_enclosing_volume().">mount_enclosing_volume_finish()</a>.<p>
 
4991
<dl compact><dt><b>Parameters:</b></dt><dd>
 
4992
  <table border="0" cellspacing="2" cellpadding="0">
 
4993
    <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>
 
4994
  </table>
 
4995
</dl>
 
4996
 
 
4997
</div>
 
4998
</div><p>
 
4999
<a class="anchor" name="20f8f18876102a5efaa0536bfa71d71c"></a><!-- doxytag: member="Gio::File::mount_enclosing_volume" ref="20f8f18876102a5efaa0536bfa71d71c" args="(MountMountFlags flags=MOUNT_MOUNT_NONE)" -->
 
5000
<div class="memitem">
 
5001
<div class="memproto">
 
5002
      <table class="memname">
 
5003
        <tr>
 
5004
          <td class="memname">void Gio::File::mount_enclosing_volume           </td>
 
5005
          <td>(</td>
 
5006
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g5484bace25c932fd4c7354259e138814">MountMountFlags</a>&nbsp;</td>
 
5007
          <td class="paramname"> <em>flags</em> = <code>MOUNT_MOUNT_NONE</code>          </td>
 
5008
          <td>&nbsp;)&nbsp;</td>
 
5009
          <td></td>
 
5010
        </tr>
 
5011
      </table>
 
5012
</div>
 
5013
<div class="memdoc">
 
5014
 
 
5015
<p>
 
5016
Starts a <em>mount_operation</em>, mounting the volume that contains the file. 
 
5017
<p>
 
5018
 
 
5019
</div>
 
5020
</div><p>
 
5021
<a class="anchor" name="efd44b1b3467bcc474b345ff98b4aa6d"></a><!-- doxytag: member="Gio::File::mount_enclosing_volume_finish" ref="efd44b1b3467bcc474b345ff98b4aa6d" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
 
5022
<div class="memitem">
 
5023
<div class="memproto">
 
5024
      <table class="memname">
 
5025
        <tr>
 
5026
          <td class="memname">bool Gio::File::mount_enclosing_volume_finish           </td>
 
5027
          <td>(</td>
 
5028
          <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>
 
5029
          <td class="paramname"> <em>result</em>          </td>
 
5030
          <td>&nbsp;)&nbsp;</td>
 
5031
          <td></td>
 
5032
        </tr>
 
5033
      </table>
 
5034
</div>
 
5035
<div class="memdoc">
 
5036
 
 
5037
<p>
 
5038
Finishes a mount operation started by g_file_mount_enclosing_volume(). 
 
5039
<p>
 
5040
<dl compact><dt><b>Parameters:</b></dt><dd>
 
5041
  <table border="0" cellspacing="2" cellpadding="0">
 
5042
    <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>
 
5043
  </table>
 
5044
</dl>
 
5045
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if successful. If an error has occurred, this function will return <code>false</code> and set <em>error</em> appropriately if present. </dd></dl>
 
5046
 
 
5047
</div>
 
5048
</div><p>
 
5049
<a class="anchor" name="40c88a403f5d01d722b5900545b6a4fe"></a><!-- doxytag: member="Gio::File::mount_mountable" ref="40c88a403f5d01d722b5900545b6a4fe" args="(const Glib::RefPtr&lt; MountOperation &gt; &amp;mount_operation, const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, MountMountFlags flags=MOUNT_MOUNT_NONE)" -->
 
5050
<div class="memitem">
 
5051
<div class="memproto">
 
5052
      <table class="memname">
 
5053
        <tr>
 
5054
          <td class="memname">void Gio::File::mount_mountable           </td>
 
5055
          <td>(</td>
 
5056
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1MountOperation.html">MountOperation</a>&gt;&amp;&nbsp;</td>
 
5057
          <td class="paramname"> <em>mount_operation</em>, </td>
 
5058
        </tr>
 
5059
        <tr>
 
5060
          <td class="paramkey"></td>
 
5061
          <td></td>
 
5062
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
5063
          <td class="paramname"> <em>slot</em>, </td>
 
5064
        </tr>
 
5065
        <tr>
 
5066
          <td class="paramkey"></td>
 
5067
          <td></td>
 
5068
          <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>
 
5069
          <td class="paramname"> <em>cancellable</em>, </td>
 
5070
        </tr>
 
5071
        <tr>
 
5072
          <td class="paramkey"></td>
 
5073
          <td></td>
 
5074
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g5484bace25c932fd4c7354259e138814">MountMountFlags</a>&nbsp;</td>
 
5075
          <td class="paramname"> <em>flags</em> = <code>MOUNT_MOUNT_NONE</code></td><td>&nbsp;</td>
 
5076
        </tr>
 
5077
        <tr>
 
5078
          <td></td>
 
5079
          <td>)</td>
 
5080
          <td></td><td></td><td></td>
 
5081
        </tr>
 
5082
      </table>
 
5083
</div>
 
5084
<div class="memdoc">
 
5085
 
 
5086
<p>
 
5087
Mounts a file of type FILE_TYPE_MOUNTABLE. 
 
5088
<p>
 
5089
Using <em>mount_operation</em>, you can request callbacks when, for instance, passwords are needed during authentication.<p>
 
5090
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>
 
5091
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#e15d36a7969c55122b9f85a1690a46e8" title="Finishes a mount operation.">mount_mountable_finish()</a> to get the result of the operation.<p>
 
5092
<dl compact><dt><b>Parameters:</b></dt><dd>
 
5093
  <table border="0" cellspacing="2" cellpadding="0">
 
5094
    <tr><td valign="top"></td><td valign="top"><em>mount_operation</em>&nbsp;</td><td>A <a class="el" href="classGio_1_1MountOperation.html" title="Authentication methods for mountable locations.">MountOperation</a>. </td></tr>
 
5095
    <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>
 
5096
    <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>
 
5097
  </table>
 
5098
</dl>
 
5099
 
 
5100
</div>
 
5101
</div><p>
 
5102
<a class="anchor" name="c3c29682ef5a50de73dc2c3c3333301c"></a><!-- doxytag: member="Gio::File::mount_mountable" ref="c3c29682ef5a50de73dc2c3c3333301c" args="(const Glib::RefPtr&lt; MountOperation &gt; &amp;mount_operation, const SlotAsyncReady &amp;slot, MountMountFlags flags=MOUNT_MOUNT_NONE)" -->
 
5103
<div class="memitem">
 
5104
<div class="memproto">
 
5105
      <table class="memname">
 
5106
        <tr>
 
5107
          <td class="memname">void Gio::File::mount_mountable           </td>
 
5108
          <td>(</td>
 
5109
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1MountOperation.html">MountOperation</a>&gt;&amp;&nbsp;</td>
 
5110
          <td class="paramname"> <em>mount_operation</em>, </td>
 
5111
        </tr>
 
5112
        <tr>
 
5113
          <td class="paramkey"></td>
 
5114
          <td></td>
 
5115
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
5116
          <td class="paramname"> <em>slot</em>, </td>
 
5117
        </tr>
 
5118
        <tr>
 
5119
          <td class="paramkey"></td>
 
5120
          <td></td>
 
5121
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g5484bace25c932fd4c7354259e138814">MountMountFlags</a>&nbsp;</td>
 
5122
          <td class="paramname"> <em>flags</em> = <code>MOUNT_MOUNT_NONE</code></td><td>&nbsp;</td>
 
5123
        </tr>
 
5124
        <tr>
 
5125
          <td></td>
 
5126
          <td>)</td>
 
5127
          <td></td><td></td><td></td>
 
5128
        </tr>
 
5129
      </table>
 
5130
</div>
 
5131
<div class="memdoc">
 
5132
 
 
5133
<p>
 
5134
Mounts a file of type FILE_TYPE_MOUNTABLE. 
 
5135
<p>
 
5136
Using <em>mount_operation</em>, you can request callbacks when, for instance, passwords are needed during authentication.<p>
 
5137
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#e15d36a7969c55122b9f85a1690a46e8" title="Finishes a mount operation.">mount_mountable_finish()</a> to get the result of the operation.<p>
 
5138
<dl compact><dt><b>Parameters:</b></dt><dd>
 
5139
  <table border="0" cellspacing="2" cellpadding="0">
 
5140
    <tr><td valign="top"></td><td valign="top"><em>mount_operation</em>&nbsp;</td><td>A <a class="el" href="classGio_1_1MountOperation.html" title="Authentication methods for mountable locations.">MountOperation</a>. </td></tr>
 
5141
    <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>
 
5142
  </table>
 
5143
</dl>
 
5144
 
 
5145
</div>
 
5146
</div><p>
 
5147
<a class="anchor" name="049e06c3d95b49ad4bff1837ef6d8677"></a><!-- doxytag: member="Gio::File::mount_mountable" ref="049e06c3d95b49ad4bff1837ef6d8677" args="(const SlotAsyncReady &amp;slot, MountMountFlags flags=MOUNT_MOUNT_NONE)" -->
 
5148
<div class="memitem">
 
5149
<div class="memproto">
 
5150
      <table class="memname">
 
5151
        <tr>
 
5152
          <td class="memname">void Gio::File::mount_mountable           </td>
 
5153
          <td>(</td>
 
5154
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
5155
          <td class="paramname"> <em>slot</em>, </td>
 
5156
        </tr>
 
5157
        <tr>
 
5158
          <td class="paramkey"></td>
 
5159
          <td></td>
 
5160
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g5484bace25c932fd4c7354259e138814">MountMountFlags</a>&nbsp;</td>
 
5161
          <td class="paramname"> <em>flags</em> = <code>MOUNT_MOUNT_NONE</code></td><td>&nbsp;</td>
 
5162
        </tr>
 
5163
        <tr>
 
5164
          <td></td>
 
5165
          <td>)</td>
 
5166
          <td></td><td></td><td></td>
 
5167
        </tr>
 
5168
      </table>
 
5169
</div>
 
5170
<div class="memdoc">
 
5171
 
 
5172
<p>
 
5173
Mounts a file of type FILE_TYPE_MOUNTABLE without user interaction. 
 
5174
<p>
 
5175
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#e15d36a7969c55122b9f85a1690a46e8" title="Finishes a mount operation.">mount_mountable_finish()</a> to get the result of the operation.<p>
 
5176
<dl compact><dt><b>Parameters:</b></dt><dd>
 
5177
  <table border="0" cellspacing="2" cellpadding="0">
 
5178
    <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>
 
5179
  </table>
 
5180
</dl>
 
5181
 
 
5182
</div>
 
5183
</div><p>
 
5184
<a class="anchor" name="8501fa88f4aaa8d52c001596960a4572"></a><!-- doxytag: member="Gio::File::mount_mountable" ref="8501fa88f4aaa8d52c001596960a4572" args="(MountMountFlags flags=MOUNT_MOUNT_NONE)" -->
 
5185
<div class="memitem">
 
5186
<div class="memproto">
 
5187
      <table class="memname">
 
5188
        <tr>
 
5189
          <td class="memname">void Gio::File::mount_mountable           </td>
 
5190
          <td>(</td>
 
5191
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g5484bace25c932fd4c7354259e138814">MountMountFlags</a>&nbsp;</td>
 
5192
          <td class="paramname"> <em>flags</em> = <code>MOUNT_MOUNT_NONE</code>          </td>
 
5193
          <td>&nbsp;)&nbsp;</td>
 
5194
          <td></td>
 
5195
        </tr>
 
5196
      </table>
 
5197
</div>
 
5198
<div class="memdoc">
 
5199
 
 
5200
<p>
 
5201
Mounts a file of type FILE_TYPE_MOUNTABLE without user interaction. 
 
5202
<p>
 
5203
 
 
5204
</div>
 
5205
</div><p>
 
5206
<a class="anchor" name="e15d36a7969c55122b9f85a1690a46e8"></a><!-- doxytag: member="Gio::File::mount_mountable_finish" ref="e15d36a7969c55122b9f85a1690a46e8" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
 
5207
<div class="memitem">
 
5208
<div class="memproto">
 
5209
      <table class="memname">
 
5210
        <tr>
 
5211
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt; Gio::File::mount_mountable_finish           </td>
 
5212
          <td>(</td>
 
5213
          <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>
 
5214
          <td class="paramname"> <em>result</em>          </td>
 
5215
          <td>&nbsp;)&nbsp;</td>
 
5216
          <td></td>
 
5217
        </tr>
 
5218
      </table>
 
5219
</div>
 
5220
<div class="memdoc">
 
5221
 
 
5222
<p>
 
5223
Finishes a mount operation. 
 
5224
<p>
 
5225
See g_file_mount_mountable() for details.<p>
 
5226
Finish an asynchronous mount operation that was started with g_file_mount_mountable(). <dl compact><dt><b>Parameters:</b></dt><dd>
 
5227
  <table border="0" cellspacing="2" cellpadding="0">
 
5228
    <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>
 
5229
  </table>
 
5230
</dl>
 
5231
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> or <code>0</code> on error. Free the returned object with Glib::object_unref(). </dd></dl>
 
5232
 
 
5233
</div>
 
5234
</div><p>
 
5235
<a class="anchor" name="5b687c8f19411e955bb069c469be92b4"></a><!-- doxytag: member="Gio::File::unmount_mountable" ref="5b687c8f19411e955bb069c469be92b4" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, MountUnmountFlags flags=MOUNT_UNMOUNT_NONE)" -->
 
5236
<div class="memitem">
 
5237
<div class="memproto">
 
5238
      <table class="memname">
 
5239
        <tr>
 
5240
          <td class="memname">void Gio::File::unmount_mountable           </td>
 
5241
          <td>(</td>
 
5242
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
5243
          <td class="paramname"> <em>slot</em>, </td>
 
5244
        </tr>
 
5245
        <tr>
 
5246
          <td class="paramkey"></td>
 
5247
          <td></td>
 
5248
          <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>
 
5249
          <td class="paramname"> <em>cancellable</em>, </td>
 
5250
        </tr>
 
5251
        <tr>
 
5252
          <td class="paramkey"></td>
 
5253
          <td></td>
 
5254
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g9fa1b6a8eabf8f88e4cf6d611a4cff44">MountUnmountFlags</a>&nbsp;</td>
 
5255
          <td class="paramname"> <em>flags</em> = <code>MOUNT_UNMOUNT_NONE</code></td><td>&nbsp;</td>
 
5256
        </tr>
 
5257
        <tr>
 
5258
          <td></td>
 
5259
          <td>)</td>
 
5260
          <td></td><td></td><td></td>
 
5261
        </tr>
 
5262
      </table>
 
5263
</div>
 
5264
<div class="memdoc">
 
5265
 
 
5266
<p>
 
5267
Unmounts a file of type FILE_TYPE_MOUNTABLE. 
 
5268
<p>
 
5269
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>
 
5270
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#51458cf04ad25e4a784a3ebcb906155d" title="Finishes an unmount operation, see g_file_unmount_mountable() for details.">unmount_mountable_finish()</a> to get the result of the operation.<p>
 
5271
<dl compact><dt><b>Parameters:</b></dt><dd>
 
5272
  <table border="0" cellspacing="2" cellpadding="0">
 
5273
    <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>
 
5274
    <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>
 
5275
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>Flags affecting the operation. </td></tr>
 
5276
  </table>
 
5277
</dl>
 
5278
 
 
5279
</div>
 
5280
</div><p>
 
5281
<a class="anchor" name="b6c8e9ef0e5d83a271c8307b18e779d8"></a><!-- doxytag: member="Gio::File::unmount_mountable" ref="b6c8e9ef0e5d83a271c8307b18e779d8" args="(const SlotAsyncReady &amp;slot, MountUnmountFlags flags=MOUNT_UNMOUNT_NONE)" -->
 
5282
<div class="memitem">
 
5283
<div class="memproto">
 
5284
      <table class="memname">
 
5285
        <tr>
 
5286
          <td class="memname">void Gio::File::unmount_mountable           </td>
 
5287
          <td>(</td>
 
5288
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
5289
          <td class="paramname"> <em>slot</em>, </td>
 
5290
        </tr>
 
5291
        <tr>
 
5292
          <td class="paramkey"></td>
 
5293
          <td></td>
 
5294
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g9fa1b6a8eabf8f88e4cf6d611a4cff44">MountUnmountFlags</a>&nbsp;</td>
 
5295
          <td class="paramname"> <em>flags</em> = <code>MOUNT_UNMOUNT_NONE</code></td><td>&nbsp;</td>
 
5296
        </tr>
 
5297
        <tr>
 
5298
          <td></td>
 
5299
          <td>)</td>
 
5300
          <td></td><td></td><td></td>
 
5301
        </tr>
 
5302
      </table>
 
5303
</div>
 
5304
<div class="memdoc">
 
5305
 
 
5306
<p>
 
5307
Unmounts a file of type FILE_TYPE_MOUNTABLE. 
 
5308
<p>
 
5309
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#51458cf04ad25e4a784a3ebcb906155d" title="Finishes an unmount operation, see g_file_unmount_mountable() for details.">unmount_mountable_finish()</a> to get the result of the operation.<p>
 
5310
<dl compact><dt><b>Parameters:</b></dt><dd>
 
5311
  <table border="0" cellspacing="2" cellpadding="0">
 
5312
    <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>
 
5313
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>Flags affecting the operation. </td></tr>
 
5314
  </table>
 
5315
</dl>
6684
5316
 
6685
5317
</div>
6686
5318
</div><p>
6711
5343
 
6712
5344
</div>
6713
5345
</div><p>
6714
 
<a class="anchor" name="b6c8e9ef0e5d83a271c8307b18e779d8"></a><!-- doxytag: member="Gio::File::unmount_mountable" ref="b6c8e9ef0e5d83a271c8307b18e779d8" args="(const SlotAsyncReady &amp;slot, MountUnmountFlags flags=MOUNT_UNMOUNT_NONE)" -->
6715
 
<div class="memitem">
6716
 
<div class="memproto">
6717
 
      <table class="memname">
6718
 
        <tr>
6719
 
          <td class="memname">void Gio::File::unmount_mountable           </td>
6720
 
          <td>(</td>
6721
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
6722
 
          <td class="paramname"> <em>slot</em>, </td>
6723
 
        </tr>
6724
 
        <tr>
6725
 
          <td class="paramkey"></td>
6726
 
          <td></td>
6727
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g9fa1b6a8eabf8f88e4cf6d611a4cff44">MountUnmountFlags</a>&nbsp;</td>
6728
 
          <td class="paramname"> <em>flags</em> = <code>MOUNT_UNMOUNT_NONE</code></td><td>&nbsp;</td>
6729
 
        </tr>
6730
 
        <tr>
6731
 
          <td></td>
6732
 
          <td>)</td>
6733
 
          <td></td><td></td><td></td>
6734
 
        </tr>
6735
 
      </table>
6736
 
</div>
6737
 
<div class="memdoc">
6738
 
 
6739
 
<p>
6740
 
Unmounts a file of type FILE_TYPE_MOUNTABLE. 
6741
 
<p>
6742
 
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#51458cf04ad25e4a784a3ebcb906155d" title="Finishes an unmount operation, see g_file_unmount_mountable() for details.">unmount_mountable_finish()</a> to get the result of the operation.<p>
6743
 
<dl compact><dt><b>Parameters:</b></dt><dd>
6744
 
  <table border="0" cellspacing="2" cellpadding="0">
6745
 
    <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>
6746
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>Flags affecting the operation. </td></tr>
6747
 
  </table>
6748
 
</dl>
6749
 
 
6750
 
</div>
6751
 
</div><p>
6752
 
<a class="anchor" name="5b687c8f19411e955bb069c469be92b4"></a><!-- doxytag: member="Gio::File::unmount_mountable" ref="5b687c8f19411e955bb069c469be92b4" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, MountUnmountFlags flags=MOUNT_UNMOUNT_NONE)" -->
6753
 
<div class="memitem">
6754
 
<div class="memproto">
6755
 
      <table class="memname">
6756
 
        <tr>
6757
 
          <td class="memname">void Gio::File::unmount_mountable           </td>
6758
 
          <td>(</td>
6759
 
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
6760
 
          <td class="paramname"> <em>slot</em>, </td>
6761
 
        </tr>
6762
 
        <tr>
6763
 
          <td class="paramkey"></td>
6764
 
          <td></td>
6765
 
          <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>
6766
 
          <td class="paramname"> <em>cancellable</em>, </td>
6767
 
        </tr>
6768
 
        <tr>
6769
 
          <td class="paramkey"></td>
6770
 
          <td></td>
6771
 
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g9fa1b6a8eabf8f88e4cf6d611a4cff44">MountUnmountFlags</a>&nbsp;</td>
6772
 
          <td class="paramname"> <em>flags</em> = <code>MOUNT_UNMOUNT_NONE</code></td><td>&nbsp;</td>
6773
 
        </tr>
6774
 
        <tr>
6775
 
          <td></td>
6776
 
          <td>)</td>
6777
 
          <td></td><td></td><td></td>
6778
 
        </tr>
6779
 
      </table>
6780
 
</div>
6781
 
<div class="memdoc">
6782
 
 
6783
 
<p>
6784
 
Unmounts a file of type FILE_TYPE_MOUNTABLE. 
6785
 
<p>
6786
 
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>
6787
 
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#51458cf04ad25e4a784a3ebcb906155d" title="Finishes an unmount operation, see g_file_unmount_mountable() for details.">unmount_mountable_finish()</a> to get the result of the operation.<p>
6788
 
<dl compact><dt><b>Parameters:</b></dt><dd>
6789
 
  <table border="0" cellspacing="2" cellpadding="0">
6790
 
    <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>
6791
 
    <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>
6792
 
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>Flags affecting the operation. </td></tr>
6793
 
  </table>
6794
 
</dl>
6795
 
 
6796
 
</div>
6797
 
</div><p>
6798
5346
<a class="anchor" name="51458cf04ad25e4a784a3ebcb906155d"></a><!-- doxytag: member="Gio::File::unmount_mountable_finish" ref="51458cf04ad25e4a784a3ebcb906155d" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
6799
5347
<div class="memitem">
6800
5348
<div class="memproto">
6823
5371
 
6824
5372
</div>
6825
5373
</div><p>
 
5374
<a class="anchor" name="8a8223e3b661f03c7a60ac0f003b916e"></a><!-- doxytag: member="Gio::File::eject_mountable" ref="8a8223e3b661f03c7a60ac0f003b916e" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, MountUnmountFlags flags=MOUNT_UNMOUNT_NONE)" -->
 
5375
<div class="memitem">
 
5376
<div class="memproto">
 
5377
      <table class="memname">
 
5378
        <tr>
 
5379
          <td class="memname">void Gio::File::eject_mountable           </td>
 
5380
          <td>(</td>
 
5381
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
5382
          <td class="paramname"> <em>slot</em>, </td>
 
5383
        </tr>
 
5384
        <tr>
 
5385
          <td class="paramkey"></td>
 
5386
          <td></td>
 
5387
          <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>
 
5388
          <td class="paramname"> <em>cancellable</em>, </td>
 
5389
        </tr>
 
5390
        <tr>
 
5391
          <td class="paramkey"></td>
 
5392
          <td></td>
 
5393
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g9fa1b6a8eabf8f88e4cf6d611a4cff44">MountUnmountFlags</a>&nbsp;</td>
 
5394
          <td class="paramname"> <em>flags</em> = <code>MOUNT_UNMOUNT_NONE</code></td><td>&nbsp;</td>
 
5395
        </tr>
 
5396
        <tr>
 
5397
          <td></td>
 
5398
          <td>)</td>
 
5399
          <td></td><td></td><td></td>
 
5400
        </tr>
 
5401
      </table>
 
5402
</div>
 
5403
<div class="memdoc">
 
5404
 
 
5405
<p>
 
5406
Starts an asynchronous eject on a mountable. 
 
5407
<p>
 
5408
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>
 
5409
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#6a5124de7c55e9dc5e85ffcb9d3dd14f" title="Finishes an asynchronous eject operation started by g_file_eject_mountable().">eject_mountable_finish()</a> to get the result of the operation.<p>
 
5410
<dl compact><dt><b>Parameters:</b></dt><dd>
 
5411
  <table border="0" cellspacing="2" cellpadding="0">
 
5412
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>Flags affecting the operation. </td></tr>
 
5413
    <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>
 
5414
    <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>
 
5415
  </table>
 
5416
</dl>
 
5417
 
 
5418
</div>
 
5419
</div><p>
 
5420
<a class="anchor" name="d8422a939a634d2248ef6d8658f0fdad"></a><!-- doxytag: member="Gio::File::eject_mountable" ref="d8422a939a634d2248ef6d8658f0fdad" args="(const SlotAsyncReady &amp;slot, MountUnmountFlags flags=MOUNT_UNMOUNT_NONE)" -->
 
5421
<div class="memitem">
 
5422
<div class="memproto">
 
5423
      <table class="memname">
 
5424
        <tr>
 
5425
          <td class="memname">void Gio::File::eject_mountable           </td>
 
5426
          <td>(</td>
 
5427
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
5428
          <td class="paramname"> <em>slot</em>, </td>
 
5429
        </tr>
 
5430
        <tr>
 
5431
          <td class="paramkey"></td>
 
5432
          <td></td>
 
5433
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g9fa1b6a8eabf8f88e4cf6d611a4cff44">MountUnmountFlags</a>&nbsp;</td>
 
5434
          <td class="paramname"> <em>flags</em> = <code>MOUNT_UNMOUNT_NONE</code></td><td>&nbsp;</td>
 
5435
        </tr>
 
5436
        <tr>
 
5437
          <td></td>
 
5438
          <td>)</td>
 
5439
          <td></td><td></td><td></td>
 
5440
        </tr>
 
5441
      </table>
 
5442
</div>
 
5443
<div class="memdoc">
 
5444
 
 
5445
<p>
 
5446
Starts an asynchronous eject on a mountable. 
 
5447
<p>
 
5448
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#6a5124de7c55e9dc5e85ffcb9d3dd14f" title="Finishes an asynchronous eject operation started by g_file_eject_mountable().">eject_mountable_finish()</a> to get the result of the operation.<p>
 
5449
<dl compact><dt><b>Parameters:</b></dt><dd>
 
5450
  <table border="0" cellspacing="2" cellpadding="0">
 
5451
    <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>
 
5452
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>Flags affecting the operation. </td></tr>
 
5453
  </table>
 
5454
</dl>
 
5455
 
 
5456
</div>
 
5457
</div><p>
 
5458
<a class="anchor" name="eb28fd505cab23a82c68ff00445b12e7"></a><!-- doxytag: member="Gio::File::eject_mountable" ref="eb28fd505cab23a82c68ff00445b12e7" args="(MountUnmountFlags flags=MOUNT_UNMOUNT_NONE)" -->
 
5459
<div class="memitem">
 
5460
<div class="memproto">
 
5461
      <table class="memname">
 
5462
        <tr>
 
5463
          <td class="memname">void Gio::File::eject_mountable           </td>
 
5464
          <td>(</td>
 
5465
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g9fa1b6a8eabf8f88e4cf6d611a4cff44">MountUnmountFlags</a>&nbsp;</td>
 
5466
          <td class="paramname"> <em>flags</em> = <code>MOUNT_UNMOUNT_NONE</code>          </td>
 
5467
          <td>&nbsp;)&nbsp;</td>
 
5468
          <td></td>
 
5469
        </tr>
 
5470
      </table>
 
5471
</div>
 
5472
<div class="memdoc">
 
5473
 
 
5474
<p>
 
5475
Starts an asynchronous eject on a mountable. 
 
5476
<p>
 
5477
<dl compact><dt><b>Parameters:</b></dt><dd>
 
5478
  <table border="0" cellspacing="2" cellpadding="0">
 
5479
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>Flags affecting the operation. </td></tr>
 
5480
  </table>
 
5481
</dl>
 
5482
 
 
5483
</div>
 
5484
</div><p>
 
5485
<a class="anchor" name="6a5124de7c55e9dc5e85ffcb9d3dd14f"></a><!-- doxytag: member="Gio::File::eject_mountable_finish" ref="6a5124de7c55e9dc5e85ffcb9d3dd14f" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
 
5486
<div class="memitem">
 
5487
<div class="memproto">
 
5488
      <table class="memname">
 
5489
        <tr>
 
5490
          <td class="memname">bool Gio::File::eject_mountable_finish           </td>
 
5491
          <td>(</td>
 
5492
          <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>
 
5493
          <td class="paramname"> <em>result</em>          </td>
 
5494
          <td>&nbsp;)&nbsp;</td>
 
5495
          <td></td>
 
5496
        </tr>
 
5497
      </table>
 
5498
</div>
 
5499
<div class="memdoc">
 
5500
 
 
5501
<p>
 
5502
Finishes an asynchronous eject operation started by g_file_eject_mountable(). 
 
5503
<p>
 
5504
<dl compact><dt><b>Parameters:</b></dt><dd>
 
5505
  <table border="0" cellspacing="2" cellpadding="0">
 
5506
    <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>
 
5507
  </table>
 
5508
</dl>
 
5509
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the <em>file</em> was ejected successfully. <code>false</code> otherwise. </dd></dl>
 
5510
 
 
5511
</div>
 
5512
</div><p>
 
5513
<a class="anchor" name="90726dcf94248d2fddf2e4c8584b7bf0"></a><!-- doxytag: member="Gio::File::copy_attributes" ref="90726dcf94248d2fddf2e4c8584b7bf0" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileCopyFlags flags=FILE_COPY_NONE)" -->
 
5514
<div class="memitem">
 
5515
<div class="memproto">
 
5516
      <table class="memname">
 
5517
        <tr>
 
5518
          <td class="memname">bool Gio::File::copy_attributes           </td>
 
5519
          <td>(</td>
 
5520
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
 
5521
          <td class="paramname"> <em>destination</em>, </td>
 
5522
        </tr>
 
5523
        <tr>
 
5524
          <td class="paramkey"></td>
 
5525
          <td></td>
 
5526
          <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>
 
5527
          <td class="paramname"> <em>cancellable</em>, </td>
 
5528
        </tr>
 
5529
        <tr>
 
5530
          <td class="paramkey"></td>
 
5531
          <td></td>
 
5532
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
 
5533
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code></td><td>&nbsp;</td>
 
5534
        </tr>
 
5535
        <tr>
 
5536
          <td></td>
 
5537
          <td>)</td>
 
5538
          <td></td><td></td><td></td>
 
5539
        </tr>
 
5540
      </table>
 
5541
</div>
 
5542
<div class="memdoc">
 
5543
 
 
5544
<p>
 
5545
Copies the file attributes from <em>source</em> to <em>destination</em>. 
 
5546
<p>
 
5547
Normally only a subset of the file attributes are copied, those that are copies in a normal file copy operation (which for instance does not include e.g. mtime). However if FILE_COPY_ALL_METADATA is specified in <em>flags</em>, then all the metadata that is possible to copy is copied.<p>
 
5548
<dl compact><dt><b>Parameters:</b></dt><dd>
 
5549
  <table border="0" cellspacing="2" cellpadding="0">
 
5550
    <tr><td valign="top"></td><td valign="top"><em>destination</em>&nbsp;</td><td>A <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> to copy attributes to. </td></tr>
 
5551
    <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>
 
5552
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileMonitorFlags. </td></tr>
 
5553
  </table>
 
5554
</dl>
 
5555
<dl class="return" compact><dt><b>Returns:</b></dt><dd>true if the attributes were copied successfully, false otherwise. </dd></dl>
 
5556
 
 
5557
</div>
 
5558
</div><p>
 
5559
<a class="anchor" name="05c1101ede98028c9234486eb0434250"></a><!-- doxytag: member="Gio::File::copy_attributes" ref="05c1101ede98028c9234486eb0434250" args="(const Glib::RefPtr&lt; File &gt; &amp;destination, FileCopyFlags flags=FILE_COPY_NONE)" -->
 
5560
<div class="memitem">
 
5561
<div class="memproto">
 
5562
      <table class="memname">
 
5563
        <tr>
 
5564
          <td class="memname">bool Gio::File::copy_attributes           </td>
 
5565
          <td>(</td>
 
5566
          <td class="paramtype">const <a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1File.html">File</a>&gt;&amp;&nbsp;</td>
 
5567
          <td class="paramname"> <em>destination</em>, </td>
 
5568
        </tr>
 
5569
        <tr>
 
5570
          <td class="paramkey"></td>
 
5571
          <td></td>
 
5572
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g08edc09a45449b136b27493647d4ecbe">FileCopyFlags</a>&nbsp;</td>
 
5573
          <td class="paramname"> <em>flags</em> = <code>FILE_COPY_NONE</code></td><td>&nbsp;</td>
 
5574
        </tr>
 
5575
        <tr>
 
5576
          <td></td>
 
5577
          <td>)</td>
 
5578
          <td></td><td></td><td></td>
 
5579
        </tr>
 
5580
      </table>
 
5581
</div>
 
5582
<div class="memdoc">
 
5583
 
 
5584
<p>
 
5585
Copies the file attributes from <em>source</em> to <em>destination</em>. 
 
5586
<p>
 
5587
Normally only a subset of the file attributes are copied, those that are copies in a normal file copy operation (which for instance does not include e.g. mtime). However if FILE_COPY_ALL_METADATA is specified in <em>flags</em>, then all the metadata that is possible to copy is copied.<p>
 
5588
<dl compact><dt><b>Parameters:</b></dt><dd>
 
5589
  <table border="0" cellspacing="2" cellpadding="0">
 
5590
    <tr><td valign="top"></td><td valign="top"><em>destination</em>&nbsp;</td><td>A <a class="el" href="classGio_1_1File.html" title="File and directory handling.">File</a> to copy attributes to. </td></tr>
 
5591
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileMonitorFlags. </td></tr>
 
5592
  </table>
 
5593
</dl>
 
5594
<dl class="return" compact><dt><b>Returns:</b></dt><dd>true if the attributes were copied successfully, false otherwise. </dd></dl>
 
5595
 
 
5596
</div>
 
5597
</div><p>
 
5598
<a class="anchor" name="a0fa22ffba0ff50779e49ff9d12344e6"></a><!-- doxytag: member="Gio::File::monitor_directory" ref="a0fa22ffba0ff50779e49ff9d12344e6" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileMonitorFlags flags=FILE_MONITOR_NONE)" -->
 
5599
<div class="memitem">
 
5600
<div class="memproto">
 
5601
      <table class="memname">
 
5602
        <tr>
 
5603
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileMonitor.html">FileMonitor</a>&gt; Gio::File::monitor_directory           </td>
 
5604
          <td>(</td>
 
5605
          <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>
 
5606
          <td class="paramname"> <em>cancellable</em>, </td>
 
5607
        </tr>
 
5608
        <tr>
 
5609
          <td class="paramkey"></td>
 
5610
          <td></td>
 
5611
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g469f795e9a4dddb2421c0e5568be6649">FileMonitorFlags</a>&nbsp;</td>
 
5612
          <td class="paramname"> <em>flags</em> = <code>FILE_MONITOR_NONE</code></td><td>&nbsp;</td>
 
5613
        </tr>
 
5614
        <tr>
 
5615
          <td></td>
 
5616
          <td>)</td>
 
5617
          <td></td><td></td><td></td>
 
5618
        </tr>
 
5619
      </table>
 
5620
</div>
 
5621
<div class="memdoc">
 
5622
 
 
5623
<p>
 
5624
Obtains a directory monitor for the given file. 
 
5625
<p>
 
5626
This may fail if directory monitoring is not supported.<p>
 
5627
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>
 
5628
<dl compact><dt><b>Parameters:</b></dt><dd>
 
5629
  <table border="0" cellspacing="2" cellpadding="0">
 
5630
    <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>
 
5631
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileMonitorFlags. </td></tr>
 
5632
  </table>
 
5633
</dl>
 
5634
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileMonitor.html" title="Monitors a file or directory for changes.">FileMonitor</a> for the file. </dd></dl>
 
5635
 
 
5636
</div>
 
5637
</div><p>
 
5638
<a class="anchor" name="12d36689c1024ff9fc8819f619910a92"></a><!-- doxytag: member="Gio::File::monitor_directory" ref="12d36689c1024ff9fc8819f619910a92" args="(FileMonitorFlags flags=FILE_MONITOR_NONE)" -->
 
5639
<div class="memitem">
 
5640
<div class="memproto">
 
5641
      <table class="memname">
 
5642
        <tr>
 
5643
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileMonitor.html">FileMonitor</a>&gt; Gio::File::monitor_directory           </td>
 
5644
          <td>(</td>
 
5645
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g469f795e9a4dddb2421c0e5568be6649">FileMonitorFlags</a>&nbsp;</td>
 
5646
          <td class="paramname"> <em>flags</em> = <code>FILE_MONITOR_NONE</code>          </td>
 
5647
          <td>&nbsp;)&nbsp;</td>
 
5648
          <td></td>
 
5649
        </tr>
 
5650
      </table>
 
5651
</div>
 
5652
<div class="memdoc">
 
5653
 
 
5654
<p>
 
5655
Obtains a directory monitor for the given file. 
 
5656
<p>
 
5657
This may fail if directory monitoring is not supported.<p>
 
5658
<dl compact><dt><b>Parameters:</b></dt><dd>
 
5659
  <table border="0" cellspacing="2" cellpadding="0">
 
5660
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileMonitorFlags. </td></tr>
 
5661
  </table>
 
5662
</dl>
 
5663
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileMonitor.html" title="Monitors a file or directory for changes.">FileMonitor</a> for the file. </dd></dl>
 
5664
 
 
5665
</div>
 
5666
</div><p>
 
5667
<a class="anchor" name="b8e14809f330ddd58e628c96921cd987"></a><!-- doxytag: member="Gio::File::monitor_file" ref="b8e14809f330ddd58e628c96921cd987" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileMonitorFlags flags=FILE_MONITOR_NONE)" -->
 
5668
<div class="memitem">
 
5669
<div class="memproto">
 
5670
      <table class="memname">
 
5671
        <tr>
 
5672
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileMonitor.html">FileMonitor</a>&gt; Gio::File::monitor_file           </td>
 
5673
          <td>(</td>
 
5674
          <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>
 
5675
          <td class="paramname"> <em>cancellable</em>, </td>
 
5676
        </tr>
 
5677
        <tr>
 
5678
          <td class="paramkey"></td>
 
5679
          <td></td>
 
5680
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g469f795e9a4dddb2421c0e5568be6649">FileMonitorFlags</a>&nbsp;</td>
 
5681
          <td class="paramname"> <em>flags</em> = <code>FILE_MONITOR_NONE</code></td><td>&nbsp;</td>
 
5682
        </tr>
 
5683
        <tr>
 
5684
          <td></td>
 
5685
          <td>)</td>
 
5686
          <td></td><td></td><td></td>
 
5687
        </tr>
 
5688
      </table>
 
5689
</div>
 
5690
<div class="memdoc">
 
5691
 
 
5692
<p>
 
5693
Obtains a file monitor for the given file. 
 
5694
<p>
 
5695
If no file notification mechanism exists, then regular polling of the file is used.<p>
 
5696
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>
 
5697
<dl compact><dt><b>Parameters:</b></dt><dd>
 
5698
  <table border="0" cellspacing="2" cellpadding="0">
 
5699
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileMonitorFlags. </td></tr>
 
5700
    <tr><td valign="top"></td><td valign="top"><em>A</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
 
5701
  </table>
 
5702
</dl>
 
5703
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileMonitor.html" title="Monitors a file or directory for changes.">FileMonitor</a> for the file. </dd></dl>
 
5704
 
 
5705
</div>
 
5706
</div><p>
 
5707
<a class="anchor" name="a410183ed3b4a745093383d038d271b9"></a><!-- doxytag: member="Gio::File::monitor_file" ref="a410183ed3b4a745093383d038d271b9" args="(FileMonitorFlags flags=FILE_MONITOR_NONE)" -->
 
5708
<div class="memitem">
 
5709
<div class="memproto">
 
5710
      <table class="memname">
 
5711
        <tr>
 
5712
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileMonitor.html">FileMonitor</a>&gt; Gio::File::monitor_file           </td>
 
5713
          <td>(</td>
 
5714
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g469f795e9a4dddb2421c0e5568be6649">FileMonitorFlags</a>&nbsp;</td>
 
5715
          <td class="paramname"> <em>flags</em> = <code>FILE_MONITOR_NONE</code>          </td>
 
5716
          <td>&nbsp;)&nbsp;</td>
 
5717
          <td></td>
 
5718
        </tr>
 
5719
      </table>
 
5720
</div>
 
5721
<div class="memdoc">
 
5722
 
 
5723
<p>
 
5724
Obtains a file monitor for the given file. 
 
5725
<p>
 
5726
If no file notification mechanism exists, then regular polling of the file is used.<p>
 
5727
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>
 
5728
<dl compact><dt><b>Parameters:</b></dt><dd>
 
5729
  <table border="0" cellspacing="2" cellpadding="0">
 
5730
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileMonitorFlags. </td></tr>
 
5731
    <tr><td valign="top"></td><td valign="top"><em>A</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
 
5732
  </table>
 
5733
</dl>
 
5734
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileMonitor.html" title="Monitors a file or directory for changes.">FileMonitor</a> for the file. </dd></dl>
 
5735
 
 
5736
</div>
 
5737
</div><p>
 
5738
<a class="anchor" name="88aacee7bb6f6d968b4383311a9dd002"></a><!-- doxytag: member="Gio::File::monitor" ref="88aacee7bb6f6d968b4383311a9dd002" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, FileMonitorFlags flags=FILE_MONITOR_NONE)" -->
 
5739
<div class="memitem">
 
5740
<div class="memproto">
 
5741
      <table class="memname">
 
5742
        <tr>
 
5743
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileMonitor.html">FileMonitor</a>&gt; Gio::File::monitor           </td>
 
5744
          <td>(</td>
 
5745
          <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>
 
5746
          <td class="paramname"> <em>cancellable</em>, </td>
 
5747
        </tr>
 
5748
        <tr>
 
5749
          <td class="paramkey"></td>
 
5750
          <td></td>
 
5751
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g469f795e9a4dddb2421c0e5568be6649">FileMonitorFlags</a>&nbsp;</td>
 
5752
          <td class="paramname"> <em>flags</em> = <code>FILE_MONITOR_NONE</code></td><td>&nbsp;</td>
 
5753
        </tr>
 
5754
        <tr>
 
5755
          <td></td>
 
5756
          <td>)</td>
 
5757
          <td></td><td></td><td></td>
 
5758
        </tr>
 
5759
      </table>
 
5760
</div>
 
5761
<div class="memdoc">
 
5762
 
 
5763
<p>
 
5764
Obtains a file monitor for the given file. 
 
5765
<p>
 
5766
If no file notification mechanism exists, then regular polling of the file is used.<p>
 
5767
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>
 
5768
<dl compact><dt><b>Parameters:</b></dt><dd>
 
5769
  <table border="0" cellspacing="2" cellpadding="0">
 
5770
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileMonitorFlags. </td></tr>
 
5771
    <tr><td valign="top"></td><td valign="top"><em>A</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
 
5772
  </table>
 
5773
</dl>
 
5774
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileMonitor.html" title="Monitors a file or directory for changes.">FileMonitor</a> for the file.</dd></dl>
 
5775
<dl compact><dt><b><a class="el" href="newin2p18s.html#_newin2p18s000019">Since glibmm 2.18:</a></b></dt><dd></dd></dl>
 
5776
 
 
5777
</div>
 
5778
</div><p>
 
5779
<a class="anchor" name="50896969a9de87f810f0bf5e2d3335bd"></a><!-- doxytag: member="Gio::File::monitor" ref="50896969a9de87f810f0bf5e2d3335bd" args="(FileMonitorFlags flags=FILE_MONITOR_NONE)" -->
 
5780
<div class="memitem">
 
5781
<div class="memproto">
 
5782
      <table class="memname">
 
5783
        <tr>
 
5784
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1FileMonitor.html">FileMonitor</a>&gt; Gio::File::monitor           </td>
 
5785
          <td>(</td>
 
5786
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g469f795e9a4dddb2421c0e5568be6649">FileMonitorFlags</a>&nbsp;</td>
 
5787
          <td class="paramname"> <em>flags</em> = <code>FILE_MONITOR_NONE</code>          </td>
 
5788
          <td>&nbsp;)&nbsp;</td>
 
5789
          <td></td>
 
5790
        </tr>
 
5791
      </table>
 
5792
</div>
 
5793
<div class="memdoc">
 
5794
 
 
5795
<p>
 
5796
Obtains a file monitor for the given file. 
 
5797
<p>
 
5798
If no file notification mechanism exists, then regular polling of the file is used.<p>
 
5799
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>
 
5800
<dl compact><dt><b>Parameters:</b></dt><dd>
 
5801
  <table border="0" cellspacing="2" cellpadding="0">
 
5802
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileMonitorFlags. </td></tr>
 
5803
    <tr><td valign="top"></td><td valign="top"><em>A</em>&nbsp;</td><td><a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object. </td></tr>
 
5804
  </table>
 
5805
</dl>
 
5806
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1FileMonitor.html" title="Monitors a file or directory for changes.">FileMonitor</a> for the file.</dd></dl>
 
5807
<dl compact><dt><b><a class="el" href="newin2p18s.html#_newin2p18s000020">Since glibmm 2.18:</a></b></dt><dd></dd></dl>
 
5808
 
 
5809
</div>
 
5810
</div><p>
 
5811
<a class="anchor" name="753546465735b25633b003333b66d05c"></a><!-- doxytag: member="Gio::File::query_default_handler" ref="753546465735b25633b003333b66d05c" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
 
5812
<div class="memitem">
 
5813
<div class="memproto">
 
5814
      <table class="memname">
 
5815
        <tr>
 
5816
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1AppInfo.html">AppInfo</a>&gt; Gio::File::query_default_handler           </td>
 
5817
          <td>(</td>
 
5818
          <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>
 
5819
          <td class="paramname"> <em>cancellable</em>          </td>
 
5820
          <td>&nbsp;)&nbsp;</td>
 
5821
          <td></td>
 
5822
        </tr>
 
5823
      </table>
 
5824
</div>
 
5825
<div class="memdoc">
 
5826
 
 
5827
<p>
 
5828
Returns: a <a class="el" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch...">AppInfo</a> if the handle was found, <code>0</code> if there were errors. 
 
5829
<p>
 
5830
<dl compact><dt><b>Parameters:</b></dt><dd>
 
5831
  <table border="0" cellspacing="2" cellpadding="0">
 
5832
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td>Optional <a class="el" href="classGio_1_1Cancellable.html" title="Allows actions to be cancelled.">Cancellable</a> object, <code>0</code> to ignore. </td></tr>
 
5833
  </table>
 
5834
</dl>
 
5835
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch...">AppInfo</a> if the handle was found, <code>0</code> if there were errors. When you are done with it, release it with Glib::object_unref(). </dd></dl>
 
5836
 
 
5837
</div>
 
5838
</div><p>
 
5839
<a class="anchor" name="0c0fd0ece2570b6704889df5ee43c283"></a><!-- doxytag: member="Gio::File::query_default_handler" ref="0c0fd0ece2570b6704889df5ee43c283" args="()" -->
 
5840
<div class="memitem">
 
5841
<div class="memproto">
 
5842
      <table class="memname">
 
5843
        <tr>
 
5844
          <td class="memname"><a class="el" href="classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGio_1_1AppInfo.html">AppInfo</a>&gt; Gio::File::query_default_handler           </td>
 
5845
          <td>(</td>
 
5846
          <td class="paramname">          </td>
 
5847
          <td>&nbsp;)&nbsp;</td>
 
5848
          <td></td>
 
5849
        </tr>
 
5850
      </table>
 
5851
</div>
 
5852
<div class="memdoc">
 
5853
 
 
5854
<p>
 
5855
Returns the <a class="el" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch...">AppInfo</a> that is registered as the default application to handle the file specified by the file. 
 
5856
<p>
 
5857
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGio_1_1AppInfo.html" title="Application information, to describe applications installed on the system, and launch...">AppInfo</a> if the handle was found, or an empty RefPtr if there were errors. </dd></dl>
 
5858
 
 
5859
</div>
 
5860
</div><p>
 
5861
<a class="anchor" name="c53be228d732b34e062a2a57814cdf15"></a><!-- doxytag: member="Gio::File::load_contents" ref="c53be228d732b34e062a2a57814cdf15" args="(const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, char *&amp;contents, gsize &amp;length, std::string &amp;etag_out)" -->
 
5862
<div class="memitem">
 
5863
<div class="memproto">
 
5864
      <table class="memname">
 
5865
        <tr>
 
5866
          <td class="memname">bool Gio::File::load_contents           </td>
 
5867
          <td>(</td>
 
5868
          <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>
 
5869
          <td class="paramname"> <em>cancellable</em>, </td>
 
5870
        </tr>
 
5871
        <tr>
 
5872
          <td class="paramkey"></td>
 
5873
          <td></td>
 
5874
          <td class="paramtype">char *&amp;&nbsp;</td>
 
5875
          <td class="paramname"> <em>contents</em>, </td>
 
5876
        </tr>
 
5877
        <tr>
 
5878
          <td class="paramkey"></td>
 
5879
          <td></td>
 
5880
          <td class="paramtype">gsize &amp;&nbsp;</td>
 
5881
          <td class="paramname"> <em>length</em>, </td>
 
5882
        </tr>
 
5883
        <tr>
 
5884
          <td class="paramkey"></td>
 
5885
          <td></td>
 
5886
          <td class="paramtype"><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>
 
5887
          <td class="paramname"> <em>etag_out</em></td><td>&nbsp;</td>
 
5888
        </tr>
 
5889
        <tr>
 
5890
          <td></td>
 
5891
          <td>)</td>
 
5892
          <td></td><td></td><td></td>
 
5893
        </tr>
 
5894
      </table>
 
5895
</div>
 
5896
<div class="memdoc">
 
5897
 
 
5898
<p>
 
5899
Loads the content of the file into memory, returning the size of the data. 
 
5900
<p>
 
5901
The data is always zero terminated, but this is not included in the resultant <em>length</em>.<p>
 
5902
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> exception with CANCELLED will be returned.<p>
 
5903
<dl compact><dt><b>Parameters:</b></dt><dd>
 
5904
  <table border="0" cellspacing="2" cellpadding="0">
 
5905
    <tr><td valign="top"></td><td valign="top"><em>cancellable</em>&nbsp;</td><td>A cancellable object. </td></tr>
 
5906
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>A location to place the contents of the file. </td></tr>
 
5907
    <tr><td valign="top"></td><td valign="top"><em>length</em>&nbsp;</td><td>A location to place the length of the contents of the file. </td></tr>
 
5908
    <tr><td valign="top"></td><td valign="top"><em>etag_out</em>&nbsp;</td><td>A location to place the current entity tag for the file. </td></tr>
 
5909
  </table>
 
5910
</dl>
 
5911
 
 
5912
</div>
 
5913
</div><p>
 
5914
<a class="anchor" name="77f7781b0ba65bc4e7e613b80b353fd7"></a><!-- doxytag: member="Gio::File::load_contents" ref="77f7781b0ba65bc4e7e613b80b353fd7" args="(char *&amp;contents, gsize &amp;length, std::string &amp;etag_out)" -->
 
5915
<div class="memitem">
 
5916
<div class="memproto">
 
5917
      <table class="memname">
 
5918
        <tr>
 
5919
          <td class="memname">bool Gio::File::load_contents           </td>
 
5920
          <td>(</td>
 
5921
          <td class="paramtype">char *&amp;&nbsp;</td>
 
5922
          <td class="paramname"> <em>contents</em>, </td>
 
5923
        </tr>
 
5924
        <tr>
 
5925
          <td class="paramkey"></td>
 
5926
          <td></td>
 
5927
          <td class="paramtype">gsize &amp;&nbsp;</td>
 
5928
          <td class="paramname"> <em>length</em>, </td>
 
5929
        </tr>
 
5930
        <tr>
 
5931
          <td class="paramkey"></td>
 
5932
          <td></td>
 
5933
          <td class="paramtype"><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>
 
5934
          <td class="paramname"> <em>etag_out</em></td><td>&nbsp;</td>
 
5935
        </tr>
 
5936
        <tr>
 
5937
          <td></td>
 
5938
          <td>)</td>
 
5939
          <td></td><td></td><td></td>
 
5940
        </tr>
 
5941
      </table>
 
5942
</div>
 
5943
<div class="memdoc">
 
5944
 
 
5945
<p>
 
5946
Loads the content of the file into memory, returning the size of the data. 
 
5947
<p>
 
5948
The data is always zero terminated, but this is not included in the resultant <em>length</em>.<p>
 
5949
<dl compact><dt><b>Parameters:</b></dt><dd>
 
5950
  <table border="0" cellspacing="2" cellpadding="0">
 
5951
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>A location to place the contents of the file. </td></tr>
 
5952
    <tr><td valign="top"></td><td valign="top"><em>length</em>&nbsp;</td><td>A location to place the length of the contents of the file. </td></tr>
 
5953
    <tr><td valign="top"></td><td valign="top"><em>etag_out</em>&nbsp;</td><td>A location to place the current entity tag for the file. </td></tr>
 
5954
  </table>
 
5955
</dl>
 
5956
 
 
5957
</div>
 
5958
</div><p>
 
5959
<a class="anchor" name="d0e02ebffbaa13036e4636d2118f71a0"></a><!-- doxytag: member="Gio::File::load_contents_async" ref="d0e02ebffbaa13036e4636d2118f71a0" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
 
5960
<div class="memitem">
 
5961
<div class="memproto">
 
5962
      <table class="memname">
 
5963
        <tr>
 
5964
          <td class="memname">void Gio::File::load_contents_async           </td>
 
5965
          <td>(</td>
 
5966
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
5967
          <td class="paramname"> <em>slot</em>, </td>
 
5968
        </tr>
 
5969
        <tr>
 
5970
          <td class="paramkey"></td>
 
5971
          <td></td>
 
5972
          <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>
 
5973
          <td class="paramname"> <em>cancellable</em></td><td>&nbsp;</td>
 
5974
        </tr>
 
5975
        <tr>
 
5976
          <td></td>
 
5977
          <td>)</td>
 
5978
          <td></td><td></td><td></td>
 
5979
        </tr>
 
5980
      </table>
 
5981
</div>
 
5982
<div class="memdoc">
 
5983
 
 
5984
<p>
 
5985
Starts an asynchronous load of the file's contents. 
 
5986
<p>
 
5987
For more details, see <a class="el" href="classGio_1_1File.html#c53be228d732b34e062a2a57814cdf15" title="Loads the content of the file into memory, returning the size of the data.">load_contents()</a> which is the synchronous version of this call.<p>
 
5988
When the load operation has completed, the <em>slot</em> will be called. To finish the operation, call <a class="el" href="classGio_1_1File.html#5fd15277ab90bcc57db088be04cac457" title="Finishes an asynchronous load of the file&#39;s contents.">load_contents_finish()</a> with the <a class="el" href="classGio_1_1AsyncResult.html" title="Provides a base class for implementing asynchronous function results.">AsyncResult</a> provided to the <em>slot</em>.<p>
 
5989
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>
 
5990
<dl compact><dt><b>Parameters:</b></dt><dd>
 
5991
  <table border="0" cellspacing="2" cellpadding="0">
 
5992
    <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>
 
5993
    <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>
 
5994
  </table>
 
5995
</dl>
 
5996
 
 
5997
</div>
 
5998
</div><p>
 
5999
<a class="anchor" name="6af7ec98d5543bce07b917b65d7276ce"></a><!-- doxytag: member="Gio::File::load_contents_async" ref="6af7ec98d5543bce07b917b65d7276ce" args="(const SlotAsyncReady &amp;slot)" -->
 
6000
<div class="memitem">
 
6001
<div class="memproto">
 
6002
      <table class="memname">
 
6003
        <tr>
 
6004
          <td class="memname">void Gio::File::load_contents_async           </td>
 
6005
          <td>(</td>
 
6006
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
6007
          <td class="paramname"> <em>slot</em>          </td>
 
6008
          <td>&nbsp;)&nbsp;</td>
 
6009
          <td></td>
 
6010
        </tr>
 
6011
      </table>
 
6012
</div>
 
6013
<div class="memdoc">
 
6014
 
 
6015
<p>
 
6016
Starts an asynchronous load of the file's contents. 
 
6017
<p>
 
6018
For more details, see <a class="el" href="classGio_1_1File.html#c53be228d732b34e062a2a57814cdf15" title="Loads the content of the file into memory, returning the size of the data.">load_contents()</a> which is the synchronous version of this call.<p>
 
6019
When the load operation has completed, the <em>slot</em> will be called. To finish the operation, call <a class="el" href="classGio_1_1File.html#5fd15277ab90bcc57db088be04cac457" title="Finishes an asynchronous load of the file&#39;s contents.">load_contents_finish()</a> with the <a class="el" href="classGio_1_1AsyncResult.html" title="Provides a base class for implementing asynchronous function results.">AsyncResult</a> provided to the <em>slot</em>.<p>
 
6020
<dl compact><dt><b>Parameters:</b></dt><dd>
 
6021
  <table border="0" cellspacing="2" cellpadding="0">
 
6022
    <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>
 
6023
  </table>
 
6024
</dl>
 
6025
 
 
6026
</div>
 
6027
</div><p>
 
6028
<a class="anchor" name="5fd15277ab90bcc57db088be04cac457"></a><!-- doxytag: member="Gio::File::load_contents_finish" ref="5fd15277ab90bcc57db088be04cac457" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result, char *&amp;contents, gsize &amp;length, std::string &amp;etag_out)" -->
 
6029
<div class="memitem">
 
6030
<div class="memproto">
 
6031
      <table class="memname">
 
6032
        <tr>
 
6033
          <td class="memname">bool Gio::File::load_contents_finish           </td>
 
6034
          <td>(</td>
 
6035
          <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>
 
6036
          <td class="paramname"> <em>result</em>, </td>
 
6037
        </tr>
 
6038
        <tr>
 
6039
          <td class="paramkey"></td>
 
6040
          <td></td>
 
6041
          <td class="paramtype">char *&amp;&nbsp;</td>
 
6042
          <td class="paramname"> <em>contents</em>, </td>
 
6043
        </tr>
 
6044
        <tr>
 
6045
          <td class="paramkey"></td>
 
6046
          <td></td>
 
6047
          <td class="paramtype">gsize &amp;&nbsp;</td>
 
6048
          <td class="paramname"> <em>length</em>, </td>
 
6049
        </tr>
 
6050
        <tr>
 
6051
          <td class="paramkey"></td>
 
6052
          <td></td>
 
6053
          <td class="paramtype"><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>
 
6054
          <td class="paramname"> <em>etag_out</em></td><td>&nbsp;</td>
 
6055
        </tr>
 
6056
        <tr>
 
6057
          <td></td>
 
6058
          <td>)</td>
 
6059
          <td></td><td></td><td></td>
 
6060
        </tr>
 
6061
      </table>
 
6062
</div>
 
6063
<div class="memdoc">
 
6064
 
 
6065
<p>
 
6066
Finishes an asynchronous load of the <em>file's</em> contents. 
 
6067
<p>
 
6068
The contents are placed in <em>contents</em>, and <em>length</em> is set to the size of the <em>contents</em> string. If <em>etag_out</em> is present, it will be set to the new entity tag for the <em>file</em>. <dl compact><dt><b>Parameters:</b></dt><dd>
 
6069
  <table border="0" cellspacing="2" cellpadding="0">
 
6070
    <tr><td valign="top"></td><td valign="top"><em>res</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>
 
6071
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>A location to place the contents of the file. </td></tr>
 
6072
    <tr><td valign="top"></td><td valign="top"><em>length</em>&nbsp;</td><td>A location to place the length of the contents of the file. </td></tr>
 
6073
    <tr><td valign="top"></td><td valign="top"><em>etag_out</em>&nbsp;</td><td>A location to place the current entity tag for the file. </td></tr>
 
6074
  </table>
 
6075
</dl>
 
6076
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the load was successful. If <code>false</code> and <em>error</em> is present, it will be set appropriately. </dd></dl>
 
6077
 
 
6078
</div>
 
6079
</div><p>
 
6080
<a class="anchor" name="0e8d95fcdf7c2aa38f54e90a22d3ab6f"></a><!-- doxytag: member="Gio::File::load_partial_contents_async" ref="0e8d95fcdf7c2aa38f54e90a22d3ab6f" args="(const SlotReadMore &amp;slot_read_more, const SlotAsyncReady &amp;slot_async_ready, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable)" -->
 
6081
<div class="memitem">
 
6082
<div class="memproto">
 
6083
      <table class="memname">
 
6084
        <tr>
 
6085
          <td class="memname">void Gio::File::load_partial_contents_async           </td>
 
6086
          <td>(</td>
 
6087
          <td class="paramtype">const <a class="el" href="classGio_1_1File.html#dd182d22071784fc345adc757b3d687b">SlotReadMore</a>&amp;&nbsp;</td>
 
6088
          <td class="paramname"> <em>slot_read_more</em>, </td>
 
6089
        </tr>
 
6090
        <tr>
 
6091
          <td class="paramkey"></td>
 
6092
          <td></td>
 
6093
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
6094
          <td class="paramname"> <em>slot_async_ready</em>, </td>
 
6095
        </tr>
 
6096
        <tr>
 
6097
          <td class="paramkey"></td>
 
6098
          <td></td>
 
6099
          <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>
 
6100
          <td class="paramname"> <em>cancellable</em></td><td>&nbsp;</td>
 
6101
        </tr>
 
6102
        <tr>
 
6103
          <td></td>
 
6104
          <td>)</td>
 
6105
          <td></td><td></td><td></td>
 
6106
        </tr>
 
6107
      </table>
 
6108
</div>
 
6109
<div class="memdoc">
 
6110
 
 
6111
<p>
 
6112
Reads the partial contents of a file. 
 
6113
<p>
 
6114
The <em>slot_read_more</em> callback slot should be used to stop reading from the file when appropriate. This operation can be finished by <a class="el" href="classGio_1_1File.html#4b323508401d2e6fd2b3ad659f9bb5eb" title="Finishes an asynchronous partial load operation that was started with load_partial_contents_async()...">load_partial_contents_finish()</a>.<p>
 
6115
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>
 
6116
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#4b323508401d2e6fd2b3ad659f9bb5eb" title="Finishes an asynchronous partial load operation that was started with load_partial_contents_async()...">load_partial_contents_finish()</a> to get the result of the operation.<p>
 
6117
<dl compact><dt><b>Parameters:</b></dt><dd>
 
6118
  <table border="0" cellspacing="2" cellpadding="0">
 
6119
    <tr><td valign="top"></td><td valign="top"><em>slot_read_more</em>&nbsp;</td><td>A callback to receive partial data and to specify whether further data should be read. </td></tr>
 
6120
    <tr><td valign="top"></td><td valign="top"><em>slot_async_ready</em>&nbsp;</td><td>A callback slot which will be called when the request is satisfied. </td></tr>
 
6121
    <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>
 
6122
  </table>
 
6123
</dl>
 
6124
 
 
6125
</div>
 
6126
</div><p>
 
6127
<a class="anchor" name="362d71932c0ba8797a8c47b77df1b6d7"></a><!-- doxytag: member="Gio::File::load_partial_contents_async" ref="362d71932c0ba8797a8c47b77df1b6d7" args="(const SlotReadMore &amp;slot_read_more, const SlotAsyncReady &amp;slot_async_ready)" -->
 
6128
<div class="memitem">
 
6129
<div class="memproto">
 
6130
      <table class="memname">
 
6131
        <tr>
 
6132
          <td class="memname">void Gio::File::load_partial_contents_async           </td>
 
6133
          <td>(</td>
 
6134
          <td class="paramtype">const <a class="el" href="classGio_1_1File.html#dd182d22071784fc345adc757b3d687b">SlotReadMore</a>&amp;&nbsp;</td>
 
6135
          <td class="paramname"> <em>slot_read_more</em>, </td>
 
6136
        </tr>
 
6137
        <tr>
 
6138
          <td class="paramkey"></td>
 
6139
          <td></td>
 
6140
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
6141
          <td class="paramname"> <em>slot_async_ready</em></td><td>&nbsp;</td>
 
6142
        </tr>
 
6143
        <tr>
 
6144
          <td></td>
 
6145
          <td>)</td>
 
6146
          <td></td><td></td><td></td>
 
6147
        </tr>
 
6148
      </table>
 
6149
</div>
 
6150
<div class="memdoc">
 
6151
 
 
6152
<p>
 
6153
Reads the partial contents of a file. 
 
6154
<p>
 
6155
The <em>slot_read_more</em> callback slot should be used to stop reading from the file when appropriate. This operation can be finished by <a class="el" href="classGio_1_1File.html#4b323508401d2e6fd2b3ad659f9bb5eb" title="Finishes an asynchronous partial load operation that was started with load_partial_contents_async()...">load_partial_contents_finish()</a>.<p>
 
6156
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>
 
6157
When the operation is finished, <em>slot</em> will be called. You can then call <a class="el" href="classGio_1_1File.html#4b323508401d2e6fd2b3ad659f9bb5eb" title="Finishes an asynchronous partial load operation that was started with load_partial_contents_async()...">load_partial_contents_finish()</a> to get the result of the operation.<p>
 
6158
<dl compact><dt><b>Parameters:</b></dt><dd>
 
6159
  <table border="0" cellspacing="2" cellpadding="0">
 
6160
    <tr><td valign="top"></td><td valign="top"><em>slot_read_more</em>&nbsp;</td><td>A callback to receive partial data and to specify whether further data should be read. </td></tr>
 
6161
    <tr><td valign="top"></td><td valign="top"><em>slot_async_ready</em>&nbsp;</td><td>A callback slot which will be called when the request is satisfied. </td></tr>
 
6162
  </table>
 
6163
</dl>
 
6164
 
 
6165
</div>
 
6166
</div><p>
 
6167
<a class="anchor" name="4b323508401d2e6fd2b3ad659f9bb5eb"></a><!-- doxytag: member="Gio::File::load_partial_contents_finish" ref="4b323508401d2e6fd2b3ad659f9bb5eb" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result, char *&amp;contents, gsize &amp;length, std::string &amp;etag_out)" -->
 
6168
<div class="memitem">
 
6169
<div class="memproto">
 
6170
      <table class="memname">
 
6171
        <tr>
 
6172
          <td class="memname">bool Gio::File::load_partial_contents_finish           </td>
 
6173
          <td>(</td>
 
6174
          <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>
 
6175
          <td class="paramname"> <em>result</em>, </td>
 
6176
        </tr>
 
6177
        <tr>
 
6178
          <td class="paramkey"></td>
 
6179
          <td></td>
 
6180
          <td class="paramtype">char *&amp;&nbsp;</td>
 
6181
          <td class="paramname"> <em>contents</em>, </td>
 
6182
        </tr>
 
6183
        <tr>
 
6184
          <td class="paramkey"></td>
 
6185
          <td></td>
 
6186
          <td class="paramtype">gsize &amp;&nbsp;</td>
 
6187
          <td class="paramname"> <em>length</em>, </td>
 
6188
        </tr>
 
6189
        <tr>
 
6190
          <td class="paramkey"></td>
 
6191
          <td></td>
 
6192
          <td class="paramtype"><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>
 
6193
          <td class="paramname"> <em>etag_out</em></td><td>&nbsp;</td>
 
6194
        </tr>
 
6195
        <tr>
 
6196
          <td></td>
 
6197
          <td>)</td>
 
6198
          <td></td><td></td><td></td>
 
6199
        </tr>
 
6200
      </table>
 
6201
</div>
 
6202
<div class="memdoc">
 
6203
 
 
6204
<p>
 
6205
Finishes an asynchronous partial load operation that was started with <a class="el" href="classGio_1_1File.html#0e8d95fcdf7c2aa38f54e90a22d3ab6f" title="Reads the partial contents of a file.">load_partial_contents_async()</a>. 
 
6206
<p>
 
6207
<dl compact><dt><b>Parameters:</b></dt><dd>
 
6208
  <table border="0" cellspacing="2" cellpadding="0">
 
6209
    <tr><td valign="top"></td><td valign="top"><em>res</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>
 
6210
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>A location to place the contents of the file. </td></tr>
 
6211
    <tr><td valign="top"></td><td valign="top"><em>length</em>&nbsp;</td><td>A location to place the length of the contents of the file. </td></tr>
 
6212
    <tr><td valign="top"></td><td valign="top"><em>etag_out</em>&nbsp;</td><td>A location to place the current entity tag for the file. </td></tr>
 
6213
  </table>
 
6214
</dl>
 
6215
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the load was successful. If <code>false</code> and <em>error</em> is present, it will be set appropriately. </dd></dl>
 
6216
 
 
6217
</div>
 
6218
</div><p>
 
6219
<a class="anchor" name="f10deca1d5c5d1f650d3b182624330dc"></a><!-- doxytag: member="Gio::File::replace_contents" ref="f10deca1d5c5d1f650d3b182624330dc" args="(const char *contents, gsize length, const std::string &amp;etag, std::string &amp;new_etag, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE)" -->
 
6220
<div class="memitem">
 
6221
<div class="memproto">
 
6222
      <table class="memname">
 
6223
        <tr>
 
6224
          <td class="memname">void Gio::File::replace_contents           </td>
 
6225
          <td>(</td>
 
6226
          <td class="paramtype">const char *&nbsp;</td>
 
6227
          <td class="paramname"> <em>contents</em>, </td>
 
6228
        </tr>
 
6229
        <tr>
 
6230
          <td class="paramkey"></td>
 
6231
          <td></td>
 
6232
          <td class="paramtype">gsize&nbsp;</td>
 
6233
          <td class="paramname"> <em>length</em>, </td>
 
6234
        </tr>
 
6235
        <tr>
 
6236
          <td class="paramkey"></td>
 
6237
          <td></td>
 
6238
          <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>
 
6239
          <td class="paramname"> <em>etag</em>, </td>
 
6240
        </tr>
 
6241
        <tr>
 
6242
          <td class="paramkey"></td>
 
6243
          <td></td>
 
6244
          <td class="paramtype"><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>
 
6245
          <td class="paramname"> <em>new_etag</em>, </td>
 
6246
        </tr>
 
6247
        <tr>
 
6248
          <td class="paramkey"></td>
 
6249
          <td></td>
 
6250
          <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>
 
6251
          <td class="paramname"> <em>cancellable</em>, </td>
 
6252
        </tr>
 
6253
        <tr>
 
6254
          <td class="paramkey"></td>
 
6255
          <td></td>
 
6256
          <td class="paramtype">bool&nbsp;</td>
 
6257
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
 
6258
        </tr>
 
6259
        <tr>
 
6260
          <td class="paramkey"></td>
 
6261
          <td></td>
 
6262
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
 
6263
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
 
6264
        </tr>
 
6265
        <tr>
 
6266
          <td></td>
 
6267
          <td>)</td>
 
6268
          <td></td><td></td><td></td>
 
6269
        </tr>
 
6270
      </table>
 
6271
</div>
 
6272
<div class="memdoc">
 
6273
 
 
6274
<p>
 
6275
Replaces the contents of the file with <em>contents</em> of <em>length</em> bytes. 
 
6276
<p>
 
6277
If <em>etag</em> is specified (not an empty string) any existing file must have that etag, or a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with WRONG_ETAG will be thrown.<p>
 
6278
If <em>make_backup</em> is <code>true</code>, this function will attempt to make a backup of the file.<p>
 
6279
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>
 
6280
The returned <em>new_etag</em> can be used to verify that the file hasn't changed the next time it is saved over. <dl compact><dt><b>Parameters:</b></dt><dd>
 
6281
  <table border="0" cellspacing="2" cellpadding="0">
 
6282
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>A string containing the new contents for the file. </td></tr>
 
6283
    <tr><td valign="top"></td><td valign="top"><em>length</em>&nbsp;</td><td>The length of <em>contents</em> in bytes. </td></tr>
 
6284
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>The old entity tag for the document. </td></tr>
 
6285
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td><code>true</code> if a backup should be created. </td></tr>
 
6286
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
 
6287
    <tr><td valign="top"></td><td valign="top"><em>new_etag</em>&nbsp;</td><td>A location to a new entity tag for the document. </td></tr>
 
6288
    <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>
 
6289
  </table>
 
6290
</dl>
 
6291
 
 
6292
</div>
 
6293
</div><p>
 
6294
<a class="anchor" name="e7febf1f0f3b4b9efca9fae469082846"></a><!-- doxytag: member="Gio::File::replace_contents" ref="e7febf1f0f3b4b9efca9fae469082846" args="(const char *contents, gsize length, const std::string &amp;etag, std::string &amp;new_etag, bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE)" -->
 
6295
<div class="memitem">
 
6296
<div class="memproto">
 
6297
      <table class="memname">
 
6298
        <tr>
 
6299
          <td class="memname">void Gio::File::replace_contents           </td>
 
6300
          <td>(</td>
 
6301
          <td class="paramtype">const char *&nbsp;</td>
 
6302
          <td class="paramname"> <em>contents</em>, </td>
 
6303
        </tr>
 
6304
        <tr>
 
6305
          <td class="paramkey"></td>
 
6306
          <td></td>
 
6307
          <td class="paramtype">gsize&nbsp;</td>
 
6308
          <td class="paramname"> <em>length</em>, </td>
 
6309
        </tr>
 
6310
        <tr>
 
6311
          <td class="paramkey"></td>
 
6312
          <td></td>
 
6313
          <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>
 
6314
          <td class="paramname"> <em>etag</em>, </td>
 
6315
        </tr>
 
6316
        <tr>
 
6317
          <td class="paramkey"></td>
 
6318
          <td></td>
 
6319
          <td class="paramtype"><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>
 
6320
          <td class="paramname"> <em>new_etag</em>, </td>
 
6321
        </tr>
 
6322
        <tr>
 
6323
          <td class="paramkey"></td>
 
6324
          <td></td>
 
6325
          <td class="paramtype">bool&nbsp;</td>
 
6326
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
 
6327
        </tr>
 
6328
        <tr>
 
6329
          <td class="paramkey"></td>
 
6330
          <td></td>
 
6331
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
 
6332
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
 
6333
        </tr>
 
6334
        <tr>
 
6335
          <td></td>
 
6336
          <td>)</td>
 
6337
          <td></td><td></td><td></td>
 
6338
        </tr>
 
6339
      </table>
 
6340
</div>
 
6341
<div class="memdoc">
 
6342
 
 
6343
<p>
 
6344
Replaces the contents of the file with <em>contents</em> of <em>length</em> bytes. 
 
6345
<p>
 
6346
If <em>etag</em> is specified (not an empty string) any existing file must have that etag, or a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with WRONG_ETAG will be thrown.<p>
 
6347
If <em>make_backup</em> is <code>true</code>, this function will attempt to make a backup of the file.<p>
 
6348
The returned <em>new_etag</em> can be used to verify that the file hasn't changed the next time it is saved over. <dl compact><dt><b>Parameters:</b></dt><dd>
 
6349
  <table border="0" cellspacing="2" cellpadding="0">
 
6350
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>A string containing the new contents for the file. </td></tr>
 
6351
    <tr><td valign="top"></td><td valign="top"><em>length</em>&nbsp;</td><td>The length of <em>contents</em> in bytes. </td></tr>
 
6352
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>The old entity tag for the document. </td></tr>
 
6353
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td><code>true</code> if a backup should be created. </td></tr>
 
6354
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
 
6355
    <tr><td valign="top"></td><td valign="top"><em>new_etag</em>&nbsp;</td><td>A location to a new entity tag for the document. </td></tr>
 
6356
  </table>
 
6357
</dl>
 
6358
 
 
6359
</div>
 
6360
</div><p>
 
6361
<a class="anchor" name="23126b43cd262b63c0e458c3a4d0b65c"></a><!-- doxytag: member="Gio::File::replace_contents" ref="23126b43cd262b63c0e458c3a4d0b65c" args="(const std::string &amp;contents, const std::string &amp;etag, std::string &amp;new_etag, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE)" -->
 
6362
<div class="memitem">
 
6363
<div class="memproto">
 
6364
      <table class="memname">
 
6365
        <tr>
 
6366
          <td class="memname">void Gio::File::replace_contents           </td>
 
6367
          <td>(</td>
 
6368
          <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>
 
6369
          <td class="paramname"> <em>contents</em>, </td>
 
6370
        </tr>
 
6371
        <tr>
 
6372
          <td class="paramkey"></td>
 
6373
          <td></td>
 
6374
          <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>
 
6375
          <td class="paramname"> <em>etag</em>, </td>
 
6376
        </tr>
 
6377
        <tr>
 
6378
          <td class="paramkey"></td>
 
6379
          <td></td>
 
6380
          <td class="paramtype"><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>
 
6381
          <td class="paramname"> <em>new_etag</em>, </td>
 
6382
        </tr>
 
6383
        <tr>
 
6384
          <td class="paramkey"></td>
 
6385
          <td></td>
 
6386
          <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>
 
6387
          <td class="paramname"> <em>cancellable</em>, </td>
 
6388
        </tr>
 
6389
        <tr>
 
6390
          <td class="paramkey"></td>
 
6391
          <td></td>
 
6392
          <td class="paramtype">bool&nbsp;</td>
 
6393
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
 
6394
        </tr>
 
6395
        <tr>
 
6396
          <td class="paramkey"></td>
 
6397
          <td></td>
 
6398
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
 
6399
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
 
6400
        </tr>
 
6401
        <tr>
 
6402
          <td></td>
 
6403
          <td>)</td>
 
6404
          <td></td><td></td><td></td>
 
6405
        </tr>
 
6406
      </table>
 
6407
</div>
 
6408
<div class="memdoc">
 
6409
 
 
6410
<p>
 
6411
Replaces the contents of the file with <em>contents</em>. 
 
6412
<p>
 
6413
If <em>etag</em> is specified (not an empty string) any existing file must have that etag, or a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with WRONG_ETAG will be thrown.<p>
 
6414
If <em>make_backup</em> is <code>true</code>, this function will attempt to make a backup of the file.<p>
 
6415
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>
 
6416
The returned <em>new_etag</em> can be used to verify that the file hasn't changed the next time it is saved over. <dl compact><dt><b>Parameters:</b></dt><dd>
 
6417
  <table border="0" cellspacing="2" cellpadding="0">
 
6418
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>A string containing the new contents for the file. </td></tr>
 
6419
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>The old entity tag for the document. </td></tr>
 
6420
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td><code>true</code> if a backup should be created. </td></tr>
 
6421
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
 
6422
    <tr><td valign="top"></td><td valign="top"><em>new_etag</em>&nbsp;</td><td>A location to a new entity tag for the document. </td></tr>
 
6423
    <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>
 
6424
  </table>
 
6425
</dl>
 
6426
 
 
6427
</div>
 
6428
</div><p>
 
6429
<a class="anchor" name="af33a17461ff4f70fed06818e364f617"></a><!-- doxytag: member="Gio::File::replace_contents" ref="af33a17461ff4f70fed06818e364f617" args="(const std::string &amp;contents, const std::string &amp;etag, std::string &amp;new_etag, bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE)" -->
 
6430
<div class="memitem">
 
6431
<div class="memproto">
 
6432
      <table class="memname">
 
6433
        <tr>
 
6434
          <td class="memname">void Gio::File::replace_contents           </td>
 
6435
          <td>(</td>
 
6436
          <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>
 
6437
          <td class="paramname"> <em>contents</em>, </td>
 
6438
        </tr>
 
6439
        <tr>
 
6440
          <td class="paramkey"></td>
 
6441
          <td></td>
 
6442
          <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>
 
6443
          <td class="paramname"> <em>etag</em>, </td>
 
6444
        </tr>
 
6445
        <tr>
 
6446
          <td class="paramkey"></td>
 
6447
          <td></td>
 
6448
          <td class="paramtype"><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>
 
6449
          <td class="paramname"> <em>new_etag</em>, </td>
 
6450
        </tr>
 
6451
        <tr>
 
6452
          <td class="paramkey"></td>
 
6453
          <td></td>
 
6454
          <td class="paramtype">bool&nbsp;</td>
 
6455
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
 
6456
        </tr>
 
6457
        <tr>
 
6458
          <td class="paramkey"></td>
 
6459
          <td></td>
 
6460
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
 
6461
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
 
6462
        </tr>
 
6463
        <tr>
 
6464
          <td></td>
 
6465
          <td>)</td>
 
6466
          <td></td><td></td><td></td>
 
6467
        </tr>
 
6468
      </table>
 
6469
</div>
 
6470
<div class="memdoc">
 
6471
 
 
6472
<p>
 
6473
Replaces the contents of the file with <em>contents</em>. 
 
6474
<p>
 
6475
If <em>etag</em> is specified (not an empty string) any existing file must have that etag, or a <a class="el" href="classGio_1_1Error.html" title="Exception class for giomm errors.">Gio::Error</a> with WRONG_ETAG will be thrown.<p>
 
6476
If <em>make_backup</em> is <code>true</code>, this function will attempt to make a backup of the file.<p>
 
6477
The returned <em>new_etag</em> can be used to verify that the file hasn't changed the next time it is saved over. <dl compact><dt><b>Parameters:</b></dt><dd>
 
6478
  <table border="0" cellspacing="2" cellpadding="0">
 
6479
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>A string containing the new contents for the file. </td></tr>
 
6480
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>The old entity tag for the document. </td></tr>
 
6481
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td><code>true</code> if a backup should be created. </td></tr>
 
6482
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
 
6483
    <tr><td valign="top"></td><td valign="top"><em>new_etag</em>&nbsp;</td><td>A location to a new entity tag for the document. </td></tr>
 
6484
  </table>
 
6485
</dl>
 
6486
 
 
6487
</div>
 
6488
</div><p>
 
6489
<a class="anchor" name="d33b24a7942429157f47379f4353378c"></a><!-- doxytag: member="Gio::File::replace_contents_async" ref="d33b24a7942429157f47379f4353378c" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, const char *contents, gsize length, const std::string &amp;etag, bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE)" -->
 
6490
<div class="memitem">
 
6491
<div class="memproto">
 
6492
      <table class="memname">
 
6493
        <tr>
 
6494
          <td class="memname">void Gio::File::replace_contents_async           </td>
 
6495
          <td>(</td>
 
6496
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
6497
          <td class="paramname"> <em>slot</em>, </td>
 
6498
        </tr>
 
6499
        <tr>
 
6500
          <td class="paramkey"></td>
 
6501
          <td></td>
 
6502
          <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>
 
6503
          <td class="paramname"> <em>cancellable</em>, </td>
 
6504
        </tr>
 
6505
        <tr>
 
6506
          <td class="paramkey"></td>
 
6507
          <td></td>
 
6508
          <td class="paramtype">const char *&nbsp;</td>
 
6509
          <td class="paramname"> <em>contents</em>, </td>
 
6510
        </tr>
 
6511
        <tr>
 
6512
          <td class="paramkey"></td>
 
6513
          <td></td>
 
6514
          <td class="paramtype">gsize&nbsp;</td>
 
6515
          <td class="paramname"> <em>length</em>, </td>
 
6516
        </tr>
 
6517
        <tr>
 
6518
          <td class="paramkey"></td>
 
6519
          <td></td>
 
6520
          <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>
 
6521
          <td class="paramname"> <em>etag</em>, </td>
 
6522
        </tr>
 
6523
        <tr>
 
6524
          <td class="paramkey"></td>
 
6525
          <td></td>
 
6526
          <td class="paramtype">bool&nbsp;</td>
 
6527
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
 
6528
        </tr>
 
6529
        <tr>
 
6530
          <td class="paramkey"></td>
 
6531
          <td></td>
 
6532
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
 
6533
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
 
6534
        </tr>
 
6535
        <tr>
 
6536
          <td></td>
 
6537
          <td>)</td>
 
6538
          <td></td><td></td><td></td>
 
6539
        </tr>
 
6540
      </table>
 
6541
</div>
 
6542
<div class="memdoc">
 
6543
 
 
6544
<p>
 
6545
Starts an asynchronous replacement of the file with the given <em>contents</em> of <em>length</em> bytes. 
 
6546
<p>
 
6547
<em>etag</em> will replace the document's current entity tag.<p>
 
6548
When this operation has completed, <em>slot</em> will be called and the operation can be finalized with <a class="el" href="classGio_1_1File.html#f019065c5503c7f47d778c20f8e5de32" title="Finishes an asynchronous replace of the given file .">replace_contents_finish()</a>.<p>
 
6549
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>
 
6550
If <em>make_backup</em> is true, this function will attempt to make a backup of the file.<p>
 
6551
<dl compact><dt><b>Parameters:</b></dt><dd>
 
6552
  <table border="0" cellspacing="2" cellpadding="0">
 
6553
    <tr><td valign="top"></td><td valign="top"><em>slot,:</em>&nbsp;</td><td>A callback to call when the request is satisfied. </td></tr>
 
6554
    <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>
 
6555
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>String of contents to replace the file with. </td></tr>
 
6556
    <tr><td valign="top"></td><td valign="top"><em>length</em>&nbsp;</td><td>The length of <em>contents</em> in bytes. </td></tr>
 
6557
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>a new entity tag for the file. </td></tr>
 
6558
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td>true if a backup should be created. </td></tr>
 
6559
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
 
6560
  </table>
 
6561
</dl>
 
6562
 
 
6563
</div>
 
6564
</div><p>
 
6565
<a class="anchor" name="9a1c445e84124e16294974a73f2f1bbb"></a><!-- doxytag: member="Gio::File::replace_contents_async" ref="9a1c445e84124e16294974a73f2f1bbb" args="(const SlotAsyncReady &amp;slot, const char *contents, gsize length, const std::string &amp;etag, bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE)" -->
 
6566
<div class="memitem">
 
6567
<div class="memproto">
 
6568
      <table class="memname">
 
6569
        <tr>
 
6570
          <td class="memname">void Gio::File::replace_contents_async           </td>
 
6571
          <td>(</td>
 
6572
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
6573
          <td class="paramname"> <em>slot</em>, </td>
 
6574
        </tr>
 
6575
        <tr>
 
6576
          <td class="paramkey"></td>
 
6577
          <td></td>
 
6578
          <td class="paramtype">const char *&nbsp;</td>
 
6579
          <td class="paramname"> <em>contents</em>, </td>
 
6580
        </tr>
 
6581
        <tr>
 
6582
          <td class="paramkey"></td>
 
6583
          <td></td>
 
6584
          <td class="paramtype">gsize&nbsp;</td>
 
6585
          <td class="paramname"> <em>length</em>, </td>
 
6586
        </tr>
 
6587
        <tr>
 
6588
          <td class="paramkey"></td>
 
6589
          <td></td>
 
6590
          <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>
 
6591
          <td class="paramname"> <em>etag</em>, </td>
 
6592
        </tr>
 
6593
        <tr>
 
6594
          <td class="paramkey"></td>
 
6595
          <td></td>
 
6596
          <td class="paramtype">bool&nbsp;</td>
 
6597
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
 
6598
        </tr>
 
6599
        <tr>
 
6600
          <td class="paramkey"></td>
 
6601
          <td></td>
 
6602
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
 
6603
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
 
6604
        </tr>
 
6605
        <tr>
 
6606
          <td></td>
 
6607
          <td>)</td>
 
6608
          <td></td><td></td><td></td>
 
6609
        </tr>
 
6610
      </table>
 
6611
</div>
 
6612
<div class="memdoc">
 
6613
 
 
6614
<p>
 
6615
Starts an asynchronous replacement of the file with the given <em>contents</em> of <em>length</em> bytes. 
 
6616
<p>
 
6617
<em>etag</em> will replace the document's current entity tag.<p>
 
6618
When this operation has completed, <em>slot</em> will be called and the operation can be finalized with <a class="el" href="classGio_1_1File.html#f019065c5503c7f47d778c20f8e5de32" title="Finishes an asynchronous replace of the given file .">replace_contents_finish()</a>.<p>
 
6619
If <em>make_backup</em> is true, this function will attempt to make a backup of the file.<p>
 
6620
<dl compact><dt><b>Parameters:</b></dt><dd>
 
6621
  <table border="0" cellspacing="2" cellpadding="0">
 
6622
    <tr><td valign="top"></td><td valign="top"><em>slot,:</em>&nbsp;</td><td>A callback to call when the request is satisfied. </td></tr>
 
6623
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>String of contents to replace the file with. </td></tr>
 
6624
    <tr><td valign="top"></td><td valign="top"><em>length</em>&nbsp;</td><td>The length of <em>contents</em> in bytes. </td></tr>
 
6625
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>a new entity tag for the file. </td></tr>
 
6626
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td>true if a backup should be created. </td></tr>
 
6627
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
 
6628
  </table>
 
6629
</dl>
 
6630
 
 
6631
</div>
 
6632
</div><p>
 
6633
<a class="anchor" name="380d6ce6362fc05e0e18ff1b881ceac7"></a><!-- doxytag: member="Gio::File::replace_contents_async" ref="380d6ce6362fc05e0e18ff1b881ceac7" args="(const SlotAsyncReady &amp;slot, const Glib::RefPtr&lt; Cancellable &gt; &amp;cancellable, const std::string &amp;contents, const std::string &amp;etag, bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE)" -->
 
6634
<div class="memitem">
 
6635
<div class="memproto">
 
6636
      <table class="memname">
 
6637
        <tr>
 
6638
          <td class="memname">void Gio::File::replace_contents_async           </td>
 
6639
          <td>(</td>
 
6640
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
6641
          <td class="paramname"> <em>slot</em>, </td>
 
6642
        </tr>
 
6643
        <tr>
 
6644
          <td class="paramkey"></td>
 
6645
          <td></td>
 
6646
          <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>
 
6647
          <td class="paramname"> <em>cancellable</em>, </td>
 
6648
        </tr>
 
6649
        <tr>
 
6650
          <td class="paramkey"></td>
 
6651
          <td></td>
 
6652
          <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>
 
6653
          <td class="paramname"> <em>contents</em>, </td>
 
6654
        </tr>
 
6655
        <tr>
 
6656
          <td class="paramkey"></td>
 
6657
          <td></td>
 
6658
          <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>
 
6659
          <td class="paramname"> <em>etag</em>, </td>
 
6660
        </tr>
 
6661
        <tr>
 
6662
          <td class="paramkey"></td>
 
6663
          <td></td>
 
6664
          <td class="paramtype">bool&nbsp;</td>
 
6665
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
 
6666
        </tr>
 
6667
        <tr>
 
6668
          <td class="paramkey"></td>
 
6669
          <td></td>
 
6670
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
 
6671
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
 
6672
        </tr>
 
6673
        <tr>
 
6674
          <td></td>
 
6675
          <td>)</td>
 
6676
          <td></td><td></td><td></td>
 
6677
        </tr>
 
6678
      </table>
 
6679
</div>
 
6680
<div class="memdoc">
 
6681
 
 
6682
<p>
 
6683
Starts an asynchronous replacement of the file with the given <em>contents</em> of <em>length</em> bytes. 
 
6684
<p>
 
6685
<em>etag</em> will replace the document's current entity tag.<p>
 
6686
When this operation has completed, <em>slot</em> will be called and the operation can be finalized with <a class="el" href="classGio_1_1File.html#f019065c5503c7f47d778c20f8e5de32" title="Finishes an asynchronous replace of the given file .">replace_contents_finish()</a>.<p>
 
6687
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>
 
6688
If <em>make_backup</em> is true, this function will attempt to make a backup of the file.<p>
 
6689
<dl compact><dt><b>Parameters:</b></dt><dd>
 
6690
  <table border="0" cellspacing="2" cellpadding="0">
 
6691
    <tr><td valign="top"></td><td valign="top"><em>slot,:</em>&nbsp;</td><td>A callback to call when the request is satisfied. </td></tr>
 
6692
    <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>
 
6693
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>String of contents to replace the file with. </td></tr>
 
6694
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>a new entity tag for the file. </td></tr>
 
6695
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td>true if a backup should be created. </td></tr>
 
6696
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
 
6697
  </table>
 
6698
</dl>
 
6699
 
 
6700
</div>
 
6701
</div><p>
 
6702
<a class="anchor" name="6fc86aab90620881899a701c2b2775cb"></a><!-- doxytag: member="Gio::File::replace_contents_async" ref="6fc86aab90620881899a701c2b2775cb" args="(const SlotAsyncReady &amp;slot, const std::string &amp;contents, const std::string &amp;etag, bool make_backup=false, FileCreateFlags flags=FILE_CREATE_NONE)" -->
 
6703
<div class="memitem">
 
6704
<div class="memproto">
 
6705
      <table class="memname">
 
6706
        <tr>
 
6707
          <td class="memname">void Gio::File::replace_contents_async           </td>
 
6708
          <td>(</td>
 
6709
          <td class="paramtype">const <a class="el" href="namespaceGio.html#ecaa02709f9ab83fa2b36d2571665cbe">SlotAsyncReady</a>&amp;&nbsp;</td>
 
6710
          <td class="paramname"> <em>slot</em>, </td>
 
6711
        </tr>
 
6712
        <tr>
 
6713
          <td class="paramkey"></td>
 
6714
          <td></td>
 
6715
          <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>
 
6716
          <td class="paramname"> <em>contents</em>, </td>
 
6717
        </tr>
 
6718
        <tr>
 
6719
          <td class="paramkey"></td>
 
6720
          <td></td>
 
6721
          <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>
 
6722
          <td class="paramname"> <em>etag</em>, </td>
 
6723
        </tr>
 
6724
        <tr>
 
6725
          <td class="paramkey"></td>
 
6726
          <td></td>
 
6727
          <td class="paramtype">bool&nbsp;</td>
 
6728
          <td class="paramname"> <em>make_backup</em> = <code>false</code>, </td>
 
6729
        </tr>
 
6730
        <tr>
 
6731
          <td class="paramkey"></td>
 
6732
          <td></td>
 
6733
          <td class="paramtype"><a class="el" href="group__giommEnums.html#g500a44e123fd4c578f8af9ddef2f7601">FileCreateFlags</a>&nbsp;</td>
 
6734
          <td class="paramname"> <em>flags</em> = <code>FILE_CREATE_NONE</code></td><td>&nbsp;</td>
 
6735
        </tr>
 
6736
        <tr>
 
6737
          <td></td>
 
6738
          <td>)</td>
 
6739
          <td></td><td></td><td></td>
 
6740
        </tr>
 
6741
      </table>
 
6742
</div>
 
6743
<div class="memdoc">
 
6744
 
 
6745
<p>
 
6746
Starts an asynchronous replacement of the file with the given <em>contents</em>. 
 
6747
<p>
 
6748
<em>etag</em> will replace the document's current entity tag.<p>
 
6749
When this operation has completed, <em>slot</em> will be called and the operation can be finalized with <a class="el" href="classGio_1_1File.html#f019065c5503c7f47d778c20f8e5de32" title="Finishes an asynchronous replace of the given file .">replace_contents_finish()</a>.<p>
 
6750
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>
 
6751
If <em>make_backup</em> is true, this function will attempt to make a backup of the file.<p>
 
6752
<dl compact><dt><b>Parameters:</b></dt><dd>
 
6753
  <table border="0" cellspacing="2" cellpadding="0">
 
6754
    <tr><td valign="top"></td><td valign="top"><em>slot,:</em>&nbsp;</td><td>A callback to call when the request is satisfied. </td></tr>
 
6755
    <tr><td valign="top"></td><td valign="top"><em>contents</em>&nbsp;</td><td>String of contents to replace the file with. </td></tr>
 
6756
    <tr><td valign="top"></td><td valign="top"><em>etag</em>&nbsp;</td><td>a new entity tag for the file. </td></tr>
 
6757
    <tr><td valign="top"></td><td valign="top"><em>make_backup</em>&nbsp;</td><td>true if a backup should be created. </td></tr>
 
6758
    <tr><td valign="top"></td><td valign="top"><em>flags</em>&nbsp;</td><td>A set of FileCreateFlags. </td></tr>
 
6759
  </table>
 
6760
</dl>
 
6761
 
 
6762
</div>
 
6763
</div><p>
 
6764
<a class="anchor" name="f019065c5503c7f47d778c20f8e5de32"></a><!-- doxytag: member="Gio::File::replace_contents_finish" ref="f019065c5503c7f47d778c20f8e5de32" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result, std::string &amp;etag)" -->
 
6765
<div class="memitem">
 
6766
<div class="memproto">
 
6767
      <table class="memname">
 
6768
        <tr>
 
6769
          <td class="memname">void Gio::File::replace_contents_finish           </td>
 
6770
          <td>(</td>
 
6771
          <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>
 
6772
          <td class="paramname"> <em>result</em>, </td>
 
6773
        </tr>
 
6774
        <tr>
 
6775
          <td class="paramkey"></td>
 
6776
          <td></td>
 
6777
          <td class="paramtype"><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>
 
6778
          <td class="paramname"> <em>etag</em></td><td>&nbsp;</td>
 
6779
        </tr>
 
6780
        <tr>
 
6781
          <td></td>
 
6782
          <td>)</td>
 
6783
          <td></td><td></td><td></td>
 
6784
        </tr>
 
6785
      </table>
 
6786
</div>
 
6787
<div class="memdoc">
 
6788
 
 
6789
<p>
 
6790
Finishes an asynchronous replace of the given file . 
 
6791
<p>
 
6792
See <a class="el" href="classGio_1_1File.html#d33b24a7942429157f47379f4353378c" title="Starts an asynchronous replacement of the file with the given contents of length...">replace_contents_async()</a>. Sets <em>new_etag</em> to the new entity tag for the document. <dl compact><dt><b>Parameters:</b></dt><dd>
 
6793
  <table border="0" cellspacing="2" cellpadding="0">
 
6794
    <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>
 
6795
    <tr><td valign="top"></td><td valign="top"><em>new_etag</em>&nbsp;</td><td>A location of a new entity tag for the document. </td></tr>
 
6796
  </table>
 
6797
</dl>
 
6798
 
 
6799
</div>
 
6800
</div><p>
 
6801
<a class="anchor" name="f0372ffd3f535f39b7e48c0483e4c1f4"></a><!-- doxytag: member="Gio::File::replace_contents_finish" ref="f0372ffd3f535f39b7e48c0483e4c1f4" args="(const Glib::RefPtr&lt; AsyncResult &gt; &amp;result)" -->
 
6802
<div class="memitem">
 
6803
<div class="memproto">
 
6804
      <table class="memname">
 
6805
        <tr>
 
6806
          <td class="memname">void Gio::File::replace_contents_finish           </td>
 
6807
          <td>(</td>
 
6808
          <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>
 
6809
          <td class="paramname"> <em>result</em>          </td>
 
6810
          <td>&nbsp;)&nbsp;</td>
 
6811
          <td></td>
 
6812
        </tr>
 
6813
      </table>
 
6814
</div>
 
6815
<div class="memdoc">
 
6816
 
 
6817
<p>
 
6818
Finishes an asynchronous replace of the given file . 
 
6819
<p>
 
6820
See <a class="el" href="classGio_1_1File.html#d33b24a7942429157f47379f4353378c" title="Starts an asynchronous replacement of the file with the given contents of length...">replace_contents_async()</a>. Sets <em>new_etag</em> to the new entity tag for the document. <dl compact><dt><b>Parameters:</b></dt><dd>
 
6821
  <table border="0" cellspacing="2" cellpadding="0">
 
6822
    <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>. for the document. </td></tr>
 
6823
  </table>
 
6824
</dl>
 
6825
 
 
6826
</div>
 
6827
</div><p>
6826
6828
<hr><h2>Friends And Related Function Documentation</h2>
6827
6829
<a class="anchor" name="69670cdc7cf63783d6f9370dcbd7cc3d"></a><!-- doxytag: member="Gio::File::wrap" ref="69670cdc7cf63783d6f9370dcbd7cc3d" args="(GFile *object, bool take_copy=false)" -->
6828
6830
<div class="memitem">
6869
6871
 
6870
6872
<hr><address><small>
6871
6873
Generated for glibmm 2.4 by <a href="http://www.doxygen.org/index.html">
6872
 
Doxygen</a> 1.5.8 &copy;&nbsp;1997-2001</small></address>
 
6874
Doxygen</a> 1.5.6 &copy;&nbsp;1997-2001</small></address>
6873
6875
</body>
6874
6876
</html>