array

type Base interface {
	IsNull(i int) bool
	IsValid(i int) bool
	Len() int
	NullN() int
	Slice(start, stop int) Base
}

type BaseBuilder interface {
	// Len returns the currently allocated length for the array builder.
	Len() int

	// Cap returns the current capacity of the underlying array.
	Cap() int

	// Reserve ensures there is enough space for appending n elements by checking
	// the capacity and calling resize if necessary.
	Reserve(n int)

	// AppendNull will append a null value to the array.
	AppendNull()

	// BuildArray will construct the array.
	BuildArray() Base
}

type Boolean interface {
	Base
	Value(i int) bool
	BooleanSlice(start, stop int) Boolean
}

type BooleanBuilder interface {
	BaseBuilder
	Append(v bool)
	AppendValues(v []bool, valid ...[]bool)

	// BuildBooleanArray will construct the array.
	BuildBooleanArray() Boolean
}

type Float interface {
	Base
	Value(i int) float64
	FloatSlice(start, stop int) Float

	// Float64Values will return the underlying slice for the Float array. It is the size
	// of the array and null values will be present, but the data at null indexes will be invalid.
	Float64Values() []float64
}

type FloatBuilder interface {
	BaseBuilder
	Append(v float64)
	AppendValues(v []float64, valid ...[]bool)

	// BuildFloatArray will construct the array.
	BuildFloatArray() Float
}

type Int interface {
	Base
	Value(i int) int64
	IntSlice(start, stop int) Int

	// Int64Values will return the underlying slice for the Int array. It is the size
	// of the array and null values will be present, but the data at null indexes will be invalid.
	Int64Values() []int64
}

type IntBuilder interface {
	BaseBuilder
	Append(v int64)
	AppendValues(v []int64, valid ...[]bool)

	// BuildIntArray will construct the array.
	BuildIntArray() Int
}

type String interface {
	Base
	Value(i int) string
	StringSlice(start, stop int) String
}

type StringBuilder interface {
	BaseBuilder
	Append(v string)
	AppendValues(v []string, valid ...[]bool)

	// BuildStringArray will construct the array.
	BuildStringArray() String
}

type Time interface {
	Base
	Value(i int) values.Time
	TimeSlice(start, stop int) Time

	// TimeValues will return the underlying slice for the Time array. It is the size
	// of the array and null values will be present, but the data at null indexes will be invalid.
	TimeValues() []values.Time
}

type TimeBuilder interface {
	BaseBuilder
	Append(v values.Time)
	AppendValues(v []values.Time, valid ...[]bool)

	// BuildTimeArray will construct the array.
	BuildTimeArray() Time
}

type UInt interface {
	Base
	Value(i int) uint64
	UIntSlice(start, stop int) UInt

	// Uint64Values will return the underlying slice for the UInt array. It is the size
	// of the array and null values will be present, but the data at null indexes will be invalid.
	Uint64Values() []uint64
}

type UIntBuilder interface {
	BaseBuilder
	Append(v uint64)
	AppendValues(v []uint64, valid ...[]bool)

	// BuildUIntArray will construct the array.
	BuildUIntArray() UInt
}