home | help
buffer_getline_sa(3)	    Library Functions Manual	    buffer_getline_sa(3)

NAME
     buffer_getline_sa - read line from buffer

SYNTAX
     #include <libowfat/stralloc.h>
     #include <libowfat/buffer.h>

     int buffer_getline_sa(buffer* b,stralloc* sa);

DESCRIPTION
     buffer_getline_sa	appends data from the b to sa until a '\n' is found, NOT
     overwriting the previous content of sa.  The new-line is also  appended  to
     sa.

     If  reading  from	the buffer or allocating memory fails, buffer_getline_sa
     returns -1 and sets errno appropriately.  At that point sa may be empty  or
     it may already contain a partial token.

RETURN VALUE
     -1 on error (setting errno), 0 on EOF, 1 when successful.

RATIONALE
     buffer_getline_sa	appends instead of overwriting so it can be used on non-
     blocking sockets (these signal error and set errno to EAGAIN; in this  case
     you  can  simply  call buffer_getline_sa again when select or poll indicate
     more data is available).

SEE ALSO
     buffer_get_token_sa(3), buffer(3)

							    buffer_getline_sa(3)

home | help