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