summaryrefslogtreecommitdiff
path: root/lib/search.in.h
diff options
context:
space:
mode:
authorBruno Haible <bruno@clisp.org>2007-10-02 00:24:48 +0200
committerBruno Haible <bruno@clisp.org>2007-10-02 00:24:48 +0200
commitb2b1b4208042f959acc8cbc9ec1da0cac0445492 (patch)
tree1f2cdcf16460d831946b593ab0b603524fc1fc53 /lib/search.in.h
parentdedb20e295405023de849f0ad98b1bcbc105c43c (diff)
downloadgnulib-b2b1b4208042f959acc8cbc9ec1da0cac0445492.tar.gz
Rename search_.h to search.in.h.
Diffstat (limited to 'lib/search.in.h')
-rw-r--r--lib/search.in.h115
1 files changed, 115 insertions, 0 deletions
diff --git a/lib/search.in.h b/lib/search.in.h
new file mode 100644
index 0000000000..b41abdc4d5
--- /dev/null
+++ b/lib/search.in.h
@@ -0,0 +1,115 @@
+/* A GNU-like <search.h>.
+
+ Copyright (C) 2007 Free Software Foundation, Inc.
+
+ This program is free software; you can redistribute it and/or modify
+ it under the terms of the GNU 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.
+
+ You should have received a copy of the GNU General Public License
+ along with this program; if not, write to the Free Software Foundation,
+ Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */
+
+#ifndef _GL_SEARCH_H
+
+/* The include_next requires a split double-inclusion guard. */
+#if @HAVE_SEARCH_H@
+# @INCLUDE_NEXT@ @NEXT_SEARCH_H@
+#endif
+
+#ifndef _GL_SEARCH_H
+#define _GL_SEARCH_H
+
+
+/* The definition of GL_LINK_WARNING is copied here. */
+
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+
+#if @GNULIB_TSEARCH@
+# if !@HAVE_TSEARCH@
+
+/* See <http://www.opengroup.org/susv3xbd/search.h.html>,
+ <http://www.opengroup.org/susv3xsh/tsearch.html>
+ for details. */
+
+typedef enum
+{
+ preorder,
+ postorder,
+ endorder,
+ leaf
+}
+VISIT;
+
+/* Searches an element in the tree *VROOTP that compares equal to KEY.
+ If one is found, it is returned. Otherwise, a new element equal to KEY
+ is inserted in the tree and is returned. */
+extern void * tsearch (const void *key, void **vrootp,
+ int (*compar) (const void *, const void *));
+
+/* Searches an element in the tree *VROOTP that compares equal to KEY.
+ If one is found, it is returned. Otherwise, NULL is returned. */
+extern void * tfind (const void *key, void *const *vrootp,
+ int (*compar) (const void *, const void *));
+
+/* Searches an element in the tree *VROOTP that compares equal to KEY.
+ If one is found, it is removed from the tree, and its parent node is
+ returned. Otherwise, NULL is returned. */
+extern void * tdelete (const void *key, void **vrootp,
+ int (*compar) (const void *, const void *));
+
+/* Perform a depth-first, left-to-right traversal of the tree VROOT.
+ The ACTION function is called:
+ - for non-leaf nodes: 3 times, before the left subtree traversal,
+ after the left subtree traversal but before the right subtree traversal,
+ and after the right subtree traversal,
+ - for leaf nodes: once.
+ The arguments passed to ACTION are:
+ 1. the node; it can be casted to a 'const void * const *', i.e. into a
+ pointer to the key,
+ 2. an indicator which visit of the node this is,
+ 3. the level of the node in the tree (0 for the root). */
+extern void twalk (const void *vroot,
+ void (*action) (const void *, VISIT, int));
+
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef tsearch
+# define tsearch(k,v,c) \
+ (GL_LINK_WARNING ("tsearch is unportable - " \
+ "use gnulib module tsearch for portability"), \
+ tsearch (k, v, c))
+# undef tfind
+# define tfind(k,v,c) \
+ (GL_LINK_WARNING ("tfind is unportable - " \
+ "use gnulib module tsearch for portability"), \
+ tfind (k, v, c))
+# undef tdelete
+# define tdelete(k,v,c) \
+ (GL_LINK_WARNING ("tdelete is unportable - " \
+ "use gnulib module tsearch for portability"), \
+ tdelete (k, v, c))
+# undef twalk
+# define twalk(v,a) \
+ (GL_LINK_WARNING ("twalk is unportable - " \
+ "use gnulib module tsearch for portability"), \
+ twalk (v, a))
+#endif
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* _GL_SEARCH_H */
+#endif /* _GL_SEARCH_H */