Stream Buffers

Modules
	Core Functions
	Producer Functions
	Consumer Functions

Detailed Description

Stream buffers provide an efficient producer-consumer model for streaming data with automatic buffering and flow control. They support two primary modes:

Push Mode: Producer writes data via sbufPWrite(), consumer is notified or receives data directly via callbacks.

Pull Mode: Consumer reads data via sbufCRead(), producer's callback is invoked to fill the buffer as needed.

Basic Usage (Push Mode):

StreamBuffer *sb = sbufCreate(4096);
 
// Producer side
sbufPRegisterPush(sb, NULL, NULL);
sbufPWrite(sb, data, size);
sbufPFinish(sb);
 
// Consumer side (with notification callback)
sbufCRegisterPush(sb, myNotifyCallback, NULL, ctx);
// In callback: use sbufCRead() to retrieve data

Basic Usage (Pull Mode):

StreamBuffer *sb = sbufCreate(4096);
 
// Producer side (with pull callback)
sbufPRegisterPull(sb, myPullCallback, NULL, ctx);
 
// Consumer side
sbufCRegisterPull(sb, NULL, NULL);
size_t bytesread;
while (sbufCRead(sb, buffer, sizeof(buffer), &bytesread)) {
    // process buffer
}
sbufCFinish(sb);