ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: usr / share / doc / git-1.8.3.1 / technical

allocation growing API
======================

Dynamically growing an array using realloc() is error prone and boring.

Define your array with:

* a pointer (`item`) that points at the array, initialized to `NULL`
  (although please name the variable based on its contents, not on its
  type);

* an integer variable (`alloc`) that keeps track of how big the current
  allocation is, initialized to `0`;

* another integer variable (`nr`) to keep track of how many elements the
  array currently has, initialized to `0`.

Then before adding `n`th element to the item, call `ALLOC_GROW(item, n,
alloc)`.  This ensures that the array can hold at least `n` elements by
calling `realloc(3)` and adjusting `alloc` variable.

------------
sometype *item;
size_t nr;
size_t alloc

for (i = 0; i < nr; i++)
	if (we like item[i] already)
		return;

/* we did not like any existing one, so add one */
ALLOC_GROW(item, nr + 1, alloc);
item[nr++] = value you like;
------------

You are responsible for updating the `nr` variable.

[-] api-strbuf.html [edit]
[-] api-credentials.txt [edit]
[-] shallow.txt [edit]
[-] api-sigchain.html [edit]
[-] racy-git.html [edit]
[-] api-allocation-growing.txt [edit]
[-] api-tree-walking.html [edit]
[-] index-format.txt [edit]
[-] pack-protocol.html [edit]
[-] api-setup.txt [edit]
[-] api-lockfile.html [edit]
[-] api-directory-listing.txt [edit]
[-] api-remote.txt [edit]
[-] pack-format.html [edit]
[-] api-quote.txt [edit]
[-] index-format.html [edit]
[-] api-in-core-index.txt [edit]
[-] api-hash.txt [edit]
[-] send-pack-pipeline.html [edit]
[-] api-strbuf.txt [edit]
[+] ..
[-] protocol-common.html [edit]
[-] pack-heuristics.html [edit]
[-] api-sha1-array.html [edit]
[-] api-xdiff-interface.html [edit]
[-] api-xdiff-interface.txt [edit]
[-] api-hashmap.html [edit]
[-] api-ref-iteration.txt [edit]
[-] trivial-merge.html [edit]
[-] api-gitattributes.txt [edit]
[-] pack-format.txt [edit]
[-] api-run-command.txt [edit]
[-] api-parse-options.html [edit]
[-] api-ref-iteration.html [edit]
[-] trivial-merge.txt [edit]
[-] api-decorate.txt [edit]
[-] api-builtin.txt [edit]
[-] api-directory-listing.html [edit]
[-] pack-protocol.txt [edit]
[-] api-hash.html [edit]
[-] api-quote.html [edit]
[-] api-setup.html [edit]
[-] api-argv-array.html [edit]
[-] api-remote.html [edit]
[-] api-grep.txt [edit]
[-] protocol-capabilities.txt [edit]
[-] api-revision-walking.html [edit]
[-] api-string-list.txt [edit]
[-] api-history-graph.txt [edit]
[-] api-diff.html [edit]
[-] protocol-common.txt [edit]
[-] api-sigchain.txt [edit]
[-] api-gitattributes.html [edit]
[-] api-grep.html [edit]
[-] api-history-graph.html [edit]
[-] api-lockfile.txt [edit]
[-] api-index.txt [edit]
[-] api-revision-walking.txt [edit]
[-] api-sha1-array.txt [edit]
[-] api-string-list.html [edit]
[-] api-object-access.txt [edit]
[-] api-hashmap.txt [edit]
[-] protocol-capabilities.html [edit]
[-] api-object-access.html [edit]
[-] pack-heuristics.txt [edit]
[-] shallow.html [edit]
[-] api-run-command.html [edit]
[-] racy-git.txt [edit]
[-] api-merge.html [edit]
[-] api-index-skel.txt [edit]
[-] api-tree-walking.txt [edit]
[-] send-pack-pipeline.txt [edit]
[-] api-in-core-index.html [edit]
[-] api-diff.txt [edit]
[-] api-index.html [edit]
[-] api-credentials.html [edit]
[-] api-builtin.html [edit]
[-] api-allocation-growing.html [edit]
[-] api-merge.txt [edit]
[-] api-parse-options.txt [edit]
[-] api-config.html [edit]
[-] api-decorate.html [edit]
[-] api-index.sh [edit]
[-] api-argv-array.txt [edit]
[-] api-config.txt [edit]