postgresql/src/backend/lib
Nathan Bossart 5af0263afd Make binaryheap available to frontend code.
There are a couple of places in frontend code that could make use
of this simple binary heap implementation.  This commit makes
binaryheap usable in frontend code, much like commit 26aaf97b68 did
for StringInfo.  Like StringInfo, the header file is left in lib/
to reduce the likelihood of unnecessary breakage.

The frontend version of binaryheap exposes a void *-based API since
frontend code does not have access to the Datum definitions.  This
seemed like a better approach than switching all existing uses to
void * or making the Datum definitions available to frontend code.

Reviewed-by: Tom Lane, Alvaro Herrera
Discussion: https://postgr.es/m/3612876.1689443232%40sss.pgh.pa.us
2023-09-18 12:18:33 -07:00
..
Makefile Make binaryheap available to frontend code. 2023-09-18 12:18:33 -07:00
README Add IntegerSet, to hold large sets of 64-bit ints efficiently. 2019-03-22 13:21:45 +02:00
bipartite_match.c Update copyright for 2023 2023-01-02 15:00:37 -05:00
bloomfilter.c Update copyright for 2023 2023-01-02 15:00:37 -05:00
dshash.c Update copyright for 2023 2023-01-02 15:00:37 -05:00
hyperloglog.c Update copyright for 2023 2023-01-02 15:00:37 -05:00
ilist.c Fix ILIST_DEBUG build 2023-01-18 10:26:15 -08:00
integerset.c Update copyright for 2023 2023-01-02 15:00:37 -05:00
knapsack.c Update copyright for 2023 2023-01-02 15:00:37 -05:00
meson.build Make binaryheap available to frontend code. 2023-09-18 12:18:33 -07:00
pairingheap.c Update copyright for 2023 2023-01-02 15:00:37 -05:00
rbtree.c Update copyright for 2023 2023-01-02 15:00:37 -05:00

README

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

integerset.c - a data structure for holding large set of integers

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.