~ubuntu-branches/ubuntu/vivid/glib2.0/vivid-proposed

<a class="link" href="GSimpleAsyncResult.html#g-simple-async-result-get-op-res-gpointer" title="g_simple_async_result_get_op_res_gpointer ()">g_simple_async_result_get_op_res_gpointer</a> ()

115

</tr>

116

<tr>

117

118

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

118

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

119

</td>

120

121

<a class="link" href="GSimpleAsyncResult.html#g-simple-async-result-get-op-res-gssize" title="g_simple_async_result_get_op_res_gssize ()">g_simple_async_result_get_op_res_gssize</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="GSimpleAsyncResult.html#g-simple-async-result-get-op-res-gboolean" title="g_simple_async_result_get_op_res_gboolean ()">g_simple_async_result_get_op_res_gboolean</a> ()

139

</tr>

140

<tr>

141

142

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

142

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

143

</td>

144

145

<a class="link" href="GSimpleAsyncResult.html#g-simple-async-result-get-source-tag" title="g_simple_async_result_get_source_tag ()">g_simple_async_result_get_source_tag</a> ()

147

</tr>

148

<tr>

149

150

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

150

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

151

</td>

152

153

<a class="link" href="GSimpleAsyncResult.html#g-simple-async-result-is-valid" title="g_simple_async_result_is_valid ()">g_simple_async_result_is_valid</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="GSimpleAsyncResult.html#g-simple-async-result-propagate-error" title="g_simple_async_result_propagate_error ()">g_simple_async_result_propagate_error</a> ()

267

</div>

268

269

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

270

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

270

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

271

╰── GSimpleAsyncResult

272

</pre>

273

</div>

292

completely transparent to the application. Results can be returned

293

as a pointer e.g. for functions that return data that is collected

294

asynchronously, a boolean value for checking the success or failure

295

of an operation, or a <a href="../glib/glib-Basic-Types.html#gssize">gssize</a> for operations which return the number

295

of an operation, or a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gssize">gssize</a> for operations which return the number

296

of bytes modified by the operation; all of the simple return cases

297

are covered.

298

Most of the time, an application will not need to know of the details

305

that asynchronous functions and their finishing functions are used

306

together correctly.

307

To create a new <a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a>, call <a class="link" href="GSimpleAsyncResult.html#g-simple-async-result-new" title="g_simple_async_result_new ()"><code class="function">g_simple_async_result_new()</code></a>.

308

If the result needs to be created for a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, use

308

If the result needs to be created for a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, use

309

<a class="link" href="GSimpleAsyncResult.html#g-simple-async-result-new-from-error" title="g_simple_async_result_new_from_error ()"><code class="function">g_simple_async_result_new_from_error()</code></a> or

310

<a class="link" href="GSimpleAsyncResult.html#g-simple-async-result-new-take-error" title="g_simple_async_result_new_take_error ()"><code class="function">g_simple_async_result_new_take_error()</code></a>. If a <a href="../glib/glib-Error-Reporting.html#GError">GError</a> is not available

311

(e.g. the asynchronous operation's doesn't take a <a href="../glib/glib-Error-Reporting.html#GError">GError</a> argument),

310

<a class="link" href="GSimpleAsyncResult.html#g-simple-async-result-new-take-error" title="g_simple_async_result_new_take_error ()"><code class="function">g_simple_async_result_new_take_error()</code></a>. If a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> is not available

311

(e.g. the asynchronous operation's doesn't take a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> argument),

312

but the result still needs to be created for an error condition, use

313

