Gecko [ unitednationsplay.com ]

Name	Size	Permission	Date
api-allocation-growing.html	17.55 KB	-rw-r--r--	2020-05-28 20:32
api-allocation-growing.txt	1019 B	-rw-r--r--	2013-06-10 20:01
api-argv-array.html	19.44 KB	-rw-r--r--	2020-05-28 20:32
api-argv-array.txt	2.12 KB	-rw-r--r--	2013-06-10 20:01
api-builtin.html	19.43 KB	-rw-r--r--	2020-05-28 20:32
api-builtin.txt	2 KB	-rw-r--r--	2013-06-10 20:01
api-config.html	23.39 KB	-rw-r--r--	2020-05-28 20:32
api-config.txt	5.18 KB	-rw-r--r--	2013-06-10 20:01
api-credentials.html	27.9 KB	-rw-r--r--	2020-05-28 20:32
api-credentials.txt	8.87 KB	-rw-r--r--	2013-06-10 20:01
api-decorate.html	16.23 KB	-rw-r--r--	2020-05-28 20:32
api-decorate.txt	60 B	-rw-r--r--	2013-06-10 20:01
api-diff.html	24.32 KB	-rw-r--r--	2020-05-28 20:32
api-diff.txt	5.22 KB	-rw-r--r--	2013-06-10 20:01
api-directory-listing.html	20.75 KB	-rw-r--r--	2020-05-28 20:32
api-directory-listing.txt	2.71 KB	-rw-r--r--	2013-06-10 20:01
api-gitattributes.html	21.9 KB	-rw-r--r--	2020-05-28 20:32
api-gitattributes.txt	3.62 KB	-rw-r--r--	2013-06-10 20:01
api-grep.html	16.31 KB	-rw-r--r--	2020-05-28 20:32
api-grep.txt	76 B	-rw-r--r--	2013-06-10 20:01
api-hash.html	18.42 KB	-rw-r--r--	2020-05-28 20:32
api-hash.txt	1.4 KB	-rw-r--r--	2013-06-10 20:01
api-hashmap.html	35.57 KB	-rw-r--r--	2020-05-28 20:32
api-hashmap.txt	7.71 KB	-rw-r--r--	2020-05-28 20:32
api-history-graph.html	24.08 KB	-rw-r--r--	2020-05-28 20:32
api-history-graph.txt	5.9 KB	-rw-r--r--	2013-06-10 20:01
api-in-core-index.html	16.96 KB	-rw-r--r--	2020-05-28 20:32
api-in-core-index.txt	457 B	-rw-r--r--	2013-06-10 20:01
api-index-skel.txt	431 B	-rw-r--r--	2013-06-10 20:01
api-index.html	18.45 KB	-rw-r--r--	2020-05-28 20:32
api-index.sh	611 B	-rw-r--r--	2013-06-10 20:01
api-index.txt	1.68 KB	-rw-r--r--	2020-05-28 20:32
api-lockfile.html	20.05 KB	-rw-r--r--	2020-05-28 20:32
api-lockfile.txt	2.92 KB	-rw-r--r--	2013-06-10 20:01
api-merge.html	21.36 KB	-rw-r--r--	2020-05-28 20:32
api-merge.txt	3.3 KB	-rw-r--r--	2013-06-10 20:01
api-object-access.html	16.73 KB	-rw-r--r--	2020-05-28 20:32
api-object-access.txt	342 B	-rw-r--r--	2013-06-10 20:01
api-parse-options.html	31.03 KB	-rw-r--r--	2020-05-28 20:32
api-parse-options.txt	9.36 KB	-rw-r--r--	2013-06-10 20:01
api-quote.html	16.42 KB	-rw-r--r--	2020-05-28 20:32
api-quote.txt	145 B	-rw-r--r--	2013-06-10 20:01
api-ref-iteration.html	19.71 KB	-rw-r--r--	2020-05-28 20:32
api-ref-iteration.txt	2.41 KB	-rw-r--r--	2013-06-10 20:01
api-remote.html	21.26 KB	-rw-r--r--	2020-05-28 20:32
api-remote.txt	3.3 KB	-rw-r--r--	2013-06-10 20:01
api-revision-walking.html	19.76 KB	-rw-r--r--	2020-05-28 20:32
api-revision-walking.txt	2.39 KB	-rw-r--r--	2013-06-10 20:01
api-run-command.html	28.25 KB	-rw-r--r--	2020-05-28 20:32
api-run-command.txt	8.08 KB	-rw-r--r--	2013-06-10 20:01
api-setup.html	16.51 KB	-rw-r--r--	2020-05-28 20:32
api-setup.txt	180 B	-rw-r--r--	2013-06-10 20:01
api-sha1-array.html	19.39 KB	-rw-r--r--	2020-05-28 20:32
api-sha1-array.txt	2.25 KB	-rw-r--r--	2013-06-10 20:01
api-sigchain.html	17.74 KB	-rw-r--r--	2020-05-28 20:32
api-sigchain.txt	1.34 KB	-rw-r--r--	2013-06-10 20:01
api-strbuf.html	32.15 KB	-rw-r--r--	2020-05-28 20:32
api-strbuf.txt	10.17 KB	-rw-r--r--	2013-06-10 20:01
api-string-list.html	26.42 KB	-rw-r--r--	2020-05-28 20:32
api-string-list.txt	6.84 KB	-rw-r--r--	2013-06-10 20:01
api-tree-walking.html	23.17 KB	-rw-r--r--	2020-05-28 20:32
api-tree-walking.txt	4.27 KB	-rw-r--r--	2013-06-10 20:01
api-xdiff-interface.html	16.3 KB	-rw-r--r--	2020-05-28 20:32
api-xdiff-interface.txt	139 B	-rw-r--r--	2013-06-10 20:01
index-format.html	27.12 KB	-rw-r--r--	2020-05-28 20:32
index-format.txt	6.29 KB	-rw-r--r--	2013-06-10 20:01
pack-format.html	24.08 KB	-rw-r--r--	2020-05-28 20:32
pack-format.txt	5.54 KB	-rw-r--r--	2013-06-10 20:01
pack-heuristics.html	42.74 KB	-rw-r--r--	2020-05-28 20:32
pack-heuristics.txt	17.77 KB	-rw-r--r--	2013-06-10 20:01
pack-protocol.html	43.12 KB	-rw-r--r--	2020-05-28 20:32
pack-protocol.txt	20.99 KB	-rw-r--r--	2013-06-10 20:01
protocol-capabilities.html	25.41 KB	-rw-r--r--	2020-05-28 20:32
protocol-capabilities.txt	7.09 KB	-rw-r--r--	2013-06-10 20:01
protocol-common.html	20.08 KB	-rw-r--r--	2020-05-28 20:32
protocol-common.txt	2.7 KB	-rw-r--r--	2013-06-10 20:01
racy-git.html	26.85 KB	-rw-r--r--	2020-05-28 20:32
racy-git.txt	8.63 KB	-rw-r--r--	2013-06-10 20:01
send-pack-pipeline.html	18.73 KB	-rw-r--r--	2020-05-28 20:32
send-pack-pipeline.txt	1.92 KB	-rw-r--r--	2013-06-10 20:01
shallow.html	18.86 KB	-rw-r--r--	2020-05-28 20:32
shallow.txt	2.3 KB	-rw-r--r--	2013-06-10 20:01
trivial-merge.html	21.62 KB	-rw-r--r--	2020-05-28 20:32
trivial-merge.txt	4.16 KB	-rw-r--r--	2013-06-10 20:01

