42 lines
1.8 KiB
Go
42 lines
1.8 KiB
Go
package game
|
|
|
|
import "github.com/kercylan98/minotaur/utils/generic"
|
|
|
|
// RankingList 排行榜
|
|
type RankingList[CompetitorID comparable, Score generic.Ordered] interface {
|
|
// Competitor 声明排行榜竞争者
|
|
// - 如果竞争者存在的情况下，会更新已有成绩，否则新增竞争者
|
|
Competitor(competitorId CompetitorID, score Score)
|
|
// RemoveCompetitor 删除特定竞争者
|
|
RemoveCompetitor(competitorId CompetitorID)
|
|
// Size 获取竞争者数量
|
|
Size() int
|
|
// GetRank 获取竞争者排名
|
|
// - 排名从 0 开始
|
|
GetRank(competitorId CompetitorID) (int, error)
|
|
// GetCompetitor 获取特定排名的竞争者
|
|
GetCompetitor(rank int) (CompetitorID, error)
|
|
// GetCompetitorWithRange 获取第start名到第end名竞争者
|
|
GetCompetitorWithRange(start, end int) ([]CompetitorID, error)
|
|
// GetScore 获取竞争者成绩
|
|
GetScore(competitorId CompetitorID) (Score, error)
|
|
// GetAllCompetitor 获取所有竞争者ID
|
|
// - 结果为名次有序的
|
|
GetAllCompetitor() []CompetitorID
|
|
// Clear 清空排行榜
|
|
Clear()
|
|
|
|
// RegRankChangeEvent 排名改变时将立即执行注册的事件处理函数
|
|
// - 排名为-1时表示未上榜
|
|
RegRankChangeEvent(handle RankChangeEventHandle[CompetitorID, Score])
|
|
OnRankChangeEvent(competitorId CompetitorID, oldRank, newRank int, oldScore, newScore Score)
|
|
// RegRankClearBeforeEvent 在排行榜被清空前执行被注册的事件处理函数
|
|
RegRankClearBeforeEvent(handle RankClearBeforeEventHandle[CompetitorID, Score])
|
|
OnRankClearBeforeEvent()
|
|
}
|
|
|
|
type (
|
|
RankChangeEventHandle[CompetitorID comparable, Score generic.Ordered] func(rankingList RankingList[CompetitorID, Score], competitorId CompetitorID, oldRank, newRank int, oldScore, newScore Score)
|
|
RankClearBeforeEventHandle[CompetitorID comparable, Score generic.Ordered] func(rankingList RankingList[CompetitorID, Score])
|
|
)
|