<a class="link" href="GSimpleAsyncResult.html#g-simple-async-result-new-error" title="g_simple_async_result_new_error ()"><code class="function">g_simple_async_result_new_error()</code></a> (or <a class="link" href="GSimpleAsyncResult.html#g-simple-async-result-set-error-va" title="g_simple_async_result_set_error_va ()"><code class="function">g_simple_async_result_set_error_va()</code></a>

314

if your application or binding requires passing a variable argument list

316

<a class="link" href="GSimpleAsyncResult.html#g-simple-async-result-propagate-error" title="g_simple_async_result_propagate_error ()"><code class="function">g_simple_async_result_propagate_error()</code></a>.

317

An asynchronous operation can be made to ignore a cancellation event by

318

calling <a class="link" href="GSimpleAsyncResult.html#g-simple-async-result-set-handle-cancellation" title="g_simple_async_result_set_handle_cancellation ()"><code class="function">g_simple_async_result_set_handle_cancellation()</code></a> with a

319

<a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a> for the operation and <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>. This is useful for

319

<a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a> for the operation and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>. This is useful for

320

operations that are dangerous to cancel, such as close (which would

321

cause a leak if cancelled before being run).

322

GSimpleAsyncResult can integrate into GLib's event loop, <a href="../glib/glib-The-Main-Event-Loop.html#GMainLoop">GMainLoop</a>,

323

or it can use <a href="../glib/glib-Threads.html#GThread">GThreads</a>.

322

GSimpleAsyncResult can integrate into GLib's event loop, <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop">GMainLoop</a>,

323

or it can use <a href="http://library.gnome.org/devel/glib/unstable/glib-Threads.html#GThread">GThreads</a>.

324

<a class="link" href="GSimpleAsyncResult.html#g-simple-async-result-complete" title="g_simple_async_result_complete ()"><code class="function">g_simple_async_result_complete()</code></a> will finish an I/O task directly

325

from the point where it is called. <a class="link" href="GSimpleAsyncResult.html#g-simple-async-result-complete-in-idle" title="g_simple_async_result_complete_in_idle ()"><code class="function">g_simple_async_result_complete_in_idle()</code></a>

326

will finish it from an idle handler in the

327

<a href="../glib/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>

327

<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>

328

. <a class="link" href="GSimpleAsyncResult.html#g-simple-async-result-run-in-thread" title="g_simple_async_result_run_in_thread ()"><code class="function">g_simple_async_result_run_in_thread()</code></a> will run the

329

job in a separate thread and then deliver the result to the

330

thread-default main context.

454

"Go to the supermarket");

455

else

456

<a href="GSimpleAsyncResult.html#g-simple-async-result-set-op-res-gpointer">g_simple_async_result_set_op_res_gpointer</a> (result,

457

<a href="../gobject/gobject-The-Base-Object-Type.html#g-object-ref">g_object_ref</a> (cake),

457

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref">g_object_ref</a> (cake),

458

g_object_unref);

459

460

464

// first returning to the mainloop — inadvisable, but some APIs do so —

465

// we would need to use g_simple_async_result_complete_in_idle().

466

<a href="GSimpleAsyncResult.html#g-simple-async-result-complete">g_simple_async_result_complete</a> (result);

467

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

467

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

468

}

469

470

void

478

479

if (radius < 3)

480

{

481

<a href="GSimpleAsyncResult.html#g-simple-async-report-error-in-idle">g_simple_async_report_error_in_idle</a> (<a href="../gobject/gobject-The-Base-Object-Type.html#G-OBJECT:CAPS">G_OBJECT</a> (self),

481

<a href="GSimpleAsyncResult.html#g-simple-async-report-error-in-idle">g_simple_async_report_error_in_idle</a> (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#G-OBJECT:CAPS">G_OBJECT</a> (self),

482

callback,

483

user_data,

484

BAKER_ERRORS,

488

return;

489

}

490

491

simple = <a href="GSimpleAsyncResult.html#g-simple-async-result-new">g_simple_async_result_new</a> (<a href="../gobject/gobject-The-Base-Object-Type.html#G-OBJECT:CAPS">G_OBJECT</a> (self),

491

simple = <a href="GSimpleAsyncResult.html#g-simple-async-result-new">g_simple_async_result_new</a> (<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#G-OBJECT:CAPS">G_OBJECT</a> (self),

492

callback,

493

user_data,

494

baker_bake_cake_async);

497

if (cake != NULL)

498

{

499

500

<a href="../gobject/gobject-The-Base-Object-Type.html#g-object-ref">g_object_ref</a> (cake),

500

501

g_object_unref);

502

<a href="GSimpleAsyncResult.html#g-simple-async-result-complete-in-idle">g_simple_async_result_complete_in_idle</a> (simple);

503

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

503

504

// Drop the reference returned by _baker_get_cached_cake();

505

// the GSimpleAsyncResult has taken its own reference.

506

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

506

507

return;

508

}

509

518

GSimpleAsyncResult *simple;

519

Cake *cake;

520

521

<a href="../glib/glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a> (<a href="GSimpleAsyncResult.html#g-simple-async-result-is-valid">g_simple_async_result_is_valid</a> (result,

522

<a href="../gobject/gobject-The-Base-Object-Type.html#G-OBJECT:CAPS">G_OBJECT</a> (self),

521

<a href="http://library.gnome.org/devel/glib/unstable/glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a> (<a href="GSimpleAsyncResult.html#g-simple-async-result-is-valid">g_simple_async_result_is_valid</a> (result,

522

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#G-OBJECT:CAPS">G_OBJECT</a> (self),

523

baker_bake_cake_async),

524

NULL);

