iter

Documentation

Index

• func AllMatch[T any](predicate func(T) bool, it Iterator[T]) bool
• func AnyMatch[T any](predicate func(T) bool, it Iterator[T]) bool
• func At[T any](index int, it Iterator[T]) (T, bool)
• func Average[T constraints.Integer | constraints.Float](it Iterator[T]) float64
• func Collect[T any, S any, R any](collector Collector[S, T, R], it Iterator[T]) R
• func CollectToMap[K comparable, V any](it Iterator[types.Pair[K, V]]) map[K]V
• func Contains[T comparable](target T, it Iterator[T]) bool
• func Count[T any](it Iterator[T]) int
• func First[T any](it Iterator[T]) (T, bool)
• func Fold[T any, R any](initial R, operation func(R, T) R, it Iterator[T]) R
• func ForEach[T any](action func(T), it Iterator[T])
• func IsEmpty[T any](it Iterator[T]) bool
• func IsNotEmpty[T any](it Iterator[T]) bool
• func Last[T any](it Iterator[T]) (T, bool)
• func Max[T constraints.Ordered](it Iterator[T]) (T, bool)
• func MaxBy[T any](greater func(T, T) bool, it Iterator[T]) (T, bool)
• func Min[T constraints.Ordered](it Iterator[T]) (T, bool)
• func MinBy[T any](less func(T, T) bool, it Iterator[T]) (T, bool)
• func NoneMatch[T any](predicate func(T) bool, it Iterator[T]) bool
• func Product[T constraints.Integer | constraints.Float](it Iterator[T]) T
• func Reduce[T any](operation func(T, T) T, it Iterator[T]) (T, bool)
• func Sum[T constraints.Integer | constraints.Float](it Iterator[T]) T
• func Unzip[A any, B any](it Iterator[types.Pair[A, B]]) ([]A, []B)
• type BiFunction
• type BinaryOperator
• type Collector
• type Comparator
• type Consumer
• type Function
• type Iterable
• type Iterator
  • func Concat[T any](left Iterator[T], right Iterator[T]) Iterator[T]
  • func Enumerate[T any](it Iterator[T]) Iterator[*types.Pair[int, T]]
  • func Filter[T any](predicate func(T) bool, it Iterator[T]) Iterator[T]
  • func Flatten[T Iterable[U], U any](it Iterator[T]) Iterator[U]
  • func Limit[T any](count int, it Iterator[T]) Iterator[T]
  • func Map[T any, R any](transform func(T) R, it Iterator[T]) Iterator[R]
  • func RangeOf[T constraints.Integer](begin, end, step T) Iterator[T]
  • func Skip[T any](count int, it Iterator[T]) Iterator[T]
  • func Step[T any](count int, it Iterator[T]) Iterator[T]
  • func StringOf(input string) Iterator[rune]
  • func Zip[T any, U any](left Iterator[T], right Iterator[U]) Iterator[*types.Pair[T, U]]
• type Predicate
• type Range
  • func (a *Range[T]) Get() (T, T)
  • func (a *Range[T]) Has(index T) bool
  • func (a *Range[T]) Iterator() Iterator[T]
• type Slice
  • func ToSlice[T any](it Iterator[T]) Slice[T]
  • func (a Slice[T]) Count() int
  • func (a Slice[T]) Iterator() Iterator[T]
• type Stream
• type String
  • func (a String) Count() int
  • func (a String) Iterator() Iterator[rune]
• type Supplier
• type UnaryOperator

Functions

func AllMatch

func AllMatch[T any](predicate func(T) bool, it Iterator[T]) bool

Returns true if all elements in the iterator match the condition.

func AnyMatch

func AnyMatch[T any](predicate func(T) bool, it Iterator[T]) bool

Returns true if any elements in the iterator match the condition.

func At

func At[T any](index int, it Iterator[T]) (T, bool)

Return the element at index.

func Average

func Average[T constraints.Integer | constraints.Float](it Iterator[T]) float64

Returns the average of all the elements in the iterator.

func Collect

func Collect[T any, S any, R any](collector Collector[S, T, R], it Iterator[T]) R

Collecting via Collector.

func CollectToMap

func CollectToMap[K comparable, V any](it Iterator[types.Pair[K, V]]) map[K]V

Collect to built-in map.

func Contains

func Contains[T comparable](target T, it Iterator[T]) bool

Returns true if the target is included in the iterator.

func Count

func Count[T any](it Iterator[T]) int

Return the total number of iterators.

func First

func First[T any](it Iterator[T]) (T, bool)

Return the first element.

func Fold

func Fold[T any, R any](initial R, operation func(R, T) R, it Iterator[T]) R

Return the value of the final composite, operates on the iterator from back to front.

func ForEach

func ForEach[T any](action func(T), it Iterator[T])

The action is executed for each element of the iterator, and the argument to the action is the element.

func IsEmpty

func IsEmpty[T any](it Iterator[T]) bool

Ruturns true if the count of Iterator is 0.

func IsNotEmpty

func IsNotEmpty[T any](it Iterator[T]) bool

Ruturns true if the count of Iterator is 0.

func Last

func Last[T any](it Iterator[T]) (T, bool)

Return the last element.

func Max

func Max[T constraints.Ordered](it Iterator[T]) (T, bool)

Return the maximum value of all elements of the iterator.

func MaxBy

func MaxBy[T any](greater func(T, T) bool, it Iterator[T]) (T, bool)

Return the maximum value of all elements of the iterator.

func Min

func Min[T constraints.Ordered](it Iterator[T]) (T, bool)

Return the minimum value of all elements of the iterator.

