~ubuntu-branches/debian/sid/glib2.0/sid

<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-id-remove-no-notify" title="g_datalist_id_remove_no_notify ()">g_datalist_id_remove_no_notify</a> (<code><a class="link" href="glib-Keyed-Data-Lists.html#GData" title="GData">GData</a> **datalist</code>,

<code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark">GQuark</a> key_id</code>);

<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> (<a class="link" href="glib-Keyed-Data-Lists.html#GDuplicateFunc" title="GDuplicateFunc ()">*GDuplicateFunc</a>) (<code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data</code>,

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

<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-id-dup-data" title="g_datalist_id_dup_data ()">g_datalist_id_dup_data</a> (<code><a class="link" href="glib-Keyed-Data-Lists.html#GData" title="GData">GData</a> **datalist</code>,

<code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark">GQuark</a> key_id</code>,

<code><a class="link" href="glib-Keyed-Data-Lists.html#GDuplicateFunc" title="GDuplicateFunc ()">GDuplicateFunc</a> dup_func</code>,

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

<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-id-replace-data" title="g_datalist_id_replace_data ()">g_datalist_id_replace_data</a> (<code><a class="link" href="glib-Keyed-Data-Lists.html#GData" title="GData">GData</a> **datalist</code>,

<code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark">GQuark</a> key_id</code>,

<code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> oldval</code>,

<code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> newval</code>,

<code><a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()">GDestroyNotify</a> destroy</code>,

<code><a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()">GDestroyNotify</a> *old_destroy</code>);

#define <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-set-data" title="g_datalist_set_data()">g_datalist_set_data</a> (dl,

108

converted to <a href="glib-Quarks.html#GQuark">GQuarks</a> anyway.

109

110

Data lists are used for associating arbitrary data with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObjects</a>,

100

using <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-set-data"><code class="function">g_object_set_data()</code></a> and related functions.

111

Data lists are used for associating arbitrary data with GObjects,

112

using <code class="function">g_object_set_data()</code> and related functions.

101

113

102

114

103

115

To create a datalist, use <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-init" title="g_datalist_init ()"><code class="function">g_datalist_init()</code></a>.

313

325

</div>

314

326

<hr>

315

327

328

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

329

<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> (*GDuplicateFunc) (<code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data</code>,

330

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

331

332

The type of functions that are used to 'duplicate' an object.

333

What this means depends on the context, it could just be

334

incrementing the reference count, if <code>data</code> is a ref-counted

335

object.

336

337

338

339

340

<col>

341

</colgroup>

342

<tbody>

343

<tr>

344

345

<td>the data to duplicate</td>

346

</tr>

347

<tr>

348

349

<td>user data that was specified in <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-id-dup-data" title="g_datalist_id_dup_data ()"><code class="function">g_datalist_id_dup_data()</code></a>

350

</td>

351

</tr>

352

<tr>

353

<td>Returns :</td>

354

<td>a duplicate of data</td>

355

</tr>

356

</tbody>

357

</table></div>

358

</div>

359

<hr>

360

361

<a name="g-datalist-id-dup-data"></a><h3>g_datalist_id_dup_data ()</h3>

362

<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> g_datalist_id_dup_data (<code><a class="link" href="glib-Keyed-Data-Lists.html#GData" title="GData">GData</a> **datalist</code>,

363

<code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark">GQuark</a> key_id</code>,

364

<code><a class="link" href="glib-Keyed-Data-Lists.html#GDuplicateFunc" title="GDuplicateFunc ()">GDuplicateFunc</a> dup_func</code>,

365

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

366

367

This is a variant of <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-id-get-data" title="g_datalist_id_get_data ()"><code class="function">g_datalist_id_get_data()</code></a> which

368

returns a 'duplicate' of the value. <code>dup_func</code> defines the

369

meaning of 'duplicate' in this context, it could e.g.

370

take a reference on a ref-counted object.

371

372

373

If the <code>key_id</code> is not set in the datalist then <code>dup_func</code>

374

will be called with a <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> argument.

375

376

377

Note that <code>dup_func</code> is called while the datalist is locked, so it

378

is not allowed to read or modify the datalist.

379

380

381

This function can be useful to avoid races when multiple

382

threads are using the same datalist and the same key.

383

384

385

386

387

<col>

388

</colgroup>

389

<tbody>

390

<tr>

391

<td><code>datalist</code> :</td>

392

<td>location of a datalist</td>

393

</tr>

394

<tr>

395

396

<td>the <a class="link" href="glib-Quarks.html#GQuark" title="GQuark">GQuark</a> identifying a data element</td>

397

</tr>

398

<tr>

399

400

<td>function to duplicate the old value. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

401

</td>

402

</tr>

403

<tr>

404

405

<td>passed as user_data to <code>dup_func</code>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

406

</td>

407

</tr>

408

<tr>

409

<td>Returns :</td>

410

<td>the result of calling <code>dup_func</code> on the value

411

associated with <code>key_id</code> in <code>datalist</code>, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if not set.

412

If <code>dup_func</code> is <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, the value is returned unmodified.</td>

413

</tr>

414

</tbody>

415

</table></div>

416

Since 2.34

417

</div>

418

<hr>

419

420

<a name="g-datalist-id-replace-data"></a><h3>g_datalist_id_replace_data ()</h3>

421

<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> g_datalist_id_replace_data (<code><a class="link" href="glib-Keyed-Data-Lists.html#GData" title="GData">GData</a> **datalist</code>,

422

<code><a class="link" href="glib-Quarks.html#GQuark" title="GQuark">GQuark</a> key_id</code>,

423

<code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> oldval</code>,

424

<code><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> newval</code>,

425

<code><a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()">GDestroyNotify</a> destroy</code>,

426

<code><a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()">GDestroyNotify</a> *old_destroy</code>);</pre>

427

428

Compares the member that is associated with <code>key_id</code> in

429

<code>datalist</code> to <code>oldval</code>, and if they are the same, replace

430

<code>oldval</code> with <code>newval</code>.

431

432

433

This is like a typical atomic compare-and-exchange

434

operation, for a member of <code>datalist</code>.

435

436

437

If the previous value was replaced then ownership of the

438

old value (<code>oldval</code>) is passed to the caller, including

439

the registred destroy notify for it (passed out in <code>old_destroy</code>).

440

Its up to the caller to free this as he wishes, which may

441

or may not include using <code>old_destroy</code> as sometimes replacement

442

should not destroy the object in the normal way.

443

444

445

Return: <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the existing value for <code>key_id</code> was replaced

446

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

447

448

449

450

451

<col>

452

</colgroup>

453

<tbody>

454

<tr>

455

<td><code>datalist</code> :</td>

456

<td>location of a datalist</td>

457

</tr>

458

<tr>

459

460

<td>the <a class="link" href="glib-Quarks.html#GQuark" title="GQuark">GQuark</a> identifying a data element</td>

461

</tr>

462

<tr>

463

<td><code>oldval</code> :</td>

464

<td>the old value to compare against. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

465

</td>

466

</tr>

467

<tr>

468

<td><code>newval</code> :</td>

469

<td>the new value to replace it with. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

470

</td>

471

</tr>

472

<tr>

473

<td><code>destroy</code> :</td>

474

<td>destroy notify for the new value. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

475

</td>

476

</tr>

477

<tr>

478

<td><code>old_destroy</code> :</td>

479

<td>destroy notify for the existing value. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

480

</td>

481

</tr>

482

</tbody>

483

</table></div>

484

Since 2.34

485

</div>

486

<hr>

487

316

488

<a name="g-datalist-set-data"></a><h3>g_datalist_set_data()</h3>

317

489

<pre class="programlisting">#define g_datalist_set_data(dl, k, d)</pre>

318

490

523

695

to keep a small number of boolean flags in an object with

524

696

a data list without using any additional space. It is

525

697

not generally useful except in circumstances where space

526

is very tight. (It is used in the base <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a> type, for

698

is very tight. (It is used in the base GObject type, for

527

699

example.)

528

700

529

701

619

791

</div>

620

792

621

793

<hr>

622

Generated by GTK-Doc V1.18</div>

794

Generated by GTK-Doc V1.18.1</div>

623

795

</body>

624

796

</html>

b'\\ No newline at end of file'

Older »