postgresql/src/backend/lib
Alvaro Herrera af38498d4c Move hash_any prototype from access/hash.h to utils/hashutils.h
... as well as its implementation from backend/access/hash/hashfunc.c to
backend/utils/hash/hashfn.c.

access/hash is the place for the hash index AM, not really appropriate
for generic facilities, which is what hash_any is; having things the old
way meant that anything using hash_any had to include the AM's include
file, pointlessly polluting its namespace with unrelated, unnecessary
cruft.

Also move the HTEqual strategy number to access/stratnum.h from
access/hash.h.

To avoid breaking third-party extension code, add an #include
"utils/hashutils.h" to access/hash.h.  (An easily removed line by
committers who enjoy their asbestos suits to protect them from angry
extension authors.)

Discussion: https://postgr.es/m/201901251935.ser5e4h6djt2@alvherre.pgsql
2019-03-11 13:17:50 -03:00
..
binaryheap.c Update copyright for 2019 2019-01-02 12:44:25 -05:00
bipartite_match.c Update copyright for 2019 2019-01-02 12:44:25 -05:00
bloomfilter.c Move hash_any prototype from access/hash.h to utils/hashutils.h 2019-03-11 13:17:50 -03:00
dshash.c Update copyright for 2019 2019-01-02 12:44:25 -05:00
hyperloglog.c Update copyright for 2019 2019-01-02 12:44:25 -05:00
ilist.c Update copyright for 2019 2019-01-02 12:44:25 -05:00
knapsack.c Update copyright for 2019 2019-01-02 12:44:25 -05:00
Makefile Add Bloom filter implementation. 2018-03-31 17:49:41 -07:00
pairingheap.c Update copyright for 2019 2019-01-02 12:44:25 -05:00
rbtree.c Update copyright for 2019 2019-01-02 12:44:25 -05:00
README Add missing files to src/backend/lib/README. 2018-05-22 13:25:28 +03:00
stringinfo.c Update copyright for 2019 2019-01-02 12:44:25 -05:00

This directory contains a general purpose data structures, for use anywhere
in the backend:

binaryheap.c - a binary heap

bipartite_match.c - Hopcroft-Karp maximum cardinality algorithm for bipartite graphs

bloomfilter.c - probabilistic, space-efficient set membership testing

dshash.c - concurrent hash tables backed by dynamic shared memory areas

hyperloglog.c - a streaming cardinality estimator

ilist.c - single and double-linked lists

knapsack.c - knapsack problem solver

pairingheap.c - a pairing heap

rbtree.c - a red-black tree

stringinfo.c - an extensible string type


Aside from the inherent characteristics of the data structures, there are a
few practical differences between the binary heap and the pairing heap. The
binary heap is fully allocated at creation, and cannot be expanded beyond the
allocated size. The pairing heap on the other hand has no inherent maximum
size, but the caller needs to allocate each element being stored in the heap,
while the binary heap works with plain Datums or pointers.

The linked-lists in ilist.c can be embedded directly into other structs, as
opposed to the List interface in nodes/pg_list.h.