combination

Documentation

Index

• type Combination
  • func NewCombination[T Item](options ...Option[T]) *Combination[T]
  • func (slf *Combination[T]) AddMatcher(name string, matcher *Matcher[T]) *Combination[T]
  • func (slf *Combination[T]) Best(items []T) (name string, result []T)
  • func (slf *Combination[T]) Combinations(items []T) (result [][]T)
  • func (slf *Combination[T]) CombinationsToName(items []T) (result map[string][][]T)
  • func (slf *Combination[T]) NewMatcher(name string, options ...MatcherOption[T]) *Combination[T]
  • func (slf *Combination[T]) RemoveMatcher(name string) *Combination[T]
  • func (slf *Combination[T]) Worst(items []T) (name string, result []T)
• type Item
• type Matcher
  • func NewMatcher[T Item](options ...MatcherOption[T]) *Matcher[T]
  • func (slf *Matcher[T]) AddFilter(filter func(items []T) [][]T)
  • func (slf *Matcher[T]) Best(items []T) []T
  • func (slf *Matcher[T]) Combinations(items []T) [][]T
  • func (slf *Matcher[T]) Worst(items []T) []T
• type MatcherOption
  • func WithMatcherContinuity[T Item, Index generic.Number](getIndex func(item T) Index) MatcherOption[T]
  • func WithMatcherEvaluation[T Item](evaluate func(items []T) float64) MatcherOption[T]
  • func WithMatcherIntervalLength[T Item](min, max int) MatcherOption[T]
  • func WithMatcherLeastLength[T Item](length int) MatcherOption[T]
  • func WithMatcherLength[T Item](length int) MatcherOption[T]
  • func WithMatcherMostLength[T Item](length int) MatcherOption[T]
  • func WithMatcherNCarryIndependentM[T Item, E generic.Ordered](n, m int, getType func(item T) E) MatcherOption[T]
  • func WithMatcherNCarryM[T Item, E generic.Ordered](n, m int, getType func(item T) E) MatcherOption[T]
  • func WithMatcherSame[T Item, E generic.Ordered](count int, getType func(item T) E) MatcherOption[T]
• type Option
  • func WithEvaluation[T Item](evaluate func(items []T) float64) Option[T]

Types

type Combination

type Combination[T Item] struct {
	// contains filtered or unexported fields
}

Combination 用于从多个匹配器内提取组合的数据结构

func NewCombination

func NewCombination[T Item](options ...Option[T]) *Combination[T]

NewCombination 创建一个新的组合器

func (*Combination[T]) AddMatcher

func (slf *Combination[T]) AddMatcher(name string, matcher *Matcher[T]) *Combination[T]

AddMatcher 添加一个匹配器

func (*Combination[T]) Best

func (slf *Combination[T]) Best(items []T) (name string, result []T)

Best 从一组数据中提取符合匹配器规则的最佳组合

func (*Combination[T]) Combinations

func (slf *Combination[T]) Combinations(items []T) (result [][]T)

Combinations 从一组数据中提取所有符合匹配器规则的组合

func (*Combination[T]) CombinationsToName

func (slf *Combination[T]) CombinationsToName(items []T) (result map[string][][]T)

CombinationsToName 从一组数据中提取所有符合匹配器规则的组合，并返回匹配器名称

func (*Combination[T]) NewMatcher

func (slf *Combination[T]) NewMatcher(name string, options ...MatcherOption[T]) *Combination[T]

NewMatcher 添加一个新的匹配器

func (*Combination[T]) RemoveMatcher

func (slf *Combination[T]) RemoveMatcher(name string) *Combination[T]

RemoveMatcher 移除一个匹配器

func (*Combination[T]) Worst

func (slf *Combination[T]) Worst(items []T) (name string, result []T)

Worst 从一组数据中提取符合匹配器规则的最差组合

type Item

type Item interface {
}

type Matcher

type Matcher[T Item] struct {
	// contains filtered or unexported fields
}

Matcher 用于从一组数据内提取组合的数据结构

func NewMatcher

func NewMatcher[T Item](options ...MatcherOption[T]) *Matcher[T]

NewMatcher 创建一个新的匹配器

func (*Matcher[T]) AddFilter

func (slf *Matcher[T]) AddFilter(filter func(items []T) [][]T)

AddFilter 添加一个筛选器

