Line Parser

Modules
	Line Parser Flags
	Pull Mode
	Push Mode

Functions
void	lparseDestroy (LineParser **lp)

Detailed Description

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

The line parser reads a stream buffer one line at a time. It handles the different line ending conventions (LF, CRLF, or mixed) and works in both stream buffer modes.

Common Use Cases:

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

Pull Mode: Create the parser with lparseCreatePull(), then call lparseLine() for each line.

Push Mode: Create the parser with lparseCreatePush() and give it a callback that runs for each line as data arrives.

Either way, destroy the parser with lparseDestroy() when done. A push parser is registered as the stream buffer's consumer and detaches when it is destroyed.

Example (pull mode):

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

Example (push mode):

bool processLine(stvlist *cvars, strref line) {
    // process each line
    return true;  // continue parsing
}
 
VFSFile *file = vfsOpen(vfs, _SL("data.txt"), FS_Read);
StreamBuffer *sb = sbufCreate(4096);
LineParser *lp = lparseCreatePush(sb, closureCreateAs(lparseLineCB, processLine, stvNone),
                                  LPARSE_LF);
sbufFileIn(sb, file, true);   // calls processLine for each line
sbufClose(sb);                  // flushes a last line with no EOL
lparseDestroy(&lp);
sbufRelease(&sb);

Function Documentation

lparseDestroy()

void lparseDestroy

(

LineParser **

lp

)

Destroys a line parser.

A push parser detaches from its stream buffer here, which runs the cleanup callback it was created with. Does not end the stream, and does not release the caller's reference to it.

Parameters

lp	Pointer to the line parser