func MinBy

func MinBy[T any](less func(T, T) bool, it Iterator[T]) (T, bool)

Return the minimum value of all elements of the iterator.

func NoneMatch

func NoneMatch[T any](predicate func(T) bool, it Iterator[T]) bool

Returns true if none elements in the iterator match the condition.

func Product

func Product[T constraints.Integer | constraints.Float](it Iterator[T]) T

Returns the product of all the elements in the iterator.

func Reduce

func Reduce[T any](operation func(T, T) T, it Iterator[T]) (T, bool)

Return the value of the final composite, operates on the iterator from front to back.

func Sum

func Sum[T constraints.Integer | constraints.Float](it Iterator[T]) T

Returns the sum of all the elements in the iterator.

func Unzip

func Unzip[A any, B any](it Iterator[types.Pair[A, B]]) ([]A, []B)

Splitting an iterator whose elements are pair into two lists.

Types

type BiFunction

type BiFunction[T, R, U any] func(T, R) U

BiFunction 将两个类型转为第三个类型

type BinaryOperator

type BinaryOperator[T any] func(T, T) T

BinaryOperator 输入两个相同类型的参数，对其做二元运算，返回相同类型的结果

type Collector

type Collector[S any, T any, R any] interface {
	Builder() S
	Append(builder S, element T)
	Finish(builder S) R
}

type Comparator

type Comparator[T any] func(T, T) int

Comparator 比较两个元素. 第一个元素大于第二个元素时，返回正数; 第一个元素小于第二个元素时，返回负数; 否则返回 0.

type Consumer

type Consumer[T any] func(T)

Consumer 消费一个元素

type Function

type Function[T, R any] func(T) R

Function 将一个类型转为另一个类型

type Iterable

type Iterable[T any] interface {
	Iter() Iterator[T]
}

type Iterator

type Iterator[T any] interface {
	Next() (v T, ok bool)
}

func Concat

func Concat[T any](left Iterator[T], right Iterator[T]) Iterator[T]

By connecting two iterators in series, the new iterator will iterate over the first iterator before continuing with the second iterator.

func Enumerate

func Enumerate[T any](it Iterator[T]) Iterator[*types.Pair[int, T]]

Add subscripts to the incoming iterators.

func Filter

func Filter[T any](predicate func(T) bool, it Iterator[T]) Iterator[T]

Use predicate to filter an iterator to another iterator。

func Flatten

func Flatten[T Iterable[U], U any](it Iterator[T]) Iterator[U]

Converting a nested iterator to a flat iterator.

func Limit

func Limit[T any](count int, it Iterator[T]) Iterator[T]

Convert an iterator to another iterator that limits the maximum number of iterations.

func Map

func Map[T any, R any](transform func(T) R, it Iterator[T]) Iterator[R]

Use transform to map an iterator to another iterator.

func RangeOf

func RangeOf[T constraints.Integer](begin, end, step T) Iterator[T]

Range returns an Iterator over a range of integers.

func Skip

func Skip[T any](count int, it Iterator[T]) Iterator[T]

Converts an iterator to another iterator that skips a specified number of times.

func Step

func Step[T any](count int, it Iterator[T]) Iterator[T]

Converts an iterator to another iterator that skips a specified number of times each time.

func StringOf

func StringOf(input string) Iterator[rune]

String returns an Iterator yielding runes from the supplied string.

func Zip

func Zip[T any, U any](left Iterator[T], right Iterator[U]) Iterator[*types.Pair[T, U]]

Compress two iterators into one iterator. The length is the length of the shortest iterator.

type Predicate

type Predicate[T any] func(T) bool

Predicate 断言是否满足指定条件

type Range

type Range[T constraints.Integer] struct {
	Begin T
	End   T
}

func (*Range[T]) Get

func (a *Range[T]) Get() (T, T)

func (*Range[T]) Has

func (a *Range[T]) Has(index T) bool

func (*Range[T]) Iterator

func (a *Range[T]) Iterator() Iterator[T]

type Slice

type Slice[T any] []T

func ToSlice

func ToSlice[T any](it Iterator[T]) Slice[T]

Converts a Iterator to a Slice.

func (Slice[T]) Count

func (a Slice[T]) Count() int

func (Slice[T]) Iterator

func (a Slice[T]) Iterator() Iterator[T]

type Stream

type Stream[T any] interface {
	Filter(Predicate[T]) Stream[T]
	Map(Function[T, T]) Stream[T]               //同类型转换,没啥意义
	FlatMap(Function[T, Iterator[T]]) Stream[T] //同Map
	Peek(Consumer[T]) Stream[T]
	Fold(initVal T, acc BinaryOperator[T])
	Zip(Iterator[T], Iterator[T]) Stream[T]

	Distinct(Function[T, int]) Stream[T]
	Sorted(Comparator[T]) Stream[T]
	Limit(int64) Stream[T]
	Skip(int64) Stream[T]

	ForEach(Consumer[T])
	Collect() []T
	All(Predicate[T]) bool
	None(Predicate[T]) bool
	Any(Predicate[T]) bool
	Reduce(acc BinaryOperator[T]) (T, bool)
	ReduceFrom(initVal T, acc BinaryOperator[T]) T
	First() (T, bool)
	Count() int64
}

type String

type String string

func (String) Count

func (a String) Count() int

func (String) Iterator

func (a String) Iterator() Iterator[rune]

type Supplier

type Supplier[T any] func() T

Supplier 产生一个元素

type UnaryOperator

type UnaryOperator[T any] func(T) T

UnaryOperator 对输入进行一元运算返回相同类型的结果