• 筛选器用于对组合进行筛选，返回一个二维数组，每个数组内的元素都是一个组合

func (*Matcher[T]) Best

func (slf *Matcher[T]) Best(items []T) []T

Best 从一组数据中提取符筛选器规则的最佳组合

func (*Matcher[T]) Combinations

func (slf *Matcher[T]) Combinations(items []T) [][]T

Combinations 从一组数据中提取所有符合筛选器规则的组合

func (*Matcher[T]) Worst

func (slf *Matcher[T]) Worst(items []T) []T

Worst 从一组数据中提取符筛选器规则的最差组合

type MatcherOption

type MatcherOption[T Item] func(matcher *Matcher[T])

MatcherOption 匹配器选项

func WithMatcherContinuity

func WithMatcherContinuity[T Item, Index generic.Number](getIndex func(item T) Index) MatcherOption[T]

WithMatcherContinuity 通过匹配连续的组合创建匹配器

• index: 用于获取组合中元素的索引值，用于判断是否连续

func WithMatcherEvaluation

func WithMatcherEvaluation[T Item](evaluate func(items []T) float64) MatcherOption[T]

WithMatcherEvaluation 设置匹配器评估函数

• 用于对组合进行评估，返回一个分值的评价函数
• 通过该选项将覆盖匹配器的默认(WithEvaluation)评估函数

func WithMatcherIntervalLength

func WithMatcherIntervalLength[T Item](min, max int) MatcherOption[T]

WithMatcherIntervalLength 通过匹配长度区间的组合创建匹配器

• min: 组合的最小长度，表示需要匹配的组合最小数量
• max: 组合的最大长度，表示需要匹配的组合最大数量

func WithMatcherLeastLength

func WithMatcherLeastLength[T Item](length int) MatcherOption[T]

WithMatcherLeastLength 通过匹配最小长度的组合创建匹配器

• length: 组合的长度，表示需要匹配的组合最小数量

func WithMatcherLength

func WithMatcherLength[T Item](length int) MatcherOption[T]

WithMatcherLength 通过匹配长度的组合创建匹配器

• length: 组合的长度，表示需要匹配的组合数量

func WithMatcherMostLength

func WithMatcherMostLength[T Item](length int) MatcherOption[T]

WithMatcherMostLength 通过匹配最大长度的组合创建匹配器

• length: 组合的长度，表示需要匹配的组合最大数量

func WithMatcherNCarryIndependentM

func WithMatcherNCarryIndependentM[T Item, E generic.Ordered](n, m int, getType func(item T) E) MatcherOption[T]

WithMatcherNCarryIndependentM 通过匹配 N 携带独立 M 的组合创建匹配器

• n: 组合中元素的数量，表示需要匹配的组合数量，n 的类型需要全部相同
• m: 组合中元素的数量，表示需要匹配的组合数量，m 的类型无需全部相同
• getType: 用于获取组合中元素的类型，用于判断是否相同

func WithMatcherNCarryM

func WithMatcherNCarryM[T Item, E generic.Ordered](n, m int, getType func(item T) E) MatcherOption[T]

WithMatcherNCarryM 通过匹配 N 携带 M 的组合创建匹配器

• n: 组合中元素的数量，表示需要匹配的组合数量，n 的类型需要全部相同
• m: 组合中元素的数量，表示需要匹配的组合数量，m 的类型需要全部相同
• getType: 用于获取组合中元素的类型，用于判断是否相同

func WithMatcherSame

func WithMatcherSame[T Item, E generic.Ordered](count int, getType func(item T) E) MatcherOption[T]

WithMatcherSame 通过匹配相同的组合创建匹配器

• count: 组合中相同元素的数量，当 count <= 0 时，表示相同元素的数量不限
• getType: 用于获取组合中元素的类型，用于判断是否相同

type Option

type Option[T Item] func(*Combination[T])

Option 组合器选项

func WithEvaluation

func WithEvaluation[T Item](evaluate func(items []T) float64) Option[T]

WithEvaluation 设置组合评估函数

• 用于对组合进行评估，返回一个分值的评价函数
• 通过该选项将设置所有匹配器的默认评估函数为该函数
• 通过匹配器选项 WithMatcherEvaluation 可以覆盖该默认评估函数
• 默认的评估函数将返回一个随机数