set

type BinaryInterceptor = Interceptor[[]byte]

type BinaryRangeFunc = RangeFunc[[]byte]

type BinarySet = Set[[]byte]

type BinaryStore = Store[[]byte]

type Interceptor[T any] struct {
	// contains filtered or unexported fields
}

type RangeFunc[T any] func(ctx context.Context, v T) (ok bool, err error)

type Set[T any] interface {
	// Name returns the name of the set.
	Name() string

	// Has returns true if v is a member of the set.
	Has(ctx context.Context, v T) (bool, error)

	// Add ensures v is a member of the set.
	Add(ctx context.Context, v T) error

	// TryAdd ensures v is a member of the set. It returns true if v was added,
	// or false if it was already a member.
	//
	// Add() may be more performant when knowledge of v's prior membership is
	// not required.
	TryAdd(ctx context.Context, v T) (bool, error)

	// Remove ensures v is not a member of the set.
	Remove(ctx context.Context, v T) error

	// TryRemove ensures v is not a member of the set. It returns true if v was
	// removed, or false if it was not a member.
	//
	// Remove() may be more performant when knowledge of v's prior membership is
	// not required.
	TryRemove(ctx context.Context, v T) (bool, error)

	// Range invokes fn for each member of the set in an undefined order.
	Range(ctx context.Context, fn RangeFunc[T]) error

	// Close closes the set.
	Close() error
}

type Store[T any] interface {
	// Open returns the set with the given name.
	Open(ctx context.Context, name string) (Set[T], error)
}