nsmcp::BoundedLogScanner method nextLine (public)

 <instance of nsmcp::BoundedLogScanner[i]> nextLine position \
    [ filter ]

Defined in /usr/local/ns/tcl/nsmcp/log-01-scanner.tcl

Read an in-memory physical line, optionally using the literal prefilter. Return physical byte bounds and newline status without parsing or redacting the record.

Parameters:
position (required)
Physical byte cursor within the loaded chunk.
filter (optional, defaults to "true")
Whether to apply the literal candidate prefilter; false reads sequentially. Defaults to 'true'.
Returns:
A dictionary with start, end, raw and terminated fields, or an empty result at exhaustion.

Testcases:
No testcase defined.
[ show source ]
Show another procedure: