istream_pop_gbuffer()

Pops and returns the current gbuffer_t * associated with the specified istream. After calling this function, the istream will no longer hold the current gbuffer_t *, and it becomes the caller’s responsibility to manage it.

C

Prototype

PUBLIC gbuffer_t *istream_pop_gbuffer(
    istream_h   istream
);

Parameters

Key	Type	Description
istream	istream_h	The handle to the istream whose current gbuffer_t * is to be popped.

---

Return Value

Returns a pointer to the current gbuffer_t * of the istream. If the istream is NULL, the function logs an error and returns NULL.

Notes

• After calling this function, the istream’s internal gbuffer_t * is reset to NULL.

• The returned gbuffer_t * must be properly decremented (GBUFFER_DECREF) or freed by the caller to avoid memory leaks.

JS

Prototype

// Not applicable in JS

Python

Prototype

# Not applicable in Python

Examples

C

// TODO C examples

JS

// TODO JS examples

Python

# TODO Python examples