istream_reset_rd()

istream_reset_rd()#

Resets the reading pointer of the gbuffer_t * associated with the given istream_h. This allows re-reading the data in the buffer from the beginning.

Prototype

PUBLIC int istream_reset_rd(
    istream_h   istream
);

Parameters

Key

Type

Description

istream

istream_h

The handle to the istream whose reading pointer needs to be reset.


Return Value

Returns 0 if the operation was successful. Returns -1 if the istream or its associated gbuffer_t * is NULL.

Notes

  • This function logs an error if the istream or its buffer is invalid.

  • It does not affect the writing pointer or any other attributes of the istream.

Example Usage This function can be used when you need to process the data in the buffer again from the start, such as during retries or repeated operations.

Prototype

// Not applicable in JS

Prototype

# Not applicable in Python
Examples
// TODO C examples
// TODO JS examples
# TODO Python examples