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

73

</tr>

74

<tr>

75

76

<a href="../glib/glib-Byte-Arrays.html#GBytes">GBytes</a> *

76

<a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#GBytes">GBytes</a> *

77

</td>

78

79

<a class="link" href="gio-GResource.html#g-resource-lookup-data" title="g_resource_lookup_data ()">g_resource_lookup_data</a> ()

97

</tr>

98

<tr>

99

100

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

100

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

101

</td>

102

103

<a class="link" href="gio-GResource.html#g-resource-get-info" title="g_resource_get_info ()">g_resource_get_info</a> ()

145

</tr>

146

<tr>

147

148

<a href="../glib/glib-Byte-Arrays.html#GBytes">GBytes</a> *

148

<a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#GBytes">GBytes</a> *

149

</td>

150

151

<a class="link" href="gio-GResource.html#g-resources-lookup-data" title="g_resources_lookup_data ()">g_resources_lookup_data</a> ()

169

</tr>

170

<tr>

171

172

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

172

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

173

</td>

174

175

<a class="link" href="gio-GResource.html#g-resources-get-info" title="g_resources_get_info ()">g_resources_get_info</a> ()

218

<a name="gio-GResource.description"></a><h2>Description</h2>

219

Applications and libraries often contain binary or textual data that is

220

really part of the application, rather than user data. For instance

221

GtkBuilder .ui files, splashscreen images, GMenu markup xml, CSS files,

221

<a href="http://developer.gnome.org/gtk2/GtkBuilder.html">GtkBuilder</a> .ui files, splashscreen images, GMenu markup xml, CSS files,

222

icons, etc. These are often shipped as files in <code class="literal">$datadir/appname</code>, or

223

manually included as literal strings in the code.

224

The <a class="link" href="gio-GResource.html#GResource" title="GResource">GResource</a> API and the <a href="glib-compile-resources.html">glib-compile-resources</a> program

316

317

<a name="g-resource-load"></a><h3>g_resource_load ()</h3>

318

<pre class="programlisting"><a class="link" href="gio-GResource.html#GResource" title="GResource">GResource</a> *

319

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

320

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

319

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

320

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

321

Loads a binary resource bundle and creates a <a class="link" href="gio-GResource.html#GResource" title="GResource">GResource</a> representation of it, allowing

322

you to query it for data.

323

If you want to use this resource in the global resource namespace you need

338

</tr>

339

<tr>

340

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

341

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

341

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

342

343

</tr>

344

</tbody>

346

</div>

347

348

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

349

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

349

a new <a class="link" href="gio-GResource.html#GResource" title="GResource">GResource</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.

350

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

351

</div>

352

Since 2.32

355

356

<a name="g-resource-new-from-data"></a><h3>g_resource_new_from_data ()</h3>

357

<pre class="programlisting"><a class="link" href="gio-GResource.html#GResource" title="GResource">GResource</a> *

358

