~ubuntu-branches/debian/jessie/glib2.0/jessie : revision 120

84

</tr>

85

<tr>

86

87

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

87

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

88

</td>

89

90

<a class="link" href="GDataInputStream.html#g-data-input-stream-read-byte" title="g_data_input_stream_read_byte ()">g_data_input_stream_read_byte</a> ()

92

</tr>

93

<tr>

94

95

95

96

</td>

97

98

<a class="link" href="GDataInputStream.html#g-data-input-stream-read-int16" title="g_data_input_stream_read_int16 ()">g_data_input_stream_read_int16</a> ()

100

</tr>

101

<tr>

102

103

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

103

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

104

</td>

105

106

<a class="link" href="GDataInputStream.html#g-data-input-stream-read-uint16" title="g_data_input_stream_read_uint16 ()">g_data_input_stream_read_uint16</a> ()

108

</tr>

109

<tr>

110

111

111

112

</td>

113

114

<a class="link" href="GDataInputStream.html#g-data-input-stream-read-int32" title="g_data_input_stream_read_int32 ()">g_data_input_stream_read_int32</a> ()

116

</tr>

117

<tr>

118

119

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

119

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

120

</td>

121

122

<a class="link" href="GDataInputStream.html#g-data-input-stream-read-uint32" title="g_data_input_stream_read_uint32 ()">g_data_input_stream_read_uint32</a> ()

124

</tr>

125

<tr>

126

127

127

128

</td>

129

130

<a class="link" href="GDataInputStream.html#g-data-input-stream-read-int64" title="g_data_input_stream_read_int64 ()">g_data_input_stream_read_int64</a> ()

132

</tr>

133

<tr>

134

135

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

135

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

136

</td>

137

138

<a class="link" href="GDataInputStream.html#g-data-input-stream-read-uint64" title="g_data_input_stream_read_uint64 ()">g_data_input_stream_read_uint64</a> ()

276

</div>

277

278

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

279

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

279

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

280

╰── <a class="link" href="GInputStream.html" title="GInputStream">GInputStream</a>

281

╰── <a class="link" href="GFilterInputStream.html" title="GFilterInputStream">GFilterInputStream</a>

282

╰── <a class="link" href="GBufferedInputStream.html" title="GBufferedInputStream">GBufferedInputStream</a>

456

<hr>

457

458

<a name="g-data-input-stream-read-byte"></a><h3>g_data_input_stream_read_byte ()</h3>

459

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

459

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

460

