istream_read_until_num_bytes()
#
Configures the istream to read data until a specified number of bytes (num_bytes
) is accumulated. Once the condition is met, the specified event (event
) will be triggered for the associated GObj.
Prototype
PUBLIC int istream_read_until_num_bytes(
istream_h istream,
size_t num_bytes,
gobj_event_t event
);
Parameters
Key |
Type |
Description |
---|---|---|
|
|
The handle to the istream where data will be read. |
|
|
The number of bytes to accumulate before marking the reading operation as complete. |
|
|
The event to be triggered when the specified number of bytes is reached. |
Return Value
Returns 0
on successful configuration.
Returns -1
if the istream
handle is invalid.
Notes
This function resets the delimiter configuration and sets the reading mode to accumulate data based on
num_bytes
.Once the specified number of bytes is accumulated, the istream triggers the specified event (
event
) for its associated GObj.The
event
name must be a unique pointer for optimized comparison during event dispatching.
Prototype
// Not applicable in JS
Prototype
# Not applicable in Python
Examples
// TODO C examples
// TODO JS examples
# TODO Python examples