NAME

       stralloc_ready - provide space in a stralloc

SYNTAX

       #include <stralloc.h>

       int stralloc_ready(stralloc* sa,size_t len);

DESCRIPTION

       stralloc_ready  makes  sure that sa has enough space allocated to hold len bytes: If sa is
       not allocated, stralloc_ready allocates at least len bytes of space, and returns 1. If  sa
       is  already allocated, but not enough to hold len bytes, stralloc_ready allocates at least
       len bytes of space, copies the old string into the new space, frees  the  old  space,  and
       returns 1. Note that this changes sa.s.

       If stralloc_ready runs out of memory, it leaves sa alone and returns 0.

RETURN VALUE

       1 for success, 0 on memory allocation failure.

SEE ALSO

       stralloc_readyplus(3)

                                                                                stralloc_ready(3)