refs

type BatchNamer ¶

type BatchNamer interface {
	ValuesOf(ctx context.Context, vals []Ref) ([]quad.Value, error)
	RefsOf(ctx context.Context, nodes []quad.Value) ([]Ref, error)
}

type Namer ¶

type Namer interface {
	// Given a node ID, return the opaque token used by the QuadStore
	// to represent that id. Returns nil, nil on not found.
	ValueOf(context.Context, quad.Value) (Ref, error)
	// Given an opaque token, return the node that it represents.
	// Returns nil, nil on not found.
	NameOf(context.Context, Ref) (quad.Value, error)
}

type PreFetchedValue ¶

type PreFetchedValue interface {
	Ref
	NameOf() quad.Value
}

PreFetchedValue is an optional interface for graph.Ref to indicate that quadstore has already loaded a value into memory.

func PreFetched(v quad.Value) PreFetchedValue

type QuadHash ¶

type QuadHash struct {
	Subject   ValueHash
	Predicate ValueHash
	Object    ValueHash
	Label     ValueHash
}

func (q QuadHash) Dirs() [4]ValueHash

func (q QuadHash) Get(d quad.Direction) ValueHash

func (q QuadHash) Key() any

func (q *QuadHash) Set(d quad.Direction, h ValueHash)

type Ref ¶

type Ref interface {
	// Key returns a dynamic type that is comparable according to the Go language specification.
	// The returned value must be unique for each receiver value.
	Key() any
}

Ref defines an opaque "quad store reference" type. However the backend wishes to implement it, a Ref is merely a token to a quad or a node that the backing store itself understands, and the base iterators pass around.

For example, in a very traditional, graphd-style graph, these are int64s (guids of the primitives). In a very direct sort of graph, these could be pointers to structs, or merely quads, or whatever works best for the backing store.

These must be comparable, or return a comparable version on Key.

func RefsOf(ctx context.Context, qs Namer, nodes []quad.Value) ([]Ref, error)

type Size ¶

type Size struct {
	Value int64
	Exact bool
}

Size of a graph (either in nodes or quads).

type ValueHash ¶

type ValueHash [quad.HashSize]byte

ValueHash is a hash of a single value.

func HashOf(s quad.Value) (out ValueHash)

func (h ValueHash) Key() any

func (h ValueHash) String() string

func (h ValueHash) Valid() bool