quad

package
v0.6.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 20, 2016 License: Apache-2.0 Imports: 9 Imported by: 0

Documentation

Overview

Package quad defines quad and triple handling.

Index

Constants

View Source 
const HashSize = sha1.Size

HashSize is a size of the slice, returned by HashOf.

Variables

View Source 
var (
	ErrInvalid    = errors.New("invalid N-Quad")
	ErrIncomplete = errors.New("incomplete N-Quad")
)
View Source 
var Directions = []Direction{Subject, Predicate, Object, Label}

Functions

func HashOf 

func HashOf(v Value) []byte

HashOf calculates a hash of value v.

func HashTo 

func HashTo(v Value, p []byte)

HashTo calculates a hash of value v, storing it in a slice p.

func NativeOf 

func NativeOf(v Value) interface{}

NativeOf safely call v.Native, returning nil in case of nil Value.

func RegisterStringConversion 

func RegisterStringConversion(dataType IRI, fnc StringConversion)

RegisterStringConversion will register an automatic conversion of TypedString values with provided type to a native equivalent such as Int, Time, etc.

If fnc is nil, automatic conversion from selected type will be removed.

func StringOf 

func StringOf(v Value) string

StringOf safely call v.String, returning empty string in case of nil Value.

Types

type BNode 

type BNode string

BNode is an RDF Blank Node (ex: _:name).

func (BNode) Native 

func (s BNode) Native() interface{}

func (BNode) String 

func (s BNode) String() string

type Bool 

type Bool bool

Bool is a native wrapper for bool type.

It uses NQuad notation similar to TypedString.

func (Bool) Native 

func (s Bool) Native() interface{}

func (Bool) String 

func (s Bool) String() string

type ByQuadString 

type ByQuadString []Quad

func (ByQuadString) Len 

func (o ByQuadString) Len() int

func (ByQuadString) Less 

func (o ByQuadString) Less(i, j int) bool

func (ByQuadString) Swap 

func (o ByQuadString) Swap(i, j int)

type ByValueString 

type ByValueString []Value

func (ByValueString) Len 

func (o ByValueString) Len() int

func (ByValueString) Less 

func (o ByValueString) Less(i, j int) bool

func (ByValueString) Swap 

func (o ByValueString) Swap(i, j int)

type Direction 

type Direction byte

Direction specifies an edge's type. 

const (
	Any Direction = iota
	Subject
	Predicate
	Object
	Label
)

List of the valid directions of a quad.

func (Direction) Prefix 

func (d Direction) Prefix() byte

func (Direction) String 

func (d Direction) String() string

type Equaler 

type Equaler interface {
	Equal(v Value) bool
}

Equaler interface is implemented by values, that needs a special equality check.

type Float 

type Float float64

Float is a native wrapper for float64 type.

It uses NQuad notation similar to TypedString.

func (Float) Native 

func (s Float) Native() interface{}

func (Float) String 

func (s Float) String() string

type IRI 

type IRI string

IRI is an RDF Internationalized Resource Identifier (ex: <name>).

func (IRI) Native 

func (s IRI) Native() interface{}

func (IRI) String 

func (s IRI) String() string

type Int 

type Int int64

Int is a native wrapper for int64 type.

It uses NQuad notation similar to TypedString.

func (Int) Native 

func (s Int) Native() interface{}

func (Int) String 

func (s Int) String() string

type LangString 

type LangString struct {
	Value String
	Lang  string
}

LangString is an RDF string with language (ex: "name"@lang).

func (LangString) Native 

func (s LangString) Native() interface{}

func (LangString) String 

func (s LangString) String() string

type Quad 

type Quad struct {
	Subject   Value `json:"subject"`
	Predicate Value `json:"predicate"`
	Object    Value `json:"object"`
	Label     Value `json:"label,omitempty"`
}

Our quad struct, used throughout.

func Make 

func Make(subject, predicate, object, label interface{}) (q Quad)

Make creates a quad with provided values.

func MakeRaw 

func MakeRaw(subject, predicate, object, label string) (q Quad)

MakeRaw creates a quad with provided raw values (nquads-escaped).

func (Quad) Get 

func (q Quad) Get(d Direction) Value

Per-field accessor for quads.

func (Quad) GetString 

func (q Quad) GetString(d Direction) string

Per-field accessor for quads that returns strings instead of values.

func (Quad) IsValid 

func (q Quad) IsValid() bool

func (Quad) MarshalJSON 

func (q Quad) MarshalJSON() ([]byte, error)

func (Quad) NQuad 

func (q Quad) NQuad() string

Prints a quad in N-Quad format.

func (Quad) String 

func (q Quad) String() string

Pretty-prints a quad.

func (*Quad) UnmarshalJSON 

func (q *Quad) UnmarshalJSON(data []byte) error

type Raw 

type Raw string

Raw is a Turtle/NQuads-encoded value.

func (Raw) Native 

func (s Raw) Native() interface{}

func (Raw) String 

func (s Raw) String() string

type String 

type String string

String is an RDF string value (ex: "name").

func (String) Native 

func (s String) Native() interface{}

func (String) String 

func (s String) String() string

type StringConversion 

type StringConversion func(string) (Value, error)

StringConversion is a function to convert string values with a specific IRI type to their native equivalents.

type Time 

type Time time.Time

Time is a native wrapper for time.Time type.

It uses NQuad notation similar to TypedString.

func (Time) Equal 

func (s Time) Equal(v Value) bool

func (Time) Native 

func (s Time) Native() interface{}

func (Time) String 

func (s Time) String() string

type TypedString 

type TypedString struct {
	Value String
	Type  IRI
}

TypedString is an RDF value with type (ex: "name"^^<type>).

func (TypedString) Native 

func (s TypedString) Native() interface{}

func (TypedString) ParseValue 

func (s TypedString) ParseValue() (Value, error)

ParseValue will try to parse underlying string value using registered functions.

It will return unchanged value if suitable function is not available.

Error will be returned if the type was recognizes, but parsing failed.

func (TypedString) String 

func (s TypedString) String() string

type Unmarshaler 

type Unmarshaler interface {
	Unmarshal() (Quad, error)
}

type Value 

type Value interface {
	String() string
	// Native converts Value to a closest native Go type.
	//
	// If type has no analogs in Go, Native return an object itself.
	Native() interface{}
}

Value is a type used by all quad directions.

func AsValue 

func AsValue(v interface{}) (out Value, ok bool)

AsValue converts native type into closest Value representation. It returns false if type was not recognized.

func StringToValue 

func StringToValue(v string) Value

StringToValue is a function to convert strings to typed quad values.

Warning: should not be used directly - will be deprecated.

Source Files

View all Source files

Directories

Path Synopsis
Package cquads implements parsing N-Quads like line-based syntax for RDF datasets.
 Package cquads implements parsing N-Quads like line-based syntax for RDF datasets.
Package nquads implements parsing the RDF 1.1 N-Quads line-based syntax for RDF datasets.
 Package nquads implements parsing the RDF 1.1 N-Quads line-based syntax for RDF datasets.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.