forked from mirror/go.uuid
67 lines
1.2 KiB
Go
67 lines
1.2 KiB
Go
package uuid
|
|
|
|
import (
|
|
"crypto/rand"
|
|
"fmt"
|
|
)
|
|
|
|
// UUID layout variants.
|
|
const (
|
|
VariantNCS = iota
|
|
VariantRFC4122
|
|
VariantMicrosoft
|
|
VariantFuture
|
|
)
|
|
|
|
// UUID representation compliant with specification
|
|
// described in RFC 4122.
|
|
type UUID [16]byte
|
|
|
|
// Returns algorithm version used to generate UUID
|
|
// RFC 4122 describes version 1, 3, 4 and 5.
|
|
func (u *UUID) Version() uint {
|
|
return uint(u[6] >> 4)
|
|
}
|
|
|
|
// Returns UUID layout variant.
|
|
func (u *UUID) Variant() uint {
|
|
switch {
|
|
case (u[8] & 0x80) == 0x00:
|
|
return VariantNCS
|
|
case (u[8]&0xc0)|0x80 == 0x80:
|
|
return VariantRFC4122
|
|
case (u[8]&0xe0)|0xc0 == 0xc0:
|
|
return VariantMicrosoft
|
|
}
|
|
return VariantFuture
|
|
}
|
|
|
|
// Returns canonical string representation of UUID:
|
|
// xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
|
|
func (u *UUID) String() string {
|
|
return fmt.Sprintf("%x-%x-%x-%x-%x",
|
|
u[:4], u[4:6], u[6:8], u[8:10], u[10:])
|
|
}
|
|
|
|
// Set version bits.
|
|
func (u *UUID) setVersion(v byte) {
|
|
u[6] = (u[6] & 0x0f) | (v << 4)
|
|
}
|
|
|
|
// Set variant bits as described in RFC 4122.
|
|
func (u *UUID) setVariant() {
|
|
u[8] = (u[8] & 0xbf) | 0x80
|
|
}
|
|
|
|
// Returns random UUID.
|
|
func NewV4() (u *UUID, err error) {
|
|
u = new(UUID)
|
|
_, err = rand.Read(u[:])
|
|
if err != nil {
|
|
return
|
|
}
|
|
u.setVersion(4)
|
|
u.setVariant()
|
|
return
|
|
}
|