Rename

sha1-array API
==============

The sha1-array API provides storage and manipulation of sets of SHA-1
identifiers. The emphasis is on storage and processing efficiency,
making them suitable for large lists. Note that the ordering of items is
not preserved over some operations.

Data Structures
---------------

`struct sha1_array`::

A single array of SHA-1 hashes. This should be initialized by
	assignment from `SHA1_ARRAY_INIT`.  The `sha1` member contains
	the actual data. The `nr` member contains the number of items in
	the set.  The `alloc` and `sorted` members are used internally,
	and should not be needed by API callers.

Functions
---------

`sha1_array_append`::
	Add an item to the set. The sha1 will be placed at the end of
	the array (but note that some operations below may lose this
	ordering).

`sha1_array_lookup`::
	Perform a binary search of the array for a specific sha1.
	If found, returns the offset (in number of elements) of the
	sha1. If not found, returns a negative integer. If the array is
	not sorted, this function has the side effect of sorting it.

`sha1_array_clear`::
	Free all memory associated with the array and return it to the
	initial, empty state.

`sha1_array_for_each_unique`::
	Efficiently iterate over each unique element of the list,
	executing the callback function for each one. If the array is
	not sorted, this function has the side effect of sorting it.

Examples
--------

-----------------------------------------
void print_callback(const unsigned char sha1[20],
		    void *data)
{
	printf("%s\n", sha1_to_hex(sha1));
}

void some_func(void)
{
	struct sha1_array hashes = SHA1_ARRAY_INIT;
	unsigned char sha1[20];

/* Read objects into our set */
	while (read_object_from_stdin(sha1))
		sha1_array_append(&hashes, sha1);

/* Check if some objects are in our set */
	while (read_object_from_stdin(sha1)) {
		if (sha1_array_lookup(&hashes, sha1) >= 0)
			printf("it's in there!\n");

/*
	 * Print the unique set of objects. We could also have
	 * avoided adding duplicate objects in the first place,
	 * but we would end up re-sorting the array repeatedly.
	 * Instead, this will sort once and then skip duplicates
	 * in linear time.
	 */
	sha1_array_for_each_unique(&hashes, print_callback, NULL);
}
-----------------------------------------