273 lines
6.6 KiB
C++
273 lines
6.6 KiB
C++
/*
|
||
创建排行榜的相关接口
|
||
*/
|
||
|
||
|
||
//tolua_begin
|
||
namespace Ranking
|
||
{
|
||
|
||
/*
|
||
* Comments:增加引用值
|
||
* Param void * pRank:
|
||
* @Return void:
|
||
*/
|
||
void addRef(void* pRank);
|
||
|
||
/*
|
||
* Comments:减少引用值
|
||
* Param void * pRank:
|
||
* @Return void:
|
||
*/
|
||
void release(void* pRank);
|
||
|
||
/*
|
||
* Comments:获取引用值
|
||
* Param void * pRank:
|
||
* @Return int:
|
||
*/
|
||
int getRef(void* pRank);
|
||
|
||
/*
|
||
* Comments:获取排行榜的指针
|
||
*/
|
||
void* getRanking(int rankId);
|
||
|
||
/*
|
||
* Comments:增加一个排行榜
|
||
* Param char * sName:排行榜的名称
|
||
* Param int nMax:发给客户端最多的行数
|
||
* Param boDisplay:是否在客户端显示，默认是0，不显示，1显示
|
||
* @Return void*:添加成功会返回排行榜的指针，返回NULL
|
||
*/
|
||
void* add(int rankId,char* sName,int nMax,int boDisplay=0, int nBroadCount = 0);
|
||
|
||
/*
|
||
* Comments:排行榜从文件中读入数据
|
||
* Param CRanking * pRank:排行榜的指针
|
||
* Param char * sFile:指定的文件，文件保存在当前目录的 ph/XXX,传入XXX就行
|
||
* @Return bool:如果文件存在并读取成功返回true
|
||
*/
|
||
bool load(void* pRank,char* sFile);
|
||
|
||
/*
|
||
* Comments:排行榜保存数据到文件
|
||
* Param void * pRank:
|
||
* Param char * sFile:文件名，不需要包含路径
|
||
* Param forceSave: 强制保存
|
||
* @Return bool:是否保存成功
|
||
*/
|
||
bool save(void* pRank,char* sFile, bool bForceSave = false);
|
||
|
||
/*
|
||
* Comments:增加一列
|
||
* Param CRanking * pRank:
|
||
* Param char * sTitle:列的标题名称
|
||
* Param int nIndex:-1表示在最后增加，否则在指定的列前增加
|
||
* Param bool bUnique:true表示唯一，不能插入相同列名的列
|
||
* @Return void:
|
||
*/
|
||
void addColumn(void* pRank,char* sTitle, int nIndex = -1, bool bUnique = false);
|
||
|
||
/*
|
||
* Comments: 设置列的标题
|
||
* Param void * pRank: 排行榜的指针
|
||
* Param char * sTitle: 列的标题名称
|
||
* Param int nIndex: 列的索引 由0开始
|
||
* @Return void:
|
||
*/
|
||
void setColumnTitle(void* pRank, char* sTitle, int nIndex);
|
||
|
||
/*
|
||
* Comments:增加一个排行榜项
|
||
* Param void * pRank:排行榜的指针
|
||
* Param int nId:id值
|
||
* Param int nPoint:初始的分值
|
||
* Param bool bRankFlag:true 表示需要检测排序
|
||
* @Return void*:成功返回排行榜项，否则返回NULL,如果已经存在对应的id，会加入失败
|
||
*/
|
||
void* addItem(void* pRank, unsigned int nId, int nPoint, bool bRankFlag = true);
|
||
|
||
/*
|
||
* Comments:获取某个id在排行榜中的位置，第一位是0，不在这个返回-1
|
||
* Param int nId:
|
||
* @Return int:
|
||
*/
|
||
int getItemIndexFromId(void* pRank,unsigned int nId);
|
||
|
||
/*
|
||
* Comments:根据id获取排行榜项的指针
|
||
* Param void * pRank:
|
||
* Param int nId:
|
||
* @Return void*:不存在返回NULL
|
||
*/
|
||
void* getItemPtrFromId(void* pRank,unsigned int nId);
|
||
|
||
/*
|
||
* Comments:更新排行榜项的分值
|
||
* Param void * pRank:
|
||
* Param int nId:id
|
||
* Param int nPoint:增加分值
|
||
* @Return void*:成功会返回对应的排行榜项，失败（不存在）返回NULL
|
||
*/
|
||
void* updateItem( void* pRank,unsigned int nId,int nPoint );
|
||
|
||
/*
|
||
* Comments:设置排行榜项的分值
|
||
* Param void * pRank:
|
||
* Param int nId:id
|
||
* Param int nPoint:分值
|
||
* @Return void*:成功会返回对应的排行榜项，失败（不存在）返回NULL
|
||
*/
|
||
void* setItem( void* pRank,unsigned int nId,int nPoint );
|
||
|
||
/*
|
||
* Comments:设置某列是否显示在客户端
|
||
* Param void * pRank:排行榜指针
|
||
* Param int nIndex:列索引，第一列是0
|
||
* Param int boDisplay:是否显示，1显示，0不显示，注意：默认是显示的
|
||
* @Return void:
|
||
*/
|
||
void setColumnDisplay( void* pRank, int nIndex ,int boDisplay);
|
||
|
||
/*
|
||
* Comments:设置排行榜项的列的显示内容
|
||
* Param void * pRankItem:排行榜项的指针
|
||
* Param int nIndex:第几列,从0开始数
|
||
* Param char * sData:字符串内容
|
||
* @Return void:
|
||
*/
|
||
void setSub(void* pRankItem,int nIndex, char* sData);
|
||
|
||
/*
|
||
* Comments:删除指定的排版榜
|
||
*/
|
||
void removeRanking(int rankId);
|
||
|
||
/*
|
||
* Comments:获取本排行榜名单的数量
|
||
* Param void * pRank:
|
||
* @Return int:
|
||
*/
|
||
int getRankItemCount(void* pRank);
|
||
|
||
/*
|
||
* Comments:获取本排行榜名单的数量
|
||
* Param void * pRank:
|
||
* @Return int:
|
||
*/
|
||
int getRankItemCountByLimit(void* pRank, int nLimit);
|
||
|
||
/*
|
||
* Comments:获取玩家的分数
|
||
* Param void * pRankItem:
|
||
* @Return int:
|
||
*/
|
||
int getPoint(void* pRankItem);
|
||
|
||
/*
|
||
* Comments:获取排行榜项的id
|
||
* Param void * pRankItem:
|
||
* @Return int:
|
||
*/
|
||
unsigned int getId(void* pRankItem);
|
||
|
||
/*
|
||
* Comments:获取名次
|
||
* Param void * pRankItem:
|
||
* @Return int:第一名是0
|
||
*/
|
||
int getIndexFromPtr(void* pRankItem);
|
||
|
||
/*
|
||
* Comments:获取某列的字符串数据
|
||
* Param void * pRankItem:排行榜项的指针
|
||
* Param int nIndex:列索引
|
||
* @Return char*:
|
||
*/
|
||
const char* getSub(void* pRankItem,int nIndex);
|
||
|
||
|
||
/*
|
||
* Comments:清除排行榜所有的名单数据
|
||
* Param void * pRank:排行榜的指针
|
||
* @Return void:
|
||
*/
|
||
void clearRanking(void* pRank);
|
||
|
||
/*
|
||
* Comments:获取排行榜某个位置的排行榜项
|
||
* Param void * pRank:
|
||
* Param int nIndex:名词，0表示第一名
|
||
* @Return void*:
|
||
*/
|
||
void* getItemFromIndex(void* pRank,int nIndex);
|
||
|
||
/*
|
||
* Comments:设置排行榜的显示在客户端的名称
|
||
* Param void * pRank:排行榜的指针
|
||
* Param const char * sName:名称
|
||
* @Return void:
|
||
*/
|
||
void setDisplayName(void* pRank, const char* sName);
|
||
|
||
/*
|
||
* Comments:设置id的显示标题
|
||
* Param void * pRank:
|
||
* Param const char * sName:
|
||
* @Return void:
|
||
*/
|
||
void setIdTitle(void* pRank,const char* sName);
|
||
|
||
/*
|
||
* Comments:设置分值的显示标题
|
||
* Param void * pRank:
|
||
* Param const char * sName:
|
||
* @Return void:
|
||
*/
|
||
void setPointTitle(void* pRank, const char* sName);
|
||
|
||
/*
|
||
* Comments:删除id
|
||
* Param void * pRank:
|
||
* Param int id:
|
||
* @Return void:
|
||
*/
|
||
void removeId(void* pRank, unsigned int id);
|
||
|
||
/*
|
||
* Comments:更新跨服排行榜
|
||
*/
|
||
void UpdateCsRank(int rankId);
|
||
|
||
///*
|
||
//* Comments:查找是否参与第几次报名
|
||
//* Param void * pRank:
|
||
//* Param int nId:角色id
|
||
//* Param int nType:报名的类型,type按数字顺序0、1、2、3 类推
|
||
//* @Return bool:
|
||
//*/
|
||
//bool queryIdType( void* pRank, int nId, int nType);
|
||
|
||
///*
|
||
//* Comments:增加一个报名
|
||
//* Param void * pRank:
|
||
//* Param int nId:角色id
|
||
//* Param int nType:报名类型
|
||
//* @Return void:
|
||
//*/
|
||
//void addIdType( void* pRank, int nId, int nType );
|
||
|
||
//设置属性排行榜配置数据 nRankPropIndex:属性配置表对应的配置索引 从0开始 ,nRankPropMax:最大配置排名
|
||
void setRankPropConfig(void* pRank, int nRankPropIndex);
|
||
|
||
/// 获取排行榜列数
|
||
/// @param pRank 排行榜指针
|
||
int GetRankColumnCount(void* pRank);
|
||
|
||
void forceSave(void* pRank,char* sFile);
|
||
bool CheckActorIdInRank(void* pRank,unsigned int id);
|
||
};
|
||
|
||
//tolua_end
|