uniqueid

Documentation

Overview

Package uniqueid defines functions that are likely to generate globally unique identifiers. We want to be able to generate many Ids quickly, so we make a time/space tradeoff. We reuse the same random data many times with a counter appended. Note: these Ids are NOT useful as a security mechanism as they will be predictable.

Index

• func Valid(id Id) bool
• type Id
  • func FromHexString(s string) (Id, error)
  • func Random() (Id, error)
  • func (id Id) String() string
  • func (x Id) VDLIsZero() bool
  • func (x *Id) VDLRead(dec vdl.Decoder) error
  • func (Id) VDLReflect(struct{ ... })
  • func (x Id) VDLWrite(enc vdl.Encoder) error
• type RandomGenerator
  • func (g *RandomGenerator) NewID() (Id, error)

Functions

func Valid

func Valid(id Id) bool

Valid returns true if the given Id is valid.

Types

type Id

type Id [16]byte

An Id is a likely globally unique identifier.

func FromHexString

func FromHexString(s string) (Id, error)

func Random

func Random() (Id, error)

Random produces a new probably unique identifier using the RandomGenerator.

func (Id) String

func (id Id) String() string

func (Id) VDLIsZero

func (x Id) VDLIsZero() bool

func (*Id) VDLRead

func (x *Id) VDLRead(dec vdl.Decoder) error

func (Id) VDLReflect

func (Id) VDLReflect(struct {
	Name string `vdl:"v.io/v23/uniqueid.Id"`
})

func (Id) VDLWrite

func (x Id) VDLWrite(enc vdl.Encoder) error

type RandomGenerator

type RandomGenerator struct {
	// contains filtered or unexported fields
}

A RandomGenerator can generate random Ids. The zero value of RandomGenerator is ready to use.

func (*RandomGenerator) NewID

func (g *RandomGenerator) NewID() (Id, error)

NewId produces a new probably unique identifier.