<!DOCTYPE File PUBLIC "-//Liam Quin//DTD C API Documentation v1.1//EN" "doc.dtd"><File>
<Entry dir="liblqutil">
<Function File="../../src/liblqutil/freadln.c">
<Name>LQU_StealReadLineBuffer</Name>
<Class>Utilities/Files
<Purpose>
<P>Returns the internal line buffer used by LQU_fReadLine, and also
causes LQU_fReadLine to allocate a new buffer the next time it is
called.  In this way, you can read lines with LQU_fReadLine, and
save any that you are interested in keeping by calling
LQU_StealReadLineBuffer, without having to copy the data.</P>
<P>The buffer returned may be longer than necessary to contain
the line that was last stored there by LQU_fReadLine by up to
LQT_READLINE_SLOP bytes; use erealloc to shrink it if desired.
The LQT_READLINE_SLOP constant is defined in freadln.c as 30 bytes.</P>
<Returns>
a pointer to the buffer, or NULL if there isn't one yet.
</Function>
<Decl>
API char *
LQU_StealReadLineBuffer()
</Decl>
</Entry>
