stralloc_ready(3diet)

stralloc_ready3diet

Provide space in a stralloc

Usage

#include <stralloc.h>

int stralloc_ready(stralloc* sa,size_t len);

Overview

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.

Releases

4 releases since Debian 3.1 (Sarge); the text changed 1 time.

  1. 3.1–4.0
  2. 5.0–6.0

From libowfat-dev 0.28-2 in Debian 6.0 (Squeeze). Parsed by carta from the page's man source.