mirror of
https://github.com/michaelrsweet/mxml.git
synced 2024-11-08 13:39:58 +00:00
e6c90615c6
Doco updates.
479 lines
10 KiB
C
479 lines
10 KiB
C
/*
|
|
* "$Id: mxml-index.c,v 1.2 2004/05/16 13:09:44 mike Exp $"
|
|
*
|
|
* Index support code for Mini-XML, a small XML-like file parsing library.
|
|
*
|
|
* Copyright 2003-2004 by Michael Sweet.
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Library General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2, or (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* Contents:
|
|
*
|
|
* mxmlIndexDelete() - Delete an index.
|
|
* mxmlIndexEnum() - Return the next node in the index.
|
|
* mxmlIndexFind() - Find the next matching node.
|
|
* mxmlIndexNew() - Create a new index.
|
|
* mxmlIndexReset() - Reset the enumeration/find pointer in the index and
|
|
* return the first node in the index.
|
|
* sort_attr() - Sort by attribute value...
|
|
* sort_attr() - Sort by element name...
|
|
* sort_element_attr() - Sort by element name and attribute value...
|
|
*/
|
|
|
|
/*
|
|
* Include necessary headers...
|
|
*/
|
|
|
|
#include "config.h"
|
|
#include "mxml.h"
|
|
|
|
|
|
/*
|
|
* Sort functions...
|
|
*/
|
|
|
|
static int index_compare(mxml_index_t *ind, const char *element,
|
|
const char *value, mxml_node_t *node);
|
|
static int sort_attr(const void *a, const void *b);
|
|
static int sort_element(const void *a, const void *b);
|
|
static int sort_element_attr(const void *a, const void *b);
|
|
|
|
|
|
/*
|
|
* Sort attribute...
|
|
*/
|
|
|
|
static const char *sort_attr_name; /* Current attribute to sort on */
|
|
|
|
|
|
/*
|
|
* 'mxmlIndexDelete()' - Delete an index.
|
|
*/
|
|
|
|
void
|
|
mxmlIndexDelete(mxml_index_t *ind) /* I - Index to delete */
|
|
{
|
|
/*
|
|
* Range check input..
|
|
*/
|
|
|
|
if (!ind)
|
|
return;
|
|
|
|
/*
|
|
* Free memory...
|
|
*/
|
|
|
|
if (ind->attr)
|
|
free(ind->attr);
|
|
|
|
if (ind->alloc_nodes)
|
|
free(ind->nodes);
|
|
|
|
free(ind);
|
|
}
|
|
|
|
|
|
/*
|
|
* 'mxmlIndexEnum()' - Return the next node in the index.
|
|
*
|
|
* Nodes are returned in the sorted order of the index.
|
|
*/
|
|
|
|
mxml_node_t * /* O - Next node or NULL if there is none */
|
|
mxmlIndexEnum(mxml_index_t *ind) /* I - Index to enumerate */
|
|
{
|
|
/*
|
|
* Range check input...
|
|
*/
|
|
|
|
if (!ind)
|
|
return (NULL);
|
|
|
|
/*
|
|
* Return the next node...
|
|
*/
|
|
|
|
if (ind->cur_node < ind->num_nodes)
|
|
return (ind->nodes[ind->cur_node ++]);
|
|
else
|
|
return (NULL);
|
|
}
|
|
|
|
|
|
/*
|
|
* 'mxmlIndexFind()' - Find the next matching node.
|
|
*
|
|
* You should call mxmlIndexReset() prior to using this function for
|
|
* the first time with a particular set of "element" and "value"
|
|
* strings. Passing NULL for both "element" and "value" is equivalent
|
|
* to calling mxmlIndexEnum().
|
|
*/
|
|
|
|
mxml_node_t * /* O - Node or NULL if none found */
|
|
mxmlIndexFind(mxml_index_t *ind, /* I - Index to search */
|
|
const char *element, /* I - Element name to find, if any */
|
|
const char *value) /* I - Attribute value, if any */
|
|
{
|
|
int diff, /* Difference between names */
|
|
current, /* Current entity in search */
|
|
first, /* First entity in search */
|
|
last; /* Last entity in search */
|
|
|
|
|
|
/*
|
|
* Range check input...
|
|
*/
|
|
|
|
if (!ind || (!ind->attr && value))
|
|
return (NULL);
|
|
|
|
/*
|
|
* If both element and value are NULL, just enumerate the nodes in the
|
|
* index...
|
|
*/
|
|
|
|
if (!element && !value)
|
|
return (mxmlIndexEnum(ind));
|
|
|
|
/*
|
|
* If there are no nodes in the index, return NULL...
|
|
*/
|
|
|
|
if (!ind->num_nodes)
|
|
return (NULL);
|
|
|
|
/*
|
|
* If cur_node == 0, then find the first matching node...
|
|
*/
|
|
|
|
if (ind->cur_node == 0)
|
|
{
|
|
/*
|
|
* Find the first node using a modified binary search algorithm...
|
|
*/
|
|
|
|
first = 0;
|
|
last = ind->num_nodes - 1;
|
|
|
|
while (last > first)
|
|
{
|
|
current = (first + last) / 2;
|
|
|
|
if ((diff = index_compare(ind, element, value, ind->nodes[current])) == 0)
|
|
{
|
|
/*
|
|
* Found a match, move back to find the first...
|
|
*/
|
|
|
|
while (current > 0 &&
|
|
!index_compare(ind, element, value, ind->nodes[current - 1]))
|
|
current --;
|
|
|
|
/*
|
|
* Return the first match and save the index to the next...
|
|
*/
|
|
|
|
ind->cur_node = current + 1;
|
|
|
|
return (ind->nodes[current]);
|
|
}
|
|
else if (diff < 0)
|
|
last = current;
|
|
else
|
|
first = current;
|
|
}
|
|
|
|
/*
|
|
* If we get this far, then we found exactly 0 or 1 matches...
|
|
*/
|
|
|
|
current = (first + last) / 2;
|
|
ind->cur_node = ind->num_nodes;
|
|
|
|
if (!index_compare(ind, element, value, ind->nodes[current]))
|
|
{
|
|
/*
|
|
* Found exactly one match...
|
|
*/
|
|
|
|
return (ind->nodes[current]);
|
|
}
|
|
else
|
|
{
|
|
/*
|
|
* No matches...
|
|
*/
|
|
|
|
return (NULL);
|
|
}
|
|
}
|
|
else if (ind->cur_node < ind->num_nodes &&
|
|
!index_compare(ind, element, value, ind->nodes[ind->cur_node]))
|
|
{
|
|
/*
|
|
* Return the next matching node...
|
|
*/
|
|
|
|
return (ind->nodes[ind->cur_node ++]);
|
|
}
|
|
|
|
/*
|
|
* If we get this far, then we have no matches...
|
|
*/
|
|
|
|
ind->cur_node = ind->num_nodes;
|
|
|
|
return (NULL);
|
|
}
|
|
|
|
|
|
/*
|
|
* 'mxmlIndexNew()' - Create a new index.
|
|
*
|
|
* The index will contain all nodes that contain the named element and/or
|
|
* attribute. If both "element" and "attr" are NULL, then the index will
|
|
* contain a sorted list of the elements in the node tree. Nodes are
|
|
* sorted by element name and optionally by attribute value if the "attr"
|
|
* argument is not NULL.
|
|
*/
|
|
|
|
mxml_index_t * /* O - New index */
|
|
mxmlIndexNew(mxml_node_t *node, /* I - XML node tree */
|
|
const char *element, /* I - Element to index or NULL for all */
|
|
const char *attr) /* I - Attribute to index or NULL for none */
|
|
{
|
|
mxml_index_t *ind; /* New index */
|
|
mxml_node_t *current, /* Current node in index */
|
|
**temp; /* Temporary node pointer array */
|
|
|
|
|
|
/*
|
|
* Range check input...
|
|
*/
|
|
|
|
if (!node)
|
|
return (NULL);
|
|
|
|
/*
|
|
* Create a new index...
|
|
*/
|
|
|
|
if ((ind = calloc(1, sizeof(mxml_index_t))) != NULL)
|
|
return (NULL);
|
|
|
|
for (current = mxmlFindElement(node, node, element, attr, NULL, MXML_DESCEND);
|
|
current;
|
|
current = mxmlFindElement(current, node, element, attr, NULL, MXML_DESCEND))
|
|
{
|
|
if (ind->num_nodes >= ind->alloc_nodes)
|
|
{
|
|
if (!ind->alloc_nodes)
|
|
temp = malloc(64 * sizeof(mxml_node_t *));
|
|
else
|
|
temp = realloc(ind->nodes, (ind->alloc_nodes + 64) * sizeof(mxml_node_t *));
|
|
|
|
if (!temp)
|
|
{
|
|
/*
|
|
* Unable to allocate memory for the index, so abort...
|
|
*/
|
|
|
|
mxml_error("Unable to allocate %d bytes for index: %s",
|
|
(ind->alloc_nodes + 64) * sizeof(mxml_node_t *),
|
|
strerror(errno));
|
|
|
|
mxmlIndexDelete(ind);
|
|
return (NULL);
|
|
}
|
|
|
|
ind->nodes = temp;
|
|
ind->alloc_nodes += 64;
|
|
}
|
|
|
|
ind->nodes[ind->num_nodes ++] = current;
|
|
}
|
|
|
|
/*
|
|
* Sort nodes based upon the search criteria...
|
|
*/
|
|
|
|
if (ind->num_nodes > 0)
|
|
{
|
|
if (!element && attr)
|
|
{
|
|
/*
|
|
* Sort based upon the element name and attribute value...
|
|
*/
|
|
|
|
sort_attr_name = attr;
|
|
ind->attr = strdup(attr);
|
|
|
|
qsort(ind->nodes, ind->num_nodes, sizeof(mxml_node_t *),
|
|
sort_element_attr);
|
|
}
|
|
else if (!element && !attr)
|
|
{
|
|
/*
|
|
* Sort based upon the element name...
|
|
*/
|
|
|
|
qsort(ind->nodes, ind->num_nodes, sizeof(mxml_node_t *),
|
|
sort_element);
|
|
}
|
|
else if (attr)
|
|
{
|
|
/*
|
|
* Sort based upon the attribute value...
|
|
*/
|
|
|
|
sort_attr_name = attr;
|
|
ind->attr = strdup(attr);
|
|
|
|
qsort(ind->nodes, ind->num_nodes, sizeof(mxml_node_t *),
|
|
sort_attr);
|
|
}
|
|
}
|
|
|
|
/*
|
|
* Return the new index...
|
|
*/
|
|
|
|
return (ind);
|
|
}
|
|
|
|
|
|
/*
|
|
* 'mxmlIndexReset()' - Reset the enumeration/find pointer in the index and
|
|
* return the first node in the index.
|
|
*
|
|
* This function should be called prior to using mxmlIndexEnum() or
|
|
* mxmlIndexFind() for the first time.
|
|
*/
|
|
|
|
mxml_node_t * /* O - First node or NULL if there is none */
|
|
mxmlIndexReset(mxml_index_t *ind) /* I - Index to reset */
|
|
{
|
|
/*
|
|
* Range check input...
|
|
*/
|
|
|
|
if (!ind)
|
|
return (NULL);
|
|
|
|
/*
|
|
* Set the index to the first element...
|
|
*/
|
|
|
|
ind->cur_node = 0;
|
|
|
|
/*
|
|
* Return the first node...
|
|
*/
|
|
|
|
if (ind->num_nodes)
|
|
return (ind->nodes[0]);
|
|
else
|
|
return (NULL);
|
|
}
|
|
|
|
|
|
/*
|
|
* 'index_compare()' - Compare a node with index values.
|
|
*/
|
|
|
|
static int /* O - Result of comparison */
|
|
index_compare(mxml_index_t *ind, /* I - Index */
|
|
const char *element, /* I - Element name or NULL */
|
|
const char *value, /* I - Attribute value or NULL */
|
|
mxml_node_t *node) /* I - Node */
|
|
{
|
|
int diff; /* Difference */
|
|
|
|
|
|
/*
|
|
* Check the element name...
|
|
*/
|
|
|
|
if (element)
|
|
{
|
|
if ((diff = strcmp(element, node->value.element.name)) != 0)
|
|
return (diff);
|
|
}
|
|
|
|
/*
|
|
* Check the attribute value...
|
|
*/
|
|
|
|
if (value)
|
|
{
|
|
if ((diff = strcmp(value, mxmlElementGetAttr(node, ind->attr))) != 0)
|
|
return (diff);
|
|
}
|
|
|
|
/*
|
|
* No difference, return 0...
|
|
*/
|
|
|
|
return (0);
|
|
}
|
|
|
|
|
|
/*
|
|
* 'sort_attr()' - Sort by attribute value...
|
|
*/
|
|
|
|
static int /* O - Result of comparison */
|
|
sort_attr(const void *a, /* I - First node */
|
|
const void *b) /* I - Second node */
|
|
{
|
|
return (strcmp(mxmlElementGetAttr((mxml_node_t *)a, sort_attr_name),
|
|
mxmlElementGetAttr((mxml_node_t *)b, sort_attr_name)));
|
|
}
|
|
|
|
|
|
/*
|
|
* 'sort_element()' - Sort by element name...
|
|
*/
|
|
|
|
static int /* O - Result of comparison */
|
|
sort_element(const void *a, /* I - First node */
|
|
const void *b) /* I - Second node */
|
|
{
|
|
return (strcmp(((mxml_node_t *)a)->value.element.name,
|
|
((mxml_node_t *)b)->value.element.name));
|
|
}
|
|
|
|
|
|
/*
|
|
* 'sort_element_attr()' - Sort by element name and attribute value...
|
|
*/
|
|
|
|
static int /* O - Result of comparison */
|
|
sort_element_attr(const void *a, /* I - First node */
|
|
const void *b) /* I - Second node */
|
|
{
|
|
int i; /* Result of comparison */
|
|
|
|
|
|
if ((i = strcmp(((mxml_node_t *)a)->value.element.name,
|
|
((mxml_node_t *)b)->value.element.name)) != 0)
|
|
return (i);
|
|
else
|
|
return (strcmp(mxmlElementGetAttr((mxml_node_t *)a, sort_attr_name),
|
|
mxmlElementGetAttr((mxml_node_t *)b, sort_attr_name)));
|
|
}
|
|
|
|
|
|
/*
|
|
* End of "$Id: mxml-index.c,v 1.2 2004/05/16 13:09:44 mike Exp $".
|
|
*/
|