File: README.md

package info (click to toggle)
golang-github-rogpeppe-fastuuid 0.0~git20150106.0.6724a57-2
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 60 kB
  • ctags: 9
  • sloc: makefile: 2
file content (50 lines) | stat: -rw-r--r-- 1,289 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
# fastuuid
--
    import "github.com/rogpeppe/fastuuid"

Package fastuuid provides fast UUID generation of 192 bit universally unique
identifiers. It does not provide formatting or parsing of the identifiers (it is
assumed that a simple hexadecimal or base64 representation is sufficient, for
which adequate functionality exists elsewhere).

Note that the generated UUIDs are not unguessable - each UUID generated from a
Generator is adjacent to the previously generated UUID.

It ignores RFC 4122.

## Usage

#### type Generator

```go
type Generator struct {
}
```

Generator represents a UUID generator that generates UUIDs in sequence from a
random starting point.

#### func  MustNewGenerator

```go
func MustNewGenerator() *Generator
```
MustNewGenerator is like NewGenerator but panics on failure.

#### func  NewGenerator

```go
func NewGenerator() (*Generator, error)
```
NewGenerator returns a new Generator. It can fail if the crypto/rand read fails.

#### func (*Generator) Next

```go
func (g *Generator) Next() [24]byte
```
Next returns the next UUID from the generator. Only the first 8 bytes can differ
from the previous UUID, so taking a slice of the first 16 bytes is sufficient to
provide a somewhat less secure 128 bit UUID.

It is OK to call this method concurrently.