xdb.h

sourceforge历史版本完整下载: http://sourceforge.net/project/showfiles.php?group_id=202044 提供了基于b树索引算法的文件数据数据

/**
 * @file xdb.h 在btree的基础上构建xdb数据库接口函数 2008-03-03 23:26
 *
 * @author lin shao chuan (email:[e-mail], msn:[e-mail])
 *
 * @brief if it works, it was written by lin shao chuan, if not, i don't know who wrote it.
 *
 * Permission to use, copy, modify, distribute and sell this software
 * and its documentation for any purpose is hereby granted without fee,
 * provided that the above copyright notice appear in all copies and
 * that both that copyright notice and this permission notice appear
 * in supporting documentation.  lin shao chuan makes no
 * representations about the suitability of this software for any
 * purpose.  It is provided "as is" without express or implied warranty.
 * see the GNU General Public License  for more detail.
 */
#ifndef __XDB_H__
#define __XDB_H__


#include "mymempool.h"


struct __xdb_t_;
typedef struct __xdb_t_ * HXDB;

struct __xdb_result_t_;
typedef struct __xdb_result_t_ * HXDBRESULT;


typedef enum __E_XDB_TYPE
{
	E_XDB_BYTE1,
	E_XDB_BYTE2,
	E_XDB_BYTE4,
	E_XDB_TEXT,
	E_XDB_BLOB,
}E_XDB_TYPE;

typedef struct __xdb_field_info_t_
{
	E_XDB_TYPE type;
	const char * field_name;
}xdb_field_info;

typedef struct __xdb_record_t_
{
	const char * field_name;
	union _r
	{
		unsigned char byte1;
		unsigned short byte2;
		unsigned int byte2;

		char * text;
		
		struct _blob
		{
			void * buf;
			unsigned int buf_sz;
		}blob;
	}r;
}xdb_record;

typedef enum __E_XDB_KEY_TYPE
{
	E_DEL_EXACTLY,
	E_DEL_GREATER,
	E_DEL_LESS,
}E_XDB_KEY_TYPE;

typedef struct __xdb_key_info_t_
{
	E_XDB_KEY_TYPE type;
	xdb_record value;
}xdb_key_info;


/**
 * @brief 打开数据库文件
 * @param file_name:数据库文件名
 * @param max_cache_pages:数据库页缓存个数
 */
extern HXDB xdb_open(HMYMEMPOOL hm, const char * file_name, const unsigned int max_cache_pages);

/**
 * @brief 关闭数据库
 */
extern int xdb_close(HXDB hdb);

/**
 * @brief 创建表相
 */
extern int xdb_create_table(HXDB hdb, const char * tlb_name, xdb_field_info * fld_info, unsigned int fld_info_count);

/**
 * @brief 删除表
 */
extern int xdb_drop_table(HXDB hdb, const char * tlb_name);

/**
 * @brief 添加记录
 */
extern int xdb_insert(HXDB hdb, const char * tlb_name, xdb_record * r, unsigned int r_count);

/**
 * @brief 删除记录
 */
extern int xdb_del(HXDB hdb, xdb_key_info * key, unsigned int key_count);

/**
 * @brief 更新记录
 */
extern int xdb_update(HXDB hdb, xdb_key_info * key, unsigned int key_count);

/**
 * @brief 查询记录,返回结果集
 */
extern int xdb_query(HXDB hdb, xdb_key_info * key, unsigned int key_count, HXDBRESULT * result);


#endif