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