X-Git-Url: http://git.indexdata.com/?p=idzebra-moved-to-github.git;a=blobdiff_plain;f=include%2Fsortidx.h;h=d660d19b4102c23d4bb2948d1e0c4d7a597862ba;hp=6ee16c489f17cb4bdb8f0221ce985a9b0e1b7586;hb=5d536c8cf5400b1e4da91061cf736a9ab53e5bd1;hpb=b3af54f7bf58db2a5d85b6a54b720bf6c5359c1f

diff --git a/include/sortidx.h b/include/sortidx.h
index 6ee16c4..d660d19 100644
--- a/include/sortidx.h
+++ b/include/sortidx.h
@@ -1,8 +1,5 @@
-/* $Id: sortidx.h,v 1.11 2006-11-21 22:17:49 adam Exp $
-   Copyright (C) 1995-2006
-   Index Data ApS
-
-This file is part of the Zebra server.
+/* This file is part of the Zebra server.
+   Copyright (C) 1994-2011 Index Data
 
 Zebra 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
@@ -26,19 +23,71 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 #include <yaz/yconfig.h>
 #include <idzebra/version.h>
 #include <idzebra/bfile.h>
+#include <yaz/wrbuf.h>
 
 YAZ_BEGIN_CDECL
 
 #define SORT_IDX_ENTRYSIZE 64
 
-typedef struct sortIdx *SortIdx;
+/** \var zebra_sort_index_t
+    \brief sort index handle
+*/
+typedef struct zebra_sort_index *zebra_sort_index_t;
+
+#define ZEBRA_SORT_TYPE_FLAT 1
+#define ZEBRA_SORT_TYPE_ISAMB 2
+#define ZEBRA_SORT_TYPE_MULTI 3
+
+/** \brief creates sort handle
+    \param bfs block files handle
+    \param write_flag (0=read-only, 1=write and read)
+    \param sort_type one of ZEBRA_SORT_TYPE_..
+    \return sort index handle
+*/
+zebra_sort_index_t zebra_sort_open(BFiles bfs, int write_flag, int sort_type);
+
+/** \brief frees sort handle
+*/
+void zebra_sort_close(zebra_sort_index_t si);
 
-SortIdx sortIdx_open(BFiles bfs, int write_flag);
-void sortIdx_close(SortIdx si);
-int sortIdx_type(SortIdx si, int type);
-void sortIdx_sysno(SortIdx si, zint sysno);
-void sortIdx_add(SortIdx si, const char *buf, int len);
-void sortIdx_read(SortIdx si, char *buf);
+/** \brief sets type for sort usage
+    \param si sort index handle
+    \param type opaque type .. A sort file for each type is created
+*/
+int zebra_sort_type(zebra_sort_index_t si, int type);
+
+/** \brief sets sort system number for read / add / delete
+    \param si sort index handle
+    \param sysno system number
+*/
+void zebra_sort_sysno(zebra_sort_index_t si, zint sysno);
+
+/** \brief adds multi-map content to sort file
+    \param si sort index handle
+    \param section_id section of key
+    \param w one or more 0-terminted strings (thus an array)
+
+    zebra_sort_type and zebra_sort_sysno must be called prior to this
+*/
+void zebra_sort_add(zebra_sort_index_t si, zint section_id, WRBUF w);
+
+
+/** \brief delete sort entry
+    \param si sort index handle
+    \param section_id section of sort key to be deleted
+
+    zebra_sort_type and zebra_sort_sysno must be called prior to this
+*/
+void zebra_sort_delete(zebra_sort_index_t si, zint section_id);
+
+/** \brief reads sort entry
+    \param si sort index handle
+    \param section_id output section ID (may be NULL and it will not be set)
+    \param w resulting buffer
+    \retval 0 could not be read
+    \retval 1 could be read (found)
+*/
+int zebra_sort_read(zebra_sort_index_t si, zint *section_id, WRBUF w);
 
 YAZ_END_CDECL
 
@@ -46,6 +95,7 @@ YAZ_END_CDECL
 /*
  * Local variables:
  * c-basic-offset: 4
+ * c-file-style: "Stroustrup"
  * indent-tabs-mode: nil
  * End:
  * vim: shiftwidth=4 tabstop=8 expandtab