/**
 *
 * @file MyfunctionDef.h 各種回調函數的原型聲明
 *
 * @author lin shao chuan (email:lsccsl@tom.com, msn:lsccsl@163.net)
 *
 */
#ifndef __MYFUNCTIONDEF_H__
#define __MYFUNCTIONDEF_H__


#include <stdlib.h>


/**
 * @brief
 *  > 0  表示 key1 大于 key2
 *  == 0 表示 key1 等于 key2
 *  < 0  表示 key1 小于 key2
 *
 * @param context:用戶自定義的上下文數據
 */
typedef int (*ALG_COMPARE)(const void * data1, const void * data2, const void * context);

/**
 *
 * 描述如何將src里的數據拷貝給dst
 *
 * @param context:用戶自定義的上下文數據
 *
 */
typedef int (*ALG_COPY)(void * dst,
						const void * src, const size_t size_copy,
						const void * context);

/**
 *
 * 描述如何將src起始的一段數據拷貝給dst起始的一段空間
 *
 * @param context:用戶自定義的上下文數據
 *
 */
typedef int (*ALG_MOVE)(void * dst, 
						const void * src, const size_t size_move,
						const void * context);

/**
 *
 * 描述如何將data1與data2的數據互相
 *
 * @param context:用戶自定義的上下文數據
 *
 */
typedef int (*ALG_SWAP)(void * data1,
						void * data2, const size_t data_size,
						const void * context);


#endif