NAME

       buffer_tosa - initialize buffer for writing to stralloc

SYNTAX

       #include <buffer.h>

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

DESCRIPTION

       buffer_tosa  makes a virtual write buffer from a stralloc.  The buffer writing functions will append data
       to the stralloc until the stralloc fails to allocate more memory.  You still need to flush the buffer.

       Note that in the end the stralloc will have allocated more memory than  is  needed  to  hold  the  actual
       contents.  The waste is 1024 bytes.

RETURN VALUE

       buffer_tosa  returns  0 if everything was fine, -1 if it failed to allocate space for the initial data in
       the stralloc.

SEE ALSO

       buffer_tosa(3), buffer_init(3), buffer(3)

                                                                                                  buffer_tosa(3)