Line Parser

Modules
	Line Parser Flags
	Pull Mode
	Push Mode

Detailed Description

Stream buffer consumer that parses line-by-line input.

The line parser is a specialized consumer that processes stream buffer data one line at a time. It automatically handles different line ending conventions (LF, CRLF, or mixed) and provides both pull and push mode operation.

Common Use Cases:

• Reading text files line by line
• Processing log files
• Parsing configuration files
• Any line-oriented data processing

Pull Mode: Register the parser with lparseRegisterPull(), then repeatedly call lparseLine() to retrieve each line.

Push Mode: Register with lparseRegisterPush() and provide a callback that is invoked for each line as data becomes available.

Example (pull mode):

VFSFile *file = vfsOpen(vfs, _S"config.txt", FS_Read);
StreamBuffer *sb = sbufCreate(4096);
sbufFilePRegisterPull(sb, file, true);
lparseRegisterPull(sb, LPARSE_Auto);
 
string line = 0;
while (lparseLine(sb, &line)) {
    // process line
}
strDestroy(&line);

Example (push mode):

bool processLine(strref line, void *ctx) {
    // process each line
    return true;  // continue parsing
}
 
VFSFile *file = vfsOpen(vfs, _S"data.txt", FS_Read);
StreamBuffer *sb = sbufCreate(4096);
lparseRegisterPush(sb, processLine, NULL, NULL, LPARSE_LF);
sbufFileIn(sb, file, true);  // automatically calls processLine for each line