-A pointer to the block of memory to use for the line buffer. This is
-all the memory the line buffer requires.
+A pointer to the block of memory to use for the line buffer. The line
+buffer will allocate memory to store incoming data automatically: this
+structure just contains bookkeeping information.
.I sz
of the chunk of data. The data is pushed through the line buffer and
any complete lines are passed on to the line handler.
.PP
The complex interface is the pair of functions
.I sz
of the chunk of data. The data is pushed through the line buffer and
any complete lines are passed on to the line handler.
.PP
The complex interface is the pair of functions
.PP
The
.B lbuf_free
function returns the address and size of a free portion of the line
buffer's memory into which data may be written. The function is passed
the address
.PP
The
.B lbuf_free
function returns the address and size of a free portion of the line
buffer's memory into which data may be written. The function is passed
the address
of the line buffer. Its result is the size of the free area, and it
writes the base address of this free space to the location pointed to by
the argument
of the line buffer. Its result is the size of the free area, and it
writes the base address of this free space to the location pointed to by
the argument
of the line which has just been read, and the pointer
.I p
which was set up in the call to
of the line which has just been read, and the pointer
.I p
which was set up in the call to
The line passed is null-terminated, and has had its trailing newline
stripped. The area of memory in which the string is located may be
overwritten by the line-handler function, although writing beyond the
The line passed is null-terminated, and has had its trailing newline
stripped. The area of memory in which the string is located may be
overwritten by the line-handler function, although writing beyond the