istream_destroy()

istream_destroy()#

Destroys an istream created using istream_create. This function releases all memory and resources allocated for the istream, including its associated gbuffer_t.

Prototype

PUBLIC void istream_destroy(
    istream_h   istream
);

Parameters

Key

Type

Description

istream

istream_h

The handle to the istream to be destroyed.


Return Value

This function does not return a value.

Notes

  • If the istream is NULL, the function performs no operation.

  • Internally, the function:

    • Frees the memory allocated for the delimiter.

    • Resets the event name pointer to NULL.

    • Decrements and frees the associated gbuffer_t.

    • Frees the memory allocated for the istream.

  • Always call this function to clean up an istream_h to avoid memory leaks.

Prototype

// Not applicable in JS

Prototype

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