immutablevector

package

v0.9.0 Latest Latest Go to latest Published: Oct 30, 2026 License: Apache-2.0 Imports: 3 Imported by: 0

Details

Package immutablevector owns compact immutable slices behind authenticated roots.

This section is empty.

This section is empty.

This section is empty.

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

Authority authenticates roots created for one owner.

func NewAuthority[T any]() *Authority[T]

NewAuthority creates an isolated root authority.

func (a *Authority[T]) Own(values []T) (Root[T], error)

Own clones values and returns their authenticated immutable root.

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

Root is a copyable authenticated immutable vector.

func (r Root[T]) At(authority *Authority[T], index int) (T, error)

At returns one value without exposing the backing slice.

func (r Root[T]) Len(authority *Authority[T]) (int, error)

Len returns the immutable vector length.

func (r Root[T]) Range(authority *Authority[T], visit func(T) bool) error

Range visits values in order until visit returns false.

func (r Root[T]) SameRoot(authority *Authority[T], other Root[T]) (bool, error)

SameRoot compares exact authenticated storage identity in O(1).

func (r Root[T]) ValidateOwnership(authority *Authority[T]) error

ValidateOwnership verifies a root in O(1).

func (r Root[T]) Values(authority *Authority[T]) ([]T, error)

Values returns a detached copy of every value.