~ubuntu-branches/ubuntu/vivid/glib2.0/vivid-proposed : revision 203

51

</tr>

52

<tr>

53

54

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

54

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

55

</td>

56

57

(<a class="link" href="GFile.html#GFileReadMoreCallback" title="GFileReadMoreCallback ()">*GFileReadMoreCallback</a>) ()

123

</tr>

124

<tr>

125

126

<a href="../glib/glib-Basic-Types.html#guint">guint</a>

126

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a>

127

</td>

128

129

<a class="link" href="GFile.html#g-file-hash" title="g_file_hash ()">g_file_hash</a> ()

131

</tr>

132

<tr>

133

134

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

134

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

135

</td>

136

137

<a class="link" href="GFile.html#g-file-equal" title="g_file_equal ()">g_file_equal</a> ()

179

</tr>

180

<tr>

181

182

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

182

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

183

</td>

184

185

<a class="link" href="GFile.html#g-file-has-parent" title="g_file_has_parent ()">g_file_has_parent</a> ()

203

</tr>

204

<tr>

205

206

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

206

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

207

</td>

208

209

<a class="link" href="GFile.html#g-file-has-prefix" title="g_file_has_prefix ()">g_file_has_prefix</a> ()

227

</tr>

228

<tr>

229

230

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

230

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

231

</td>

232

233

<a class="link" href="GFile.html#g-file-is-native" title="g_file_is_native ()">g_file_is_native</a> ()

235

</tr>

236

<tr>

237

238

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

238

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

239

</td>

240

241

<a class="link" href="GFile.html#g-file-has-uri-scheme" title="g_file_has_uri_scheme ()">g_file_has_uri_scheme</a> ()

371

</tr>

372

<tr>

373

374

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

374

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

375

</td>

376

377

<a class="link" href="GFile.html#g-file-query-exists" title="g_file_query_exists ()">g_file_query_exists</a> ()

419

</tr>

420

<tr>

421

422

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

422

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

423

</td>

424

425

<a class="link" href="GFile.html#g-file-measure-disk-usage" title="g_file_measure_disk_usage ()">g_file_measure_disk_usage</a> ()

435

</tr>

436

<tr>

437

438

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

438

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

439

</td>

440

441

<a class="link" href="GFile.html#g-file-measure-disk-usage-finish" title="g_file_measure_disk_usage_finish ()">g_file_measure_disk_usage_finish</a> ()

515

</tr>

516

<tr>

517

518

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

518

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

519

</td>

520

521

<a class="link" href="GFile.html#g-file-delete" title="g_file_delete ()">g_file_delete</a> ()

531

</tr>

532

<tr>

533

534

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

534

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

535

</td>

536

537

<a class="link" href="GFile.html#g-file-delete-finish" title="g_file_delete_finish ()">g_file_delete_finish</a> ()

539

</tr>

540

<tr>

541

542

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

542

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

543

</td>

544

545

<a class="link" href="GFile.html#g-file-trash" title="g_file_trash ()">g_file_trash</a> ()

555

</tr>

556

<tr>

557

558

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

558

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

559

</td>

560

561

<a class="link" href="GFile.html#g-file-trash-finish" title="g_file_trash_finish ()">g_file_trash_finish</a> ()

563

</tr>

564

<tr>

565

566

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

566

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

567

</td>

568

569

<a class="link" href="GFile.html#g-file-copy" title="g_file_copy ()">g_file_copy</a> ()

579

</tr>

580

<tr>

581

582

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

582

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

583

</td>

584

585

<a class="link" href="GFile.html#g-file-copy-finish" title="g_file_copy_finish ()">g_file_copy_finish</a> ()

587

</tr>

588

<tr>

589

590

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

590

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

591

</td>

592

593

<a class="link" href="GFile.html#g-file-move" title="g_file_move ()">g_file_move</a> ()

595

</tr>

596

<tr>

597

598

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

598

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

599

</td>

600

601

<a class="link" href="GFile.html#g-file-make-directory" title="g_file_make_directory ()">g_file_make_directory</a> ()

611

</tr>

612

<tr>

613

614

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

614

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

615

</td>

616

617

<a class="link" href="GFile.html#g-file-make-directory-finish" title="g_file_make_directory_finish ()">g_file_make_directory_finish</a> ()

619

</tr>

620

<tr>

621

622

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

622

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

623

</td>

624

625

<a class="link" href="GFile.html#g-file-make-directory-with-parents" title="g_file_make_directory_with_parents ()">g_file_make_directory_with_parents</a> ()

627

</tr>

628

<tr>

629

630

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

630

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

631

</td>

632

633

<a class="link" href="GFile.html#g-file-make-symbolic-link" title="g_file_make_symbolic_link ()">g_file_make_symbolic_link</a> ()

651

</tr>

652

<tr>

653

654

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

654

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

655

</td>

656

657

<a class="link" href="GFile.html#g-file-set-attribute" title="g_file_set_attribute ()">g_file_set_attribute</a> ()

659

</tr>

660

<tr>

661

662

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

662

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

663

</td>

664

665

<a class="link" href="GFile.html#g-file-set-attributes-from-info" title="g_file_set_attributes_from_info ()">g_file_set_attributes_from_info</a> ()

675

</tr>

676

<tr>

677

678

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

678

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

679

</td>

680

681

<a class="link" href="GFile.html#g-file-set-attributes-finish" title="g_file_set_attributes_finish ()">g_file_set_attributes_finish</a> ()

683

</tr>

684

<tr>

685

686

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

686

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

687

</td>

688

689

<a class="link" href="GFile.html#g-file-set-attribute-string" title="g_file_set_attribute_string ()">g_file_set_attribute_string</a> ()

691

</tr>

692

<tr>

693

694

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

694

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

695

</td>

696

697

<a class="link" href="GFile.html#g-file-set-attribute-byte-string" title="g_file_set_attribute_byte_string ()">g_file_set_attribute_byte_string</a> ()

699

</tr>

700

<tr>

701

702

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

702

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

703

</td>

704

705

<a class="link" href="GFile.html#g-file-set-attribute-uint32" title="g_file_set_attribute_uint32 ()">g_file_set_attribute_uint32</a> ()

707

</tr>

708

<tr>

709

710

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

710

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

711

</td>

712

713

<a class="link" href="GFile.html#g-file-set-attribute-int32" title="g_file_set_attribute_int32 ()">g_file_set_attribute_int32</a> ()

715

</tr>

716

<tr>

717

718

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

718

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

719

</td>

720

721

<a class="link" href="GFile.html#g-file-set-attribute-uint64" title="g_file_set_attribute_uint64 ()">g_file_set_attribute_uint64</a> ()

723

</tr>

724

<tr>

725

726

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

726

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

727

</td>

728

729

<a class="link" href="GFile.html#g-file-set-attribute-int64" title="g_file_set_attribute_int64 ()">g_file_set_attribute_int64</a> ()

755

</tr>

756

<tr>

757

758

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

758

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

759

</td>

760

761

<a class="link" href="GFile.html#g-file-unmount-mountable-finish" title="g_file_unmount_mountable_finish ()">g_file_unmount_mountable_finish</a> ()

771

</tr>

772

<tr>

773

774

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

774

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

775

</td>

776

777

<a class="link" href="GFile.html#g-file-unmount-mountable-with-operation-finish" title="g_file_unmount_mountable_with_operation_finish ()">g_file_unmount_mountable_with_operation_finish</a> ()

787

</tr>

788

<tr>

789

790

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

790

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

791

</td>

792

793

<a class="link" href="GFile.html#g-file-eject-mountable-finish" title="g_file_eject_mountable_finish ()">g_file_eject_mountable_finish</a> ()

803

</tr>

804

<tr>

805

806

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

806

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

807

</td>

808

809

<a class="link" href="GFile.html#g-file-eject-mountable-with-operation-finish" title="g_file_eject_mountable_with_operation_finish ()">g_file_eject_mountable_with_operation_finish</a> ()

819

</tr>

820

<tr>

821

822

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

822

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

823

</td>

824

825

<a class="link" href="GFile.html#g-file-start-mountable-finish" title="g_file_start_mountable_finish ()">g_file_start_mountable_finish</a> ()

835

</tr>

836

<tr>

837

838

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

838

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

839

</td>

840

841

<a class="link" href="GFile.html#g-file-stop-mountable-finish" title="g_file_stop_mountable_finish ()">g_file_stop_mountable_finish</a> ()

851

</tr>

852

<tr>

853

854

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

854

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

855

</td>

856

857

<a class="link" href="GFile.html#g-file-poll-mountable-finish" title="g_file_poll_mountable_finish ()">g_file_poll_mountable_finish</a> ()

867

</tr>

868

<tr>

869

870

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

870

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

871

</td>

872

873

<a class="link" href="GFile.html#g-file-mount-enclosing-volume-finish" title="g_file_mount_enclosing_volume_finish ()">g_file_mount_enclosing_volume_finish</a> ()

899

</tr>

900

<tr>

901

902

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

902

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

903

</td>

904

905

<a class="link" href="GFile.html#g-file-load-contents" title="g_file_load_contents ()">g_file_load_contents</a> ()

915

</tr>

916

<tr>

917

918

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

918

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

919

</td>

920

921

<a class="link" href="GFile.html#g-file-load-contents-finish" title="g_file_load_contents_finish ()">g_file_load_contents_finish</a> ()

931

</tr>

932

<tr>

933

934

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

934

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

935

</td>

936

937

<a class="link" href="GFile.html#g-file-load-partial-contents-finish" title="g_file_load_partial_contents_finish ()">g_file_load_partial_contents_finish</a> ()

939

</tr>

940

<tr>

941

942

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

942

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

943

</td>

944

945

<a class="link" href="GFile.html#g-file-replace-contents" title="g_file_replace_contents ()">g_file_replace_contents</a> ()

963

</tr>

964

<tr>

965

966

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

966

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

967

</td>

968

969

<a class="link" href="GFile.html#g-file-replace-contents-finish" title="g_file_replace_contents_finish ()">g_file_replace_contents_finish</a> ()

971

</tr>

972

<tr>

973

974

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

974

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

975

</td>

976

977

<a class="link" href="GFile.html#g-file-copy-attributes" title="g_file_copy_attributes ()">g_file_copy_attributes</a> ()

1051

</tr>

1052

<tr>

1053

1054

<a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

1054

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

1055

</td>

1056

1057

<a class="link" href="GFile.html#g-file-supports-thread-contexts" title="g_file_supports_thread_contexts ()">g_file_supports_thread_contexts</a> ()

1105

</div>

1106

1107

<a name="GFile.object-hierarchy"></a><h2>Object Hierarchy</h2>

1108

<pre class="screen"> <a href="/home/desrt/.cache/jhbuild/install/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html">GFlags</a>

1108

<pre class="screen"> <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Enumeration-and-Flag-Types.html">GFlags</a>

1109

╰── GFileMonitorFlags

1110

<a href="/home/desrt/.cache/jhbuild/install/share/gtk-doc/html/gobject/GTypeModule.html">GInterface</a>

1110

<a href="http://library.gnome.org/devel/gobject/unstable/GTypeModule.html">GInterface</a>

1111

╰── GFile

1112

</pre>

1113

</div>

1115

<a name="GFile.prerequisites"></a><h2>Prerequisites</h2>

1116

1117

GFile requires

1118

<a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>.

1118

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>.

1119

</div>

1120

1121

<a name="GFile.includes"></a><h2>Includes</h2>

1201

1202

<a name="GFileProgressCallback"></a><h3>GFileProgressCallback ()</h3>

1203

<pre class="programlisting">void

1204

