treap: make treap_insert return inserted node
commit97a5e3453abf63bbf5926979fcd89efb4388e937
authorJonathan Nieder <jrnieder@gmail.com>
Sun, 5 Dec 2010 09:35:17 +0000 (5 03:35 -0600)
committerJunio C Hamano <gitster@pobox.com>
Wed, 8 Dec 2010 00:03:55 +0000 (7 16:03 -0800)
tree1b07e107f8a422abfb1ba749c6e1502274b8cbb5
parentb0ad24be8ca9acd86393ce099d3217872d838915
treap: make treap_insert return inserted node

Suppose I try the following:

struct int_node *node = node_pointer(node_alloc(1));
node->n = 5;
treap_insert(&root, node);
printf("%d\n", node->n);

Usually the result will be 5.  But since treap_insert draws memory
from the node pool, if the caller is unlucky then (1) the node pool
will be full and (2) realloc will be forced to move the node pool to
find room, so the node address becomes invalid and the result of
dereferencing it is undefined.

So we ought to use offsets in preference to pointers for references
that would remain valid after a call to treap_insert.  Tweak the
signature to hint at a certain special case: since the inserted node
can change address (though not offset), as a convenience teach
treap_insert to return its new address.

So the motivational example could be fixed by adding "node =".

struct int_node *node = node_pointer(node_alloc(1));
node->n = 5;
node = treap_insert(&root, node);
printf("%d\n", node->n);

Based on a true story.

Signed-off-by: Jonathan Nieder <jrnieder@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
test-treap.c
vcs-svn/trp.h
vcs-svn/trp.txt