-/* $Id: sortidx.h,v 1.3 2002-08-02 19:26:55 adam Exp $
- Copyright (C) 1995,1996,1997,1998,1999,2000,2001,2002
- Index Data Aps
-
-This file is part of the Zebra server.
+/* This file is part of the Zebra server.
+ Copyright (C) 1994-2010 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
for more details.
You should have received a copy of the GNU General Public License
-along with Zebra; see the file LICENSE.zebra. If not, write to the
-Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA
-02111-1307, USA.
-*/
-
+along with this program; if not, write to the Free Software
+Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+*/
#ifndef SORTIDX_H
#define SORTIDX_H
-#include <bfile.h>
+#include <yaz/yconfig.h>
+#include <idzebra/version.h>
+#include <idzebra/bfile.h>
+#include <yaz/wrbuf.h>
-#ifdef __cplusplus
-extern "C" {
-#endif
+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;
-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, int sysno);
-void sortIdx_add (SortIdx si, const char *buf, int len);
-void sortIdx_read (SortIdx si, char *buf);
+#define ZEBRA_SORT_TYPE_FLAT 1
+#define ZEBRA_SORT_TYPE_ISAMB 2
+#define ZEBRA_SORT_TYPE_MULTI 3
-#ifdef __cplusplus
-}
-#endif
+/** \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);
+
+/** \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
#endif
+/*
+ * Local variables:
+ * c-basic-offset: 4
+ * c-file-style: "Stroustrup"
+ * indent-tabs-mode: nil
+ * End:
+ * vim: shiftwidth=4 tabstop=8 expandtab
+ */
+