g_data_input_stream_read_byte (<code><a class="link" href="GDataInputStream.html" title="GDataInputStream">GDataInputStream</a> *stream</code>,

461

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

462

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

462

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

463

Reads an unsigned 8-bit/1-byte value from <code>stream</code>

464

.

465

478

</tr>

479

<tr>

480

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

481

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

481

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

482

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

483

</tr>

484

<tr>

485

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

486

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

486

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

487

488

</tr>

489

</tbody>

500

<hr>

501

502

<a name="g-data-input-stream-read-int16"></a><h3>g_data_input_stream_read_int16 ()</h3>

503

503

504

g_data_input_stream_read_int16 (<code><a class="link" href="GDataInputStream.html" title="GDataInputStream">GDataInputStream</a> *stream</code>,

505

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

506

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

506

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

507

Reads a 16-bit/2-byte value from <code>stream</code>

508

.

509

In order to get the correct byte order for this read operation,

524

</tr>

525

<tr>

526

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

527

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

527

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

528

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

529

</tr>

530

<tr>

531

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

532

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

532

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

533

534

</tr>

535

</tbody>

546

<hr>

547

548

<a name="g-data-input-stream-read-uint16"></a><h3>g_data_input_stream_read_uint16 ()</h3>

549

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

549

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

550

g_data_input_stream_read_uint16 (<code><a class="link" href="GDataInputStream.html" title="GDataInputStream">GDataInputStream</a> *stream</code>,

551

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

552

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

552

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

553

Reads an unsigned 16-bit/2-byte value from <code>stream</code>

554

.

555

In order to get the correct byte order for this read operation,

570

</tr>

571

<tr>

572

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

573

<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

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

574

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

575

</tr>

576

<tr>

577

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

578

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

578

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

579

580

</tr>

581

</tbody>

592

<hr>

593

594

<a name="g-data-input-stream-read-int32"></a><h3>g_data_input_stream_read_int32 ()</h3>

595

595

596

g_data_input_stream_read_int32 (<code><a class="link" href="GDataInputStream.html" title="GDataInputStream">GDataInputStream</a> *stream</code>,

597

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

598

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

598

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

599

Reads a signed 32-bit/4-byte value from <code>stream</code>

600

.

601

In order to get the correct byte order for this read operation,

602

see <a class="link" href="GDataInputStream.html#g-data-input-stream-get-byte-order" title="g_data_input_stream_get_byte_order ()"><code class="function">g_data_input_stream_get_byte_order()</code></a> and <a class="link" href="GDataInputStream.html#g-data-input-stream-set-byte-order" title="g_data_input_stream_set_byte_order ()"><code class="function">g_data_input_stream_set_byte_order()</code></a>.

603

If <code>cancellable</code>

604

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

604

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

605

triggering the cancellable object from another thread. If the operation

606

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

607

620

</tr>

621

<tr>

622

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

623

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

623

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

624

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

625

</tr>

626

<tr>

627

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

628

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

628

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

629

630

</tr>

631

</tbody>

642

<hr>

643

644

<a name="g-data-input-stream-read-uint32"></a><h3>g_data_input_stream_read_uint32 ()</h3>

645

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

645

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

646

g_data_input_stream_read_uint32 (<code><a class="link" href="GDataInputStream.html" title="GDataInputStream">GDataInputStream</a> *stream</code>,

647

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

648

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

648

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

649

Reads an unsigned 32-bit/4-byte value from <code>stream</code>

650

.

651

In order to get the correct byte order for this read operation,

652

see <a class="link" href="GDataInputStream.html#g-data-input-stream-get-byte-order" title="g_data_input_stream_get_byte_order ()"><code class="function">g_data_input_stream_get_byte_order()</code></a> and <a class="link" href="GDataInputStream.html#g-data-input-stream-set-byte-order" title="g_data_input_stream_set_byte_order ()"><code class="function">g_data_input_stream_set_byte_order()</code></a>.

653

If <code>cancellable</code>

654

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

654

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

655

triggering the cancellable object from another thread. If the operation

656

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

657

670

</tr>

671

<tr>

672

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

673

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

673

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

674

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

675

</tr>

676

<tr>

677

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

678

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

678

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

679

680

</tr>

681

</tbody>

692

<hr>

693

694

<a name="g-data-input-stream-read-int64"></a><h3>g_data_input_stream_read_int64 ()</h3>

695

695

696

g_data_input_stream_read_int64 (<code><a class="link" href="GDataInputStream.html" title="GDataInputStream">GDataInputStream</a> *stream</code>,

697

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

698

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

698

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

699

Reads a 64-bit/8-byte value from <code>stream</code>

700

.

701

In order to get the correct byte order for this read operation,

702

see <a class="link" href="GDataInputStream.html#g-data-input-stream-get-byte-order" title="g_data_input_stream_get_byte_order ()"><code class="function">g_data_input_stream_get_byte_order()</code></a> and <a class="link" href="GDataInputStream.html#g-data-input-stream-set-byte-order" title="g_data_input_stream_set_byte_order ()"><code class="function">g_data_input_stream_set_byte_order()</code></a>.

703

If <code>cancellable</code>

704

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

704

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

705

triggering the cancellable object from another thread. If the operation

706

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

707

720

</tr>

721

<tr>

722

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

723

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

723

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

724

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

725

</tr>

726

<tr>

727

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

728

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

728

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

729

730

</tr>

731

</tbody>

742

<hr>

743

744

<a name="g-data-input-stream-read-uint64"></a><h3>g_data_input_stream_read_uint64 ()</h3>

745

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

745

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

746

g_data_input_stream_read_uint64 (<code><a class="link" href="GDataInputStream.html" title="GDataInputStream">GDataInputStream</a> *stream</code>,

747

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

748

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

748

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

749

Reads an unsigned 64-bit/8-byte value from <code>stream</code>

750

.

751

In order to get the correct byte order for this read operation,

752

see <a class="link" href="GDataInputStream.html#g-data-input-stream-get-byte-order" title="g_data_input_stream_get_byte_order ()"><code class="function">g_data_input_stream_get_byte_order()</code></a>.

753

If <code>cancellable</code>

754

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

754

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

755

triggering the cancellable object from another thread. If the operation

756

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

757

770

</tr>

771

<tr>

772

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

773

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

773

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

774

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

775

</tr>

776

<tr>

777

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

778

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

778

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

779

780

</tr>

781

</tbody>

794

<a name="g-data-input-stream-read-line"></a><h3>g_data_input_stream_read_line ()</h3>

795

<pre class="programlisting">char *

796

g_data_input_stream_read_line (<code><a class="link" href="GDataInputStream.html" title="GDataInputStream">GDataInputStream</a> *stream</code>,

797

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

797

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

798

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

799

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

799

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

800

Reads a line from the data input stream. Note that no encoding

801

checks or conversion is performed; the input is not guaranteed to

802

be UTF-8, and may in fact have embedded NUL characters.

803

If <code>cancellable</code>

804

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

804

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

805

triggering the cancellable object from another thread. If the operation

806

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

807

820

</tr>

821

<tr>

822

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

823

<td class="parameter_description"> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> to get the length of the data read in. </td>

823

<td class="parameter_description"> a <a href="../glib/glib-Basic-Types.html#gsize">gsize</a> to get the length of the data read in. </td>

824

825

</tr>

826

<tr>

827

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

828

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

828

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

829

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

830

</tr>

831

<tr>

832

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

833

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

833

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

834

835

</tr>

836

</tbody>

840

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

841

a NUL terminated byte array with the line that was read in

842

(without the newlines). Set <code>length</code>

843

to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> to get the length

844

of the read line. On an error, it will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and <code>error</code>

843

to a <a href="../glib/glib-Basic-Types.html#gsize">gsize</a> to get the length

844

of the read line. On an error, it will return <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and <code>error</code>

845

will be set. If there's no content to read, it will still return

846

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

846

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

847

won't be set.

848

[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value.">nullable</acronym>][<acronym title="Free data after the code is done.">transfer full</acronym>][<acronym title="Parameter points to an array of items.">array</acronym> zero-terminated=1][<acronym title="Generics and defining elements of containers and arrays.">element-type</acronym> guint8]

849

</div>

853

<a name="g-data-input-stream-read-line-utf8"></a><h3>g_data_input_stream_read_line_utf8 ()</h3>

854

<pre class="programlisting">char *

855

g_data_input_stream_read_line_utf8 (<code><a class="link" href="GDataInputStream.html" title="GDataInputStream">GDataInputStream</a> *stream</code>,

856

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

856

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

857

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

858

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

858

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

859

Reads a UTF-8 encoded line from the data input stream.

860

If <code>cancellable</code>

861

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

861

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

862

triggering the cancellable object from another thread. If the operation

863

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

864

877

</tr>

878

<tr>

879

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

880

<td class="parameter_description"> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> to get the length of the data read in. </td>

880

<td class="parameter_description"> a <a href="../glib/glib-Basic-Types.html#gsize">gsize</a> to get the length of the data read in. </td>

881

882

</tr>

883

<tr>

884

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

885

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

885

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

886

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

887

</tr>

888

<tr>

889

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

890

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

890

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

891

892

</tr>

893

</tbody>

898

a NUL terminated UTF-8 string

899

with the line that was read in (without the newlines). Set

900

<code>length</code>

901

to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> to get the length of the read line. On an

902

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

901

to a <a href="../glib/glib-Basic-Types.html#gsize">gsize</a> to get the length of the read line. On an

902

error, it will return <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and <code>error</code>

903

will be set. For UTF-8

904

conversion errors, the set error domain is <a href="http://library.gnome.org/devel/glib/unstable/glib-Character-Set-Conversion.html#G-CONVERT-ERROR:CAPS"><code class="literal">G_CONVERT_ERROR</code></a>. If

905

there's no content to read, it will still return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, but <code>error</code>

904

conversion errors, the set error domain is <a href="../glib/glib-Character-Set-Conversion.html#G-CONVERT-ERROR:CAPS"><code class="literal">G_CONVERT_ERROR</code></a>. If

905

there's no content to read, it will still return <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, but <code>error</code>

906

won't be set.

907

[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value.">nullable</acronym>][<acronym title="Free data after the code is done.">transfer full</acronym>]

908

</div>

913

<a name="g-data-input-stream-read-line-async"></a><h3>g_data_input_stream_read_line_async ()</h3>

914

<pre class="programlisting">void

915

g_data_input_stream_read_line_async (<code><a class="link" href="GDataInputStream.html" title="GDataInputStream">GDataInputStream</a> *stream</code>,

916

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

916

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

917

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

918

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

919

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

919

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

920

The asynchronous version of <a class="link" href="GDataInputStream.html#g-data-input-stream-read-line" title="g_data_input_stream_read_line ()"><code class="function">g_data_input_stream_read_line()</code></a>. It is

921

an error to have two outstanding calls to this function.

922

When the operation is finished, <code>callback</code>

944

</tr>

945

<tr>

946

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

947

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

947

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

948

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

949

</tr>

950

<tr>

968

<pre class="programlisting">char *

969

g_data_input_stream_read_line_finish (<code><a class="link" href="GDataInputStream.html" title="GDataInputStream">GDataInputStream</a> *stream</code>,

970

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

971

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

972

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

971

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

972

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

973

Finish an asynchronous call started by

974

<a class="link" href="GDataInputStream.html#g-data-input-stream-read-line-async" title="g_data_input_stream_read_line_async ()"><code class="function">g_data_input_stream_read_line_async()</code></a>. Note the warning about

975

string encoding in <a class="link" href="GDataInputStream.html#g-data-input-stream-read-line" title="g_data_input_stream_read_line ()"><code class="function">g_data_input_stream_read_line()</code></a> applies here as

995

</tr>

996

<tr>

997

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

998

<td class="parameter_description"> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> to get the length of the data read in. </td>

998

<td class="parameter_description"> a <a href="../glib/glib-Basic-Types.html#gsize">gsize</a> to get the length of the data read in. </td>

999

1000

</tr>

1001

<tr>

1002

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

1003

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

1003

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

1004

1005

</tr>

1006

</tbody>

1010

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

1011

a NUL-terminated byte array with the line that was read in

1012

(without the newlines). Set <code>length</code>

1013

to a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> to get the length

1014

of the read line. On an error, it will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and <code>error</code>

1013

to a <a href="../glib/glib-Basic-Types.html#gsize">gsize</a> to get the length

1014

of the read line. On an error, it will return <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and <code>error</code>

1015

will be set. If there's no content to read, it will still return

1016

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

1016

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

1017

won't be set.

1018

[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value.">nullable</acronym>][<acronym title="Free data after the code is done.">transfer full</acronym>][<acronym title="Parameter points to an array of items.">array</acronym> zero-terminated=1][<acronym title="Generics and defining elements of containers and arrays.">element-type</acronym> guint8]

1019

</div>

1026

g_data_input_stream_read_line_finish_utf8

1027

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

1028

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

1029

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

1030

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

1029

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

1030

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

1031

Finish an asynchronous call started by

1032

<a class="link" href="GDataInputStream.html#g-data-input-stream-read-line-async" title="g_data_input_stream_read_line_async ()"><code class="function">g_data_input_stream_read_line_async()</code></a>.

1033

1051

</tr>

1052

<tr>

1053

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

1054

<td class="parameter_description"> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> to get the length of the data read in. </td>

1054

<td class="parameter_description"> a <a href="../glib/glib-Basic-Types.html#gsize">gsize</a> to get the length of the data read in. </td>

1055

1056

</tr>

1057

<tr>

1058

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

1059

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

1059

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

1060

1061

</tr>

1062

</tbody>

1066

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

1067

a string with the line that

1068

was read in (without the newlines). Set <code>length</code>

1069

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

1069

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

1070

get the length of the read line. On an error, it will return

1071

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

1071

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

1072

will be set. For UTF-8 conversion errors, the set

1073

error domain is <a href="http://library.gnome.org/devel/glib/unstable/glib-Character-Set-Conversion.html#G-CONVERT-ERROR:CAPS"><code class="literal">G_CONVERT_ERROR</code></a>. If there's no content to read,

1074

it will still return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, but <code>error</code>

1073

error domain is <a href="../glib/glib-Character-Set-Conversion.html#G-CONVERT-ERROR:CAPS"><code class="literal">G_CONVERT_ERROR</code></a>. If there's no content to read,

1074

it will still return <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, but <code>error</code>

1075

won't be set.

1076

[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value.">nullable</acronym>][<acronym title="Free data after the code is done.">transfer full</acronym>]

1077

</div>

1082

<a name="g-data-input-stream-read-upto"></a><h3>g_data_input_stream_read_upto ()</h3>

1083

<pre class="programlisting">char *

1084

g_data_input_stream_read_upto (<code><a class="link" href="GDataInputStream.html" title="GDataInputStream">GDataInputStream</a> *stream</code>,

1085

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

1086

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

1087

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

1085

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

1086

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

1087

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

1088

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

1089

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

1089

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

1090

Reads a string from the data input stream, up to the first

1091

occurrence of any of the stop characters.

1092

In contrast to <a class="link" href="GDataInputStream.html#g-data-input-stream-read-until" title="g_data_input_stream_read_until ()"><code class="function">g_data_input_stream_read_until()</code></a>, this function

1126

</tr>

1127

<tr>

1128

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

1129

<td class="parameter_description"> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> to get the length of the data read in. </td>

1129

<td class="parameter_description"> a <a href="../glib/glib-Basic-Types.html#gsize">gsize</a> to get the length of the data read in. </td>

1130

1131

</tr>

1132

<tr>

1133

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

1134

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

1134

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

1135

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

1136

</tr>

1137

<tr>

1138

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

1139

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

1139

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

1140

1141

</tr>

1142

</tbody>

1147

a string with the data that was read

1148

before encountering any of the stop characters. Set <code>length</code>

1149

to

1150

a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> to get the length of the string. This function will

1151

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

1150

a <a href="../glib/glib-Basic-Types.html#gsize">gsize</a> to get the length of the string. This function will

1151

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

1152

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

1153

</div>

1154

Since 2.26

1158

<a name="g-data-input-stream-read-upto-async"></a><h3>g_data_input_stream_read_upto_async ()</h3>

1159

<pre class="programlisting">void

1160

g_data_input_stream_read_upto_async (<code><a class="link" href="GDataInputStream.html" title="GDataInputStream">GDataInputStream</a> *stream</code>,

1161

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

1162

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

1163

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

1161

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

1162

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

1163

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

1164

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

1165

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

1166

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

1166

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

1167

The asynchronous version of <a class="link" href="GDataInputStream.html#g-data-input-stream-read-upto" title="g_data_input_stream_read_upto ()"><code class="function">g_data_input_stream_read_upto()</code></a>.

1168

It is an error to have two outstanding calls to this function.

1169

In contrast to <a class="link" href="GDataInputStream.html#g-data-input-stream-read-until" title="g_data_input_stream_read_until ()"><code class="function">g_data_input_stream_read_until()</code></a>, this function

1212

</tr>

1213

<tr>

1214

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

1215

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

1215

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

1216

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

1217

</tr>

1218

<tr>

1236

<pre class="programlisting">char *

1237

g_data_input_stream_read_upto_finish (<code><a class="link" href="GDataInputStream.html" title="GDataInputStream">GDataInputStream</a> *stream</code>,

1238

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

1239

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

1240

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

1239

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

1240

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

1241

Finish an asynchronous call started by

1242

<a class="link" href="GDataInputStream.html#g-data-input-stream-read-upto-async" title="g_data_input_stream_read_upto_async ()"><code class="function">g_data_input_stream_read_upto_async()</code></a>.

1243

Note that this function does not consume the stop character. You

1264

</tr>

1265

<tr>

1266

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

1267

<td class="parameter_description"> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> to get the length of the data read in. </td>

1267

<td class="parameter_description"> a <a href="../glib/glib-Basic-Types.html#gsize">gsize</a> to get the length of the data read in. </td>

1268

1269

</tr>

1270

<tr>

1271

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

1272

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

1272

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

1273

1274

</tr>

1275

</tbody>

1280

a string with the data that was read

1281

before encountering any of the stop characters. Set <code>length</code>

1282

to

1283

a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> to get the length of the string. This function will

1284

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

1283

a <a href="../glib/glib-Basic-Types.html#gsize">gsize</a> to get the length of the string. This function will

1284

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

1285

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

1286

</div>

1287

Since 2.24

1291

<a name="g-data-input-stream-read-until"></a><h3>g_data_input_stream_read_until ()</h3>

1292

<pre class="programlisting">char *

1293

g_data_input_stream_read_until (<code><a class="link" href="GDataInputStream.html" title="GDataInputStream">GDataInputStream</a> *stream</code>,

1294

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

1295

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

1294

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

1295

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

1296

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

1297

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

1297

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

1298

Reads a string from the data input stream, up to the first

1299

occurrence of any of the stop characters.

1300

Note that, in contrast to <a class="link" href="GDataInputStream.html#g-data-input-stream-read-until-async" title="g_data_input_stream_read_until_async ()"><code class="function">g_data_input_stream_read_until_async()</code></a>,

1325

</tr>

1326

<tr>

1327

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

1328

<td class="parameter_description"> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> to get the length of the data read in. </td>

1328

<td class="parameter_description"> a <a href="../glib/glib-Basic-Types.html#gsize">gsize</a> to get the length of the data read in. </td>

1329

1330

</tr>

1331

<tr>

1332

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

1333

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

1333

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

1334

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

1335

</tr>

1336

<tr>

1337

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

1338

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

1338

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

1339

1340

</tr>

1341

</tbody>

1346

a string with the data that was read

1347

before encountering any of the stop characters. Set <code>length</code>

1348

to

1349

a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> to get the length of the string. This function will

1350

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

1349

a <a href="../glib/glib-Basic-Types.html#gsize">gsize</a> to get the length of the string. This function will

1350

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

1351

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

1352

</div>

1353

</div>

1356

<a name="g-data-input-stream-read-until-async"></a><h3>g_data_input_stream_read_until_async ()</h3>

1357

<pre class="programlisting">void

1358

g_data_input_stream_read_until_async (<code><a class="link" href="GDataInputStream.html" title="GDataInputStream">GDataInputStream</a> *stream</code>,

1359

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

1360

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

1359

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

1360

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

1361

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

1362

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

1363

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

1363

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

1364

The asynchronous version of <a class="link" href="GDataInputStream.html#g-data-input-stream-read-until" title="g_data_input_stream_read_until ()"><code class="function">g_data_input_stream_read_until()</code></a>.

1365

It is an error to have two outstanding calls to this function.

1366

Note that, in contrast to <a class="link" href="GDataInputStream.html#g-data-input-stream-read-until" title="g_data_input_stream_read_until ()"><code class="function">g_data_input_stream_read_until()</code></a>,

1400

</tr>

1401

<tr>

1402

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

1403

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

1403

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

1404

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

1405

</tr>

1406

<tr>

1424

<pre class="programlisting">char *

1425

g_data_input_stream_read_until_finish (<code><a class="link" href="GDataInputStream.html" title="GDataInputStream">GDataInputStream</a> *stream</code>,

1426

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

1427

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

1428

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

1427

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

1428

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

1429

Finish an asynchronous call started by

1430

<a class="link" href="GDataInputStream.html#g-data-input-stream-read-until-async" title="g_data_input_stream_read_until_async ()"><code class="function">g_data_input_stream_read_until_async()</code></a>.

1431

1449

</tr>

1450

<tr>

1451

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

1452

<td class="parameter_description"> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> to get the length of the data read in. </td>

1452

<td class="parameter_description"> a <a href="../glib/glib-Basic-Types.html#gsize">gsize</a> to get the length of the data read in. </td>

1453

1454

</tr>

1455

<tr>

1456

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

1457

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

1457

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

1458

1459

</tr>

1460

</tbody>

1465

a string with the data that was read

1466

before encountering any of the stop characters. Set <code>length</code>

1467

to

1468

a <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize">gsize</a> to get the length of the string. This function will

1469

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

1468

a <a href="../glib/glib-Basic-Types.html#gsize">gsize</a> to get the length of the string. This function will

1469

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

1470

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

1471

</div>

1472

Since 2.20