initial commits

master
Charles Iliya Krempeaux 2021-11-07 21:11:26 -08:00
parent 9fd2afadb7
commit 24c5dcecb1
1 changed files with 8 additions and 8 deletions

View File

@ -1,22 +1,22 @@
# go-iid # go-xim
Package **iid** provides quazi monotonicallyincreasing uniqueidentifiers. Package **xim** provides quazi monotonicallyincreasing uniqueidentifiers.
The serialized form of the **IID** is safe to use as a _file_ or _directory_ name. The serialized form of the **IID** is safe to use as a _file_ or _directory_ name.
## Documention ## Documention
Online documentation, which includes examples, can be found at: http://godoc.org/github.com/reiver/go-iid Online documentation, which includes examples, can be found at: http://godoc.org/github.com/reiver/go-xim
[![GoDoc](https://godoc.org/github.com/reiver/go-iid?status.svg)](https://godoc.org/github.com/reiver/go-iid) [![GoDoc](https://godoc.org/github.com/reiver/go-xim?status.svg)](https://godoc.org/github.com/reiver/go-xim)
## Example ## Example
Here is an example of using `package iid`: Here is an example of using `package xim`:
```go ```go
var id iid.IID = iid.Generate() var id xim.IID = xim.Generate()
``` ```
## Representation ## Representation
@ -30,9 +30,9 @@ Internally, the IID is compactly stored in an `uint64`. The anatomy of this is a
always zero (1-bit) chaos (20-bits) always zero (1-bit) chaos (20-bits)
``` ```
The `iid.IID.UnixTime()` method will give you that 39-bit _unix timestamp_. The `xim.IID.UnixTime()` method will give you that 39-bit _unix timestamp_.
And the `iid.IID.Chaos()` method will give you that 24-bit _chaos_. And the `xim.IID.Chaos()` method will give you that 24-bit _chaos_.
(The _chaos_ is just a randomness that helps make these IIDs unique, when multiple IIDs are being produced simultaneously.) (The _chaos_ is just a randomness that helps make these IIDs unique, when multiple IIDs are being produced simultaneously.)