]> mj.ucw.cz Git - libucw.git/blob - ucw/doc/gary.txt
Doc: Documented growing arrays, generic allocators and related things
[libucw.git] / ucw / doc / gary.txt
1 Growing arrays
2 ==============
3
4 This module provides growing arrays with items of an arbitrary type.
5 (Alternatively, you might want to use <<mempool:gbuf,growing mempool buffers>>,
6 or the somewhat obsolete <<growbuf:,growing buffers>>.)
7
8 From the user's point of view, the array is represented as a pointer to
9 its first element, so it can be indexed by the usual `[]` operator. Please
10 keep in mind that this pointer can change, whenever the array is resized.
11
12 Additional book-keeping information is stored before the first element
13 and it can be accessed using the macros below.
14
15 ucw/gary.h
16 ----------
17
18 !!ucw/gary.h