slices

Documentation

Index

• func Filter[S ~[]E, E any](s *S, predicate Predicate[E]) uint
• func Reject[S ~[]E, E any](s *S, predicate Predicate[E]) uint
• func RejectNils[S ~[]*E, E any](s *S) uint
• func RejectZero[S ~[]E, E comparable](s *S) uint
• type Builder
  • func (b *Builder[E]) Append(elem E) error
  • func (b Builder[E]) Build() []E
  • func (b *Builder[E]) Reset() error
• type Predicate

Functions

func Filter

func Filter[S ~[]E, E any](s *S, predicate Predicate[E]) uint

Filter filters a slice of E's according to a predicate.

Parameters:

• s: The slice of E's to filter.
• predicate: The predicate to use for filtering.

Returns:

• uint: The number of elements filtered-out.

Panics:

• common.ErrBadParam: If the predicate is nil.

func Reject

func Reject[S ~[]E, E any](s *S, predicate Predicate[E]) uint

Reject rejects a slice of E's according to a predicate.

Parameters:

• s: The slice of E's to reject.
• predicate: The predicate to use for rejecting.

Returns:

• uint: The number of elements rejected.

Panics:

• common.ErrBadParam: If the predicate is nil.

func RejectNils

func RejectNils[S ~[]*E, E any](s *S) uint

RejectNils rejects in-place all nil elements from a slice of E's and returns the number of elements rejected.

Parameters:

• s: The slice of E's to filter.

Returns:

• uint: The number of elements rejected.

func RejectZero

func RejectZero[S ~[]E, E comparable](s *S) uint

RejectZero rejects in-place all zero-valued elements from a slice of E's and returns the number of elements rejected.

Parameters:

• s: The slice of E's to filter.

Returns:

• uint: The number of elements rejected.

Types

type Builder

type Builder[E any] struct {
	// contains filtered or unexported fields
}

Builder is a builder for slices. It is only efficent for making many slices one after the other.

An empty builder can be created with the `var b Builder[T]` syntax or with the `new(Builder[T])` constructor.

func (*Builder[E]) Append

func (b *Builder[E]) Append(elem E) error

Append appends an element to the slice being built.

Parameters:

• elem: The element to append.

Returns:

• error: An error if the element could not be appended.

Errors:

• common.ErrNilReceiver: If the receiver is nil.

func (Builder[E]) Build

func (b Builder[E]) Build() []E

Build builds the slice being built.

Returns:

• []E: The slice being built.

func (*Builder[E]) Reset

func (b *Builder[E]) Reset() error

Reset resets the builder to its initial state, freeing up any allocated memory so that it can be reused to build another slice. This is more efficient than creating a new builder if you need to build many slices in a row.

Returns:

• error: An error if the builder is nil.

Errors:

• errors.ErrNilReceiver: If the receiver is nil.

type Predicate

type Predicate[E any] func(e E) bool

Predicate is a function that returns true if the element is valid.

Parameters:

• e: The element to check.

Returns:

• bool: True if the element is valid, false otherwise.