2016-01-09 07:44:39 +01:00
|
|
|
/*
|
|
|
|
* charybdis: an advanced ircd.
|
|
|
|
* irc_radixtree.c: Dictionary-based information storage.
|
|
|
|
*
|
|
|
|
* Copyright (c) 2007-2016 William Pitcock <nenolod -at- dereferenced.org>
|
|
|
|
* Copyright (c) 2007-2016 Jilles Tjoelker <jilles -at- stack.nl>
|
|
|
|
*
|
|
|
|
* Redistribution and use in source and binary forms, with or without
|
|
|
|
* modification, are permitted provided that the following conditions are
|
|
|
|
* met:
|
|
|
|
*
|
|
|
|
* 1. Redistributions of source code must retain the above copyright notice,
|
|
|
|
* this list of conditions and the following disclaimer.
|
|
|
|
*
|
|
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
|
|
* documentation and/or other materials provided with the distribution.
|
|
|
|
*
|
|
|
|
* 3. The name of the author may not be used to endorse or promote products
|
|
|
|
* derived from this software without specific prior written permission.
|
|
|
|
*
|
|
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
|
|
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
|
|
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
|
|
* DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
|
|
|
|
* INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
|
|
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
|
|
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
|
|
|
* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
|
|
|
|
* IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#include "stdinc.h"
|
|
|
|
#include "s_assert.h"
|
2016-01-09 08:00:55 +01:00
|
|
|
#include "match.h"
|
2016-01-09 07:44:39 +01:00
|
|
|
#include "irc_radixtree.h"
|
|
|
|
|
2016-01-09 07:54:57 +01:00
|
|
|
rb_dlink_list radixtree_list = {NULL, NULL, 0};
|
|
|
|
|
2016-01-09 07:44:39 +01:00
|
|
|
/*
|
|
|
|
* Patricia tree.
|
|
|
|
*
|
|
|
|
* A radix trie that avoids one-way branching and redundant nodes.
|
|
|
|
*
|
|
|
|
* To find a node, the tree is traversed starting from the root. The
|
|
|
|
* nibnum in each node indicates which nibble of the key needs to be
|
|
|
|
* tested, and the appropriate branch is taken.
|
|
|
|
*
|
|
|
|
* The nibnum values are strictly increasing while going down the tree.
|
|
|
|
*
|
|
|
|
* -- jilles
|
|
|
|
*/
|
|
|
|
|
|
|
|
union irc_radixtree_elem;
|
|
|
|
|
|
|
|
struct irc_radixtree
|
|
|
|
{
|
|
|
|
void (*canonize_cb)(char *key);
|
|
|
|
union irc_radixtree_elem *root;
|
|
|
|
|
|
|
|
unsigned int count;
|
|
|
|
char *id;
|
2016-01-09 07:54:57 +01:00
|
|
|
|
|
|
|
rb_dlink_node node;
|
2016-01-09 07:44:39 +01:00
|
|
|
};
|
|
|
|
|
|
|
|
#define POINTERS_PER_NODE 16
|
|
|
|
#define NIBBLE_VAL(key, nibnum) (((key)[(nibnum) / 2] >> ((nibnum) & 1 ? 0 : 4)) & 0xF)
|
|
|
|
|
|
|
|
struct irc_radixtree_node
|
|
|
|
{
|
|
|
|
/* nibble to test (nibble NUM%2 of byte NUM/2) */
|
|
|
|
int nibnum;
|
|
|
|
|
|
|
|
/* branches of the tree */
|
|
|
|
union irc_radixtree_elem *down[POINTERS_PER_NODE];
|
|
|
|
union irc_radixtree_elem *parent;
|
|
|
|
|
|
|
|
char parent_val;
|
|
|
|
};
|
|
|
|
|
|
|
|
struct irc_radixtree_leaf
|
|
|
|
{
|
|
|
|
/* -1 to indicate this is a leaf, not a node */
|
|
|
|
int nibnum;
|
|
|
|
|
|
|
|
/* data associated with the key */
|
|
|
|
void *data;
|
|
|
|
|
|
|
|
/* key (canonized copy) */
|
|
|
|
char *key;
|
|
|
|
union irc_radixtree_elem *parent;
|
|
|
|
|
|
|
|
char parent_val;
|
|
|
|
};
|
|
|
|
|
|
|
|
union irc_radixtree_elem
|
|
|
|
{
|
|
|
|
int nibnum;
|
|
|
|
struct irc_radixtree_node node;
|
|
|
|
|
|
|
|
struct irc_radixtree_leaf leaf;
|
|
|
|
};
|
|
|
|
|
|
|
|
#define IS_LEAF(elem) ((elem)->nibnum == -1)
|
|
|
|
|
|
|
|
/* Preserve compatibility with the old mowgli_patricia.h */
|
|
|
|
#define STATE_CUR(state) ((state)->pspare[0])
|
|
|
|
#define STATE_NEXT(state) ((state)->pspare[1])
|
|
|
|
|
|
|
|
/*
|
|
|
|
* first_leaf()
|
|
|
|
*
|
|
|
|
* Find the smallest leaf hanging off a subtree.
|
|
|
|
*
|
|
|
|
* Inputs:
|
|
|
|
* - element (may be leaf or node) heading subtree
|
|
|
|
*
|
|
|
|
* Outputs:
|
|
|
|
* - lowest leaf in subtree
|
|
|
|
*
|
|
|
|
* Side Effects:
|
|
|
|
* - none
|
|
|
|
*/
|
|
|
|
static union irc_radixtree_elem *
|
|
|
|
first_leaf(union irc_radixtree_elem *delem)
|
|
|
|
{
|
|
|
|
int val;
|
|
|
|
|
|
|
|
while (!IS_LEAF(delem))
|
|
|
|
{
|
|
|
|
for (val = 0; val < POINTERS_PER_NODE; val++)
|
|
|
|
if (delem->node.down[val] != NULL)
|
|
|
|
{
|
|
|
|
delem = delem->node.down[val];
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return delem;
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* irc_radixtree_create_named(const char *name,
|
|
|
|
* void (*canonize_cb)(char *key))
|
|
|
|
*
|
|
|
|
* Dictionary object factory.
|
|
|
|
*
|
|
|
|
* Inputs:
|
|
|
|
* - patricia name
|
|
|
|
* - function to use for canonizing keys (for example, use
|
|
|
|
* a function that makes the string upper case to create
|
|
|
|
* a patricia with case-insensitive matching)
|
|
|
|
*
|
|
|
|
* Outputs:
|
|
|
|
* - on success, a new patricia object.
|
|
|
|
*
|
|
|
|
* Side Effects:
|
|
|
|
* - if services runs out of memory and cannot allocate the object,
|
|
|
|
* the program will abort.
|
|
|
|
*/
|
|
|
|
struct irc_radixtree *
|
2016-01-09 07:54:57 +01:00
|
|
|
irc_radixtree_create(const char *name, void (*canonize_cb)(char *key))
|
2016-01-09 07:44:39 +01:00
|
|
|
{
|
|
|
|
struct irc_radixtree *dtree = (struct irc_radixtree *) rb_malloc(sizeof(struct irc_radixtree));
|
|
|
|
|
|
|
|
dtree->canonize_cb = canonize_cb;
|
|
|
|
dtree->id = rb_strdup(name);
|
|
|
|
dtree->root = NULL;
|
|
|
|
|
2016-01-09 07:54:57 +01:00
|
|
|
rb_dlinkAdd(dtree, &dtree->node, &radixtree_list);
|
|
|
|
|
2016-01-09 07:44:39 +01:00
|
|
|
return dtree;
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* irc_radixtree_destroy(struct irc_radixtree *dtree,
|
|
|
|
* void (*destroy_cb)(const char *key, void *data, void *privdata),
|
|
|
|
* void *privdata);
|
|
|
|
*
|
|
|
|
* Recursively destroys all nodes in a patricia tree.
|
|
|
|
*
|
|
|
|
* Inputs:
|
|
|
|
* - patricia tree object
|
|
|
|
* - optional iteration callback
|
|
|
|
* - optional opaque/private data to pass to callback
|
|
|
|
*
|
|
|
|
* Outputs:
|
|
|
|
* - nothing
|
|
|
|
*
|
|
|
|
* Side Effects:
|
|
|
|
* - on success, a dtree and optionally it's children are destroyed.
|
|
|
|
*
|
|
|
|
* Notes:
|
|
|
|
* - if this is called without a callback, the objects bound to the
|
|
|
|
* DTree will not be destroyed.
|
|
|
|
*/
|
|
|
|
void
|
|
|
|
irc_radixtree_destroy(struct irc_radixtree *dtree, void (*destroy_cb)(const char *key, void *data, void *privdata), void *privdata)
|
|
|
|
{
|
|
|
|
struct irc_radixtree_iteration_state state;
|
|
|
|
union irc_radixtree_elem *delem;
|
|
|
|
|
|
|
|
void *entry;
|
|
|
|
|
|
|
|
s_assert(dtree != NULL);
|
|
|
|
|
|
|
|
IRC_RADIXTREE_FOREACH(entry, &state, dtree)
|
|
|
|
{
|
|
|
|
delem = STATE_CUR(&state);
|
|
|
|
|
|
|
|
if (destroy_cb != NULL)
|
|
|
|
(*destroy_cb)(delem->leaf.key, delem->leaf.data,
|
|
|
|
privdata);
|
|
|
|
|
|
|
|
irc_radixtree_delete(dtree, delem->leaf.key);
|
|
|
|
}
|
|
|
|
|
|
|
|
rb_free(dtree);
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* irc_radixtree_foreach(struct irc_radixtree *dtree,
|
|
|
|
* int (*foreach_cb)(const char *key, void *data, void *privdata),
|
|
|
|
* void *privdata);
|
|
|
|
*
|
|
|
|
* Iterates over all entries in a DTree.
|
|
|
|
*
|
|
|
|
* Inputs:
|
|
|
|
* - patricia tree object
|
|
|
|
* - optional iteration callback
|
|
|
|
* - optional opaque/private data to pass to callback
|
|
|
|
*
|
|
|
|
* Outputs:
|
|
|
|
* - nothing
|
|
|
|
*
|
|
|
|
* Side Effects:
|
|
|
|
* - on success, a dtree is iterated
|
|
|
|
*/
|
|
|
|
void
|
|
|
|
irc_radixtree_foreach(struct irc_radixtree *dtree, int (*foreach_cb)(const char *key, void *data, void *privdata), void *privdata)
|
|
|
|
{
|
|
|
|
union irc_radixtree_elem *delem, *next;
|
|
|
|
|
|
|
|
int val;
|
|
|
|
|
|
|
|
s_assert(dtree != NULL);
|
|
|
|
|
|
|
|
delem = dtree->root;
|
|
|
|
|
|
|
|
if (delem == NULL)
|
|
|
|
return;
|
|
|
|
|
|
|
|
/* Only one element in the tree */
|
|
|
|
if (IS_LEAF(delem))
|
|
|
|
{
|
|
|
|
if (foreach_cb != NULL)
|
|
|
|
(*foreach_cb)(delem->leaf.key, delem->leaf.data, privdata);
|
|
|
|
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
val = 0;
|
|
|
|
|
|
|
|
do
|
|
|
|
{
|
|
|
|
do
|
|
|
|
next = delem->node.down[val++];
|
|
|
|
while (next == NULL && val < POINTERS_PER_NODE);
|
|
|
|
|
|
|
|
if (next != NULL)
|
|
|
|
{
|
|
|
|
if (IS_LEAF(next))
|
|
|
|
{
|
|
|
|
if (foreach_cb != NULL)
|
|
|
|
(*foreach_cb)(next->leaf.key, next->leaf.data, privdata);
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
delem = next;
|
|
|
|
val = 0;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
while (val >= POINTERS_PER_NODE)
|
|
|
|
{
|
|
|
|
val = delem->node.parent_val;
|
|
|
|
delem = delem->node.parent;
|
|
|
|
|
|
|
|
if (delem == NULL)
|
|
|
|
break;
|
|
|
|
|
|
|
|
val++;
|
|
|
|
}
|
|
|
|
} while (delem != NULL);
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* irc_radixtree_search(struct irc_radixtree *dtree,
|
|
|
|
* void *(*foreach_cb)(const char *key, void *data, void *privdata),
|
|
|
|
* void *privdata);
|
|
|
|
*
|
|
|
|
* Searches all entries in a DTree using a custom callback.
|
|
|
|
*
|
|
|
|
* Inputs:
|
|
|
|
* - patricia tree object
|
|
|
|
* - optional iteration callback
|
|
|
|
* - optional opaque/private data to pass to callback
|
|
|
|
*
|
|
|
|
* Outputs:
|
|
|
|
* - on success, the requested object
|
|
|
|
* - on failure, NULL.
|
|
|
|
*
|
|
|
|
* Side Effects:
|
|
|
|
* - a dtree is iterated until the requested conditions are met
|
|
|
|
*/
|
|
|
|
void *
|
|
|
|
irc_radixtree_search(struct irc_radixtree *dtree, void *(*foreach_cb)(const char *key, void *data, void *privdata), void *privdata)
|
|
|
|
{
|
|
|
|
union irc_radixtree_elem *delem, *next;
|
|
|
|
|
|
|
|
int val;
|
|
|
|
void *ret = NULL;
|
|
|
|
|
|
|
|
s_assert(dtree != NULL);
|
|
|
|
|
|
|
|
delem = dtree->root;
|
|
|
|
|
|
|
|
if (delem == NULL)
|
|
|
|
return NULL;
|
|
|
|
|
|
|
|
/* Only one element in the tree */
|
|
|
|
if (IS_LEAF(delem))
|
|
|
|
{
|
|
|
|
if (foreach_cb != NULL)
|
|
|
|
return (*foreach_cb)(delem->leaf.key, delem->leaf.data, privdata);
|
|
|
|
|
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
|
|
|
|
val = 0;
|
|
|
|
|
|
|
|
for (;;)
|
|
|
|
{
|
|
|
|
do
|
|
|
|
next = delem->node.down[val++];
|
|
|
|
while (next == NULL && val < POINTERS_PER_NODE);
|
|
|
|
|
|
|
|
if (next != NULL)
|
|
|
|
{
|
|
|
|
if (IS_LEAF(next))
|
|
|
|
{
|
|
|
|
if (foreach_cb != NULL)
|
|
|
|
ret = (*foreach_cb)(next->leaf.key, next->leaf.data, privdata);
|
|
|
|
|
|
|
|
if (ret != NULL)
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
delem = next;
|
|
|
|
val = 0;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
while (val >= POINTERS_PER_NODE)
|
|
|
|
{
|
|
|
|
val = delem->node.parent_val;
|
|
|
|
delem = delem->node.parent;
|
|
|
|
|
|
|
|
if (delem == NULL)
|
|
|
|
break;
|
|
|
|
|
|
|
|
val++;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return ret;
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* irc_radixtree_foreach_start(struct irc_radixtree *dtree,
|
|
|
|
* struct irc_radixtree_iteration_state *state);
|
|
|
|
*
|
|
|
|
* Initializes a static DTree iterator.
|
|
|
|
*
|
|
|
|
* Inputs:
|
|
|
|
* - patricia tree object
|
|
|
|
* - static DTree iterator
|
|
|
|
*
|
|
|
|
* Outputs:
|
|
|
|
* - nothing
|
|
|
|
*
|
|
|
|
* Side Effects:
|
|
|
|
* - the static iterator, &state, is initialized.
|
|
|
|
*/
|
|
|
|
void
|
|
|
|
irc_radixtree_foreach_start(struct irc_radixtree *dtree, struct irc_radixtree_iteration_state *state)
|
|
|
|
{
|
|
|
|
if (dtree == NULL)
|
|
|
|
return;
|
|
|
|
|
|
|
|
s_assert(state != NULL);
|
|
|
|
|
|
|
|
if (dtree->root != NULL)
|
|
|
|
STATE_NEXT(state) = first_leaf(dtree->root);
|
|
|
|
else
|
|
|
|
STATE_NEXT(state) = NULL;
|
|
|
|
|
|
|
|
STATE_CUR(state) = STATE_NEXT(state);
|
|
|
|
|
|
|
|
if (STATE_NEXT(state) == NULL)
|
|
|
|
return;
|
|
|
|
|
|
|
|
/* make STATE_CUR point to first item and STATE_NEXT point to
|
|
|
|
* second item */
|
|
|
|
irc_radixtree_foreach_next(dtree, state);
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* irc_radixtree_foreach_cur(struct irc_radixtree *dtree,
|
|
|
|
* struct irc_radixtree_iteration_state *state);
|
|
|
|
*
|
|
|
|
* Returns the data from the current node being iterated by the
|
|
|
|
* static iterator.
|
|
|
|
*
|
|
|
|
* Inputs:
|
|
|
|
* - patricia tree object
|
|
|
|
* - static DTree iterator
|
|
|
|
*
|
|
|
|
* Outputs:
|
|
|
|
* - reference to data in the current dtree node being iterated
|
|
|
|
*
|
|
|
|
* Side Effects:
|
|
|
|
* - none
|
|
|
|
*/
|
|
|
|
void *
|
|
|
|
irc_radixtree_foreach_cur(struct irc_radixtree *dtree, struct irc_radixtree_iteration_state *state)
|
|
|
|
{
|
|
|
|
if (dtree == NULL)
|
|
|
|
return NULL;
|
|
|
|
|
|
|
|
s_assert(state != NULL);
|
|
|
|
|
|
|
|
return STATE_CUR(state) != NULL ?
|
|
|
|
((struct irc_radixtree_leaf *) STATE_CUR(state))->data : NULL;
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* irc_radixtree_foreach_next(struct irc_radixtree *dtree,
|
|
|
|
* struct irc_radixtree_iteration_state *state);
|
|
|
|
*
|
|
|
|
* Advances a static DTree iterator.
|
|
|
|
*
|
|
|
|
* Inputs:
|
|
|
|
* - patricia tree object
|
|
|
|
* - static DTree iterator
|
|
|
|
*
|
|
|
|
* Outputs:
|
|
|
|
* - nothing
|
|
|
|
*
|
|
|
|
* Side Effects:
|
|
|
|
* - the static iterator, &state, is advanced to a new DTree node.
|
|
|
|
*/
|
|
|
|
void
|
|
|
|
irc_radixtree_foreach_next(struct irc_radixtree *dtree, struct irc_radixtree_iteration_state *state)
|
|
|
|
{
|
|
|
|
struct irc_radixtree_leaf *leaf;
|
|
|
|
|
|
|
|
union irc_radixtree_elem *delem, *next;
|
|
|
|
|
|
|
|
int val;
|
|
|
|
|
|
|
|
if (dtree == NULL)
|
|
|
|
return;
|
|
|
|
|
|
|
|
s_assert(state != NULL);
|
|
|
|
|
|
|
|
if (STATE_CUR(state) == NULL)
|
|
|
|
return;
|
|
|
|
|
|
|
|
STATE_CUR(state) = STATE_NEXT(state);
|
|
|
|
|
|
|
|
if (STATE_NEXT(state) == NULL)
|
|
|
|
return;
|
|
|
|
|
|
|
|
leaf = STATE_NEXT(state);
|
|
|
|
delem = leaf->parent;
|
|
|
|
val = leaf->parent_val;
|
|
|
|
|
|
|
|
while (delem != NULL)
|
|
|
|
{
|
|
|
|
do
|
|
|
|
next = delem->node.down[val++];
|
|
|
|
while (next == NULL && val < POINTERS_PER_NODE);
|
|
|
|
|
|
|
|
if (next != NULL)
|
|
|
|
{
|
|
|
|
if (IS_LEAF(next))
|
|
|
|
{
|
|
|
|
/* We will find the original leaf first. */
|
|
|
|
if (&next->leaf != leaf)
|
|
|
|
{
|
|
|
|
if (strcmp(next->leaf.key, leaf->key) < 0)
|
|
|
|
{
|
|
|
|
STATE_NEXT(state) = NULL;
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
STATE_NEXT(state) = next;
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
delem = next;
|
|
|
|
val = 0;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
while (val >= POINTERS_PER_NODE)
|
|
|
|
{
|
|
|
|
val = delem->node.parent_val;
|
|
|
|
delem = delem->node.parent;
|
|
|
|
|
|
|
|
if (delem == NULL)
|
|
|
|
break;
|
|
|
|
|
|
|
|
val++;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
STATE_NEXT(state) = NULL;
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
2016-01-21 02:52:17 +01:00
|
|
|
* irc_radixtree_elem_find(struct irc_radixtree *dtree, const char *key)
|
2016-01-09 07:44:39 +01:00
|
|
|
*
|
|
|
|
* Looks up a DTree node by name.
|
|
|
|
*
|
|
|
|
* Inputs:
|
|
|
|
* - patricia tree object
|
|
|
|
* - name of node to lookup
|
|
|
|
*
|
|
|
|
* Outputs:
|
|
|
|
* - on success, the dtree node requested
|
|
|
|
* - on failure, NULL
|
|
|
|
*
|
|
|
|
* Side Effects:
|
|
|
|
* - none
|
|
|
|
*/
|
|
|
|
struct irc_radixtree_leaf *
|
2016-01-21 02:52:17 +01:00
|
|
|
irc_radixtree_elem_find(struct irc_radixtree *dict, const char *key)
|
2016-01-09 07:44:39 +01:00
|
|
|
{
|
|
|
|
char ckey_store[256];
|
|
|
|
|
|
|
|
char *ckey_buf = NULL;
|
|
|
|
const char *ckey;
|
|
|
|
union irc_radixtree_elem *delem;
|
|
|
|
|
|
|
|
int val, keylen;
|
|
|
|
|
|
|
|
s_assert(dict != NULL);
|
|
|
|
s_assert(key != NULL);
|
|
|
|
|
|
|
|
keylen = strlen(key);
|
|
|
|
|
|
|
|
if (dict->canonize_cb == NULL)
|
|
|
|
{
|
|
|
|
ckey = key;
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
if (keylen >= (int) sizeof(ckey_store))
|
|
|
|
{
|
|
|
|
ckey_buf = rb_strdup(key);
|
|
|
|
dict->canonize_cb(ckey_buf);
|
|
|
|
ckey = ckey_buf;
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
rb_strlcpy(ckey_store, key, sizeof ckey_store);
|
|
|
|
dict->canonize_cb(ckey_store);
|
|
|
|
ckey = ckey_store;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
delem = dict->root;
|
|
|
|
|
|
|
|
while (delem != NULL && !IS_LEAF(delem))
|
|
|
|
{
|
|
|
|
if (delem->nibnum / 2 < keylen)
|
|
|
|
val = NIBBLE_VAL(ckey, delem->nibnum);
|
|
|
|
else
|
|
|
|
val = 0;
|
|
|
|
|
|
|
|
delem = delem->node.down[val];
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Now, if the key is in the tree, delem contains it. */
|
|
|
|
if ((delem != NULL) && strcmp(delem->leaf.key, ckey))
|
|
|
|
delem = NULL;
|
|
|
|
|
|
|
|
if (ckey_buf != NULL)
|
|
|
|
rb_free(ckey_buf);
|
|
|
|
|
|
|
|
return &delem->leaf;
|
|
|
|
}
|
|
|
|
|
2016-01-21 03:02:03 +01:00
|
|
|
/*
|
|
|
|
* irc_radixtree_foreach_start_from(struct irc_radixtree *dtree, struct irc_radixtree_iteration_state *state, const char *key)
|
|
|
|
*
|
|
|
|
* Starts iteration from a specified key, by wrapping irc_radixtree_elem_find().
|
|
|
|
*
|
|
|
|
* Inputs:
|
|
|
|
* - patricia tree object
|
|
|
|
* - iterator
|
|
|
|
* - key to start from
|
|
|
|
*
|
|
|
|
* Outputs:
|
|
|
|
* - none
|
|
|
|
*
|
|
|
|
* Side Effects:
|
|
|
|
* - the iterator's state is initialized at a specific point
|
|
|
|
*/
|
|
|
|
void
|
|
|
|
irc_radixtree_foreach_start_from(struct irc_radixtree *dtree, struct irc_radixtree_iteration_state *state, const char *key)
|
|
|
|
{
|
|
|
|
s_assert(dtree != NULL);
|
|
|
|
s_assert(state != NULL);
|
|
|
|
|
|
|
|
if (key != NULL)
|
|
|
|
{
|
|
|
|
STATE_CUR(state) = NULL;
|
|
|
|
STATE_NEXT(state) = irc_radixtree_elem_find(dtree, key);
|
|
|
|
|
|
|
|
/* make STATE_CUR point to selected item and STATE_NEXT point to
|
|
|
|
* next item in the tree */
|
|
|
|
irc_radixtree_foreach_next(dtree, state);
|
|
|
|
}
|
|
|
|
else
|
|
|
|
irc_radixtree_foreach_start(dtree, state);
|
|
|
|
}
|
|
|
|
|
2016-01-09 07:44:39 +01:00
|
|
|
/*
|
|
|
|
* irc_radixtree_add(struct irc_radixtree *dtree, const char *key, void *data)
|
|
|
|
*
|
|
|
|
* Creates a new DTree node and binds data to it.
|
|
|
|
*
|
|
|
|
* Inputs:
|
|
|
|
* - patricia tree object
|
|
|
|
* - name for new DTree node
|
|
|
|
* - data to bind to the new DTree node
|
|
|
|
*
|
|
|
|
* Outputs:
|
|
|
|
* - on success, TRUE
|
|
|
|
* - on failure, FALSE
|
|
|
|
*
|
|
|
|
* Side Effects:
|
|
|
|
* - data is inserted into the DTree.
|
|
|
|
*/
|
|
|
|
struct irc_radixtree_leaf *
|
2016-01-21 02:52:17 +01:00
|
|
|
irc_radixtree_elem_add(struct irc_radixtree *dict, const char *key, void *data)
|
2016-01-09 07:44:39 +01:00
|
|
|
{
|
|
|
|
char *ckey;
|
|
|
|
|
|
|
|
union irc_radixtree_elem *delem, *prev, *newnode;
|
|
|
|
|
|
|
|
union irc_radixtree_elem **place1;
|
|
|
|
|
|
|
|
int val, keylen;
|
|
|
|
int i, j;
|
|
|
|
|
|
|
|
s_assert(dict != NULL);
|
|
|
|
s_assert(key != NULL);
|
|
|
|
s_assert(data != NULL);
|
|
|
|
|
|
|
|
keylen = strlen(key);
|
|
|
|
ckey = rb_strdup(key);
|
|
|
|
|
|
|
|
if (ckey == NULL)
|
|
|
|
return NULL;
|
|
|
|
|
|
|
|
if (dict->canonize_cb != NULL)
|
|
|
|
dict->canonize_cb(ckey);
|
|
|
|
|
|
|
|
prev = NULL;
|
|
|
|
val = POINTERS_PER_NODE + 2; /* trap value */
|
|
|
|
delem = dict->root;
|
|
|
|
|
|
|
|
while (delem != NULL && !IS_LEAF(delem))
|
|
|
|
{
|
|
|
|
prev = delem;
|
|
|
|
|
|
|
|
if (delem->nibnum / 2 < keylen)
|
|
|
|
val = NIBBLE_VAL(ckey, delem->nibnum);
|
|
|
|
else
|
|
|
|
val = 0;
|
|
|
|
|
|
|
|
delem = delem->node.down[val];
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Now, if the key is in the tree, delem contains it. */
|
|
|
|
if ((delem != NULL) && !strcmp(delem->leaf.key, ckey))
|
|
|
|
{
|
|
|
|
rb_free(ckey);
|
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
|
|
|
|
if ((delem == NULL) && (prev != NULL))
|
|
|
|
/* Get a leaf to compare with. */
|
|
|
|
delem = first_leaf(prev);
|
|
|
|
|
|
|
|
if (delem == NULL)
|
|
|
|
{
|
|
|
|
s_assert(prev == NULL);
|
|
|
|
s_assert(dict->count == 0);
|
|
|
|
place1 = &dict->root;
|
|
|
|
*place1 = rb_malloc(sizeof(struct irc_radixtree_leaf));
|
|
|
|
s_assert(*place1 != NULL);
|
|
|
|
(*place1)->nibnum = -1;
|
|
|
|
(*place1)->leaf.data = data;
|
|
|
|
(*place1)->leaf.key = ckey;
|
|
|
|
(*place1)->leaf.parent = prev;
|
|
|
|
(*place1)->leaf.parent_val = val;
|
|
|
|
dict->count++;
|
|
|
|
return &(*place1)->leaf;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Find the first nibble where they differ. */
|
|
|
|
for (i = 0; NIBBLE_VAL(ckey, i) == NIBBLE_VAL(delem->leaf.key, i); i++)
|
|
|
|
;
|
|
|
|
|
|
|
|
/* Find where to insert the new node. */
|
|
|
|
while (prev != NULL && prev->nibnum > i)
|
|
|
|
{
|
|
|
|
val = prev->node.parent_val;
|
|
|
|
prev = prev->node.parent;
|
|
|
|
}
|
|
|
|
|
|
|
|
if ((prev == NULL) || (prev->nibnum < i))
|
|
|
|
{
|
|
|
|
/* Insert new node below prev */
|
|
|
|
newnode = rb_malloc(sizeof(struct irc_radixtree_node));
|
|
|
|
s_assert(newnode != NULL);
|
|
|
|
newnode->nibnum = i;
|
|
|
|
newnode->node.parent = prev;
|
|
|
|
newnode->node.parent_val = val;
|
|
|
|
|
|
|
|
for (j = 0; j < POINTERS_PER_NODE; j++)
|
|
|
|
newnode->node.down[j] = NULL;
|
|
|
|
|
|
|
|
if (prev == NULL)
|
|
|
|
{
|
|
|
|
newnode->node.down[NIBBLE_VAL(delem->leaf.key, i)] = dict->root;
|
|
|
|
|
|
|
|
if (IS_LEAF(dict->root))
|
|
|
|
{
|
|
|
|
dict->root->leaf.parent = newnode;
|
|
|
|
dict->root->leaf.parent_val = NIBBLE_VAL(delem->leaf.key, i);
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
s_assert(dict->root->nibnum > i);
|
|
|
|
dict->root->node.parent = newnode;
|
|
|
|
dict->root->node.parent_val = NIBBLE_VAL(delem->leaf.key, i);
|
|
|
|
}
|
|
|
|
|
|
|
|
dict->root = newnode;
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
newnode->node.down[NIBBLE_VAL(delem->leaf.key, i)] = prev->node.down[val];
|
|
|
|
|
|
|
|
if (IS_LEAF(prev->node.down[val]))
|
|
|
|
{
|
|
|
|
prev->node.down[val]->leaf.parent = newnode;
|
|
|
|
prev->node.down[val]->leaf.parent_val = NIBBLE_VAL(delem->leaf.key, i);
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
prev->node.down[val]->node.parent = newnode;
|
|
|
|
prev->node.down[val]->node.parent_val = NIBBLE_VAL(delem->leaf.key, i);
|
|
|
|
}
|
|
|
|
|
|
|
|
prev->node.down[val] = newnode;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
/* This nibble is already checked. */
|
|
|
|
s_assert(prev->nibnum == i);
|
|
|
|
newnode = prev;
|
|
|
|
}
|
|
|
|
|
|
|
|
val = NIBBLE_VAL(ckey, i);
|
|
|
|
place1 = &newnode->node.down[val];
|
|
|
|
s_assert(*place1 == NULL);
|
|
|
|
*place1 = rb_malloc(sizeof(struct irc_radixtree_leaf));
|
|
|
|
s_assert(*place1 != NULL);
|
|
|
|
(*place1)->nibnum = -1;
|
|
|
|
(*place1)->leaf.data = data;
|
|
|
|
(*place1)->leaf.key = ckey;
|
|
|
|
(*place1)->leaf.parent = newnode;
|
|
|
|
(*place1)->leaf.parent_val = val;
|
|
|
|
dict->count++;
|
|
|
|
return &(*place1)->leaf;
|
|
|
|
}
|
|
|
|
|
|
|
|
int
|
|
|
|
irc_radixtree_add(struct irc_radixtree *dict, const char *key, void *data)
|
|
|
|
{
|
2016-01-21 02:52:17 +01:00
|
|
|
return (irc_radixtree_elem_add(dict, key, data) != NULL);
|
2016-01-09 07:44:39 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* irc_radixtree_delete(struct irc_radixtree *dtree, const char *key)
|
|
|
|
*
|
|
|
|
* Deletes data from a patricia tree.
|
|
|
|
*
|
|
|
|
* Inputs:
|
|
|
|
* - patricia tree object
|
|
|
|
* - name of DTree node to delete
|
|
|
|
*
|
|
|
|
* Outputs:
|
|
|
|
* - on success, the remaining data that needs to be rb_freed
|
|
|
|
* - on failure, NULL
|
|
|
|
*
|
|
|
|
* Side Effects:
|
|
|
|
* - data is removed from the DTree.
|
|
|
|
*
|
|
|
|
* Notes:
|
|
|
|
* - the returned data needs to be rb_freed/released manually!
|
|
|
|
*/
|
|
|
|
void *
|
|
|
|
irc_radixtree_delete(struct irc_radixtree *dict, const char *key)
|
|
|
|
{
|
|
|
|
void *data;
|
|
|
|
struct irc_radixtree_leaf *leaf;
|
|
|
|
|
2016-01-21 02:52:17 +01:00
|
|
|
leaf = irc_radixtree_elem_find(dict, key);
|
2016-01-09 07:44:39 +01:00
|
|
|
|
|
|
|
if (leaf == NULL)
|
|
|
|
return NULL;
|
|
|
|
|
|
|
|
data = leaf->data;
|
|
|
|
irc_radixtree_elem_delete(dict, leaf);
|
|
|
|
return data;
|
|
|
|
}
|
|
|
|
|
|
|
|
void
|
|
|
|
irc_radixtree_elem_delete(struct irc_radixtree *dict, struct irc_radixtree_leaf *leaf)
|
|
|
|
{
|
|
|
|
union irc_radixtree_elem *delem, *prev, *next;
|
|
|
|
|
|
|
|
int val, i, used;
|
|
|
|
|
|
|
|
s_assert(dict != NULL);
|
|
|
|
s_assert(leaf != NULL);
|
|
|
|
|
|
|
|
delem = (union irc_radixtree_elem *) leaf;
|
|
|
|
|
|
|
|
val = delem->leaf.parent_val;
|
|
|
|
prev = delem->leaf.parent;
|
|
|
|
|
|
|
|
rb_free(delem->leaf.key);
|
|
|
|
rb_free(delem);
|
|
|
|
|
|
|
|
if (prev != NULL)
|
|
|
|
{
|
|
|
|
prev->node.down[val] = NULL;
|
|
|
|
|
|
|
|
/* Leaf is gone, now consider the node it was in. */
|
|
|
|
delem = prev;
|
|
|
|
|
|
|
|
used = -1;
|
|
|
|
|
|
|
|
for (i = 0; i < POINTERS_PER_NODE; i++)
|
|
|
|
if (delem->node.down[i] != NULL)
|
|
|
|
used = used == -1 ? i : -2;
|
|
|
|
|
|
|
|
s_assert(used == -2 || used >= 0);
|
|
|
|
|
|
|
|
if (used >= 0)
|
|
|
|
{
|
|
|
|
/* Only one pointer in this node, remove it.
|
|
|
|
* Replace the pointer that pointed to it by
|
|
|
|
* the sole pointer in it.
|
|
|
|
*/
|
|
|
|
next = delem->node.down[used];
|
|
|
|
val = delem->node.parent_val;
|
|
|
|
prev = delem->node.parent;
|
|
|
|
|
|
|
|
if (prev != NULL)
|
|
|
|
prev->node.down[val] = next;
|
|
|
|
else
|
|
|
|
dict->root = next;
|
|
|
|
|
|
|
|
if (IS_LEAF(next))
|
|
|
|
next->leaf.parent = prev, next->leaf.parent_val = val;
|
|
|
|
else
|
|
|
|
next->node.parent = prev, next->node.parent_val = val;
|
|
|
|
|
|
|
|
rb_free(delem);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
/* This was the last leaf. */
|
|
|
|
dict->root = NULL;
|
|
|
|
}
|
|
|
|
|
|
|
|
dict->count--;
|
|
|
|
|
|
|
|
if (dict->count == 0)
|
|
|
|
{
|
|
|
|
s_assert(dict->root == NULL);
|
|
|
|
dict->root = NULL;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* irc_radixtree_retrieve(struct irc_radixtree *dtree, const char *key)
|
|
|
|
*
|
|
|
|
* Retrieves data from a patricia.
|
|
|
|
*
|
|
|
|
* Inputs:
|
|
|
|
* - patricia tree object
|
|
|
|
* - name of node to lookup
|
|
|
|
*
|
|
|
|
* Outputs:
|
|
|
|
* - on success, the data bound to the DTree node.
|
|
|
|
* - on failure, NULL
|
|
|
|
*
|
|
|
|
* Side Effects:
|
|
|
|
* - none
|
|
|
|
*/
|
|
|
|
void *
|
|
|
|
irc_radixtree_retrieve(struct irc_radixtree *dtree, const char *key)
|
|
|
|
{
|
2016-01-21 02:52:17 +01:00
|
|
|
struct irc_radixtree_leaf *delem = irc_radixtree_elem_find(dtree, key);
|
2016-01-09 07:44:39 +01:00
|
|
|
|
|
|
|
if (delem != NULL)
|
|
|
|
return delem->data;
|
|
|
|
|
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
|
|
|
|
const char *
|
2016-01-21 02:52:17 +01:00
|
|
|
irc_radixtree_elem_get_key(struct irc_radixtree_leaf *leaf)
|
2016-01-09 07:44:39 +01:00
|
|
|
{
|
|
|
|
s_assert(leaf != NULL);
|
|
|
|
|
|
|
|
return leaf->key;
|
|
|
|
}
|
|
|
|
|
|
|
|
void
|
2016-01-21 02:52:17 +01:00
|
|
|
irc_radixtree_elem_set_data(struct irc_radixtree_leaf *leaf, void *data)
|
2016-01-09 07:44:39 +01:00
|
|
|
{
|
|
|
|
s_assert(leaf != NULL);
|
|
|
|
|
|
|
|
leaf->data = data;
|
|
|
|
}
|
|
|
|
|
|
|
|
void *
|
2016-01-21 02:52:17 +01:00
|
|
|
irc_radixtree_elem_get_data(struct irc_radixtree_leaf *leaf)
|
2016-01-09 07:44:39 +01:00
|
|
|
{
|
|
|
|
s_assert(leaf != NULL);
|
|
|
|
|
|
|
|
return leaf->data;
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* irc_radixtree_size(struct irc_radixtree *dict)
|
|
|
|
*
|
|
|
|
* Returns the size of a patricia.
|
|
|
|
*
|
|
|
|
* Inputs:
|
|
|
|
* - patricia tree object
|
|
|
|
*
|
|
|
|
* Outputs:
|
|
|
|
* - size of patricia
|
|
|
|
*
|
|
|
|
* Side Effects:
|
|
|
|
* - none
|
|
|
|
*/
|
|
|
|
unsigned int
|
|
|
|
irc_radixtree_size(struct irc_radixtree *dict)
|
|
|
|
{
|
|
|
|
s_assert(dict != NULL);
|
|
|
|
|
|
|
|
return dict->count;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* returns the sum of the depths of the subtree rooted in delem at depth depth */
|
|
|
|
/* there is no need for this to be recursive, but it is easier... */
|
|
|
|
static int
|
|
|
|
stats_recurse(union irc_radixtree_elem *delem, int depth, int *pmaxdepth)
|
|
|
|
{
|
|
|
|
int result = 0;
|
|
|
|
int val;
|
|
|
|
union irc_radixtree_elem *next;
|
|
|
|
|
|
|
|
if (depth > *pmaxdepth)
|
|
|
|
*pmaxdepth = depth;
|
|
|
|
|
|
|
|
if (depth == 0)
|
|
|
|
{
|
|
|
|
if (IS_LEAF(delem))
|
|
|
|
s_assert(delem->leaf.parent == NULL);
|
|
|
|
|
|
|
|
else
|
|
|
|
s_assert(delem->node.parent == NULL);
|
|
|
|
}
|
|
|
|
|
|
|
|
if (IS_LEAF(delem))
|
|
|
|
return depth;
|
|
|
|
|
|
|
|
for (val = 0; val < POINTERS_PER_NODE; val++)
|
|
|
|
{
|
|
|
|
next = delem->node.down[val];
|
|
|
|
|
|
|
|
if (next == NULL)
|
|
|
|
continue;
|
|
|
|
|
|
|
|
result += stats_recurse(next, depth + 1, pmaxdepth);
|
|
|
|
|
|
|
|
if (IS_LEAF(next))
|
|
|
|
{
|
|
|
|
s_assert(next->leaf.parent == delem);
|
|
|
|
s_assert(next->leaf.parent_val == val);
|
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
|
|
|
s_assert(next->node.parent == delem);
|
|
|
|
s_assert(next->node.parent_val == val);
|
|
|
|
s_assert(next->node.nibnum > delem->node.nibnum);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return result;
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* irc_radixtree_stats(struct irc_radixtree *dict, void (*cb)(const char *line, void *privdata), void *privdata)
|
|
|
|
*
|
|
|
|
* Returns the size of a patricia.
|
|
|
|
*
|
|
|
|
* Inputs:
|
|
|
|
* - patricia tree object
|
|
|
|
* - callback
|
|
|
|
* - data for callback
|
|
|
|
*
|
|
|
|
* Outputs:
|
|
|
|
* - none
|
|
|
|
*
|
|
|
|
* Side Effects:
|
|
|
|
* - callback called with stats text
|
|
|
|
*/
|
|
|
|
void
|
|
|
|
irc_radixtree_stats(struct irc_radixtree *dict, void (*cb)(const char *line, void *privdata), void *privdata)
|
|
|
|
{
|
|
|
|
char str[256];
|
|
|
|
int sum, maxdepth;
|
|
|
|
|
|
|
|
s_assert(dict != NULL);
|
|
|
|
|
|
|
|
maxdepth = 0;
|
|
|
|
if (dict->count > 0)
|
|
|
|
{
|
|
|
|
sum = stats_recurse(dict->root, 0, &maxdepth);
|
2016-01-09 13:23:13 +01:00
|
|
|
snprintf(str, sizeof str, "%-30s %-15s %-10d %-10d %-10d %-10d", dict->id, "RADIX", dict->count, sum, sum / dict->count, maxdepth);
|
2016-01-09 07:44:39 +01:00
|
|
|
}
|
|
|
|
else
|
|
|
|
{
|
2016-01-09 13:23:13 +01:00
|
|
|
snprintf(str, sizeof str, "%-30s %-15s %-10s %-10s %-10s %-10s", dict->id, "RADIX", "0", "0", "0", "0");
|
2016-01-09 07:44:39 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
cb(str, privdata);
|
|
|
|
return;
|
|
|
|
}
|
2016-01-09 07:54:57 +01:00
|
|
|
|
|
|
|
void
|
|
|
|
irc_radixtree_stats_walk(void (*cb)(const char *line, void *privdata), void *privdata)
|
|
|
|
{
|
|
|
|
rb_dlink_node *ptr;
|
|
|
|
|
|
|
|
RB_DLINK_FOREACH(ptr, radixtree_list.head)
|
|
|
|
{
|
|
|
|
irc_radixtree_stats(ptr->data, cb, privdata);
|
|
|
|
}
|
|
|
|
}
|
2016-01-09 08:00:55 +01:00
|
|
|
|
|
|
|
void irc_radixtree_irccasecanon(char *str)
|
|
|
|
{
|
|
|
|
while (*str)
|
|
|
|
{
|
|
|
|
*str = ToUpper(*str);
|
|
|
|
str++;
|
|
|
|
}
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
void irc_radixtree_strcasecanon(char *str)
|
|
|
|
{
|
|
|
|
while (*str)
|
|
|
|
{
|
|
|
|
*str = toupper((unsigned char)*str);
|
|
|
|
str++;
|
|
|
|
}
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|