525

529

return NULL;

530

531

cake = CAKE (<a href="GSimpleAsyncResult.html#g-simple-async-result-get-op-res-gpointer">g_simple_async_result_get_op_res_gpointer</a> (simple));

532

return <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-ref">g_object_ref</a> (cake);

532

return <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref">g_object_ref</a> (cake);

533

}</pre></td>

534

</tr>

535

</tbody>

544

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

545

<pre class="programlisting">void

546

(*GSimpleAsyncThreadFunc) (<code><a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a> *res</code>,

547

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

547

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

548

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

549

Simple thread function that runs an asynchronous operation and

550

checks for cancellation.

564

</tr>

565

<tr>

566

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

567

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

567

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

568

569

</tr>

570

<tr>

571

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

572

<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>

572

<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>

573

574

</tr>

575

</tbody>

580

581

<a name="g-simple-async-result-new"></a><h3>g_simple_async_result_new ()</h3>

582

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

583

g_simple_async_result_new (<code><a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a> *source_object</code>,

583

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

584

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

585

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

586

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

585

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

586

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

587

Creates a <a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a>.

588

The common convention is to create the <a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a> in the

589

function that starts the asynchronous operation and use that same

604

<tbody>

605

<tr>

606

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

607

<td class="parameter_description"> a <a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

607

<td class="parameter_description"> a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

608

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

609

</tr>

610

<tr>

636

637

<a name="g-simple-async-result-new-error"></a><h3>g_simple_async_result_new_error ()</h3>

638

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

639

g_simple_async_result_new_error (<code><a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a> *source_object</code>,

639

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

640

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

641

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

642

<code><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> domain</code>,

643

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

641

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

642

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> domain</code>,

643

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

644

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

645

646

Creates a new <a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a> with a set error.

655

<tbody>

656

<tr>

657

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

658

659

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

660

</tr>

661

<tr>

671

</tr>

672

<tr>

673

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

674

<td class="parameter_description">a <a href="../glib/glib-Quarks.html#GQuark">GQuark</a>.</td>

674

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

675

676

</tr>

677

<tr>

703

704

<a name="g-simple-async-result-new-from-error"></a><h3>g_simple_async_result_new_from_error ()</h3>

705

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

706

g_simple_async_result_new_from_error (<code><a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a> *source_object</code>,

706

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

707

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

708

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

709

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

708

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

709

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

710

Creates a <a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a> from an error condition.

711

712

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

719

<tbody>

720

<tr>

721

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

722

723

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

724

</tr>

725

<tr>

735

</tr>

736

<tr>

737

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

738

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

738

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

739

740

</tr>

741

</tbody>

751

752

<a name="g-simple-async-result-new-take-error"></a><h3>g_simple_async_result_new_take_error ()</h3>

753

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

754

g_simple_async_result_new_take_error (<code><a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a> *source_object</code>,

754

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

755

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

756

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

757

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

756

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

757

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

758

Creates a <a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a> from an error condition, and takes over the

759

caller's ownership of <code>error</code>

760

, so the caller does not need to free it anymore.

769

<tbody>

770

<tr>

771

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

772

773

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

774

</tr>

775

<tr>

785

</tr>

786

<tr>

787

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

788

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

788

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

789

790

</tr>

791

</tbody>

833

</tr>

834

<tr>

835

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

836

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

836

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

837

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

838

</tr>

839

</tbody>

847

<pre class="programlisting">void

848

g_simple_async_result_set_op_res_gpointer

849

(<code><a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a> *simple</code>,

850

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

851

<code><a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_op_res</code>);</pre>

850

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

851

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy_op_res</code>);</pre>

852

Sets the operation result within the asynchronous result to a pointer.

853

854

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

871

</tr>

872

<tr>

873

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

874

<td class="parameter_description">a <a href="../glib/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> function.</td>

874

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> function.</td>

875

876

</tr>

877

</tbody>

881

<hr>

882

883

<a name="g-simple-async-result-get-op-res-gpointer"></a><h3>g_simple_async_result_get_op_res_gpointer ()</h3>

884

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

884

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

885

g_simple_async_result_get_op_res_gpointer

886

(<code><a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a> *simple</code>);</pre>

887

Gets a pointer result as returned by the asynchronous function.

912

<pre class="programlisting">void

913

g_simple_async_result_set_op_res_gssize

914

(<code><a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a> *simple</code>,

915

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

915

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

916

Sets the operation result within the asynchronous result to

917

the given <code>op_res</code>

918

.

932

</tr>

933

<tr>

934

935

<td class="parameter_description">a <a href="../glib/glib-Basic-Types.html#gssize">gssize</a>.</td>

935

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

936

937

</tr>

938

</tbody>

942

<hr>

943

944

<a name="g-simple-async-result-get-op-res-gssize"></a><h3>g_simple_async_result_get_op_res_gssize ()</h3>

945

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

945

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

946

g_simple_async_result_get_op_res_gssize

947

(<code><a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a> *simple</code>);</pre>

948

Gets a gssize from the asynchronous result.

973

<pre class="programlisting">void

974

g_simple_async_result_set_op_res_gboolean

975

(<code><a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a> *simple</code>,

976

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

976

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

977

Sets the operation result to a boolean within the asynchronous result.

978

979

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

991

</tr>

992

<tr>

993

994

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

994

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

995

996

</tr>

997

</tbody>

1001

<hr>

1002

1003

<a name="g-simple-async-result-get-op-res-gboolean"></a><h3>g_simple_async_result_get_op_res_gboolean ()</h3>

1004

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

1004

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

1005

g_simple_async_result_get_op_res_gboolean

1006

(<code><a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a> *simple</code>);</pre>

1007

Gets the operation result boolean from within the asynchronous result.

1022

</div>

1023

1024

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

1025

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation's result was <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>

1026

if the operation's result was <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.

1025

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation's result was <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>

1026

if the operation's result was <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.

1027

1028

</div>

1029

</div>

1030

<hr>

1031

1032

<a name="g-simple-async-result-get-source-tag"></a><h3>g_simple_async_result_get_source_tag ()</h3>

1033

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

1033

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

1034

g_simple_async_result_get_source_tag (<code><a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a> *simple</code>);</pre>

1035

Gets the source tag for the <a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a>.

1036

1050

</div>

1051

1052

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

1053

a <a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> to the source object for the <a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a>.

1053

a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> to the source object for the <a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a>.

1054

1055

</div>

1056

</div>

1057

<hr>

1058

1059

<a name="g-simple-async-result-is-valid"></a><h3>g_simple_async_result_is_valid ()</h3>

1060

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

1060

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

1061

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

1062

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

1063

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

1062

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

1063

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

1064

Ensures that the data passed to the _finish function of an async

1065

operation is consistent. Three checks are performed.

1066

First, <code>result</code>

1077

which this function is called). (Alternatively, if either

1078

<code>source_tag</code>

1079

or <code>result</code>

1080

's source tag is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the source tag

1080

's source tag is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the source tag

1081

check is skipped.)

1082

1083

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

1095

</tr>

1096

<tr>

1097

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

1098

<td class="parameter_description"> the <a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a> passed to the _finish function. </td>

1098

<td class="parameter_description"> the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> passed to the _finish function. </td>

1099

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

1100

</tr>

1101

<tr>

1108

</div>

1109

1110

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

1111

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a> if all checks passed or <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a> if any failed.

1111

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a> if all checks passed or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a> if any failed.

1112

1113

</div>

1114

Since 2.20

1119

<pre class="programlisting">void

1120

g_simple_async_result_set_handle_cancellation

1121

(<code><a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a> *simple</code>,

1122

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

1122

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

1123

Sets whether to handle cancellation within the asynchronous operation.

1124

This function has nothing to do with

1125

<a class="link" href="GSimpleAsyncResult.html#g-simple-async-result-set-check-cancellable" title="g_simple_async_result_set_check_cancellable ()"><code class="function">g_simple_async_result_set_check_cancellable()</code></a>. It only refers to the

1140

</tr>

1141

<tr>

1142

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

1143

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

1143

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

1144

1145

</tr>

1146

</tbody>

1182

g_simple_async_result_complete_in_idle

1183

(<code><a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a> *simple</code>);</pre>

1184

Completes an asynchronous function in an idle handler in the

1185

<a href="../glib/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>

1185

<a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-main-context-push-thread-default">thread-default main context</a>

1186

of the thread that <code>simple</code>

1187

was initially created in

1188

(and re-pushes that context around the invocation of the callback).

1246

</tr>

1247

<tr>

1248

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

1249

<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>

1249

<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>

1250

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

1251

</tr>

1252

</tbody>

1258

<a name="g-simple-async-result-set-from-error"></a><h3>g_simple_async_result_set_from_error ()</h3>

1259

<pre class="programlisting">void

1260

g_simple_async_result_set_from_error (<code><a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a> *simple</code>,

1261

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

1262

Sets the result from a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>.

1261

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

1262

Sets the result from a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>.

1263

1264

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

1265

1276

</tr>

1277

<tr>

1278

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

1279

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

1279

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

1280

1281

</tr>

1282

</tbody>

1288

<a name="g-simple-async-result-take-error"></a><h3>g_simple_async_result_take_error ()</h3>

1289

<pre class="programlisting">void

1290

g_simple_async_result_take_error (<code><a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a> *simple</code>,

1291

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

1291

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

1292

Sets the result from <code>error</code>

1293

, and takes over the caller's ownership

1294

of <code>error</code>

1309

</tr>

1310

<tr>

1311

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

1312

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

1312

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

1313

1314

</tr>

1315

</tbody>

1320

<hr>

1321

1322

<a name="g-simple-async-result-propagate-error"></a><h3>g_simple_async_result_propagate_error ()</h3>

1323

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

1323

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

1324

g_simple_async_result_propagate_error (<code><a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a> *simple</code>,

1325

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

1325

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

1326

Propagates an error from within the simple asynchronous result to

1327

a given destination.

1328

If the <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> given to a prior call to

1329

1330

function will return <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> with <code>dest</code>

1330

function will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> with <code>dest</code>

1331

set appropriately.

1332

1333

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

1353

</div>

1354

1355

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

1356

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the error was propagated to <code>dest</code>

1357

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

1356

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

1357

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

1358

1359

</div>

1360

</div>

1363

<a name="g-simple-async-result-set-error"></a><h3>g_simple_async_result_set_error ()</h3>

1364

<pre class="programlisting">void

1365

g_simple_async_result_set_error (<code><a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a> *simple</code>,

1366

<code><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> domain</code>,

1367

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

1366

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> domain</code>,

1367

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

1368

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

1369

1370

Sets an error within the asynchronous result without a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>.

1370

Sets an error within the asynchronous result without a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>.

1371

1372

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

1373

1384

</tr>

1385

<tr>

1386

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

1387

<td class="parameter_description">a <a href="../glib/glib-Quarks.html#GQuark">GQuark</a> (usually <a class="link" href="gio-GIOError.html#G-IO-ERROR:CAPS" title="G_IO_ERROR">G_IO_ERROR</a>).</td>

1387

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> (usually <a class="link" href="gio-GIOError.html#G-IO-ERROR:CAPS" title="G_IO_ERROR">G_IO_ERROR</a>).</td>

1388

1389

</tr>

1390

<tr>

1412

<a name="g-simple-async-result-set-error-va"></a><h3>g_simple_async_result_set_error_va ()</h3>

1413

<pre class="programlisting">void

1414

g_simple_async_result_set_error_va (<code><a class="link" href="GSimpleAsyncResult.html" title="GSimpleAsyncResult">GSimpleAsyncResult</a> *simple</code>,

1415

<code><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> domain</code>,

1416

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

1415

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> domain</code>,

1416

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

1417

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

1418

1419

Sets an error within the asynchronous result without a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>.

1419

Sets an error within the asynchronous result without a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>.

1420

Unless writing a binding, see <a class="link" href="GSimpleAsyncResult.html#g-simple-async-result-set-error" title="g_simple_async_result_set_error ()"><code class="function">g_simple_async_result_set_error()</code></a>.

1421

1422

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

1434

</tr>

1435

<tr>

1436

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

1437

1438

1439

</tr>

1440

<tr>

1460

1461

<a name="g-simple-async-report-error-in-idle"></a><h3>g_simple_async_report_error_in_idle ()</h3>

1462

<pre class="programlisting">void

1463

g_simple_async_report_error_in_idle (<code><a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

1463

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

1464

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

1465

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

1466

<code><a href="../glib/glib-Quarks.html#GQuark">GQuark</a> domain</code>,

1467

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

1465

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

1466

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> domain</code>,

1467

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

1468

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

1469

1470

Reports an error in an asynchronous function in an idle function by

1481

<tbody>

1482

<tr>

1483

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

1484

1485

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

1486

</tr>

1487

<tr>

1497

</tr>

1498

<tr>

1499

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

1500

<td class="parameter_description">a <a href="../glib/glib-Quarks.html#GQuark">GQuark</a> containing the error domain (usually <a class="link" href="gio-GIOError.html#G-IO-ERROR:CAPS" title="G_IO_ERROR">G_IO_ERROR</a>).</td>

1500

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark">GQuark</a> containing the error domain (usually <a class="link" href="gio-GIOError.html#G-IO-ERROR:CAPS" title="G_IO_ERROR">G_IO_ERROR</a>).</td>

1501

1502

</tr>

1503

<tr>

1524

1525

<a name="g-simple-async-report-gerror-in-idle"></a><h3>g_simple_async_report_gerror_in_idle ()</h3>

1526

<pre class="programlisting">void

1527

g_simple_async_report_gerror_in_idle (<code><a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

1527

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

1528

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

1529

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

1530

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

1529

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

1530

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

1531

Reports an error in an idle function. Similar to

1532

<a class="link" href="GSimpleAsyncResult.html#g-simple-async-report-error-in-idle" title="g_simple_async_report_error_in_idle ()"><code class="function">g_simple_async_report_error_in_idle()</code></a>, but takes a <a href="../glib/glib-Error-Reporting.html#GError">GError</a> rather

1532

<a class="link" href="GSimpleAsyncResult.html#g-simple-async-report-error-in-idle" title="g_simple_async_report_error_in_idle ()"><code class="function">g_simple_async_report_error_in_idle()</code></a>, but takes a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> rather

1533

than building a new one.

1534

1535

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

1542

<tbody>

1543

<tr>

1544

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

1545

1546

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

1547

</tr>

1548

<tr>

1558

</tr>

1559

<tr>

1560

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

1561

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

1561

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

1562

1563

</tr>

1564

</tbody>

1570

<a name="g-simple-async-report-take-gerror-in-idle"></a><h3>g_simple_async_report_take_gerror_in_idle ()</h3>

1571

<pre class="programlisting">void

1572

g_simple_async_report_take_gerror_in_idle

1573

(<code><a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a> *object</code>,

1573

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

1574

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

1575

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

1576

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

1575

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

1576

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

1577

Reports an error in an idle function. Similar to

1578

<a class="link" href="GSimpleAsyncResult.html#g-simple-async-report-gerror-in-idle" title="g_simple_async_report_gerror_in_idle ()"><code class="function">g_simple_async_report_gerror_in_idle()</code></a>, but takes over the caller's

1579

ownership of <code>error</code>

1589

<tbody>

1590

<tr>

1591

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

1592

1593

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

1594

</tr>

1595

<tr>

1605

</tr>

1606

<tr>

1607

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

1608

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

1608

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

1609

1610

</tr>

1611

</tbody>

Older »