id

Documentation

Overview

Package id provides types and functions for generation of identifiers.

Index

• Constants
• type ID
  • func Hash(f func(w io.Writer) error) (ID, error)
  • func OfBytes(data ...[]byte) ID
  • func OfString(strings ...string) ID
  • func Parse(s string) (ID, error)
  • func Unique() ID
  • func (id ID) Format(f fmt.State, c rune)
  • func (id ID) IsValid() bool
  • func (i ID) MarshalJSON() ([]byte, error)
  • func (id *ID) Parse(s string) error
  • func (id ID) String() string
  • func (i *ID) UnmarshalJSON(data []byte) error

Constants

const Size = 20

Size is the size of an ID.

Types

type ID

type ID [Size]byte

ID is a codeable unique identifier.

func Hash

func Hash(f func(w io.Writer) error) (ID, error)

Hash creates a new ID by calling f and hashing all data written to w.

func OfBytes

func OfBytes(data ...[]byte) ID

OfBytes calculates the ID for the supplied data using the Hash function.

func OfString

func OfString(strings ...string) ID

OfString calculates the ID for the supplied strings using the Hash function.

func Parse

func Parse(s string) (ID, error)

Parse parses lowercase string s as a 20 byte hex-encoded ID.

func Unique

func Unique() ID

Unique returns a unique identifier by hashing the current time and machine hostname.

func (ID) Format

func (id ID) Format(f fmt.State, c rune)

func (ID) IsValid

func (id ID) IsValid() bool

IsValid returns true if the id is not the default value.

func (ID) MarshalJSON

func (i ID) MarshalJSON() ([]byte, error)

MarshalJSON encodes the ID as a JSON string.

func (*ID) Parse

func (id *ID) Parse(s string) error

Parse parses lowercase string s as a 20 byte hex-encoded ID, or copies s to the ID if it is 20 bytes long.

func (ID) String

func (id ID) String() string

func (*ID) UnmarshalJSON

func (i *ID) UnmarshalJSON(data []byte) error

UnmarshalJSON decodes a JSON string as an ID.