(*GFileProgressCallback) (<code><a href="../glib/glib-Basic-Types.html#goffset">goffset</a> current_num_bytes</code>,

1205

<code><a href="../glib/glib-Basic-Types.html#goffset">goffset</a> total_num_bytes</code>,

1206

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

1204

(*GFileProgressCallback) (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#goffset">goffset</a> current_num_bytes</code>,

1205

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#goffset">goffset</a> total_num_bytes</code>,

1206

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

1207

When doing file operations that may take a while, such as moving

1208

a file or copying a file, a progress callback is used to pass how

1209

far along that operation is to the application.

1238

<hr>

1239

1240

<a name="GFileReadMoreCallback"></a><h3>GFileReadMoreCallback ()</h3>

1241

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

1241

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

1242

(*GFileReadMoreCallback) (<code>const char *file_contents</code>,

1243

<code><a href="../glib/glib-Basic-Types.html#goffset">goffset</a> file_size</code>,

1244

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> callback_data</code>);</pre>

1243

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#goffset">goffset</a> file_size</code>,

1244

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> callback_data</code>);</pre>

1245

When loading the partial contents of a file with <a class="link" href="GFile.html#g-file-load-partial-contents-async" title="g_file_load_partial_contents_async ()"><code class="function">g_file_load_partial_contents_async()</code></a>,

1246

it may become necessary to determine if any more data from the file should be loaded.

1247

A <a class="link" href="GFile.html#GFileReadMoreCallback" title="GFileReadMoreCallback ()">GFileReadMoreCallback</a> function facilitates this by returning <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if more data

1248

should be read, or <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

1247

A <a class="link" href="GFile.html#GFileReadMoreCallback" title="GFileReadMoreCallback ()">GFileReadMoreCallback</a> function facilitates this by returning <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if more data

1248

should be read, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

1249

1250

<a name="id-1.4.2.2.9.3.5"></a><h4>Parameters</h4>

1251

1275

</div>

1276

1277

<a name="id-1.4.2.2.9.3.6"></a><h4>Returns</h4>

1278

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if more data should be read back. <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

1278

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if more data should be read back. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

1279

1280

</div>

1281

</div>

1283

1284

<a name="GFileMeasureProgressCallback"></a><h3>GFileMeasureProgressCallback ()</h3>

1285

<pre class="programlisting">void

1286

(*GFileMeasureProgressCallback) (<code><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a> reporting</code>,

1287

<code><a href="../glib/glib-Basic-Types.html#guint64">guint64</a> current_size</code>,

1288

<code><a href="../glib/glib-Basic-Types.html#guint64">guint64</a> num_dirs</code>,

1289

<code><a href="../glib/glib-Basic-Types.html#guint64">guint64</a> num_files</code>,

1290

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

1286

(*GFileMeasureProgressCallback) (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> reporting</code>,

1287

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint64">guint64</a> current_size</code>,

1288

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint64">guint64</a> num_dirs</code>,

1289

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint64">guint64</a> num_files</code>,

1290

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

1291

This callback type is used by <a class="link" href="GFile.html#g-file-measure-disk-usage" title="g_file_measure_disk_usage ()"><code class="function">g_file_measure_disk_usage()</code></a> to make

1292

periodic progress reports when measuring the amount of disk spaced

1293

used by a directory.

1296

always be made immediately.

1297

In the case that there is no support, <code>reporting</code>

1298

will be set to

1299

<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> (and the other values undefined) and no further calls will be

1299

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> (and the other values undefined) and no further calls will be

1300

made. Otherwise, the <code>reporting</code>

1301

will be <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> and the other values

1301

will be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> and the other values

1302

all-zeros during the first (immediate) call. In this way, you can

1303

know which type of progress UI to show without a delay.

1304

For <a class="link" href="GFile.html#g-file-measure-disk-usage" title="g_file_measure_disk_usage ()"><code class="function">g_file_measure_disk_usage()</code></a> the callback is made directly. For

1323

<tbody>

1324

<tr>

1325

<td class="parameter_name">reporting</td>

1326

<td class="parameter_description"><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if more reports will come</td>

1326

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if more reports will come</td>

1327

1328

</tr>

1329

<tr>

1380

<a name="id-1.4.2.2.9.5.6"></a><h4>Returns</h4>

1381

a new <a class="link" href="GFile.html" title="GFile">GFile</a> for the given <code>path</code>

1382

.

1383

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

1383

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

1384

[<acronym title="Free data after the code is done.">transfer full</acronym>]

1385

</div>

1386

</div>

1413

<a name="id-1.4.2.2.9.6.6"></a><h4>Returns</h4>

1414

a new <a class="link" href="GFile.html" title="GFile">GFile</a> for the given <code>uri</code>

1415

.

1416

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

1416

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

1417

[<acronym title="Free data after the code is done.">transfer full</acronym>]

1418

</div>

1419

</div>

1432

Note that on Windows, this function expects its argument to be in

1433

UTF-8 -- not the system code page. This means that you

1434

should not use this function with string from argv as it is passed

1435

to <code class="function">main()</code>. <a href="../glib/glib-Windows-Compatibility-Functions.html#g-win32-get-command-line"><code class="function">g_win32_get_command_line()</code></a> will return a UTF-8 version of

1435

to <code class="function">main()</code>. <a href="http://library.gnome.org/devel/glib/unstable/glib-Windows-Compatibility-Functions.html#g-win32-get-command-line"><code class="function">g_win32_get_command_line()</code></a> will return a UTF-8 version of

1436

the commandline. <a class="link" href="GApplication.html" title="GApplication">GApplication</a> also uses UTF-8 but

1437

<a class="link" href="GApplicationCommandLine.html#g-application-command-line-create-file-for-arg" title="g_application_command_line_create_file_for_arg ()"><code class="function">g_application_command_line_create_file_for_arg()</code></a> may be more useful

1438

for you there. It is also always possible to use this function with

1439

<a href="../glib/glib-Commandline-option-parser.html#GOptionContext">GOptionContext</a> arguments of type <code class="literal">G_OPTION_ARG_FILENAME</code>.

1439

<a href="http://library.gnome.org/devel/glib/unstable/glib-Commandline-option-parser.html#GOptionContext">GOptionContext</a> arguments of type <a href="http://library.gnome.org/devel/glib/unstable/glib-Commandline-option-parser.html#G-OPTION-ARG-FILENAME:CAPS"><code class="literal">G_OPTION_ARG_FILENAME</code></a>.

1440

1441

<a name="id-1.4.2.2.9.7.6"></a><h4>Parameters</h4>

1442

1455

1456

<a name="id-1.4.2.2.9.7.7"></a><h4>Returns</h4>

1457

a new <a class="link" href="GFile.html" title="GFile">GFile</a>.

1458

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

1458

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

1459

[<acronym title="Free data after the code is done.">transfer full</acronym>]

1460

</div>

1461

</div>

1464

<a name="g-file-new-for-commandline-arg-and-cwd"></a><h3>g_file_new_for_commandline_arg_and_cwd ()</h3>

1465

<pre class="programlisting"><a class="link" href="GFile.html" title="GFile">GFile</a> *

1466

g_file_new_for_commandline_arg_and_cwd

1467

(<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *arg</code>,

1468

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *cwd</code>);</pre>

1467

(<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *arg</code>,

1468

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *cwd</code>);</pre>

1469

Creates a <a class="link" href="GFile.html" title="GFile">GFile</a> with the given argument from the command line.

1470

This function is similar to <a class="link" href="GFile.html#g-file-new-for-commandline-arg" title="g_file_new_for_commandline_arg ()"><code class="function">g_file_new_for_commandline_arg()</code></a> except

1471

that it allows for passing the current working directory as an

1509

<pre class="programlisting"><a class="link" href="GFile.html" title="GFile">GFile</a> *

1510

g_file_new_tmp (<code>const char *tmpl</code>,

1511

<code><a class="link" href="GFileIOStream.html" title="GFileIOStream">GFileIOStream</a> **iostream</code>,

1512

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

1512

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

1513

Opens a file in the preferred directory for temporary files (as

1514

returned by <a href="../glib/glib-Miscellaneous-Utility-Functions.html#g-get-tmp-dir"><code class="function">g_get_tmp_dir()</code></a>) and returns a <a class="link" href="GFile.html" title="GFile">GFile</a> and

1514

returned by <a href="http://library.gnome.org/devel/glib/unstable/glib-Miscellaneous-Utility-Functions.html#g-get-tmp-dir"><code class="function">g_get_tmp_dir()</code></a>) and returns a <a class="link" href="GFile.html" title="GFile">GFile</a> and

1515

<a class="link" href="GFileIOStream.html" title="GFileIOStream">GFileIOStream</a> pointing to it.

1516

1517

should be a string in the GLib file name encoding

1518

containing a sequence of six 'X' characters, and containing no

1519

directory components. If it is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a default template is used.

1520

Unlike the other <a class="link" href="GFile.html" title="GFile">GFile</a> constructors, this will return <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

1519

directory components. If it is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a default template is used.

1520

Unlike the other <a class="link" href="GFile.html" title="GFile">GFile</a> constructors, this will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

1521

a temporary file could not be created.

1522

1523

<a name="id-1.4.2.2.9.9.7"></a><h4>Parameters</h4>

1531

<tr>

1532

1533

<td class="parameter_description"> Template for the file

1534

name, as in <a href="../glib/glib-File-Utilities.html#g-file-open-tmp"><code class="function">g_file_open_tmp()</code></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for a default template. </td>

1534

name, as in <a href="http://library.gnome.org/devel/glib/unstable/glib-File-Utilities.html#g-file-open-tmp"><code class="function">g_file_open_tmp()</code></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for a default template. </td>

1535

<td class="parameter_annotations">[<acronym title="Override the parsed C type with given type.">type</acronym> filename][<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

1536

</tr>

1537

<tr>

1541

</tr>

1542

<tr>

1543

<td class="parameter_name">error</td>

1544

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

1544

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

1545

1546

</tr>

1547

</tbody>

1550

1551

<a name="id-1.4.2.2.9.9.8"></a><h4>Returns</h4>

1552

a new <a class="link" href="GFile.html" title="GFile">GFile</a>.

1553

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

1553

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

1554

[<acronym title="Free data after the code is done.">transfer full</acronym>]

1555

</div>

1556

Since 2.32

1621

<hr>

1622

1623

1624

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint">guint</a>

1625

g_file_hash (<code><a href="../glib/glib-Basic-Types.html#gconstpointer">gconstpointer</a> file</code>);</pre>

1624

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a>

1625

g_file_hash (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gconstpointer">gconstpointer</a> file</code>);</pre>

1626

Creates a hash value for a <a class="link" href="GFile.html" title="GFile">GFile</a>.

1627

This call does no blocking I/O.

1628

Virtual: hash

1636

</colgroup>

1637

1638

1639

<td class="parameter_description"> <a href="../glib/glib-Basic-Types.html#gconstpointer">gconstpointer</a> to a <a class="link" href="GFile.html" title="GFile">GFile</a>. </td>

1639

<td class="parameter_description"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gconstpointer">gconstpointer</a> to a <a class="link" href="GFile.html" title="GFile">GFile</a>. </td>

1640

<td class="parameter_annotations">[<acronym title="Override the parsed C type with given type.">type</acronym> GFile]</td>

1641

</tr></tbody>

1642

</table></div>

1647

is not a valid <a class="link" href="GFile.html" title="GFile">GFile</a>, otherwise an

1648

integer that can be used as hash value for the <a class="link" href="GFile.html" title="GFile">GFile</a>.

1649

This function is intended for easily hashing a <a class="link" href="GFile.html" title="GFile">GFile</a> to

1650

add to a <a href="../glib/glib-Hash-Tables.html#GHashTable">GHashTable</a> or similar data structure.

1650

add to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Hash-Tables.html#GHashTable">GHashTable</a> or similar data structure.

1651

1652

</div>

1653

</div>

1654

<hr>

1655

1656

<a name="g-file-equal"></a><h3>g_file_equal ()</h3>

1657

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

1657

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

1658

g_file_equal (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file1</code>,

1659

<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file2</code>);</pre>

1660

Checks equality of two given <a href="GFile.html">GFiles</a>.

1686

</div>

1687

1688

<a name="id-1.4.2.2.9.13.8"></a><h4>Returns</h4>

1689

1689

1690

and <code>file2</code>

1691

are equal.

1692

<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if either is not a <a class="link" href="GFile.html" title="GFile">GFile</a>.

1692

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if either is not a <a class="link" href="GFile.html" title="GFile">GFile</a>.

1693

1694

</div>

1695

</div>

1725

</div>

1726

1727

<a name="id-1.4.2.2.9.14.9"></a><h4>Returns</h4>

1728

string containing the <a class="link" href="GFile.html" title="GFile">GFile</a>'s base name, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

1728

string containing the <a class="link" href="GFile.html" title="GFile">GFile</a>'s base name, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

1729

if given <a class="link" href="GFile.html" title="GFile">GFile</a> is invalid. The returned string should be

1730

freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer needed.

1730

freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer needed.

1731

1732

</div>

1733

</div>

1755

</div>

1756

1757

<a name="id-1.4.2.2.9.15.7"></a><h4>Returns</h4>

1758

string containing the <a class="link" href="GFile.html" title="GFile">GFile</a>'s path, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

1758

string containing the <a class="link" href="GFile.html" title="GFile">GFile</a>'s path, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if

1759

no such path exists. The returned string should be

1760

freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer needed.

1760

freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer needed.

1761

1762

</div>

1763

</div>

1787

1788

<a name="id-1.4.2.2.9.16.7"></a><h4>Returns</h4>

1789

a string containing the <a class="link" href="GFile.html" title="GFile">GFile</a>'s URI.

1790

The returned string should be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>

1790

The returned string should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>

1791

when no longer needed.

1792

1793

</div>

1827

1828

<a name="id-1.4.2.2.9.17.9"></a><h4>Returns</h4>

1829

a string containing the <a class="link" href="GFile.html" title="GFile">GFile</a>'s parse name.

1830

The returned string should be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>

1830

The returned string should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>

1831

when no longer needed.

1832

1833

</div>

1841

.

1842

If the <code>file</code>

1843

represents the root directory of the

1844

file system, then <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned.

1844

file system, then <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned.

1845

This call does no blocking I/O.

1846

1847

<a name="id-1.4.2.2.9.18.6"></a><h4>Parameters</h4>

1861

1862

<a name="id-1.4.2.2.9.18.7"></a><h4>Returns</h4>

1863

a <a class="link" href="GFile.html" title="GFile">GFile</a> structure to the

1864

parent of the given <a class="link" href="GFile.html" title="GFile">GFile</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there is

1865

no parent. Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

1864

parent of the given <a class="link" href="GFile.html" title="GFile">GFile</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there is

1865

no parent. Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

1866

[<acronym title="Free data after the code is done.">transfer full</acronym>]

1867

</div>

1868

</div>

1869

<hr>

1870

1871

<a name="g-file-has-parent"></a><h3>g_file_has_parent ()</h3>

1872

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

1872

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

1873

g_file_has_parent (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

1874

<code><a class="link" href="GFile.html" title="GFile">GFile</a> *parent</code>);</pre>

1875

Checks if <code>file</code>

1876

has a parent, and optionally, if it is <code>parent</code>

1877

.

1878

If <code>parent</code>

1879

is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then this function returns <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <code>file</code>

1879

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <code>file</code>

1880

has any

1881

parent at all. If <code>parent</code>

1882

is non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is only returned

1882

is non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is only returned

1883

if <code>file</code>

1884

is a child of <code>parent</code>

1885

.

1899

</tr>

1900

<tr>

1901

<td class="parameter_name">parent</td>

1902

<td class="parameter_description"> the parent to check for, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

1902

<td class="parameter_description"> the parent to check for, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

1903

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

1904

</tr>

1905

</tbody>

1907

</div>

1908

1909

<a name="id-1.4.2.2.9.19.7"></a><h4>Returns</h4>

1910

1910

1911

is a child of <code>parent</code>

1912

(or any parent in the

1913

case that <code>parent</code>

1914

is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>).

1914

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>).

1915

1916

</div>

1917

Since 2.24

1955

<a name="id-1.4.2.2.9.20.8"></a><h4>Returns</h4>

1956

a <a class="link" href="GFile.html" title="GFile">GFile</a> to a child specified by <code>name</code>

1957

.

1958

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

1958

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

1959

[<acronym title="Free data after the code is done.">transfer full</acronym>]

1960

</div>

1961

</div>

1965

<pre class="programlisting"><a class="link" href="GFile.html" title="GFile">GFile</a> *

1966

g_file_get_child_for_display_name (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

1967

<code>const char *display_name</code>,

1968

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

1968

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

1969

Gets the child of <code>file</code>

1970

for a given <code>display_name</code>

1971

(i.e. a UTF-8

1972

version of the name). If this function fails, it returns <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

1972

version of the name). If this function fails, it returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

1973

and <code>error</code>

1974

will be set. This is very useful when constructing a

1975

<a class="link" href="GFile.html" title="GFile">GFile</a> for a new file and the user entered the filename in the

2006

2007

<a name="id-1.4.2.2.9.21.7"></a><h4>Returns</h4>

2008

a <a class="link" href="GFile.html" title="GFile">GFile</a> to the specified child, or

2009

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the display name couldn't be converted.

2010

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

2009

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the display name couldn't be converted.

2010

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

2011

[<acronym title="Free data after the code is done.">transfer full</acronym>]

2012

</div>

2013

</div>

2014

<hr>

2015

2016

<a name="g-file-has-prefix"></a><h3>g_file_has_prefix ()</h3>

2017

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

2017

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

2018

g_file_has_prefix (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

2019

<code><a class="link" href="GFile.html" title="GFile">GFile</a> *prefix</code>);</pre>

2020

Checks whether <code>file</code>

2027

so a path like /foo is not considered a prefix of /foobar, only

2028

of /foo/bar.

2029

This call does no I/O, as it works purely on names. As such it can

2030

sometimes return <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> even if <code>file</code>

2030

sometimes return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> even if <code>file</code>

2031

is inside a <code>prefix</code>

2032

(from a

2033

filesystem point of view), because the prefix of <code>file</code>

2059

</div>

2060

2061

<a name="id-1.4.2.2.9.22.9"></a><h4>Returns</h4>

2062

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <code>files</code>

2062

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <code>files</code>

2063

's parent, grandparent, etc is <code>prefix</code>

2064

,

2065

<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

2065

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

2066

2067

</div>

2068

</div>

2102

<a name="id-1.4.2.2.9.23.7"></a><h4>Returns</h4>

2103

string with the relative path from <code>descendant</code>

2104

to <code>parent</code>

2105

, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>descendant</code>

2105

, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>descendant</code>

2106

doesn't have <code>parent</code>

2107

as prefix. The returned string should be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>

2107

as prefix. The returned string should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>

2108

when no longer needed.

2109

2110

</div>

2143

2144

<a name="id-1.4.2.2.9.24.7"></a><h4>Returns</h4>

2145

<a class="link" href="GFile.html" title="GFile">GFile</a> to the resolved path.

2146

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>relative_path</code>

2147

is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or if <code>file</code>

2146

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <code>relative_path</code>

2147

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or if <code>file</code>

2148

is invalid.

2149

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

2149

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

2150

[<acronym title="Free data after the code is done.">transfer full</acronym>]

2151

</div>

2152

</div>

2153

<hr>

2154

2155

<a name="g-file-is-native"></a><h3>g_file_is_native ()</h3>

2156

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

2156

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

2157

g_file_is_native (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>);</pre>

2158

Checks to see if a file is native to the platform.

2159

A native file s one expressed in the platform-native filename format,

2161

as it might be on a locally mounted remote filesystem.

2162

On some systems non-native files may be available using the native

2163

filesystem via a userspace filesystem (FUSE), in these cases this call

2164

will return <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, but <a class="link" href="GFile.html#g-file-get-path" title="g_file_get_path ()"><code class="function">g_file_get_path()</code></a> will still return a native path.

2164

will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, but <a class="link" href="GFile.html#g-file-get-path" title="g_file_get_path ()"><code class="function">g_file_get_path()</code></a> will still return a native path.

2165

This call does no blocking I/O.

2166

2167

<a name="id-1.4.2.2.9.25.8"></a><h4>Parameters</h4>

2180

</div>

2181

2182

<a name="id-1.4.2.2.9.25.9"></a><h4>Returns</h4>

2183

2183

2184

is native

2185

2186

</div>

2188

<hr>

2189

2190

<a name="g-file-has-uri-scheme"></a><h3>g_file_has_uri_scheme ()</h3>

2191

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

2191

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

2192

g_file_has_uri_scheme (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

2193

<code>const char *uri_scheme</code>);</pre>

2194

Checks to see if a <a class="link" href="GFile.html" title="GFile">GFile</a> has a given URI scheme.

2217

</div>

2218

2219

<a name="id-1.4.2.2.9.26.7"></a><h4>Returns</h4>

2220

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <a class="link" href="GFile.html" title="GFile">GFile</a>'s backend supports the

2221

given URI scheme, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if URI scheme is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>,

2220

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <a class="link" href="GFile.html" title="GFile">GFile</a>'s backend supports the

2221

given URI scheme, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if URI scheme is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>,

2222

not supported, or <a class="link" href="GFile.html" title="GFile">GFile</a> is invalid.

2223

2224

</div>

2262

2263

<a name="id-1.4.2.2.9.27.9"></a><h4>Returns</h4>

2264

a string containing the URI scheme for the given

2265

<a class="link" href="GFile.html" title="GFile">GFile</a>. The returned string should be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>

2265

<a class="link" href="GFile.html" title="GFile">GFile</a>. The returned string should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>

2266

when no longer needed.

2267

2268

</div>

2273

<pre class="programlisting"><a class="link" href="GFileInputStream.html" title="GFileInputStream">GFileInputStream</a> *

2274

g_file_read (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

2275

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

2276

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

2276

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

2277

Opens a file for reading. The result is a <a class="link" href="GFileInputStream.html" title="GFileInputStream">GFileInputStream</a> that

2278

can be used to read the contents of the file.

2279

If <code>cancellable</code>

2280

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

2280

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

2281

triggering the cancellable object from another thread. If the operation

2282

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

2283

If the file does not exist, the <a class="link" href="gio-GIOError.html#G-IO-ERROR-NOT-FOUND:CAPS"><code class="literal">G_IO_ERROR_NOT_FOUND</code></a> error will be

2306

</tr>

2307

<tr>

2308

<td class="parameter_name">error</td>

2309

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2309

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2310

2311

</tr>

2312

</tbody>

2314

</div>

2315

2316

<a name="id-1.4.2.2.9.28.9"></a><h4>Returns</h4>

2317

<a class="link" href="GFileInputStream.html" title="GFileInputStream">GFileInputStream</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

2318

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

2317

<a class="link" href="GFileInputStream.html" title="GFileInputStream">GFileInputStream</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

2318

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

2319

[<acronym title="Free data after the code is done.">transfer full</acronym>]

2320

</div>

2321

</div>

2327

<code>int io_priority</code>,

2328

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

2329

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

2330

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

2330

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

2331

Asynchronously opens <code>file</code>

2332

for reading.

2333

For more details, see <a class="link" href="GFile.html#g-file-read" title="g_file_read ()"><code class="function">g_file_read()</code></a> which is

2358

<tr>

2359

<td class="parameter_name">cancellable</td>

2360

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

2361

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

2361

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

2362

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

2363

</tr>

2364

<tr>

2382

<pre class="programlisting"><a class="link" href="GFileInputStream.html" title="GFileInputStream">GFileInputStream</a> *

2383

g_file_read_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

2384

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *res</code>,

2385

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

2385

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

2386

Finishes an asynchronous file read operation started with

2387

<a class="link" href="GFile.html#g-file-read-async" title="g_file_read_async ()"><code class="function">g_file_read_async()</code></a>.

2388

2406

</tr>

2407

<tr>

2408

<td class="parameter_name">error</td>

2409

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2409

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2410

2411

</tr>

2412

</tbody>

2414

</div>

2415

2416

<a name="id-1.4.2.2.9.30.6"></a><h4>Returns</h4>

2417

a <a class="link" href="GFileInputStream.html" title="GFileInputStream">GFileInputStream</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

2418

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

2417

a <a class="link" href="GFileInputStream.html" title="GFileInputStream">GFileInputStream</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

2418

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

2419

[<acronym title="Free data after the code is done.">transfer full</acronym>]

2420

</div>

2421

</div>

2426

g_file_append_to (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

2427

<code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags">GFileCreateFlags</a> flags</code>,

2428

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

2429

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

2429

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

2430

Gets an output stream for appending data to the file.

2431

If the file doesn't already exist it is created.

2432

By default files created are generally readable by everyone,

2435

will be made readable only to the current user, to the level that

2436

is supported on the target filesystem.

2437

If <code>cancellable</code>

2438

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled

2438

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled

2439

by triggering the cancellable object from another thread. If the

2440

operation was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be

2441

returned.

2465

<tr>

2466

<td class="parameter_name">cancellable</td>

2467

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

2468

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

2468

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

2469

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

2470

</tr>

2471

<tr>

2472

<td class="parameter_name">error</td>

2473

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2473

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2474

2475

</tr>

2476

</tbody>

2478

</div>

2479

2480

<a name="id-1.4.2.2.9.31.9"></a><h4>Returns</h4>

2481

a <a class="link" href="GFileOutputStream.html" title="GFileOutputStream">GFileOutputStream</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

2482

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

2481

a <a class="link" href="GFileOutputStream.html" title="GFileOutputStream">GFileOutputStream</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

2482

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

2483

[<acronym title="Free data after the code is done.">transfer full</acronym>]

2484

</div>

2485

</div>

2490

g_file_create (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

2491

<code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags">GFileCreateFlags</a> flags</code>,

2492

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

2493

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

2493

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

2494

Creates a new file and returns an output stream for writing to it.

2495

The file must not already exist.

2496

By default files created are generally readable by everyone,

2499

will be made readable only to the current user, to the level

2500

that is supported on the target filesystem.

2501

If <code>cancellable</code>

2502

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled

2502

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled

2503

by triggering the cancellable object from another thread. If the

2504

operation was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be

2505

returned.

2531

<tr>

2532

<td class="parameter_name">cancellable</td>

2533

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

2534

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

2534

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

2535

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

2536

</tr>

2537

<tr>

2538

<td class="parameter_name">error</td>

2539

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2539

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2540

2541

</tr>

2542

</tbody>

2545

2546

<a name="id-1.4.2.2.9.32.9"></a><h4>Returns</h4>

2547

a <a class="link" href="GFileOutputStream.html" title="GFileOutputStream">GFileOutputStream</a> for the newly created

2548

file, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

2549

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

2548

file, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

2549

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

2550

[<acronym title="Free data after the code is done.">transfer full</acronym>]

2551

</div>

2552

</div>

2556

<pre class="programlisting"><a class="link" href="GFileOutputStream.html" title="GFileOutputStream">GFileOutputStream</a> *

2557

g_file_replace (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

2558

<code>const char *etag</code>,

2559

<code><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a> make_backup</code>,

2559

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> make_backup</code>,

2560

<code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags">GFileCreateFlags</a> flags</code>,

2561

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

2562

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

2562

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

2563

Returns an output stream for overwriting the file, possibly

2564

creating a backup copy of the file first. If the file doesn't exist,

2565

it will be created.

2574

will be made readable only to the current user, to the level that

2575

is supported on the target filesystem.

2576

If <code>cancellable</code>

2577

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled

2577

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled

2578

by triggering the cancellable object from another thread. If the

2579

operation was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be

2580

returned.

2581

If you pass in a non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> <code>etag</code>

2581

If you pass in a non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> <code>etag</code>

2582

value, then this value is

2583

compared to the current entity tag of the file, and if they differ

2584

an <a class="link" href="gio-GIOError.html#G-IO-ERROR-WRONG-ETAG:CAPS"><code class="literal">G_IO_ERROR_WRONG_ETAG</code></a> error is returned. This generally means

2588

a new file you can use <a class="link" href="GFileInputStream.html#g-file-input-stream-query-info" title="g_file_input_stream_query_info ()"><code class="function">g_file_input_stream_query_info()</code></a> to get

2589

the etag of the file.

2590

If <code>make_backup</code>

2591

is <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, this function will attempt to make a

2591

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, this function will attempt to make a

2592

backup of the current file before overwriting it. If this fails

2593

a <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANT-CREATE-BACKUP:CAPS"><code class="literal">G_IO_ERROR_CANT_CREATE_BACKUP</code></a> error will be returned. If you

2594

want to replace anyway, try again with <code>make_backup</code>

2595

set to <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.

2595

set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.

2596

If the file is a directory the <a class="link" href="gio-GIOError.html#G-IO-ERROR-IS-DIRECTORY:CAPS"><code class="literal">G_IO_ERROR_IS_DIRECTORY</code></a> error will

2597

be returned, and if the file is some other form of non-regular file

2598

then a <a class="link" href="gio-GIOError.html#G-IO-ERROR-NOT-REGULAR-FILE:CAPS"><code class="literal">G_IO_ERROR_NOT_REGULAR_FILE</code></a> error will be returned. Some

2617

<tr>

2618

2619

<td class="parameter_description"> an optional <a class="link" href="GFile.html#gfile-etag" title="Entity Tags">entity tag</a>

2620

for the current <a class="link" href="GFile.html" title="GFile">GFile</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a> to ignore. </td>

2620

for the current <a class="link" href="GFile.html" title="GFile">GFile</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a> to ignore. </td>

2621

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

2622

</tr>

2623

<tr>

2624

<td class="parameter_name">make_backup</td>

2625

<td class="parameter_description"><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a backup should be created</td>

2625

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a backup should be created</td>

2626

2627

</tr>

2628

<tr>

2633

<tr>

2634

<td class="parameter_name">cancellable</td>

2635

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

2636

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

2636

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

2637

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

2638

</tr>

2639

<tr>

2640

<td class="parameter_name">error</td>

2641

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2641

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2642

2643

</tr>

2644

</tbody>

2646

</div>

2647

2648

<a name="id-1.4.2.2.9.33.12"></a><h4>Returns</h4>

2649

a <a class="link" href="GFileOutputStream.html" title="GFileOutputStream">GFileOutputStream</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

2650

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

2649

a <a class="link" href="GFileOutputStream.html" title="GFileOutputStream">GFileOutputStream</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

2650

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

2651

[<acronym title="Free data after the code is done.">transfer full</acronym>]

2652

</div>

2653

</div>

2660

<code>int io_priority</code>,

2661

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

2662

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

2663

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

2663

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

2664

Asynchronously opens <code>file</code>

2665

for appending.

2666

For more details, see <a class="link" href="GFile.html#g-file-append-to" title="g_file_append_to ()"><code class="function">g_file_append_to()</code></a> which is

2696

<tr>

2697

<td class="parameter_name">cancellable</td>

2698

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

2699

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

2699

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

2700

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

2701

</tr>

2702

<tr>

2720

<pre class="programlisting"><a class="link" href="GFileOutputStream.html" title="GFileOutputStream">GFileOutputStream</a> *

2721

g_file_append_to_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

2722

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *res</code>,

2723

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

2723

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

2724

Finishes an asynchronous file append operation started with

2725

<a class="link" href="GFile.html#g-file-append-to-async" title="g_file_append_to_async ()"><code class="function">g_file_append_to_async()</code></a>.

2726

2744

</tr>

2745

<tr>

2746

<td class="parameter_name">error</td>

2747

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2747

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2748

2749

</tr>

2750

</tbody>

2753

2754

<a name="id-1.4.2.2.9.35.6"></a><h4>Returns</h4>

2755

a valid <a class="link" href="GFileOutputStream.html" title="GFileOutputStream">GFileOutputStream</a>

2756

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

2757

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

2756

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

2757

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

2758

[<acronym title="Free data after the code is done.">transfer full</acronym>]

2759

</div>

2760

</div>

2767

<code>int io_priority</code>,

2768

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

2769

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

2770

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

2770

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

2771

Asynchronously creates a new file and returns an output stream

2772

for writing to it. The file must not already exist.

2773

For more details, see <a class="link" href="GFile.html#g-file-create" title="g_file_create ()"><code class="function">g_file_create()</code></a> which is

2803

<tr>

2804

<td class="parameter_name">cancellable</td>

2805

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

2806

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

2806

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

2807

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

2808

</tr>

2809

<tr>

2827

<pre class="programlisting"><a class="link" href="GFileOutputStream.html" title="GFileOutputStream">GFileOutputStream</a> *

2828

g_file_create_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

2829

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *res</code>,

2830

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

2830

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

2831

Finishes an asynchronous file create operation started with

2832

<a class="link" href="GFile.html#g-file-create-async" title="g_file_create_async ()"><code class="function">g_file_create_async()</code></a>.

2833

2851

</tr>

2852

<tr>

2853

<td class="parameter_name">error</td>

2854

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2854

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2855

2856

</tr>

2857

</tbody>

2859

</div>

2860

2861

<a name="id-1.4.2.2.9.37.6"></a><h4>Returns</h4>

2862

a <a class="link" href="GFileOutputStream.html" title="GFileOutputStream">GFileOutputStream</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

2863

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

2862

a <a class="link" href="GFileOutputStream.html" title="GFileOutputStream">GFileOutputStream</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

2863

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

2864

[<acronym title="Free data after the code is done.">transfer full</acronym>]

2865

</div>

2866

</div>

2870

<pre class="programlisting">void

2871

g_file_replace_async (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

2872

<code>const char *etag</code>,

2873

<code><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a> make_backup</code>,

2873

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> make_backup</code>,

2874

<code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags">GFileCreateFlags</a> flags</code>,

2875

<code>int io_priority</code>,

2876

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

2877

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

2878

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

2878

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

2879

Asynchronously overwrites the file, replacing the contents,

2880

possibly creating a backup copy of the file first.

2881

For more details, see <a class="link" href="GFile.html#g-file-replace" title="g_file_replace ()"><code class="function">g_file_replace()</code></a> which is

2901

<tr>

2902

2903

<td class="parameter_description"> an <a class="link" href="GFile.html#gfile-etag" title="Entity Tags">entity tag</a> for the current <a class="link" href="GFile.html" title="GFile">GFile</a>,

2904

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

2904

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

2905

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

2906

</tr>

2907

<tr>

2908

<td class="parameter_name">make_backup</td>

2909

<td class="parameter_description"><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a backup should be created</td>

2909

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a backup should be created</td>

2910

2911

</tr>

2912

<tr>

2922

<tr>

2923

<td class="parameter_name">cancellable</td>

2924

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

2925

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

2925

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

2926

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

2927

</tr>

2928

<tr>

2946

<pre class="programlisting"><a class="link" href="GFileOutputStream.html" title="GFileOutputStream">GFileOutputStream</a> *

2947

g_file_replace_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

2948

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *res</code>,

2949

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

2949

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

2950

Finishes an asynchronous file replace operation started with

2951

<a class="link" href="GFile.html#g-file-replace-async" title="g_file_replace_async ()"><code class="function">g_file_replace_async()</code></a>.

2952

2970

</tr>

2971

<tr>

2972

<td class="parameter_name">error</td>

2973

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2973

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

2974

2975

</tr>

2976

</tbody>

2978

</div>

2979

2980

<a name="id-1.4.2.2.9.39.6"></a><h4>Returns</h4>

2981

a <a class="link" href="GFileOutputStream.html" title="GFileOutputStream">GFileOutputStream</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

2982

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

2981

a <a class="link" href="GFileOutputStream.html" title="GFileOutputStream">GFileOutputStream</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

2982

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

2983

[<acronym title="Free data after the code is done.">transfer full</acronym>]

2984

</div>

2985

</div>

2991

<code>const char *attributes</code>,

2992

<code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags">GFileQueryInfoFlags</a> flags</code>,

2993

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

2994

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

2994

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

2995

Gets the requested information about specified <code>file</code>

2996

.

2997

The result is a <a class="link" href="GFileInfo.html" title="GFileInfo">GFileInfo</a> object that contains key-value

3009

The standard attributes are available as defines, like

3010

<a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-NAME:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_NAME">G_FILE_ATTRIBUTE_STANDARD_NAME</a>.

3011

If <code>cancellable</code>

3012

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled

3012

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled

3013

by triggering the cancellable object from another thread. If the

3014

operation was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be

3015

returned.

3050

<tr>

3051

<td class="parameter_name">cancellable</td>

3052

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

3053

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

3053

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

3054

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

3055

</tr>

3056

<tr>

3057

<td class="parameter_name">error</td>

3058

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a></td>

3058

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a></td>

3059

3060

</tr>

3061

</tbody>

3064

3065

<a name="id-1.4.2.2.9.40.10"></a><h4>Returns</h4>

3066

a <a class="link" href="GFileInfo.html" title="GFileInfo">GFileInfo</a> for the given <code>file</code>

3067

, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

3068

on error. Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

3067

, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

3068

on error. Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

3069

[<acronym title="Free data after the code is done.">transfer full</acronym>]

3070

</div>

3071

</div>

3079

<code>int io_priority</code>,

3080

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

3081

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

3082

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

3082

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

3083

Asynchronously gets the requested information about specified <code>file</code>

3084

.

3085

The result is a <a class="link" href="GFileInfo.html" title="GFileInfo">GFileInfo</a> object that contains key-value attributes

3121

<tr>

3122

<td class="parameter_name">cancellable</td>

3123

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

3124

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

3124

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

3125

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

3126

</tr>

3127

<tr>

3145

<pre class="programlisting"><a class="link" href="GFileInfo.html" title="GFileInfo">GFileInfo</a> *

3146

g_file_query_info_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

3147

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *res</code>,

3148

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

3148

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

3149

Finishes an asynchronous file info query.

3150

See <a class="link" href="GFile.html#g-file-query-info-async" title="g_file_query_info_async ()"><code class="function">g_file_query_info_async()</code></a>.

3151

3169

</tr>

3170

<tr>

3171

<td class="parameter_name">error</td>

3172

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a></td>

3172

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a></td>

3173

3174

</tr>

3175

</tbody>

3178

3179

<a name="id-1.4.2.2.9.42.6"></a><h4>Returns</h4>

3180

<a class="link" href="GFileInfo.html" title="GFileInfo">GFileInfo</a> for given <code>file</code>

3181

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. Free the returned object with

3182

<a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

3181

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. Free the returned object with

3182

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

3183

[<acronym title="Free data after the code is done.">transfer full</acronym>]

3184

</div>

3185

</div>

3186

<hr>

3187

3188

<a name="g-file-query-exists"></a><h3>g_file_query_exists ()</h3>

3189

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

3189

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

3190

g_file_query_exists (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

3191

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>);</pre>

3192

Utility function to check if a particular file exists. This is

3225

<tr>

3226

<td class="parameter_name">cancellable</td>

3227

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

3228

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

3228

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

3229

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

3230

</tr>

3231

</tbody>

3233

</div>

3234

3235

<a name="id-1.4.2.2.9.43.9"></a><h4>Returns</h4>

3236

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the file exists (and can be detected without error),

3237

<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise (or if cancelled).

3236

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the file exists (and can be detected without error),

3237

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise (or if cancelled).

3238

3239

</div>

3240

</div>

3271

<tr>

3272

<td class="parameter_name">cancellable</td>

3273

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

3274

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

3274

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

3275

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

3276

</tr>

3277

</tbody>

3292

g_file_query_filesystem_info (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

3293

<code>const char *attributes</code>,

3294

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

3295

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

3295

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

3296

Similar to <a class="link" href="GFile.html#g-file-query-info" title="g_file_query_info ()"><code class="function">g_file_query_info()</code></a>, but obtains information

3297

about the filesystem the <code>file</code>

3298

is on, rather than the file itself.

3312

in bytes), <a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-FILESYSTEM-FREE:CAPS" title="G_FILE_ATTRIBUTE_FILESYSTEM_FREE">G_FILE_ATTRIBUTE_FILESYSTEM_FREE</a> (number of bytes available),

3313

and <a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-FILESYSTEM-TYPE:CAPS" title="G_FILE_ATTRIBUTE_FILESYSTEM_TYPE">G_FILE_ATTRIBUTE_FILESYSTEM_TYPE</a> (type of the filesystem).

3314

If <code>cancellable</code>

3315

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled

3315

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled

3316

by triggering the cancellable object from another thread. If the

3317

operation was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be

3318

returned.

3341

<tr>

3342

<td class="parameter_name">cancellable</td>

3343

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

3344

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

3344

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

3345

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

3346

</tr>

3347

<tr>

3348

<td class="parameter_name">error</td>

3349

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a></td>

3349

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a></td>

3350

3351

</tr>

3352

</tbody>

3354

</div>

3355

3356

<a name="id-1.4.2.2.9.45.9"></a><h4>Returns</h4>

3357

a <a class="link" href="GFileInfo.html" title="GFileInfo">GFileInfo</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there was an error.

3358

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

3357

a <a class="link" href="GFileInfo.html" title="GFileInfo">GFileInfo</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there was an error.

3358

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

3359

[<acronym title="Free data after the code is done.">transfer full</acronym>]

3360

</div>

3361

</div>

3368

<code>int io_priority</code>,

3369

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

3370

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

3371

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

3371

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

3372

Asynchronously gets the requested information about the filesystem

3373

that the specified <code>file</code>

3374

is on. The result is a <a class="link" href="GFileInfo.html" title="GFileInfo">GFileInfo</a> object

3407

<tr>

3408

<td class="parameter_name">cancellable</td>

3409

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

3410

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

3410

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

3411

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

3412

</tr>

3413

<tr>

3431

<pre class="programlisting"><a class="link" href="GFileInfo.html" title="GFileInfo">GFileInfo</a> *

3432

g_file_query_filesystem_info_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

3433

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *res</code>,

3434

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

3434

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

3435

Finishes an asynchronous filesystem info query.

3436

See <a class="link" href="GFile.html#g-file-query-filesystem-info-async" title="g_file_query_filesystem_info_async ()"><code class="function">g_file_query_filesystem_info_async()</code></a>.

3437

3455

</tr>

3456

<tr>

3457

<td class="parameter_name">error</td>

3458

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a></td>

3458

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a></td>

3459

3460

</tr>

3461

</tbody>

3464

3465

<a name="id-1.4.2.2.9.47.6"></a><h4>Returns</h4>

3466

<a class="link" href="GFileInfo.html" title="GFileInfo">GFileInfo</a> for given <code>file</code>

3467

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

3468

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

3467

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

3468

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

3469

[<acronym title="Free data after the code is done.">transfer full</acronym>]

3470

</div>

3471

</div>

3475

<pre class="programlisting"><a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> *

3476

g_file_query_default_handler (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

3477

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

3478

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

3478

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

3479

Returns the <a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> that is registered as the default

3480

application to handle the file specified by <code>file</code>

3481

.

3482

If <code>cancellable</code>

3483

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

3483

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

3484

triggering the cancellable object from another thread. If the operation

3485

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

3486

3499

</tr>

3500

<tr>

3501

<td class="parameter_name">cancellable</td>

3502

<td class="parameter_description">optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore</td>

3502

<td class="parameter_description">optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore</td>

3503

3504

</tr>

3505

<tr>

3506

<td class="parameter_name">error</td>

3507

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

3507

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

3508

3509

</tr>

3510

</tbody>

3513

3514

<a name="id-1.4.2.2.9.48.7"></a><h4>Returns</h4>

3515

a <a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a> if the handle was found,

3516

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there were errors.

3517

When you are done with it, release it with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

3516

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there were errors.

3517

When you are done with it, release it with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

3518

[<acronym title="Free data after the code is done.">transfer full</acronym>]

3519

</div>

3520

</div>

3521

<hr>

3522

3523

<a name="g-file-measure-disk-usage"></a><h3>g_file_measure_disk_usage ()</h3>

3524

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

3524

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

3525

g_file_measure_disk_usage (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

3526

<code><a class="link" href="GFile.html#GFileMeasureFlags" title="enum GFileMeasureFlags">GFileMeasureFlags</a> flags</code>,

3527

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

3528

<code><a class="link" href="GFile.html#GFileMeasureProgressCallback" title="GFileMeasureProgressCallback ()">GFileMeasureProgressCallback</a> progress_callback</code>,

3529

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> progress_data</code>,

3530

<code><a href="../glib/glib-Basic-Types.html#guint64">guint64</a> *disk_usage</code>,

3531

<code><a href="../glib/glib-Basic-Types.html#guint64">guint64</a> *num_dirs</code>,

3532

<code><a href="../glib/glib-Basic-Types.html#guint64">guint64</a> *num_files</code>,

3533

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

3529

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> progress_data</code>,

3530

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint64">guint64</a> *disk_usage</code>,

3531

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint64">guint64</a> *num_dirs</code>,

3532

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint64">guint64</a> *num_files</code>,

3533

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

3534

Recursively measures the disk usage of <code>file</code>

3535

.

3536

This is essentially an analog of the 'du' command, but it also

3542

.

3543

The returned size, <code>disk_usage</code>

3544

, is in bytes and should be formatted

3545

with <a href="../glib/glib-Miscellaneous-Utility-Functions.html#g-format-size"><code class="function">g_format_size()</code></a> in order to get something reasonable for showing

3545

with <a href="http://library.gnome.org/devel/glib/unstable/glib-Miscellaneous-Utility-Functions.html#g-format-size"><code class="function">g_format_size()</code></a> in order to get something reasonable for showing

3546

in a user interface.

3547

<code>progress_callback</code>

3548

and <code>progress_data</code>

3602

</tr>

3603

<tr>

3604

<td class="parameter_name">error</td>

3605

<td class="parameter_description"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, or a pointer to a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> <a href="../glib/glib-Error-Reporting.html#GError">GError</a> pointer. </td>

3605

<td class="parameter_description"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, or a pointer to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> pointer. </td>

3606

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

3607

</tr>

3608

</tbody>

3610

</div>

3611

3612

<a name="id-1.4.2.2.9.49.10"></a><h4>Returns</h4>

3613

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if successful, with the out parameters set.

3614

<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise, with <code>error</code>

3613

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if successful, with the out parameters set.

3614

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise, with <code>error</code>

3615

set.

3616

3617

</div>

3623

<pre class="programlisting">void

3624

g_file_measure_disk_usage_async (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

3625

<code><a class="link" href="GFile.html#GFileMeasureFlags" title="enum GFileMeasureFlags">GFileMeasureFlags</a> flags</code>,

3626

<code><a href="../glib/glib-Basic-Types.html#gint">gint</a> io_priority</code>,

3626

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> io_priority</code>,

3627

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

3628

<code><a class="link" href="GFile.html#GFileMeasureProgressCallback" title="GFileMeasureProgressCallback ()">GFileMeasureProgressCallback</a> progress_callback</code>,

3629

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> progress_data</code>,

3629

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> progress_data</code>,

3630

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

3631

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

3631

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

3632

Recursively measures the disk usage of <code>file</code>

3633

.

3634

This is the asynchronous version of <a class="link" href="GFile.html#g-file-measure-disk-usage" title="g_file_measure_disk_usage ()"><code class="function">g_file_measure_disk_usage()</code></a>. See

3691

<hr>

3692

3693

<a name="g-file-measure-disk-usage-finish"></a><h3>g_file_measure_disk_usage_finish ()</h3>

3694

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

3694

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

3695

g_file_measure_disk_usage_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

3696

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result</code>,

3697

<code><a href="../glib/glib-Basic-Types.html#guint64">guint64</a> *disk_usage</code>,

3698

<code><a href="../glib/glib-Basic-Types.html#guint64">guint64</a> *num_dirs</code>,

3699

<code><a href="../glib/glib-Basic-Types.html#guint64">guint64</a> *num_files</code>,

3700

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

3697

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint64">guint64</a> *disk_usage</code>,

3698

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint64">guint64</a> *num_dirs</code>,

3699

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint64">guint64</a> *num_files</code>,

3700

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

3701

Collects the results from an earlier call to

3702

<a class="link" href="GFile.html#g-file-measure-disk-usage-async" title="g_file_measure_disk_usage_async ()"><code class="function">g_file_measure_disk_usage_async()</code></a>. See <a class="link" href="GFile.html#g-file-measure-disk-usage" title="g_file_measure_disk_usage ()"><code class="function">g_file_measure_disk_usage()</code></a> for

3703

more information.

3737

</tr>

3738

<tr>

3739

<td class="parameter_name">error</td>

3740

<td class="parameter_description"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, or a pointer to a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> <a href="../glib/glib-Error-Reporting.html#GError">GError</a> pointer. </td>

3740

<td class="parameter_description"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, or a pointer to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> pointer. </td>

3741

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

3742

</tr>

3743

</tbody>

3745

</div>

3746

3747

<a name="id-1.4.2.2.9.51.6"></a><h4>Returns</h4>

3748

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if successful, with the out parameters set.

3749

<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise, with <code>error</code>

3748

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if successful, with the out parameters set.

3749

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise, with <code>error</code>

3750

set.

3751

3752

</div>

3758

<pre class="programlisting"><a class="link" href="GMount.html" title="GMount">GMount</a> *

3759

g_file_find_enclosing_mount (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

3760

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

3761

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

3761

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

3762

Gets a <a class="link" href="GMount.html" title="GMount">GMount</a> for the <a class="link" href="GFile.html" title="GFile">GFile</a>.

3763

If the <a class="link" href="GFile.html#GFileIface" title="struct GFileIface">GFileIface</a> for <code>file</code>

3764

does not have a mount (e.g.

3765

possibly a remote share), <code>error</code>

3766

will be set to <a class="link" href="gio-GIOError.html#G-IO-ERROR-NOT-FOUND:CAPS"><code class="literal">G_IO_ERROR_NOT_FOUND</code></a>

3767

and <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned.

3767

and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned.

3768

If <code>cancellable</code>

3769

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

3769

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

3770

triggering the cancellable object from another thread. If the operation

3771

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

3772

3786

<tr>

3787

<td class="parameter_name">cancellable</td>

3788

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

3789

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

3789

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

3790

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

3791

</tr>

3792

<tr>

3793

<td class="parameter_name">error</td>

3794

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a></td>

3794

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a></td>

3795

3796

</tr>

3797

</tbody>

3801

<a name="id-1.4.2.2.9.52.8"></a><h4>Returns</h4>

3802

a <a class="link" href="GMount.html" title="GMount">GMount</a> where the <code>file</code>

3803

is located

3804

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

3805

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

3804

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

3805

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

3806

[<acronym title="Free data after the code is done.">transfer full</acronym>]

3807

</div>

3808

</div>

3814

<code>int io_priority</code>,

3815

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

3816

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

3817

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

3817

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

3818

Asynchronously gets the mount for the file.

3819

For more details, see <a class="link" href="GFile.html#g-file-find-enclosing-mount" title="g_file_find_enclosing_mount ()"><code class="function">g_file_find_enclosing_mount()</code></a> which is

3820

the synchronous version of this call.

3844

<tr>

3845

<td class="parameter_name">cancellable</td>

3846

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

3847

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

3847

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

3848

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

3849

</tr>

3850

<tr>

3868

<pre class="programlisting"><a class="link" href="GMount.html" title="GMount">GMount</a> *

3869

g_file_find_enclosing_mount_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

3870

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *res</code>,

3871

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

3871

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

3872

Finishes an asynchronous find mount request.

3873

See <a class="link" href="GFile.html#g-file-find-enclosing-mount-async" title="g_file_find_enclosing_mount_async ()"><code class="function">g_file_find_enclosing_mount_async()</code></a>.

3874

3892

</tr>

3893

<tr>

3894

<td class="parameter_name">error</td>

3895

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a></td>

3895

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a></td>

3896

3897

</tr>

3898

</tbody>

3901

3902

<a name="id-1.4.2.2.9.54.6"></a><h4>Returns</h4>

3903

<a class="link" href="GMount.html" title="GMount">GMount</a> for given <code>file</code>

3904

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

3905

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

3904

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

3905

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

3906

[<acronym title="Free data after the code is done.">transfer full</acronym>]

3907

</div>

3908

</div>

3914

<code>const char *attributes</code>,

3915

<code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags">GFileQueryInfoFlags</a> flags</code>,

3916

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

3917

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

3917

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

3918

Gets the requested information about the files in a directory.

3919

The result is a <a class="link" href="GFileEnumerator.html" title="GFileEnumerator">GFileEnumerator</a> object that will give out

3920

<a class="link" href="GFileInfo.html" title="GFileInfo">GFileInfo</a> objects for all the files in the directory.

3931

The standard attributes are available as defines, like

3932

<a class="link" href="GFileInfo.html#G-FILE-ATTRIBUTE-STANDARD-NAME:CAPS" title="G_FILE_ATTRIBUTE_STANDARD_NAME">G_FILE_ATTRIBUTE_STANDARD_NAME</a>.

3933

If <code>cancellable</code>

3934

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled

3934

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled

3935

by triggering the cancellable object from another thread. If the

3936

operation was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be

3937

returned.

3965

<tr>

3966

<td class="parameter_name">cancellable</td>

3967

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

3968

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

3968

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

3969

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

3970

</tr>

3971

<tr>

3972

<td class="parameter_name">error</td>

3973

<td class="parameter_description"><a href="../glib/glib-Error-Reporting.html#GError">GError</a> for error reporting</td>

3973

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> for error reporting</td>

3974

3975

</tr>

3976

</tbody>

3979

3980

<a name="id-1.4.2.2.9.55.9"></a><h4>Returns</h4>

3981

A <a class="link" href="GFileEnumerator.html" title="GFileEnumerator">GFileEnumerator</a> if successful,

3982

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

3982

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

3983

[<acronym title="Free data after the code is done.">transfer full</acronym>]

3984

</div>

3985

</div>

3993

<code>int io_priority</code>,

3994

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

3995

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

3996

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

3996

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

3997

Asynchronously gets the requested information about the files

3998

in a directory. The result is a <a class="link" href="GFileEnumerator.html" title="GFileEnumerator">GFileEnumerator</a> object that will

3999

give out <a class="link" href="GFileInfo.html" title="GFileInfo">GFileInfo</a> objects for all the files in the directory.

4035

<tr>

4036

<td class="parameter_name">cancellable</td>

4037

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

4038

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4038

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4039

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

4040

</tr>

4041

<tr>

4059

<pre class="programlisting"><a class="link" href="GFileEnumerator.html" title="GFileEnumerator">GFileEnumerator</a> *

4060

g_file_enumerate_children_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

4061

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *res</code>,

4062

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

4062

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

4063

Finishes an async enumerate children operation.

4064

See <a class="link" href="GFile.html#g-file-enumerate-children-async" title="g_file_enumerate_children_async ()"><code class="function">g_file_enumerate_children_async()</code></a>.

4065

4083

</tr>

4084

<tr>

4085

<td class="parameter_name">error</td>

4086

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a></td>

4086

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a></td>

4087

4088

</tr>

4089

</tbody>

4091

</div>

4092

4093

<a name="id-1.4.2.2.9.57.6"></a><h4>Returns</h4>

4094

a <a class="link" href="GFileEnumerator.html" title="GFileEnumerator">GFileEnumerator</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

4094

a <a class="link" href="GFileEnumerator.html" title="GFileEnumerator">GFileEnumerator</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

4095

if an error occurred.

4096

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

4096

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

4097

[<acronym title="Free data after the code is done.">transfer full</acronym>]

4098

</div>

4099

</div>

4104

g_file_set_display_name (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

4105

<code>const char *display_name</code>,

4106

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

4107

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

4107

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

4108

Renames <code>file</code>

4109

to the specified display name.

4110

The display name is converted from UTF-8 to the correct encoding

4116

should be passed to <a class="link" href="GFile.html#g-file-set-display-name" title="g_file_set_display_name ()"><code class="function">g_file_set_display_name()</code></a>.

4117

On success the resulting converted filename is returned.

4118

If <code>cancellable</code>

4119

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

4119

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

4120

triggering the cancellable object from another thread. If the operation

4121

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

4122

4141

<tr>

4142

<td class="parameter_name">cancellable</td>

4143

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

4144

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4144

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4145

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

4146

</tr>

4147

<tr>

4148

<td class="parameter_name">error</td>

4149

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

4149

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

4150

4151

</tr>

4152

</tbody>

4156

<a name="id-1.4.2.2.9.58.10"></a><h4>Returns</h4>

4157

a <a class="link" href="GFile.html" title="GFile">GFile</a> specifying what <code>file</code>

4158

was renamed to,

4159

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there was an error.

4160

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

4159

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there was an error.

4160

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

4161

[<acronym title="Free data after the code is done.">transfer full</acronym>]

4162

</div>

4163

</div>

4170

<code>int io_priority</code>,

4171

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

4172

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

4173

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

4173

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

4174

Asynchronously sets the display name for a given <a class="link" href="GFile.html" title="GFile">GFile</a>.

4175

For more details, see <a class="link" href="GFile.html#g-file-set-display-name" title="g_file_set_display_name ()"><code class="function">g_file_set_display_name()</code></a> which is

4176

the synchronous version of this call.

4205

<tr>

4206

<td class="parameter_name">cancellable</td>

4207

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

4208

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4208

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4209

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

4210

</tr>

4211

<tr>

4229

<pre class="programlisting"><a class="link" href="GFile.html" title="GFile">GFile</a> *

4230

g_file_set_display_name_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

4231

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *res</code>,

4232

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

4232

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

4233

Finishes setting a display name started with

4234

<a class="link" href="GFile.html#g-file-set-display-name-async" title="g_file_set_display_name_async ()"><code class="function">g_file_set_display_name_async()</code></a>.

4235

4253

</tr>

4254

<tr>

4255

<td class="parameter_name">error</td>

4256

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

4256

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

4257

4258

</tr>

4259

</tbody>

4261

</div>

4262

4263

<a name="id-1.4.2.2.9.60.6"></a><h4>Returns</h4>

4264

a <a class="link" href="GFile.html" title="GFile">GFile</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

4265

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

4264

a <a class="link" href="GFile.html" title="GFile">GFile</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

4265

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

4266

[<acronym title="Free data after the code is done.">transfer full</acronym>]

4267

</div>

4268

</div>

4269

<hr>

4270

4271

<a name="g-file-delete"></a><h3>g_file_delete ()</h3>

4272

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

4272

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

4273

g_file_delete (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

4274

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

4275

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

4275

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

4276

Deletes a file. If the <code>file</code>

4277

is a directory, it will only be

4278

deleted if it is empty. This has the same semantics as <a href="../glib/glib-File-Utilities.html#g-unlink"><code class="function">g_unlink()</code></a>.

4278

deleted if it is empty. This has the same semantics as <a href="http://library.gnome.org/devel/glib/unstable/glib-File-Utilities.html#g-unlink"><code class="function">g_unlink()</code></a>.

4279

If <code>cancellable</code>

4280

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

4280

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

4281

triggering the cancellable object from another thread. If the operation

4282

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

4283

Virtual: delete_file

4298

<tr>

4299

<td class="parameter_name">cancellable</td>

4300

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

4301

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4301

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4302

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

4303

</tr>

4304

<tr>

4305

<td class="parameter_name">error</td>

4306

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

4306

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

4307

4308

</tr>

4309

</tbody>

4311

</div>

4312

4313

<a name="id-1.4.2.2.9.61.8"></a><h4>Returns</h4>

4314

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the file was deleted. <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

4314

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the file was deleted. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

4315

4316

</div>

4317

</div>

4323

<code>int io_priority</code>,

4324

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

4325

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

4326

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

4326

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

4327

Asynchronously delete a file. If the <code>file</code>

4328

is a directory, it will

4329

only be deleted if it is empty. This has the same semantics as

4330

<a href="../glib/glib-File-Utilities.html#g-unlink"><code class="function">g_unlink()</code></a>.

4330

<a href="http://library.gnome.org/devel/glib/unstable/glib-File-Utilities.html#g-unlink"><code class="function">g_unlink()</code></a>.

4331

Virtual: delete_file_async

4332

4333

<a name="id-1.4.2.2.9.62.6"></a><h4>Parameters</h4>

4351

<tr>

4352

<td class="parameter_name">cancellable</td>

4353

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

4354

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4354

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4355

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

4356

</tr>

4357

<tr>

4373

<hr>

4374

4375

<a name="g-file-delete-finish"></a><h3>g_file_delete_finish ()</h3>

4376

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

4376

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

4377

g_file_delete_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

4378

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result</code>,

4379

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

4379

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

4380

Finishes deleting a file started with <a class="link" href="GFile.html#g-file-delete-async" title="g_file_delete_async ()"><code class="function">g_file_delete_async()</code></a>.

4381

Virtual: delete_file_finish

4382

4400

</tr>

4401

<tr>

4402

<td class="parameter_name">error</td>

4403

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

4403

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

4404

4405

</tr>

4406

</tbody>

4408

</div>

4409

4410

<a name="id-1.4.2.2.9.63.7"></a><h4>Returns</h4>

4411

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the file was deleted. <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

4411

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the file was deleted. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

4412

4413

</div>

4414

Since 2.34

4416

<hr>

4417

4418

<a name="g-file-trash"></a><h3>g_file_trash ()</h3>

4419

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

4419

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

4420

g_file_trash (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

4421

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

4422

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

4422

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

4423

Sends <code>file</code>

4424

to the "Trashcan", if possible. This is similar to

4425

deleting it, but the user can recover it before emptying the trashcan.

4426

Not all file systems support trashing, so this call can return the

4427

<a class="link" href="gio-GIOError.html#G-IO-ERROR-NOT-SUPPORTED:CAPS"><code class="literal">G_IO_ERROR_NOT_SUPPORTED</code></a> error.

4428

If <code>cancellable</code>

4429

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

4429

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

4430

triggering the cancellable object from another thread. If the operation

4431

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

4432

Virtual: trash

4447

<tr>

4448

<td class="parameter_name">cancellable</td>

4449

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

4450

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4450

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4451

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

4452

</tr>

4453

<tr>

4454

<td class="parameter_name">error</td>

4455

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

4455

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

4456

4457

</tr>

4458

</tbody>

4460

</div>

4461

4462

<a name="id-1.4.2.2.9.64.8"></a><h4>Returns</h4>

4463

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on successful trash, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

4463

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on successful trash, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

4464

4465

</div>

4466

</div>

4472

<code>int io_priority</code>,

4473

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

4474

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

4475

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

4475

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

4476

Asynchronously sends <code>file</code>

4477

to the Trash location, if possible.

4478

Virtual: trash_async

4498

<tr>

4499

<td class="parameter_name">cancellable</td>

4500

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

4501

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4501

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4502

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

4503

</tr>

4504

<tr>

4520

<hr>

4521

4522

<a name="g-file-trash-finish"></a><h3>g_file_trash_finish ()</h3>

4523

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

4523

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

4524

g_file_trash_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

4525

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result</code>,

4526

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

4526

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

4527

Finishes an asynchronous file trashing operation, started with

4528

<a class="link" href="GFile.html#g-file-trash-async" title="g_file_trash_async ()"><code class="function">g_file_trash_async()</code></a>.

4529

Virtual: trash_finish

4548

</tr>

4549

<tr>

4550

<td class="parameter_name">error</td>

4551

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

4551

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

4552

4553

</tr>

4554

</tbody>

4556

</div>

4557

4558

<a name="id-1.4.2.2.9.66.7"></a><h4>Returns</h4>

4559

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on successful trash, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

4559

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on successful trash, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

4560

4561

</div>

4562

Since 2.38

4564

<hr>

4565

4566

4567

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

4567

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

4568

g_file_copy (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *source</code>,

4569

<code><a class="link" href="GFile.html" title="GFile">GFile</a> *destination</code>,

4570

<code><a class="link" href="GFile.html#GFileCopyFlags" title="enum GFileCopyFlags">GFileCopyFlags</a> flags</code>,

4571

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

4572

<code><a class="link" href="GFile.html#GFileProgressCallback" title="GFileProgressCallback ()">GFileProgressCallback</a> progress_callback</code>,

4573

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> progress_callback_data</code>,

4574

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

4573

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> progress_callback_data</code>,

4574

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

4575

Copies the file <code>source</code>

4576

to the location specified by <code>destination</code>

4577

.

4584

<code>source</code>

4585

symlink will be copied.

4586

If <code>cancellable</code>

4587

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

4587

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

4588

triggering the cancellable object from another thread. If the operation

4589

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

4590

If <code>progress_callback</code>

4591

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be monitored

4591

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be monitored

4592

by setting this to a <a class="link" href="GFile.html#GFileProgressCallback" title="GFileProgressCallback ()">GFileProgressCallback</a> function.

4593

<code>progress_callback_data</code>

4594

will be passed to this function. It is guaranteed

4635

<tr>

4636

<td class="parameter_name">cancellable</td>

4637

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

4638

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4638

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4639

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

4640

</tr>

4641

<tr>

4642

<td class="parameter_name">progress_callback</td>

4643

<td class="parameter_description"> function to callback with

4644

progress information, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if progress information is not needed. </td>

4644

progress information, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if progress information is not needed. </td>

4645

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>][<acronym title="The callback is valid only during the call to the method.">scope call</acronym>]</td>

4646

</tr>

4647

<tr>

4652

</tr>

4653

<tr>

4654

<td class="parameter_name">error</td>

4655

<td class="parameter_description"><a href="../glib/glib-Error-Reporting.html#GError">GError</a> to set on error, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

4655

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> to set on error, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

4656

4657

</tr>

4658

</tbody>

4660

</div>

4661

4662

<a name="id-1.4.2.2.9.67.15"></a><h4>Returns</h4>

4663

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

4663

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

4664

4665

</div>

4666

</div>

4674

<code>int io_priority</code>,

4675

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

4676

<code><a class="link" href="GFile.html#GFileProgressCallback" title="GFileProgressCallback ()">GFileProgressCallback</a> progress_callback</code>,

4677

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> progress_callback_data</code>,

4677

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> progress_callback_data</code>,

4678

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

4679

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

4679

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

4680

Copies the file <code>source</code>

4681

to the location specified by <code>destination</code>

4682

4683

asynchronously. For details of the behaviour, see <a class="link" href="GFile.html#g-file-copy" title="g_file_copy ()"><code class="function">g_file_copy()</code></a>.

4684

If <code>progress_callback</code>

4685

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then that function that will be called

4685

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then that function that will be called

4686

just like in <a class="link" href="GFile.html#g-file-copy" title="g_file_copy ()"><code class="function">g_file_copy()</code></a>, however the callback will run in the main loop,

4687

not in the thread that is doing the I/O operation.

4688

When the operation is finished, <code>callback</code>

4720

<tr>

4721

<td class="parameter_name">cancellable</td>

4722

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

4723

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4723

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4724

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

4725

</tr>

4726

<tr>

4727

<td class="parameter_name">progress_callback</td>

4728

<td class="parameter_description"> function to callback with progress

4729

information, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if progress information is not needed. </td>

4729

information, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if progress information is not needed. </td>

4730

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

4731

</tr>

4732

<tr>

4752

<hr>

4753

4754

<a name="g-file-copy-finish"></a><h3>g_file_copy_finish ()</h3>

4755

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

4755

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

4756

g_file_copy_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

4757

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *res</code>,

4758

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

4758

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

4759

Finishes copying the file started with <a class="link" href="GFile.html#g-file-copy-async" title="g_file_copy_async ()"><code class="function">g_file_copy_async()</code></a>.

4760

4761

<a name="id-1.4.2.2.9.69.5"></a><h4>Parameters</h4>

4778

</tr>

4779

<tr>

4780

<td class="parameter_name">error</td>

4781

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

4781

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

4782

4783

</tr>

4784

</tbody>

4786

</div>

4787

4788

<a name="id-1.4.2.2.9.69.6"></a><h4>Returns</h4>

4789

a <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error.

4789

a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on error.

4790

4791

</div>

4792

</div>

4793

<hr>

4794

4795

4796

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

4796

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

4797

g_file_move (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *source</code>,

4798

<code><a class="link" href="GFile.html" title="GFile">GFile</a> *destination</code>,

4799

<code><a class="link" href="GFile.html#GFileCopyFlags" title="enum GFileCopyFlags">GFileCopyFlags</a> flags</code>,

4800

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

4801

<code><a class="link" href="GFile.html#GFileProgressCallback" title="GFileProgressCallback ()">GFileProgressCallback</a> progress_callback</code>,

4802

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> progress_callback_data</code>,

4803

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

4802

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> progress_callback_data</code>,

4803

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

4804

Tries to move the file or directory <code>source</code>

4805

to the location specified

4806

by <code>destination</code>

4816

<code>source</code>

4817

symlink will be copied.

4818

If <code>cancellable</code>

4819

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

4819

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

4820

triggering the cancellable object from another thread. If the operation

4821

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

4822

If <code>progress_callback</code>

4823

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be monitored

4823

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be monitored

4824

by setting this to a <a class="link" href="GFile.html#GFileProgressCallback" title="GFileProgressCallback ()">GFileProgressCallback</a> function.

4825

<code>progress_callback_data</code>

4826

will be passed to this function. It is

4866

<tr>

4867

<td class="parameter_name">cancellable</td>

4868

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

4869

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4869

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4870

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

4871

</tr>

4872

<tr>

4883

</tr>

4884

<tr>

4885

<td class="parameter_name">error</td>

4886

<td class="parameter_description"><a href="../glib/glib-Error-Reporting.html#GError">GError</a> for returning error conditions, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

4886

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> for returning error conditions, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

4887

4888

</tr>

4889

</tbody>

4891

</div>

4892

4893

<a name="id-1.4.2.2.9.70.14"></a><h4>Returns</h4>

4894

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on successful move, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

4894

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on successful move, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

4895

4896

</div>

4897

</div>

4898

<hr>

4899

4900

<a name="g-file-make-directory"></a><h3>g_file_make_directory ()</h3>

4901

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

4901

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

4902

g_file_make_directory (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

4903

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

4904

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

4904

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

4905

Creates a directory. Note that this will only create a child directory

4906

of the immediate parent directory of the path or URI given by the <a class="link" href="GFile.html" title="GFile">GFile</a>.

4907

To recursively create directories, see <a class="link" href="GFile.html#g-file-make-directory-with-parents" title="g_file_make_directory_with_parents ()"><code class="function">g_file_make_directory_with_parents()</code></a>.

4914

For a local <a class="link" href="GFile.html" title="GFile">GFile</a> the newly created directory will have the default

4915

(current) ownership and permissions of the current process.

4916

If <code>cancellable</code>

4917

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

4917

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

4918

triggering the cancellable object from another thread. If the operation

4919

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

4920

4934

<tr>

4935

<td class="parameter_name">cancellable</td>

4936

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

4937

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4937

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4938

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

4939

</tr>

4940

<tr>

4941

<td class="parameter_name">error</td>

4942

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

4942

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

4943

4944

</tr>

4945

</tbody>

4947

</div>

4948

4949

<a name="id-1.4.2.2.9.71.8"></a><h4>Returns</h4>

4950

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on successful creation, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

4950

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on successful creation, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

4951

4952

</div>

4953

</div>

4959

<code>int io_priority</code>,

4960

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

4961

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

4962

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

4962

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

4963

Asynchronously creates a directory.

4964

Virtual: make_directory_async

4965

4984

<tr>

4985

<td class="parameter_name">cancellable</td>

4986

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

4987

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4987

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

4988

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

4989

</tr>

4990

<tr>

5006

<hr>

5007

5008

<a name="g-file-make-directory-finish"></a><h3>g_file_make_directory_finish ()</h3>

5009

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

5009

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

5010

g_file_make_directory_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

5011

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result</code>,

5012

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5012

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5013

Finishes an asynchronous directory creation, started with

5014

<a class="link" href="GFile.html#g-file-make-directory-async" title="g_file_make_directory_async ()"><code class="function">g_file_make_directory_async()</code></a>.

5015

Virtual: make_directory_finish

5034

</tr>

5035

<tr>

5036

<td class="parameter_name">error</td>

5037

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5037

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5038

5039

</tr>

5040

</tbody>

5042

</div>

5043

5044

<a name="id-1.4.2.2.9.73.7"></a><h4>Returns</h4>

5045

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on successful directory creation, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

5045

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on successful directory creation, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

5046

5047

</div>

5048

Since 2.38

5050

<hr>

5051

5052

<a name="g-file-make-directory-with-parents"></a><h3>g_file_make_directory_with_parents ()</h3>

5053

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

5053

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

5054

g_file_make_directory_with_parents (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

5055

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

5056

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5056

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5057

Creates a directory and any parent directories that may not

5058

exist similar to 'mkdir -p'. If the file system does not support

5059

creating directories, this function will fail, setting <code>error</code>

5061

<a class="link" href="gio-GIOError.html#G-IO-ERROR-NOT-SUPPORTED:CAPS"><code class="literal">G_IO_ERROR_NOT_SUPPORTED</code></a>. If the directory itself already exists,

5062

this function will fail setting <code>error</code>

5063

to <a class="link" href="gio-GIOError.html#G-IO-ERROR-EXISTS:CAPS"><code class="literal">G_IO_ERROR_EXISTS</code></a>, unlike

5064

the similar <a href="../glib/glib-File-Utilities.html#g-mkdir-with-parents"><code class="function">g_mkdir_with_parents()</code></a>.

5064

the similar <a href="http://library.gnome.org/devel/glib/unstable/glib-File-Utilities.html#g-mkdir-with-parents"><code class="function">g_mkdir_with_parents()</code></a>.

5065

For a local <a class="link" href="GFile.html" title="GFile">GFile</a> the newly created directories will have the default

5066

(current) ownership and permissions of the current process.

5067

If <code>cancellable</code>

5068

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5068

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5069

triggering the cancellable object from another thread. If the operation

5070

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

5071

5085

<tr>

5086

<td class="parameter_name">cancellable</td>

5087

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

5088

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5088

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5089

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

5090

</tr>

5091

<tr>

5092

<td class="parameter_name">error</td>

5093

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5093

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5094

5095

</tr>

5096

</tbody>

5098

</div>

5099

5100

<a name="id-1.4.2.2.9.74.8"></a><h4>Returns</h4>

5101

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if all directories have been successfully created, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>

5101

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if all directories have been successfully created, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>

5102

otherwise.

5103

5104

</div>

5107

<hr>

5108

5109

<a name="g-file-make-symbolic-link"></a><h3>g_file_make_symbolic_link ()</h3>

5110

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

5110

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

5111

g_file_make_symbolic_link (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

5112

<code>const char *symlink_value</code>,

5113

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

5114

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5114

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5115

Creates a symbolic link named <code>file</code>

5116

which contains the string

5117

<code>symlink_value</code>

5118

.

5119

If <code>cancellable</code>

5120

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5120

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5121

triggering the cancellable object from another thread. If the operation

5122

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

5123

5142

<tr>

5143

<td class="parameter_name">cancellable</td>

5144

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

5145

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5145

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5146

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

5147

</tr>

5148

<tr>

5149

<td class="parameter_name">error</td>

5150

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a></td>

5150

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a></td>

5151

5152

</tr>

5153

</tbody>

5155

</div>

5156

5157

<a name="id-1.4.2.2.9.75.7"></a><h4>Returns</h4>

5158

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on the creation of a new symlink, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

5158

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on the creation of a new symlink, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

5159

5160

</div>

5161

</div>

5165

<pre class="programlisting"><a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList">GFileAttributeInfoList</a> *

5166

g_file_query_settable_attributes (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

5167

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

5168

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5168

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5169

Obtain the list of settable attributes for the file.

5170

Returns the type and full attribute name of all the attributes

5171

that can be set on this file. This doesn't mean setting it will

5172

always succeed though, you might get an access failure, or some

5173

specific file may not support a specific attribute.

5174

If <code>cancellable</code>

5175

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5175

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5176

triggering the cancellable object from another thread. If the operation

5177

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

5178

5192

<tr>

5193

<td class="parameter_name">cancellable</td>

5194

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

5195

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5195

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5196

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

5197

</tr>

5198

<tr>

5199

<td class="parameter_name">error</td>

5200

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5200

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5201

5202

</tr>

5203

</tbody>

5217

<pre class="programlisting"><a class="link" href="gio-GFileAttribute.html#GFileAttributeInfoList" title="GFileAttributeInfoList">GFileAttributeInfoList</a> *

5218

g_file_query_writable_namespaces (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

5219

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

5220

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5220

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5221

Obtain the list of attribute namespaces where new attributes

5222

can be created by a user. An example of this is extended

5223

attributes (in the "xattr" namespace).

5224

If <code>cancellable</code>

5225

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5225

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5226

triggering the cancellable object from another thread. If the operation

5227

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

5228

5242

<tr>

5243

<td class="parameter_name">cancellable</td>

5244

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

5245

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5245

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5246

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

5247

</tr>

5248

<tr>

5249

<td class="parameter_name">error</td>

5250

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5250

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5251

5252

</tr>

5253

</tbody>

5264

<hr>

5265

5266

<a name="g-file-set-attribute"></a><h3>g_file_set_attribute ()</h3>

5267

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

5267

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

5268

g_file_set_attribute (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

5269

<code>const char *attribute</code>,

5270

<code><a class="link" href="gio-GFileAttribute.html#GFileAttributeType" title="enum GFileAttributeType">GFileAttributeType</a> type</code>,

5271

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> value_p</code>,

5271

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> value_p</code>,

5272

<code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags">GFileQueryInfoFlags</a> flags</code>,

5273

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

5274

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5274

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5275

Sets an attribute in the file with attribute name <code>attribute</code>

5276

to <code>value</code>

5277

.

5278

Some attributes can be unset by setting <code>attribute</code>

5279

to

5280

<a class="link" href="gio-GFileAttribute.html#G-FILE-ATTRIBUTE-TYPE-INVALID:CAPS"><code class="literal">G_FILE_ATTRIBUTE_TYPE_INVALID</code></a> and <code>value_p</code>

5281

to <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

5281

to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.

5282

If <code>cancellable</code>

5283

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5283

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5284

triggering the cancellable object from another thread. If the operation

5285

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

5286

5321

<tr>

5322

<td class="parameter_name">cancellable</td>

5323

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

5324

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5324

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5325

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

5326

</tr>

5327

<tr>

5328

<td class="parameter_name">error</td>

5329

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5329

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5330

5331

</tr>

5332

</tbody>

5334

</div>

5335

5336

<a name="id-1.4.2.2.9.78.8"></a><h4>Returns</h4>

5337

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the attribute was set, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

5337

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the attribute was set, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

5338

5339

</div>

5340

</div>

5341

<hr>

5342

5343

<a name="g-file-set-attributes-from-info"></a><h3>g_file_set_attributes_from_info ()</h3>

5344

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

5344

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

5345

g_file_set_attributes_from_info (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

5346

<code><a class="link" href="GFileInfo.html" title="GFileInfo">GFileInfo</a> *info</code>,

5347

<code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags">GFileQueryInfoFlags</a> flags</code>,

5348

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

5349

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5349

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5350

Tries to set all attributes in the <a class="link" href="GFileInfo.html" title="GFileInfo">GFileInfo</a> on the target

5351

values, not stopping on the first error.

5352

If there is any error during this operation then <code>error</code>

5356

<a class="link" href="gio-GFileAttribute.html#G-FILE-ATTRIBUTE-STATUS-ERROR-SETTING:CAPS"><code class="literal">G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING</code></a>, which means you can

5357

also detect further errors.

5358

If <code>cancellable</code>

5359

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5359

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5360

triggering the cancellable object from another thread. If the operation

5361

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

5362

5386

<tr>

5387

<td class="parameter_name">cancellable</td>

5388

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

5389

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5389

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5390

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

5391

</tr>

5392

<tr>

5393

<td class="parameter_name">error</td>

5394

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5394

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5395

5396

</tr>

5397

</tbody>

5399

</div>

5400

5401

<a name="id-1.4.2.2.9.79.8"></a><h4>Returns</h4>

5402

<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if there was any error, <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> otherwise.

5402

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if there was any error, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> otherwise.

5403

5404

</div>

5405

</div>

5413

<code>int io_priority</code>,

5414

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

5415

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

5416

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

5416

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

5417

Asynchronously sets the attributes of <code>file</code>

5418

with <code>info</code>

5419

.

5455

<tr>

5456

<td class="parameter_name">cancellable</td>

5457

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

5458

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5458

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5459

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

5460

</tr>

5461

<tr>

5465

</tr>

5466

<tr>

5467

5468

<td class="parameter_description"> a <a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a>. </td>

5468

<td class="parameter_description"> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a>. </td>

5469

<td class="parameter_annotations">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here.">closure</acronym>]</td>

5470

</tr>

5471

</tbody>

5475

<hr>

5476

5477

<a name="g-file-set-attributes-finish"></a><h3>g_file_set_attributes_finish ()</h3>

5478

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

5478

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

5479

g_file_set_attributes_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

5480

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result</code>,

5481

<code><a class="link" href="GFileInfo.html" title="GFileInfo">GFileInfo</a> **info</code>,

5482

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5482

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5483

Finishes setting an attribute started in <a class="link" href="GFile.html#g-file-set-attributes-async" title="g_file_set_attributes_async ()"><code class="function">g_file_set_attributes_async()</code></a>.

5484

5485

<a name="id-1.4.2.2.9.81.5"></a><h4>Parameters</h4>

5507

</tr>

5508

<tr>

5509

<td class="parameter_name">error</td>

5510

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5510

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5511

5512

</tr>

5513

</tbody>

5515

</div>

5516

5517

<a name="id-1.4.2.2.9.81.6"></a><h4>Returns</h4>

5518

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the attributes were set correctly, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

5518

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the attributes were set correctly, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

5519

5520

</div>

5521

</div>

5522

<hr>

5523

5524

<a name="g-file-set-attribute-string"></a><h3>g_file_set_attribute_string ()</h3>

5525

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

5525

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

5526

g_file_set_attribute_string (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

5527

<code>const char *attribute</code>,

5528

<code>const char *value</code>,

5529

<code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags">GFileQueryInfoFlags</a> flags</code>,

5530

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

5531

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5531

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5532

Sets <code>attribute</code>

5533

of type <a class="link" href="gio-GFileAttribute.html#G-FILE-ATTRIBUTE-TYPE-STRING:CAPS"><code class="literal">G_FILE_ATTRIBUTE_TYPE_STRING</code></a> to <code>value</code>

5534

.

5535

If <code>attribute</code>

5536

is of a different type, this operation will fail.

5537

If <code>cancellable</code>

5538

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5538

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5539

triggering the cancellable object from another thread. If the operation

5540

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

5541

5570

<tr>

5571

<td class="parameter_name">cancellable</td>

5572

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

5573

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5573

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5574

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

5575

</tr>

5576

<tr>

5577

<td class="parameter_name">error</td>

5578

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5578

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5579

5580

</tr>

5581

</tbody>

5583

</div>

5584

5585

<a name="id-1.4.2.2.9.82.7"></a><h4>Returns</h4>

5586

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <code>attribute</code>

5587

was successfully set, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

5586

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <code>attribute</code>

5587

was successfully set, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

5588

5589

</div>

5590

</div>

5591

<hr>

5592

5593

<a name="g-file-set-attribute-byte-string"></a><h3>g_file_set_attribute_byte_string ()</h3>

5594

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

5594

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

5595

g_file_set_attribute_byte_string (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

5596

<code>const char *attribute</code>,

5597

<code>const char *value</code>,

5598

<code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags">GFileQueryInfoFlags</a> flags</code>,

5599

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

5600

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5600

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5601

Sets <code>attribute</code>

5602

of type <a class="link" href="gio-GFileAttribute.html#G-FILE-ATTRIBUTE-TYPE-BYTE-STRING:CAPS"><code class="literal">G_FILE_ATTRIBUTE_TYPE_BYTE_STRING</code></a> to <code>value</code>

5603

.

5604

If <code>attribute</code>

5605

is of a different type, this operation will fail,

5606

returning <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.

5606

returning <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.

5607

If <code>cancellable</code>

5608

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5608

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5609

triggering the cancellable object from another thread. If the operation

5610

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

5611

5640

<tr>

5641

<td class="parameter_name">cancellable</td>

5642

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

5643

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5643

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5644

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

5645

</tr>

5646

<tr>

5647

<td class="parameter_name">error</td>

5648

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5648

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5649

5650

</tr>

5651

</tbody>

5653

</div>

5654

5655

<a name="id-1.4.2.2.9.83.7"></a><h4>Returns</h4>

5656

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <code>attribute</code>

5656

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <code>attribute</code>

5657

was successfully set to <code>value</code>

5658

in the <code>file</code>

5659

, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

5659

, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

5660

5661

</div>

5662

</div>

5663

<hr>

5664

5665

<a name="g-file-set-attribute-uint32"></a><h3>g_file_set_attribute_uint32 ()</h3>

5666

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

5666

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

5667

g_file_set_attribute_uint32 (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

5668

<code>const char *attribute</code>,

5669

<code><a href="../glib/glib-Basic-Types.html#guint32">guint32</a> value</code>,

5669

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32">guint32</a> value</code>,

5670

<code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags">GFileQueryInfoFlags</a> flags</code>,

5671

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

5672

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5672

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5673

Sets <code>attribute</code>

5674

of type <a class="link" href="gio-GFileAttribute.html#G-FILE-ATTRIBUTE-TYPE-UINT32:CAPS"><code class="literal">G_FILE_ATTRIBUTE_TYPE_UINT32</code></a> to <code>value</code>

5675

.

5676

If <code>attribute</code>

5677

is of a different type, this operation will fail.

5678

If <code>cancellable</code>

5679

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5679

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5680

triggering the cancellable object from another thread. If the operation

5681

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

5682

5700

</tr>

5701

<tr>

5702

<td class="parameter_name">value</td>

5703

<td class="parameter_description">a <a href="../glib/glib-Basic-Types.html#guint32">guint32</a> containing the attribute's new value</td>

5703

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32">guint32</a> containing the attribute's new value</td>

5704

5705

</tr>

5706

<tr>

5711

<tr>

5712

<td class="parameter_name">cancellable</td>

5713

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

5714

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5714

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5715

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

5716

</tr>

5717

<tr>

5718

<td class="parameter_name">error</td>

5719

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5719

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5720

5721

</tr>

5722

</tbody>

5724

</div>

5725

5726

<a name="id-1.4.2.2.9.84.7"></a><h4>Returns</h4>

5727

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <code>attribute</code>

5727

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <code>attribute</code>

5728

was successfully set to <code>value</code>

5729

in the <code>file</code>

5730

, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

5730

, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

5731

5732

</div>

5733

</div>

5734

<hr>

5735

5736

<a name="g-file-set-attribute-int32"></a><h3>g_file_set_attribute_int32 ()</h3>

5737

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

5737

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

5738

g_file_set_attribute_int32 (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

5739

<code>const char *attribute</code>,

5740

<code><a href="../glib/glib-Basic-Types.html#gint32">gint32</a> value</code>,

5740

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32">gint32</a> value</code>,

5741

<code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags">GFileQueryInfoFlags</a> flags</code>,

5742

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

5743

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5743

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5744

Sets <code>attribute</code>

5745

of type <a class="link" href="gio-GFileAttribute.html#G-FILE-ATTRIBUTE-TYPE-INT32:CAPS"><code class="literal">G_FILE_ATTRIBUTE_TYPE_INT32</code></a> to <code>value</code>

5746

.

5747

If <code>attribute</code>

5748

is of a different type, this operation will fail.

5749

If <code>cancellable</code>

5750

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5750

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5751

triggering the cancellable object from another thread. If the operation

5752

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

5753

5771

</tr>

5772

<tr>

5773

<td class="parameter_name">value</td>

5774

<td class="parameter_description">a <a href="../glib/glib-Basic-Types.html#gint32">gint32</a> containing the attribute's new value</td>

5774

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint32">gint32</a> containing the attribute's new value</td>

5775

5776

</tr>

5777

<tr>

5782

<tr>

5783

<td class="parameter_name">cancellable</td>

5784

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

5785

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5785

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5786

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

5787

</tr>

5788

<tr>

5789

<td class="parameter_name">error</td>

5790

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5790

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5791

5792

</tr>

5793

</tbody>

5795

</div>

5796

5797

<a name="id-1.4.2.2.9.85.7"></a><h4>Returns</h4>

5798

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <code>attribute</code>

5798

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <code>attribute</code>

5799

was successfully set to <code>value</code>

5800

in the <code>file</code>

5801

, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

5801

, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

5802

5803

</div>

5804

</div>

5805

<hr>

5806

5807

<a name="g-file-set-attribute-uint64"></a><h3>g_file_set_attribute_uint64 ()</h3>

5808

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

5808

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

5809

g_file_set_attribute_uint64 (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

5810

<code>const char *attribute</code>,

5811

<code><a href="../glib/glib-Basic-Types.html#guint64">guint64</a> value</code>,

5811

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint64">guint64</a> value</code>,

5812

<code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags">GFileQueryInfoFlags</a> flags</code>,

5813

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

5814

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5814

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5815

Sets <code>attribute</code>

5816

of type <a class="link" href="gio-GFileAttribute.html#G-FILE-ATTRIBUTE-TYPE-UINT64:CAPS"><code class="literal">G_FILE_ATTRIBUTE_TYPE_UINT64</code></a> to <code>value</code>

5817

.

5818

If <code>attribute</code>

5819

is of a different type, this operation will fail.

5820

If <code>cancellable</code>

5821

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5821

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5822

triggering the cancellable object from another thread. If the operation

5823

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

5824

5842

</tr>

5843

<tr>

5844

<td class="parameter_name">value</td>

5845

<td class="parameter_description">a <a href="../glib/glib-Basic-Types.html#guint64">guint64</a> containing the attribute's new value</td>

5845

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint64">guint64</a> containing the attribute's new value</td>

5846

5847

</tr>

5848

<tr>

5853

<tr>

5854

<td class="parameter_name">cancellable</td>

5855

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

5856

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5856

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5857

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

5858

</tr>

5859

<tr>

5860

<td class="parameter_name">error</td>

5861

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5861

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5862

5863

</tr>

5864

</tbody>

5866

</div>

5867

5868

<a name="id-1.4.2.2.9.86.7"></a><h4>Returns</h4>

5869

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <code>attribute</code>

5869

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <code>attribute</code>

5870

was successfully set to <code>value</code>

5871

in the <code>file</code>

5872

, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

5872

, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

5873

5874

</div>

5875

</div>

5876

<hr>

5877

5878

<a name="g-file-set-attribute-int64"></a><h3>g_file_set_attribute_int64 ()</h3>

5879

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

5879

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

5880

g_file_set_attribute_int64 (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

5881

<code>const char *attribute</code>,

5882

<code><a href="../glib/glib-Basic-Types.html#gint64">gint64</a> value</code>,

5882

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint64">gint64</a> value</code>,

5883

<code><a class="link" href="GFile.html#GFileQueryInfoFlags" title="enum GFileQueryInfoFlags">GFileQueryInfoFlags</a> flags</code>,

5884

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

5885

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5885

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

5886

Sets <code>attribute</code>

5887

of type <a class="link" href="gio-GFileAttribute.html#G-FILE-ATTRIBUTE-TYPE-INT64:CAPS"><code class="literal">G_FILE_ATTRIBUTE_TYPE_INT64</code></a> to <code>value</code>

5888

.

5889

If <code>attribute</code>

5890

is of a different type, this operation will fail.

5891

If <code>cancellable</code>

5892

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5892

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5893

triggering the cancellable object from another thread. If the operation

5894

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

5895

5913

</tr>

5914

<tr>

5915

<td class="parameter_name">value</td>

5916

<td class="parameter_description">a <a href="../glib/glib-Basic-Types.html#guint64">guint64</a> containing the attribute's new value</td>

5916

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint64">guint64</a> containing the attribute's new value</td>

5917

5918

</tr>

5919

<tr>

5924

<tr>

5925

<td class="parameter_name">cancellable</td>

5926

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

5927

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5927

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5928

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

5929

</tr>

5930

<tr>

5931

<td class="parameter_name">error</td>

5932

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5932

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

5933

5934

</tr>

5935

</tbody>

5937

</div>

5938

5939

<a name="id-1.4.2.2.9.87.7"></a><h4>Returns</h4>

5940

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <code>attribute</code>

5941

was successfully set, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

5940

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <code>attribute</code>

5941

was successfully set, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

5942

5943

</div>

5944

</div>

5951

<code><a class="link" href="GMountOperation.html" title="GMountOperation">GMountOperation</a> *mount_operation</code>,

5952

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

5953

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

5954

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

5954

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

5955

Mounts a file of type G_FILE_TYPE_MOUNTABLE.

5956

Using <code>mount_operation</code>

5957

, you can request callbacks when, for instance,

5958

passwords are needed during authentication.

5959

If <code>cancellable</code>

5960

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5960

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

5961

triggering the cancellable object from another thread. If the operation

5962

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

5963

When the operation is finished, <code>callback</code>

5986

<tr>

5987

<td class="parameter_name">mount_operation</td>

5988

<td class="parameter_description"> a <a class="link" href="GMountOperation.html" title="GMountOperation">GMountOperation</a>,

5989

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid user interaction. </td>

5989

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid user interaction. </td>

5990

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

5991

</tr>

5992

<tr>

5993

<td class="parameter_name">cancellable</td>

5994

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

5995

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5995

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

5996

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

5997

</tr>

5998

<tr>

5999

<td class="parameter_name">callback</td>

6000

<td class="parameter_description"> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> to call

6001

when the request is satisfied, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

6001

when the request is satisfied, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

6002

<td class="parameter_annotations">[<acronym title="The callback is valid until first called.">scope async</acronym>][<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

6003

</tr>

6004

<tr>

6016

<pre class="programlisting"><a class="link" href="GFile.html" title="GFile">GFile</a> *

6017

g_file_mount_mountable_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

6018

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result</code>,

6019

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

6019

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

6020

Finishes a mount operation. See <a class="link" href="GFile.html#g-file-mount-mountable" title="g_file_mount_mountable ()"><code class="function">g_file_mount_mountable()</code></a> for details.

6021

Finish an asynchronous mount operation that was started

6022

with <a class="link" href="GFile.html#g-file-mount-mountable" title="g_file_mount_mountable ()"><code class="function">g_file_mount_mountable()</code></a>.

6041

</tr>

6042

<tr>

6043

<td class="parameter_name">error</td>

6044

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

6044

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

6045

6046

</tr>

6047

</tbody>

6049

</div>

6050

6051

<a name="id-1.4.2.2.9.89.7"></a><h4>Returns</h4>

6052

a <a class="link" href="GFile.html" title="GFile">GFile</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

6053

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

6052

a <a class="link" href="GFile.html" title="GFile">GFile</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

6053

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

6054

[<acronym title="Free data after the code is done.">transfer full</acronym>]

6055

</div>

6056

</div>

6062

<code><a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags">GMountUnmountFlags</a> flags</code>,

6063

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

6064

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

6065

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

6065

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

6066

6067

<code class="literal">g_file_unmount_mountable</code> has been deprecated since version 2.22 and should not be used in newly-written code.

6068

Use <a class="link" href="GFile.html#g-file-unmount-mountable-with-operation" title="g_file_unmount_mountable_with_operation ()"><code class="function">g_file_unmount_mountable_with_operation()</code></a> instead.

6069

</div>

6070

Unmounts a file of type G_FILE_TYPE_MOUNTABLE.

6071

If <code>cancellable</code>

6072

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

6072

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

6073

triggering the cancellable object from another thread. If the operation

6074

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

6075

When the operation is finished, <code>callback</code>

6098

<tr>

6099

<td class="parameter_name">cancellable</td>

6100

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

6101

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

6101

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

6102

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

6103

</tr>

6104

<tr>

6105

<td class="parameter_name">callback</td>

6106

<td class="parameter_description"> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> to call

6107

when the request is satisfied, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

6107

when the request is satisfied, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

6108

<td class="parameter_annotations">[<acronym title="The callback is valid until first called.">scope async</acronym>][<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

6109

</tr>

6110

<tr>

6119

<hr>

6120

6121

<a name="g-file-unmount-mountable-finish"></a><h3>g_file_unmount_mountable_finish ()</h3>

6122

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

6122

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

6123

g_file_unmount_mountable_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

6124

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result</code>,

6125

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

6125

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

6126

6127

<code class="literal">g_file_unmount_mountable_finish</code> has been deprecated since version 2.22 and should not be used in newly-written code.

6128

Use <a class="link" href="GFile.html#g-file-unmount-mountable-with-operation-finish" title="g_file_unmount_mountable_with_operation_finish ()"><code class="function">g_file_unmount_mountable_with_operation_finish()</code></a>

6152

</tr>

6153

<tr>

6154

<td class="parameter_name">error</td>

6155

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

6155

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

6156

6157

</tr>

6158

</tbody>

6160

</div>

6161

6162

<a name="id-1.4.2.2.9.91.8"></a><h4>Returns</h4>

6163

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation finished successfully.

6164

<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

6163

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation finished successfully.

6164

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

6165

6166

</div>

6167

</div>

6175

<code><a class="link" href="GMountOperation.html" title="GMountOperation">GMountOperation</a> *mount_operation</code>,

6176

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

6177

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

6178

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

6178

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

6179

Unmounts a file of type <a class="link" href="GFileInfo.html#G-FILE-TYPE-MOUNTABLE:CAPS">G_FILE_TYPE_MOUNTABLE</a>.

6180

If <code>cancellable</code>

6181

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

6181

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

6182

triggering the cancellable object from another thread. If the operation

6183

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

6184

When the operation is finished, <code>callback</code>

6207

<tr>

6208

<td class="parameter_name">mount_operation</td>

6209

<td class="parameter_description"> a <a class="link" href="GMountOperation.html" title="GMountOperation">GMountOperation</a>,

6210

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid user interaction. </td>

6210

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid user interaction. </td>

6211

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

6212

</tr>

6213

<tr>

6214

<td class="parameter_name">cancellable</td>

6215

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

6216

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

6216

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

6217

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

6218

</tr>

6219

<tr>

6220

<td class="parameter_name">callback</td>

6221

<td class="parameter_description"> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> to call

6222

when the request is satisfied, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

6222

when the request is satisfied, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

6223

<td class="parameter_annotations">[<acronym title="The callback is valid until first called.">scope async</acronym>][<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

6224

</tr>

6225

<tr>

6235

<hr>

6236

6237

<a name="g-file-unmount-mountable-with-operation-finish"></a><h3>g_file_unmount_mountable_with_operation_finish ()</h3>

6238

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

6238

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

6239

g_file_unmount_mountable_with_operation_finish

6240

(<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

6241

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result</code>,

6242

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

6242

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

6243

Finishes an unmount operation,

6244

see <a class="link" href="GFile.html#g-file-unmount-mountable-with-operation" title="g_file_unmount_mountable_with_operation ()"><code class="function">g_file_unmount_mountable_with_operation()</code></a> for details.

6245

Finish an asynchronous unmount operation that was started

6265

</tr>

6266

<tr>

6267

<td class="parameter_name">error</td>

6268

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

6268

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

6269

6270

</tr>

6271

</tbody>

6273

</div>

6274

6275

<a name="id-1.4.2.2.9.93.7"></a><h4>Returns</h4>

6276

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation finished successfully.

6277

<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

6276

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation finished successfully.

6277

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

6278

6279

</div>

6280

Since 2.22

6287

<code><a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags">GMountUnmountFlags</a> flags</code>,

6288

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

6289

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

6290

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

6290

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

6291

6292

<code class="literal">g_file_eject_mountable</code> has been deprecated since version 2.22 and should not be used in newly-written code.

6293

Use <a class="link" href="GFile.html#g-file-eject-mountable-with-operation" title="g_file_eject_mountable_with_operation ()"><code class="function">g_file_eject_mountable_with_operation()</code></a> instead.

6299

data, and the operation can be finalized with

6300

<a class="link" href="GFile.html#g-file-eject-mountable-finish" title="g_file_eject_mountable_finish ()"><code class="function">g_file_eject_mountable_finish()</code></a>.

6301

If <code>cancellable</code>

6302

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

6302

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

6303

triggering the cancellable object from another thread. If the operation

6304

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

6305

6324

<tr>

6325

<td class="parameter_name">cancellable</td>

6326

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

6327

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

6327

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

6328

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

6329

</tr>

6330

<tr>

6331

<td class="parameter_name">callback</td>

6332

<td class="parameter_description"> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> to call

6333

when the request is satisfied, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

6333

when the request is satisfied, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

6334

<td class="parameter_annotations">[<acronym title="The callback is valid until first called.">scope async</acronym>][<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

6335

</tr>

6336

<tr>

6345

<hr>

6346

6347

<a name="g-file-eject-mountable-finish"></a><h3>g_file_eject_mountable_finish ()</h3>

6348

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

6348

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

6349

g_file_eject_mountable_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

6350

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result</code>,

6351

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

6351

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

6352

6353

<code class="literal">g_file_eject_mountable_finish</code> has been deprecated since version 2.22 and should not be used in newly-written code.

6354

Use <a class="link" href="GFile.html#g-file-eject-mountable-with-operation-finish" title="g_file_eject_mountable_with_operation_finish ()"><code class="function">g_file_eject_mountable_with_operation_finish()</code></a>

6377

</tr>

6378

<tr>

6379

<td class="parameter_name">error</td>

6380

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

6380

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

6381

6382

</tr>

6383

</tbody>

6385

</div>

6386

6387

<a name="id-1.4.2.2.9.95.7"></a><h4>Returns</h4>

6388

6388

6389

was ejected successfully.

6390

<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

6390

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

6391

6392

</div>

6393

</div>

6400

<code><a class="link" href="GMountOperation.html" title="GMountOperation">GMountOperation</a> *mount_operation</code>,

6401

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

6402

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

6403

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

6403

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

6404

Starts an asynchronous eject on a mountable.

6405

When this operation has completed, <code>callback</code>

6406

will be called with

6408

data, and the operation can be finalized with

6409

<a class="link" href="GFile.html#g-file-eject-mountable-with-operation-finish" title="g_file_eject_mountable_with_operation_finish ()"><code class="function">g_file_eject_mountable_with_operation_finish()</code></a>.

6410

If <code>cancellable</code>

6411

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

6411

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

6412

triggering the cancellable object from another thread. If the operation

6413

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

6414

6433

<tr>

6434

<td class="parameter_name">mount_operation</td>

6435

<td class="parameter_description"> a <a class="link" href="GMountOperation.html" title="GMountOperation">GMountOperation</a>,

6436

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid user interaction. </td>

6436

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid user interaction. </td>

6437

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

6438

</tr>

6439

<tr>

6440

<td class="parameter_name">cancellable</td>

6441

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

6442

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

6442

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

6443

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

6444

</tr>

6445

<tr>

6446

<td class="parameter_name">callback</td>

6447

<td class="parameter_description"> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> to call

6448

when the request is satisfied, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

6448

when the request is satisfied, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

6449

<td class="parameter_annotations">[<acronym title="The callback is valid until first called.">scope async</acronym>][<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

6450

</tr>

6451

<tr>

6461

<hr>

6462

6463

<a name="g-file-eject-mountable-with-operation-finish"></a><h3>g_file_eject_mountable_with_operation_finish ()</h3>

6464

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

6464

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

6465

g_file_eject_mountable_with_operation_finish

6466

(<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

6467

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result</code>,

6468

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

6468

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

6469

Finishes an asynchronous eject operation started by

6470

<a class="link" href="GFile.html#g-file-eject-mountable-with-operation" title="g_file_eject_mountable_with_operation ()"><code class="function">g_file_eject_mountable_with_operation()</code></a>.

6471

6489

</tr>

6490

<tr>

6491

<td class="parameter_name">error</td>

6492

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

6492

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

6493

6494

</tr>

6495

</tbody>

6497

</div>

6498

6499

<a name="id-1.4.2.2.9.97.6"></a><h4>Returns</h4>

6500

6500

6501

was ejected successfully.

6502

<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

6502

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

6503

6504

</div>

6505

Since 2.22

6513

<code><a class="link" href="GMountOperation.html" title="GMountOperation">GMountOperation</a> *start_operation</code>,

6514

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

6515

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

6516

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

6516

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

6517

Starts a file of type <a class="link" href="GFileInfo.html#G-FILE-TYPE-MOUNTABLE:CAPS">G_FILE_TYPE_MOUNTABLE</a>.

6518

Using <code>start_operation</code>

6519

, you can request callbacks when, for instance,

6520

passwords are needed during authentication.

6521

If <code>cancellable</code>

6522

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

6522

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

6523

triggering the cancellable object from another thread. If the operation

6524

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

6525

When the operation is finished, <code>callback</code>

6547

</tr>

6548

<tr>

6549

<td class="parameter_name">start_operation</td>

6550

<td class="parameter_description"> a <a class="link" href="GMountOperation.html" title="GMountOperation">GMountOperation</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid user interaction. </td>

6550

<td class="parameter_description"> a <a class="link" href="GMountOperation.html" title="GMountOperation">GMountOperation</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid user interaction. </td>

6551

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

6552

</tr>

6553

<tr>

6554

<td class="parameter_name">cancellable</td>

6555

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

6555

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

6556

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

6557

</tr>

6558

<tr>

6559

<td class="parameter_name">callback</td>

6560

<td class="parameter_description"> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> to call when the request is satisfied, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

6560

<td class="parameter_description"> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> to call when the request is satisfied, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

6561

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

6562

</tr>

6563

<tr>

6573

<hr>

6574

6575

<a name="g-file-start-mountable-finish"></a><h3>g_file_start_mountable_finish ()</h3>

6576

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

6576

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

6577

g_file_start_mountable_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

6578

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result</code>,

6579

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

6579

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

6580

Finishes a start operation. See <a class="link" href="GFile.html#g-file-start-mountable" title="g_file_start_mountable ()"><code class="function">g_file_start_mountable()</code></a> for details.

6581

Finish an asynchronous start operation that was started

6582

with <a class="link" href="GFile.html#g-file-start-mountable" title="g_file_start_mountable ()"><code class="function">g_file_start_mountable()</code></a>.

6601

</tr>

6602

<tr>

6603

<td class="parameter_name">error</td>

6604

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

6604

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

6605

6606

</tr>

6607

</tbody>

6609

</div>

6610

6611

<a name="id-1.4.2.2.9.99.7"></a><h4>Returns</h4>

6612

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation finished successfully. <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>

6612

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation finished successfully. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>

6613

otherwise.

6614

6615

</div>

6624

<code><a class="link" href="GMountOperation.html" title="GMountOperation">GMountOperation</a> *mount_operation</code>,

6625

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

6626

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

6627

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

6627

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

6628

Stops a file of type <a class="link" href="GFileInfo.html#G-FILE-TYPE-MOUNTABLE:CAPS">G_FILE_TYPE_MOUNTABLE</a>.

6629

If <code>cancellable</code>

6630

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

6630

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

6631

triggering the cancellable object from another thread. If the operation

6632

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

6633

When the operation is finished, <code>callback</code>

6656

<tr>

6657

<td class="parameter_name">mount_operation</td>

6658

<td class="parameter_description"> a <a class="link" href="GMountOperation.html" title="GMountOperation">GMountOperation</a>,

6659

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid user interaction. </td>

6659

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid user interaction. </td>

6660

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

6661

</tr>

6662

<tr>

6663

<td class="parameter_name">cancellable</td>

6664

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

6665

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

6665

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

6666

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

6667

</tr>

6668

<tr>

6669

<td class="parameter_name">callback</td>

6670

<td class="parameter_description"> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> to call

6671

when the request is satisfied, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

6671

when the request is satisfied, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

6672

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

6673

</tr>

6674

<tr>

6684

<hr>

6685

6686

<a name="g-file-stop-mountable-finish"></a><h3>g_file_stop_mountable_finish ()</h3>

6687

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

6687

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

6688

g_file_stop_mountable_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

6689

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result</code>,

6690

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

6690

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

6691

Finishes an stop operation, see <a class="link" href="GFile.html#g-file-stop-mountable" title="g_file_stop_mountable ()"><code class="function">g_file_stop_mountable()</code></a> for details.

6692

Finish an asynchronous stop operation that was started

6693

with <a class="link" href="GFile.html#g-file-stop-mountable" title="g_file_stop_mountable ()"><code class="function">g_file_stop_mountable()</code></a>.

6712

</tr>

6713

<tr>

6714

<td class="parameter_name">error</td>

6715

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

6715

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

6716

6717

</tr>

6718

</tbody>

6720

</div>

6721

6722

<a name="id-1.4.2.2.9.101.7"></a><h4>Returns</h4>

6723

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation finished successfully.

6724

<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

6723

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation finished successfully.

6724

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

6725

6726

</div>

6727

Since 2.22

6733

g_file_poll_mountable (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

6734

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

6735

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

6736

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

6736

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

6737

Polls a file of type <a class="link" href="GFileInfo.html#G-FILE-TYPE-MOUNTABLE:CAPS">G_FILE_TYPE_MOUNTABLE</a>.

6738

If <code>cancellable</code>

6739

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

6739

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

6740

triggering the cancellable object from another thread. If the operation

6741

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

6742

When the operation is finished, <code>callback</code>

6759

</tr>

6760

<tr>

6761

<td class="parameter_name">cancellable</td>

6762

<td class="parameter_description">optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore</td>

6762

<td class="parameter_description">optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore</td>

6763

6764

</tr>

6765

<tr>

6766

<td class="parameter_name">callback</td>

6767

<td class="parameter_description"> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> to call

6768

when the request is satisfied, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

6768

when the request is satisfied, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

6769

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

6770

</tr>

6771

<tr>

6781

<hr>

6782

6783

<a name="g-file-poll-mountable-finish"></a><h3>g_file_poll_mountable_finish ()</h3>

6784

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

6784

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

6785

g_file_poll_mountable_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

6786

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result</code>,

6787

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

6787

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

6788

Finishes a poll operation. See <a class="link" href="GFile.html#g-file-poll-mountable" title="g_file_poll_mountable ()"><code class="function">g_file_poll_mountable()</code></a> for details.

6789

Finish an asynchronous poll operation that was polled

6790

with <a class="link" href="GFile.html#g-file-poll-mountable" title="g_file_poll_mountable ()"><code class="function">g_file_poll_mountable()</code></a>.

6809

</tr>

6810

<tr>

6811

<td class="parameter_name">error</td>

6812

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

6812

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

6813

6814

</tr>

6815

</tbody>

6817

</div>

6818

6819

<a name="id-1.4.2.2.9.103.7"></a><h4>Returns</h4>

6820

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation finished successfully. <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>

6820

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation finished successfully. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>

6821

otherwise.

6822

6823

</div>

6832

<code><a class="link" href="GMountOperation.html" title="GMountOperation">GMountOperation</a> *mount_operation</code>,

6833

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

6834

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

6835

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

6835

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

6836

Starts a <code>mount_operation</code>

6837

, mounting the volume that contains

6838

the file <code>location</code>

6843

data, and the operation can be finalized with

6844

<a class="link" href="GFile.html#g-file-mount-enclosing-volume-finish" title="g_file_mount_enclosing_volume_finish ()"><code class="function">g_file_mount_enclosing_volume_finish()</code></a>.

6845

If <code>cancellable</code>

6846

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

6846

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

6847

triggering the cancellable object from another thread. If the operation

6848

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

6849

6868

<tr>

6869

<td class="parameter_name">mount_operation</td>

6870

<td class="parameter_description"> a <a class="link" href="GMountOperation.html" title="GMountOperation">GMountOperation</a>

6871

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid user interaction. </td>

6871

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid user interaction. </td>

6872

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

6873

</tr>

6874

<tr>

6875

<td class="parameter_name">cancellable</td>

6876

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

6877

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

6877

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

6878

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

6879

</tr>

6880

<tr>

6881

<td class="parameter_name">callback</td>

6882

<td class="parameter_description"> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> to call

6883

when the request is satisfied, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

6883

when the request is satisfied, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

6884

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

6885

</tr>

6886

<tr>

6895

<hr>

6896

6897

<a name="g-file-mount-enclosing-volume-finish"></a><h3>g_file_mount_enclosing_volume_finish ()</h3>

6898

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

6898

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

6899

g_file_mount_enclosing_volume_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *location</code>,

6900

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result</code>,

6901

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

6901

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

6902

Finishes a mount operation started by <a class="link" href="GFile.html#g-file-mount-enclosing-volume" title="g_file_mount_enclosing_volume ()"><code class="function">g_file_mount_enclosing_volume()</code></a>.

6903

6904

<a name="id-1.4.2.2.9.105.5"></a><h4>Parameters</h4>

6921

</tr>

6922

<tr>

6923

<td class="parameter_name">error</td>

6924

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

6924

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

6925

6926

</tr>

6927

</tbody>

6929

</div>

6930

6931

<a name="id-1.4.2.2.9.105.6"></a><h4>Returns</h4>

6932

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if successful. If an error has occurred,

6933

this function will return <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and set <code>error</code>

6932

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if successful. If an error has occurred,

6933

this function will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and set <code>error</code>

6934

appropriately if present.

6935

6936

</div>

6942

g_file_monitor_directory (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

6943

<code><a class="link" href="GFile.html#GFileMonitorFlags" title="enum GFileMonitorFlags">GFileMonitorFlags</a> flags</code>,

6944

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

6945

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

6945

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

6946

Obtains a directory monitor for the given file.

6947

This may fail if directory monitoring is not supported.

6948

If <code>cancellable</code>

6949

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

6949

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

6950

triggering the cancellable object from another thread. If the operation

6951

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

6952

It does not make sense for <code>flags</code>

6978

<tr>

6979

<td class="parameter_name">cancellable</td>

6980

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

6981

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

6981

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

6982

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

6983

</tr>

6984

<tr>

6985

<td class="parameter_name">error</td>

6986

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

6986

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

6987

6988

</tr>

6989

</tbody>

6993

<a name="id-1.4.2.2.9.106.9"></a><h4>Returns</h4>

6994

a <a class="link" href="GFileMonitor.html" title="GFileMonitor">GFileMonitor</a> for the given <code>file</code>

6995

,

6996

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

6997

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

6996

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

6997

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

6998

[<acronym title="Free data after the code is done.">transfer full</acronym>]

6999

</div>

7000

</div>

7005

g_file_monitor_file (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

7006

<code><a class="link" href="GFile.html#GFileMonitorFlags" title="enum GFileMonitorFlags">GFileMonitorFlags</a> flags</code>,

7007

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

7008

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

7008

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

7009

Obtains a file monitor for the given file. If no file notification

7010

mechanism exists, then regular polling of the file is used.

7011

If <code>cancellable</code>

7012

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

7012

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

7013

triggering the cancellable object from another thread. If the operation

7014

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

7015

If <code>flags</code>

7043

<tr>

7044

<td class="parameter_name">cancellable</td>

7045

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

7046

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

7046

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

7047

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

7048

</tr>

7049

<tr>

7050

<td class="parameter_name">error</td>

7051

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

7051

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

7052

7053

</tr>

7054

</tbody>

7058

<a name="id-1.4.2.2.9.107.8"></a><h4>Returns</h4>

7059

a <a class="link" href="GFileMonitor.html" title="GFileMonitor">GFileMonitor</a> for the given <code>file</code>

7060

,

7061

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

7062

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

7061

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

7062

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

7063

[<acronym title="Free data after the code is done.">transfer full</acronym>]

7064

</div>

7065

</div>

7070

g_file_monitor (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

7071

<code><a class="link" href="GFile.html#GFileMonitorFlags" title="enum GFileMonitorFlags">GFileMonitorFlags</a> flags</code>,

7072

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

7073

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

7073

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

7074

Obtains a file or directory monitor for the given file,

7075

depending on the type of the file.

7076

If <code>cancellable</code>

7077

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

7077

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

7078

triggering the cancellable object from another thread. If the operation

7079

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

7080

7099

<tr>

7100

<td class="parameter_name">cancellable</td>

7101

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

7102

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

7102

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

7103

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

7104

</tr>

7105

<tr>

7106

<td class="parameter_name">error</td>

7107

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

7107

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

7108

7109

</tr>

7110

</tbody>

7114

<a name="id-1.4.2.2.9.108.7"></a><h4>Returns</h4>

7115

a <a class="link" href="GFileMonitor.html" title="GFileMonitor">GFileMonitor</a> for the given <code>file</code>

7116

,

7117

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

7118

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

7117

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

7118

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

7119

[<acronym title="Free data after the code is done.">transfer full</acronym>]

7120

</div>

7121

Since 2.18

7123

<hr>

7124

7125

<a name="g-file-load-contents"></a><h3>g_file_load_contents ()</h3>

7126

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

7126

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

7127

g_file_load_contents (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

7128

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

7129

<code>char **contents</code>,

7130

<code><a href="../glib/glib-Basic-Types.html#gsize">gsize</a> *length</code>,

7130

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> *length</code>,

7131

<code>char **etag_out</code>,

7132

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

7132

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

7133

Loads the content of the file into memory. The data is always

7134

zero-terminated, but this is not included in the resultant <code>length</code>

7135

.

7136

The returned <code>content</code>

7137

should be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer

7137

should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer

7138

needed.

7139

If <code>cancellable</code>

7140

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

7140

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

7141

triggering the cancellable object from another thread. If the operation

7142

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

7143

7156

</tr>

7157

<tr>

7158

<td class="parameter_name">cancellable</td>

7159

<td class="parameter_description">optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore</td>

7159

<td class="parameter_description">optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore</td>

7160

7161

</tr>

7162

<tr>

7167

<tr>

7168

<td class="parameter_name">length</td>

7169

<td class="parameter_description"> a location to place the length of the contents of the file,

7170

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the length is not needed. </td>

7170

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the length is not needed. </td>

7171

<td class="parameter_annotations">[<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>][<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

7172

</tr>

7173

<tr>

7174

7175

<td class="parameter_description"> a location to place the current entity tag for the file,

7176

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the entity tag is not needed. </td>

7176

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the entity tag is not needed. </td>

7177

<td class="parameter_annotations">[<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>][<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

7178

</tr>

7179

<tr>

7180

<td class="parameter_name">error</td>

7181

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

7181

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

7182

7183

</tr>

7184

</tbody>

7186

</div>

7187

7188

<a name="id-1.4.2.2.9.109.7"></a><h4>Returns</h4>

7189

7189

7190

's contents were successfully loaded.

7191

<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if there were errors.

7191

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if there were errors.

7192

7193

</div>

7194

</div>

7199

g_file_load_contents_async (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

7200

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

7201

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

7202

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

7202

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

7203

Starts an asynchronous load of the <code>file</code>

7204

's contents.

7205

For more details, see <a class="link" href="GFile.html#g-file-load-contents" title="g_file_load_contents ()"><code class="function">g_file_load_contents()</code></a> which is

7212

the <code>callback</code>

7213

.

7214

If <code>cancellable</code>

7215

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

7215

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

7216

triggering the cancellable object from another thread. If the operation

7217

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

7218

7231

</tr>

7232

<tr>

7233

<td class="parameter_name">cancellable</td>

7234

<td class="parameter_description">optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore</td>

7234

<td class="parameter_description">optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore</td>

7235

7236

</tr>

7237

<tr>

7251

<hr>

7252

7253

<a name="g-file-load-contents-finish"></a><h3>g_file_load_contents_finish ()</h3>

7254

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

7254

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

7255

g_file_load_contents_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

7256

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *res</code>,

7257

<code>char **contents</code>,

7258

<code><a href="../glib/glib-Basic-Types.html#gsize">gsize</a> *length</code>,

7258

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> *length</code>,

7259

<code>char **etag_out</code>,

7260

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

7260

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

7261

Finishes an asynchronous load of the <code>file</code>

7262

's contents.

7263

The contents are placed in <code>contents</code>

7266

size of the <code>contents</code>

7267

string. The <code>content</code>

7268

should be freed with

7269

<a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer needed. If <code>etag_out</code>

7269

<a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer needed. If <code>etag_out</code>

7270

is present, it will be

7271

set to the new entity tag for the <code>file</code>

7272

.

7297

<tr>

7298

<td class="parameter_name">length</td>

7299

<td class="parameter_description"> a location to place the length of the contents of the file,

7300

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the length is not needed. </td>

7300

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the length is not needed. </td>

7301

<td class="parameter_annotations">[<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>][<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

7302

</tr>

7303

<tr>

7304

7305

<td class="parameter_description"> a location to place the current entity tag for the file,

7306

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the entity tag is not needed. </td>

7306

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the entity tag is not needed. </td>

7307

<td class="parameter_annotations">[<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>][<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

7308

</tr>

7309

<tr>

7310

<td class="parameter_name">error</td>

7311

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

7311

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

7312

7313

</tr>

7314

</tbody>

7316

</div>

7317

7318

<a name="id-1.4.2.2.9.111.6"></a><h4>Returns</h4>

7319

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the load was successful. If <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and <code>error</code>

7319

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the load was successful. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and <code>error</code>

7320

is

7321

present, it will be set appropriately.

7322

7330

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

7331

<code><a class="link" href="GFile.html#GFileReadMoreCallback" title="GFileReadMoreCallback ()">GFileReadMoreCallback</a> read_more_callback</code>,

7332

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

7333

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

7333

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

7334

Reads the partial contents of a file. A <a class="link" href="GFile.html#GFileReadMoreCallback" title="GFileReadMoreCallback ()">GFileReadMoreCallback</a> should

7335

be used to stop reading from the file when appropriate, else this

7336

function will behave exactly as <a class="link" href="GFile.html#g-file-load-contents-async" title="g_file_load_contents_async ()"><code class="function">g_file_load_contents_async()</code></a>. This

7341

and the <code>callback</code>

7342

.

7343

If <code>cancellable</code>

7344

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

7344

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

7345

triggering the cancellable object from another thread. If the operation

7346

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

7347

7360

</tr>

7361

<tr>

7362

<td class="parameter_name">cancellable</td>

7363

<td class="parameter_description">optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore</td>

7363

<td class="parameter_description">optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore</td>

7364

7365

</tr>

7366

<tr>

7386

<hr>

7387

7388

<a name="g-file-load-partial-contents-finish"></a><h3>g_file_load_partial_contents_finish ()</h3>

7389

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

7389

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

7390

g_file_load_partial_contents_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

7391

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *res</code>,

7392

<code>char **contents</code>,

7393

<code><a href="../glib/glib-Basic-Types.html#gsize">gsize</a> *length</code>,

7393

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> *length</code>,

7394

<code>char **etag_out</code>,

7395

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

7395

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

7396

Finishes an asynchronous partial load operation that was started

7397

with <a class="link" href="GFile.html#g-file-load-partial-contents-async" title="g_file_load_partial_contents_async ()"><code class="function">g_file_load_partial_contents_async()</code></a>. The data is always

7398

zero-terminated, but this is not included in the resultant <code>length</code>

7399

.

7400

The returned <code>content</code>

7401

should be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer

7401

should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer

7402

needed.

7403

7404

<a name="id-1.4.2.2.9.113.5"></a><h4>Parameters</h4>

7427

<tr>

7428

<td class="parameter_name">length</td>

7429

<td class="parameter_description"> a location to place the length of the contents of the file,

7430

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the length is not needed. </td>

7430

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the length is not needed. </td>

7431

<td class="parameter_annotations">[<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>][<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

7432

</tr>

7433

<tr>

7434

7435

<td class="parameter_description"> a location to place the current entity tag for the file,

7436

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the entity tag is not needed. </td>

7436

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the entity tag is not needed. </td>

7437

<td class="parameter_annotations">[<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>][<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

7438

</tr>

7439

<tr>

7440

<td class="parameter_name">error</td>

7441

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

7441

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

7442

7443

</tr>

7444

</tbody>

7446

</div>

7447

7448

<a name="id-1.4.2.2.9.113.6"></a><h4>Returns</h4>

7449

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the load was successful. If <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and <code>error</code>

7449

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the load was successful. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and <code>error</code>

7450

is

7451

present, it will be set appropriately.

7452

7455

<hr>

7456

7457

<a name="g-file-replace-contents"></a><h3>g_file_replace_contents ()</h3>

7458

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

7458

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

7459

g_file_replace_contents (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

7460

<code>const char *contents</code>,

7461

<code><a href="../glib/glib-Basic-Types.html#gsize">gsize</a> length</code>,

7461

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> length</code>,

7462

<code>const char *etag</code>,

7463

<code><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a> make_backup</code>,

7463

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> make_backup</code>,

7464

<code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags">GFileCreateFlags</a> flags</code>,

7465

<code>char **new_etag</code>,

7466

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

7467

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

7467

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

7468

Replaces the contents of <code>file</code>

7469

with <code>contents</code>

7470

of <code>length</code>

7471

bytes.

7472

If <code>etag</code>

7473

is specified (not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>), any existing file must have that etag,

7473

is specified (not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>), any existing file must have that etag,

7474

or the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-WRONG-ETAG:CAPS"><code class="literal">G_IO_ERROR_WRONG_ETAG</code></a> will be returned.

7475

If <code>make_backup</code>

7476

is <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, this function will attempt to make a backup

7476

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, this function will attempt to make a backup

7477

of <code>file</code>

7478

.

7479

If <code>cancellable</code>

7480

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

7480

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

7481

triggering the cancellable object from another thread. If the operation

7482

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

7483

The returned <code>new_etag</code>

7512

<tr>

7513

7514

<td class="parameter_description"> the old <a class="link" href="GFile.html#gfile-etag" title="Entity Tags">entity-tag</a> for the document,

7515

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

7515

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

7516

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

7517

</tr>

7518

<tr>

7519

<td class="parameter_name">make_backup</td>

7520

<td class="parameter_description"><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a backup should be created</td>

7520

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a backup should be created</td>

7521

7522

</tr>

7523

<tr>

7528

<tr>

7529

7530

<td class="parameter_description"> a location to a new <a class="link" href="GFile.html#gfile-etag" title="Entity Tags">entity tag</a>

7531

for the document. This should be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer

7532

needed, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

7531

for the document. This should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer

7532

needed, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

7533

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>][<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>]</td>

7534

</tr>

7535

<tr>

7536

<td class="parameter_name">cancellable</td>

7537

<td class="parameter_description">optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore</td>

7537

<td class="parameter_description">optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore</td>

7538

7539

</tr>

7540

<tr>

7541

<td class="parameter_name">error</td>

7542

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

7542

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

7543

7544

</tr>

7545

</tbody>

7547

</div>

7548

7549

<a name="id-1.4.2.2.9.114.10"></a><h4>Returns</h4>

7550

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if successful. If an error has occurred, this function

7551

will return <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and set <code>error</code>

7550

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if successful. If an error has occurred, this function

7551

will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and set <code>error</code>

7552

appropriately if present.

7553

7554

</div>

7559

<pre class="programlisting">void

7560

g_file_replace_contents_async (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

7561

<code>const char *contents</code>,

7562

<code><a href="../glib/glib-Basic-Types.html#gsize">gsize</a> length</code>,

7562

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> length</code>,

7563

<code>const char *etag</code>,

7564

<code><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a> make_backup</code>,

7564

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> make_backup</code>,

7565

<code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags">GFileCreateFlags</a> flags</code>,

7566

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

7567

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

7568

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

7568

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

7569

Starts an asynchronous replacement of <code>file</code>

7570

with the given

7571

<code>contents</code>

7579

data, and the operation can be finalized with

7580

<a class="link" href="GFile.html#g-file-replace-contents-finish" title="g_file_replace_contents_finish ()"><code class="function">g_file_replace_contents_finish()</code></a>.

7581

If <code>cancellable</code>

7582

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

7582

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by

7583

triggering the cancellable object from another thread. If the operation

7584

was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be returned.

7585

If <code>make_backup</code>

7586

is <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, this function will attempt to

7586

is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, this function will attempt to

7587

make a backup of <code>file</code>

7588

.

7589

Note that no copy of <code>content</code>

7590

will be made, so it must stay valid

7591

until <code>callback</code>

7592

is called. See <a class="link" href="GFile.html#g-file-replace-contents-bytes-async" title="g_file_replace_contents_bytes_async ()"><code class="function">g_file_replace_contents_bytes_async()</code></a>

7593

for a <a href="../glib/glib-Byte-Arrays.html#GBytes">GBytes</a> version that will automatically hold a reference to the

7593

for a <a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#GBytes">GBytes</a> version that will automatically hold a reference to the

7594

contents (without copying) for the duration of the call.

7595

7596

<a name="id-1.4.2.2.9.115.9"></a><h4>Parameters</h4>

7620

<tr>

7621

7622

<td class="parameter_description"> a new <a class="link" href="GFile.html#gfile-etag" title="Entity Tags">entity tag</a> for the <code>file</code>

7623

, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

7623

, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

7624

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

7625

</tr>

7626

<tr>

7627

<td class="parameter_name">make_backup</td>

7628

<td class="parameter_description"><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a backup should be created</td>

7628

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a backup should be created</td>

7629

7630

</tr>

7631

<tr>

7635

</tr>

7636

<tr>

7637

<td class="parameter_name">cancellable</td>

7638

<td class="parameter_description">optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore</td>

7638

<td class="parameter_description">optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore</td>

7639

7640

</tr>

7641

<tr>

7657

<a name="g-file-replace-contents-bytes-async"></a><h3>g_file_replace_contents_bytes_async ()</h3>

7658

<pre class="programlisting">void

7659

g_file_replace_contents_bytes_async (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

7660

<code><a href="../glib/glib-Byte-Arrays.html#GBytes">GBytes</a> *contents</code>,

7660

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#GBytes">GBytes</a> *contents</code>,

7661

<code>const char *etag</code>,

7662

<code><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a> make_backup</code>,

7662

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> make_backup</code>,

7663

<code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags">GFileCreateFlags</a> flags</code>,

7664

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

7665

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

7666

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

7667

Same as <a class="link" href="GFile.html#g-file-replace-contents-async" title="g_file_replace_contents_async ()"><code class="function">g_file_replace_contents_async()</code></a> but takes a <a href="../glib/glib-Byte-Arrays.html#GBytes">GBytes</a> input instead.

7666

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

7667

Same as <a class="link" href="GFile.html#g-file-replace-contents-async" title="g_file_replace_contents_async ()"><code class="function">g_file_replace_contents_async()</code></a> but takes a <a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#GBytes">GBytes</a> input instead.

7668

This function will keep a ref on <code>contents</code>

7669

until the operation is done.

7670

Unlike <a class="link" href="GFile.html#g-file-replace-contents-async" title="g_file_replace_contents_async ()"><code class="function">g_file_replace_contents_async()</code></a> this allows forgetting about the

7690

</tr>

7691

<tr>

7692

<td class="parameter_name">contents</td>

7693

<td class="parameter_description">a <a href="../glib/glib-Byte-Arrays.html#GBytes">GBytes</a></td>

7693

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#GBytes">GBytes</a></td>

7694

7695

</tr>

7696

<tr>

7697

7698

<td class="parameter_description"> a new <a class="link" href="GFile.html#gfile-etag" title="Entity Tags">entity tag</a> for the <code>file</code>

7699

, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

7699

, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

7700

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

7701

</tr>

7702

<tr>

7703

<td class="parameter_name">make_backup</td>

7704

<td class="parameter_description"><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a backup should be created</td>

7704

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a backup should be created</td>

7705

7706

</tr>

7707

<tr>

7711

</tr>

7712

<tr>

7713

<td class="parameter_name">cancellable</td>

7714

<td class="parameter_description">optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore</td>

7714

<td class="parameter_description">optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore</td>

7715

7716

</tr>

7717

<tr>

7732

<hr>

7733

7734

<a name="g-file-replace-contents-finish"></a><h3>g_file_replace_contents_finish ()</h3>

7735

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

7735

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

7736

g_file_replace_contents_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

7737

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *res</code>,

7738

<code>char **new_etag</code>,

7739

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

7739

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

7740

Finishes an asynchronous replace of the given <code>file</code>

7741

. See

7742

<a class="link" href="GFile.html#g-file-replace-contents-async" title="g_file_replace_contents_async ()"><code class="function">g_file_replace_contents_async()</code></a>. Sets <code>new_etag</code>

7764

<tr>

7765

7766

<td class="parameter_description"> a location of a new <a class="link" href="GFile.html#gfile-etag" title="Entity Tags">entity tag</a>

7767

for the document. This should be freed with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when it is no

7768

longer needed, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

7767

for the document. This should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when it is no

7768

longer needed, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

7769

<td class="parameter_annotations">[<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>][<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

7770

</tr>

7771

<tr>

7772

<td class="parameter_name">error</td>

7773

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

7773

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

7774

7775

</tr>

7776

</tbody>

7778

</div>

7779

7780

<a name="id-1.4.2.2.9.117.6"></a><h4>Returns</h4>

7781

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on failure.

7781

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on failure.

7782

7783

</div>

7784

</div>

7785

<hr>

7786

7787

<a name="g-file-copy-attributes"></a><h3>g_file_copy_attributes ()</h3>

7788

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

7788

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

7789

g_file_copy_attributes (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *source</code>,

7790

<code><a class="link" href="GFile.html" title="GFile">GFile</a> *destination</code>,

7791

<code><a class="link" href="GFile.html#GFileCopyFlags" title="enum GFileCopyFlags">GFileCopyFlags</a> flags</code>,

7792

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

7793

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

7793

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

7794

Copies the file attributes from <code>source</code>

7795

to <code>destination</code>

7796

.

7828

<tr>

7829

<td class="parameter_name">cancellable</td>

7830

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

7831

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

7831

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

7832

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

7833

</tr>

7834

<tr>

7835

<td class="parameter_name">error</td>

7836

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore</td>

7836

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore</td>

7837

7838

</tr>

7839

</tbody>

7841

</div>

7842

7843

<a name="id-1.4.2.2.9.118.7"></a><h4>Returns</h4>

7844

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the attributes were copied successfully,

7845

<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

7844

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the attributes were copied successfully,

7845

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.

7846

7847

</div>

7848

</div>

7853

g_file_create_readwrite (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

7854

<code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags">GFileCreateFlags</a> flags</code>,

7855

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

7856

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

7856

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

7857

Creates a new file and returns a stream for reading and

7858

writing to it. The file must not already exist.

7859

By default files created are generally readable by everyone,

7862

will be made readable only to the current user, to the level

7863

that is supported on the target filesystem.

7864

If <code>cancellable</code>

7865

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled

7865

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled

7866

by triggering the cancellable object from another thread. If the

7867

operation was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be

7868

returned.

7897

<tr>

7898

<td class="parameter_name">cancellable</td>

7899

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

7900

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

7900

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

7901

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

7902

</tr>

7903

<tr>

7904

<td class="parameter_name">error</td>

7905

<td class="parameter_description">return location for a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

7905

<td class="parameter_description">return location for a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

7906

7907

</tr>

7908

</tbody>

7911

7912

<a name="id-1.4.2.2.9.119.10"></a><h4>Returns</h4>

7913

a <a class="link" href="GFileIOStream.html" title="GFileIOStream">GFileIOStream</a> for the newly created

7914

file, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

7915

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

7914

file, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

7915

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

7916

[<acronym title="Free data after the code is done.">transfer full</acronym>]

7917

</div>

7918

Since 2.22

7926

<code>int io_priority</code>,

7927

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

7928

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

7929

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

7929

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

7930

Asynchronously creates a new file and returns a stream

7931

for reading and writing to it. The file must not already exist.

7932

For more details, see <a class="link" href="GFile.html#g-file-create-readwrite" title="g_file_create_readwrite ()"><code class="function">g_file_create_readwrite()</code></a> which is

7962

<tr>

7963

<td class="parameter_name">cancellable</td>

7964

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

7965

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

7965

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

7966

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

7967

</tr>

7968

<tr>

7987

<pre class="programlisting"><a class="link" href="GFileIOStream.html" title="GFileIOStream">GFileIOStream</a> *

7988

g_file_create_readwrite_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

7989

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *res</code>,

7990

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

7990

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

7991

Finishes an asynchronous file create operation started with

7992

<a class="link" href="GFile.html#g-file-create-readwrite-async" title="g_file_create_readwrite_async ()"><code class="function">g_file_create_readwrite_async()</code></a>.

7993

8011

</tr>

8012

<tr>

8013

<td class="parameter_name">error</td>

8014

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

8014

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

8015

8016

</tr>

8017

</tbody>

8019

</div>

8020

8021

<a name="id-1.4.2.2.9.121.6"></a><h4>Returns</h4>

8022

a <a class="link" href="GFileIOStream.html" title="GFileIOStream">GFileIOStream</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

8023

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

8022

a <a class="link" href="GFileIOStream.html" title="GFileIOStream">GFileIOStream</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

8023

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

8024

[<acronym title="Free data after the code is done.">transfer full</acronym>]

8025

</div>

8026

Since 2.22

8031

<pre class="programlisting"><a class="link" href="GFileIOStream.html" title="GFileIOStream">GFileIOStream</a> *

8032

g_file_open_readwrite (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

8033

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

8034

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

8034

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

8035

Opens an existing file for reading and writing. The result is

8036

a <a class="link" href="GFileIOStream.html" title="GFileIOStream">GFileIOStream</a> that can be used to read and write the contents

8037

of the file.

8038

If <code>cancellable</code>

8039

is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled

8039

is not <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled

8040

by triggering the cancellable object from another thread. If the

8041

operation was cancelled, the error <a class="link" href="gio-GIOError.html#G-IO-ERROR-CANCELLED:CAPS"><code class="literal">G_IO_ERROR_CANCELLED</code></a> will be

8042

returned.

8068

</tr>

8069

<tr>

8070

<td class="parameter_name">error</td>

8071

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

8071

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

8072

8073

</tr>

8074

</tbody>

8076

</div>

8077

8078

<a name="id-1.4.2.2.9.122.8"></a><h4>Returns</h4>

8079

<a class="link" href="GFileIOStream.html" title="GFileIOStream">GFileIOStream</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

8080

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

8079

<a class="link" href="GFileIOStream.html" title="GFileIOStream">GFileIOStream</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

8080

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

8081

[<acronym title="Free data after the code is done.">transfer full</acronym>]

8082

</div>

8083

Since 2.22

8090

<code>int io_priority</code>,

8091

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

8092

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

8093

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

8093

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

8094

Asynchronously opens <code>file</code>

8095

for reading and writing.

8096

For more details, see <a class="link" href="GFile.html#g-file-open-readwrite" title="g_file_open_readwrite ()"><code class="function">g_file_open_readwrite()</code></a> which is

8121

<tr>

8122

<td class="parameter_name">cancellable</td>

8123

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

8124

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

8124

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

8125

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

8126

</tr>

8127

<tr>

8146

<pre class="programlisting"><a class="link" href="GFileIOStream.html" title="GFileIOStream">GFileIOStream</a> *

8147

g_file_open_readwrite_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

8148

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *res</code>,

8149

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

8149

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

8150

Finishes an asynchronous file read operation started with

8151

<a class="link" href="GFile.html#g-file-open-readwrite-async" title="g_file_open_readwrite_async ()"><code class="function">g_file_open_readwrite_async()</code></a>.

8152

8170

</tr>

8171

<tr>

8172

<td class="parameter_name">error</td>

8173

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

8173

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

8174

8175

</tr>

8176

</tbody>

8178

</div>

8179

8180

<a name="id-1.4.2.2.9.124.6"></a><h4>Returns</h4>

8181

a <a class="link" href="GFileIOStream.html" title="GFileIOStream">GFileIOStream</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

8182

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

8181

a <a class="link" href="GFileIOStream.html" title="GFileIOStream">GFileIOStream</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

8182

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

8183

[<acronym title="Free data after the code is done.">transfer full</acronym>]

8184

</div>

8185

Since 2.22

8190

<pre class="programlisting"><a class="link" href="GFileIOStream.html" title="GFileIOStream">GFileIOStream</a> *

8191

g_file_replace_readwrite (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

8192

<code>const char *etag</code>,

8193

<code><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a> make_backup</code>,

8193

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> make_backup</code>,

8194

<code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags">GFileCreateFlags</a> flags</code>,

8195

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

8196

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

8196

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

8197

Returns an output stream for overwriting the file in readwrite mode,

8198

possibly creating a backup copy of the file first. If the file doesn't

8199

exist, it will be created.

8219

<tr>

8220

8221

<td class="parameter_description"> an optional <a class="link" href="GFile.html#gfile-etag" title="Entity Tags">entity tag</a>

8222

for the current <a class="link" href="GFile.html" title="GFile">GFile</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a> to ignore. </td>

8222

for the current <a class="link" href="GFile.html" title="GFile">GFile</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a> to ignore. </td>

8223

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

8224

</tr>

8225

<tr>

8226

<td class="parameter_name">make_backup</td>

8227

<td class="parameter_description"><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a backup should be created</td>

8227

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a backup should be created</td>

8228

8229

</tr>

8230

<tr>

8235

<tr>

8236

<td class="parameter_name">cancellable</td>

8237

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

8238

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

8238

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

8239

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

8240

</tr>

8241

<tr>

8242

<td class="parameter_name">error</td>

8243

<td class="parameter_description">return location for a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

8243

<td class="parameter_description">return location for a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

8244

8245

</tr>

8246

</tbody>

8248

</div>

8249

8250

<a name="id-1.4.2.2.9.125.8"></a><h4>Returns</h4>

8251

a <a class="link" href="GFileIOStream.html" title="GFileIOStream">GFileIOStream</a> or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

8252

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

8251

a <a class="link" href="GFileIOStream.html" title="GFileIOStream">GFileIOStream</a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

8252

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

8253

[<acronym title="Free data after the code is done.">transfer full</acronym>]

8254

</div>

8255

Since 2.22

8260

<pre class="programlisting">void

8261

g_file_replace_readwrite_async (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

8262

<code>const char *etag</code>,

8263

<code><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a> make_backup</code>,

8263

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> make_backup</code>,

8264

<code><a class="link" href="GFile.html#GFileCreateFlags" title="enum GFileCreateFlags">GFileCreateFlags</a> flags</code>,

8265

<code>int io_priority</code>,

8266

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

8267

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

8268

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

8268

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

8269

Asynchronously overwrites the file in read-write mode,

8270

replacing the contents, possibly creating a backup copy

8271

of the file first.

8292

<tr>

8293

8294

<td class="parameter_description"> an <a class="link" href="GFile.html#gfile-etag" title="Entity Tags">entity tag</a> for the current <a class="link" href="GFile.html" title="GFile">GFile</a>,

8295

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

8295

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

8296

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

8297

</tr>

8298

<tr>

8299

<td class="parameter_name">make_backup</td>

8300

<td class="parameter_description"><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a backup should be created</td>

8300

<td class="parameter_description"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a backup should be created</td>

8301

8302

</tr>

8303

<tr>

8313

<tr>

8314

<td class="parameter_name">cancellable</td>

8315

<td class="parameter_description"> optional <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> object,

8316

<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

8316

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore. </td>

8317

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

8318

</tr>

8319

<tr>

8338

<pre class="programlisting"><a class="link" href="GFileIOStream.html" title="GFileIOStream">GFileIOStream</a> *

8339

g_file_replace_readwrite_finish (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>,

8340

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *res</code>,

8341

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

8341

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

8342

Finishes an asynchronous file replace operation started with

8343

<a class="link" href="GFile.html#g-file-replace-readwrite-async" title="g_file_replace_readwrite_async ()"><code class="function">g_file_replace_readwrite_async()</code></a>.

8344

8362

</tr>

8363

<tr>

8364

<td class="parameter_name">error</td>

8365

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

8365

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

8366

8367

</tr>

8368

</tbody>

8370

</div>

8371

8372

<a name="id-1.4.2.2.9.127.6"></a><h4>Returns</h4>

8373

a <a class="link" href="GFileIOStream.html" title="GFileIOStream">GFileIOStream</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

8374

Free the returned object with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

8373

a <a class="link" href="GFileIOStream.html" title="GFileIOStream">GFileIOStream</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.

8374

Free the returned object with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.

8375

[<acronym title="Free data after the code is done.">transfer full</acronym>]

8376

</div>

8377

Since 2.22

8379

<hr>

8380

8381

<a name="g-file-supports-thread-contexts"></a><h3>g_file_supports_thread_contexts ()</h3>

8382

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a>

8382

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a>

8383

g_file_supports_thread_contexts (<code><a class="link" href="GFile.html" title="GFile">GFile</a> *file</code>);</pre>

8384

Checks if <code>file</code>

8385

supports

8386

thread-default contexts.

8387

If this returns <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, you cannot perform asynchronous operations on

8387

If this returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, you cannot perform asynchronous operations on

8388

8389

in a thread that has a thread-default context.

8390

8865

</colgroup>

8866

<tbody>

8867

<tr>

8868

<td class="struct_member_name"><a href="../gobject/gobject-Type-Information.html#GTypeInterface">GTypeInterface</a> <code><a name="GFileIface.g-iface"></a>g_iface</code>;</td>

8868

<td class="struct_member_name"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GTypeInterface">GTypeInterface</a> <code><a name="GFileIface.g-iface"></a>g_iface</code>;</td>

8869

<td class="struct_member_description">The parent interface.</td>

8870

8871

</tr>

9335

9336

</tr>

9337

<tr>

9338

<td class="struct_member_name"><a href="../glib/glib-Basic-Types.html#gboolean">gboolean</a> <code><a name="GFileIface.supports-thread-contexts"></a>supports_thread_contexts</code>;</td>

9338

<td class="struct_member_name"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <code><a name="GFileIface.supports-thread-contexts"></a>supports_thread_contexts</code>;</td>

9339

<td class="struct_member_description">a boolean that indicates whether the <a class="link" href="GFile.html" title="GFile">GFile</a> implementation supports thread-default contexts. Since 2.22.</td>

9340

9341

</tr>