g_resource_new_from_data (<code><a href="../glib/glib-Byte-Arrays.html#GBytes">GBytes</a> *data</code>,

359

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

358

g_resource_new_from_data (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#GBytes">GBytes</a> *data</code>,

359

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

360

Creates a GResource from a reference to the binary resource bundle.

361

This will keep a reference to <code>data</code>

362

while the resource lives, so

374

<tbody>

375

<tr>

376

377

<td class="parameter_description">A <a href="../glib/glib-Byte-Arrays.html#GBytes">GBytes</a></td>

377

<td class="parameter_description">A <a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#GBytes">GBytes</a></td>

378

379

</tr>

380

<tr>

381

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

382

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

382

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

383

384

</tr>

385

</tbody>

387

</div>

388

389

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

390

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

390

a new <a class="link" href="gio-GResource.html#GResource" title="GResource">GResource</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.

391

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

392

</div>

393

Since 2.32

452

<hr>

453

454

<a name="g-resource-lookup-data"></a><h3>g_resource_lookup_data ()</h3>

455

<pre class="programlisting"><a href="../glib/glib-Byte-Arrays.html#GBytes">GBytes</a> *

455

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#GBytes">GBytes</a> *

456

g_resource_lookup_data (<code><a class="link" href="gio-GResource.html#GResource" title="GResource">GResource</a> *resource</code>,

457

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

458

<code><a class="link" href="gio-GResource.html#GResourceLookupFlags" title="enum GResourceLookupFlags">GResourceLookupFlags</a> lookup_flags</code>,

459

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

459

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

460

Looks for a file at the specified <code>path</code>

461

in the resource and

462

returns a <a href="../glib/glib-Byte-Arrays.html#GBytes">GBytes</a> that lets you directly access the data in

462

returns a <a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#GBytes">GBytes</a> that lets you directly access the data in

463

memory.

464

The data is always followed by a zero byte, so you

465

can safely use the data as a C string. However, that byte

496

</tr>

497

<tr>

498

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

499

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

499

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

500

501

</tr>

502

</tbody>

504

</div>

505

506

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

507

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

508

Free the returned object with <a href="../glib/glib-Byte-Arrays.html#g-bytes-unref"><code class="function">g_bytes_unref()</code></a>.

507

<a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#GBytes">GBytes</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.

508

Free the returned object with <a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#g-bytes-unref"><code class="function">g_bytes_unref()</code></a>.

509

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

510

</div>

511

Since 2.32

517

g_resource_open_stream (<code><a class="link" href="gio-GResource.html#GResource" title="GResource">GResource</a> *resource</code>,

518

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

519

<code><a class="link" href="gio-GResource.html#GResourceLookupFlags" title="enum GResourceLookupFlags">GResourceLookupFlags</a> lookup_flags</code>,

520

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

520

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

521

Looks for a file at the specified <code>path</code>

522

in the resource and

523

returns a <a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a> that lets you read the data.

549

</tr>

550

<tr>

551

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

552

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

552

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

553

554

</tr>

555

</tbody>

557

</div>

558

559

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

560

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

561

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

560

<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</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.

561

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

562

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

563

</div>

564

Since 2.32

570

g_resource_enumerate_children (<code><a class="link" href="gio-GResource.html#GResource" title="GResource">GResource</a> *resource</code>,

571

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

572

<code><a class="link" href="gio-GResource.html#GResourceLookupFlags" title="enum GResourceLookupFlags">GResourceLookupFlags</a> lookup_flags</code>,

573

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

573

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

574

Returns all the names of children at the specified <code>path</code>

575

in the resource.

576

The return result is a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> terminated list of strings which should

577

be released with <a href="../glib/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a>.

576

The return result is a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> terminated list of strings which should

577

be released with <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a>.

578

<code>lookup_flags</code>

579

controls the behaviour of the lookup.

580

603

</tr>

604

<tr>

605

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

606

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

606

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

607

608

</tr>

609

</tbody>

619

<hr>

620

621

<a name="g-resource-get-info"></a><h3>g_resource_get_info ()</h3>

622

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

622

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

623

g_resource_get_info (<code><a class="link" href="gio-GResource.html#GResource" title="GResource">GResource</a> *resource</code>,

624

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

625

<code><a class="link" href="gio-GResource.html#GResourceLookupFlags" title="enum GResourceLookupFlags">GResourceLookupFlags</a> lookup_flags</code>,

626

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

627

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

628

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

626

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

627

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

628

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

629

Looks for a file at the specified <code>path</code>

630

in the resource and

631

if found returns information about it.

658

<tr>

659

660

<td class="parameter_description"> a location to place the length of the contents of the file,

661

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the length is not needed. </td>

661

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>

662

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

663

</tr>

664

<tr>

665

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

666

<td class="parameter_description"> a location to place the flags about the file,

667

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the length is not needed. </td>

667

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>

668

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

669

</tr>

670

<tr>

671

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

672

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

672

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

673

674

</tr>

675

</tbody>

677

</div>

678

679

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

680

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the file was found. <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if there were errors

680

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

681

682

</div>

683

Since 2.32

817

<hr>

818

819

<a name="g-resources-lookup-data"></a><h3>g_resources_lookup_data ()</h3>

820

<pre class="programlisting"><a href="../glib/glib-Byte-Arrays.html#GBytes">GBytes</a> *

820

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#GBytes">GBytes</a> *

821

g_resources_lookup_data (<code>const char *path</code>,

822

<code><a class="link" href="gio-GResource.html#GResourceLookupFlags" title="enum GResourceLookupFlags">GResourceLookupFlags</a> lookup_flags</code>,

823

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

823

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

824

Looks for a file at the specified <code>path</code>

825

in the set of

826

globally registered resources and returns a <a href="../glib/glib-Byte-Arrays.html#GBytes">GBytes</a> that

826

globally registered resources and returns a <a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#GBytes">GBytes</a> that

827

lets you directly access the data in memory.

828

The data is always followed by a zero byte, so you

829

can safely use the data as a C string. However, that byte

855

</tr>

856

<tr>

857

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

858

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

858

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

859

860

</tr>

861

</tbody>

863

</div>

864

865

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

866

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

867

Free the returned object with <a href="../glib/glib-Byte-Arrays.html#g-bytes-unref"><code class="function">g_bytes_unref()</code></a>.

866

<a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#GBytes">GBytes</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.

867

Free the returned object with <a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#g-bytes-unref"><code class="function">g_bytes_unref()</code></a>.

868

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

869

</div>

870

Since 2.32

875

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

876

g_resources_open_stream (<code>const char *path</code>,

877

<code><a class="link" href="gio-GResource.html#GResourceLookupFlags" title="enum GResourceLookupFlags">GResourceLookupFlags</a> lookup_flags</code>,

878

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

878

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

879

Looks for a file at the specified <code>path</code>

880

in the set of

881

globally registered resources and returns a <a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a>

903

</tr>

904

<tr>

905

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

906

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

906

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

907

908

</tr>

909

</tbody>

911

</div>

912

913

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

914

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

915

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

914

<a class="link" href="GInputStream.html" title="GInputStream">GInputStream</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.

915

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

916

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

917

</div>

918

Since 2.32

923

<pre class="programlisting">char **

924

g_resources_enumerate_children (<code>const char *path</code>,

925

<code><a class="link" href="gio-GResource.html#GResourceLookupFlags" title="enum GResourceLookupFlags">GResourceLookupFlags</a> lookup_flags</code>,

926

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

926

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

927

Returns all the names of children at the specified <code>path</code>

928

in the set of

929

globally registered resources.

930

The return result is a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> terminated list of strings which should

931

be released with <a href="../glib/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a>.

930

The return result is a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> terminated list of strings which should

931

be released with <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a>.

932

<code>lookup_flags</code>

933

controls the behaviour of the lookup.

934

952

</tr>

953

<tr>

954

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

955

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

955

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

956

957

</tr>

958

</tbody>

968

<hr>

969

970

<a name="g-resources-get-info"></a><h3>g_resources_get_info ()</h3>

971

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

971

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

972

g_resources_get_info (<code>const char *path</code>,

973

<code><a class="link" href="gio-GResource.html#GResourceLookupFlags" title="enum GResourceLookupFlags">GResourceLookupFlags</a> lookup_flags</code>,

974

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

975

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

976

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

974

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

975

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

976

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

977

Looks for a file at the specified <code>path</code>

978

in the set of

979

globally registered resources and if found returns information about it.

1001

<tr>

1002

1003

<td class="parameter_description"> a location to place the length of the contents of the file,

1004

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the length is not needed. </td>

1004

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>

1005

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

1006

</tr>

1007

<tr>

1008

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

1009

<td class="parameter_description"> a location to place the flags about the file,

1010

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the length is not needed. </td>

1010

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>

1011

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

1012

</tr>

1013

<tr>

1014

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

1015

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

1015

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

1016

1017

</tr>

1018

</tbody>

1020

</div>

1021

1022

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

1023

<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the file was found. <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if there were errors

1023

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

1024

1025

</div>

1026

Since 2.32

1031

<pre class="programlisting">#define G_RESOURCE_ERROR (g_resource_error_quark ())

1032

</pre>

1033

Error domain for <a class="link" href="gio-GResource.html#GResource" title="GResource">GResource</a>. Errors in this domain will be from the

1034

<a class="link" href="gio-GResource.html#GResourceError" title="enum GResourceError">GResourceError</a> enumeration. See <a href="../glib/glib-Error-Reporting.html#GError">GError</a> for more information on

1034

<a class="link" href="gio-GResource.html#GResourceError" title="enum GResourceError">GResourceError</a> enumeration. See <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> for more information on

1035

error domains.

1036

</div>

1037

</div>

1102

<hr>

1103

1104

<a name="GResourceError"></a><h3>enum GResourceError</h3>

1105

An error code used with <a class="link" href="gio-GResource.html#G-RESOURCE-ERROR:CAPS" title="G_RESOURCE_ERROR"><code class="literal">G_RESOURCE_ERROR</code></a> in a <a href="../glib/glib-Error-Reporting.html#GError">GError</a> returned

1105

An error code used with <a class="link" href="gio-GResource.html#G-RESOURCE-ERROR:CAPS" title="G_RESOURCE_ERROR"><code class="literal">G_RESOURCE_ERROR</code></a> in a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> returned

1106

from a <a class="link" href="gio-GResource.html#GResource" title="GResource">GResource</a> routine.

1107

1108

<a name="id-1.4.20.2.8.5.4"></a><h4>Members</h4>