dispatch/vendor/github.com/kjk/betterguid/doc.go

23 lines
913 B
Go
Raw Normal View History

2017-04-20 03:32:22 +00:00
/*
Package betterguid generates 20-character guid (globally unique id) strings
with good properties:
They're 20 character strings, safe for inclusion in urls (don't require escaping)
They're based on timestamp so that they sort **after** any existing ids
They contain 72-bits of random data after the timestamp so that IDs won't collide with other clients' IDs
They sort **lexicographically** (so the timestamp is converted to characters that will sort properly)
They're monotonically increasing. Even if you generate more than one in the same timestamp, thelatter ones will sort after the former ones. We do this by using the previous random bits but "incrementing" them by 1 (only in the case of a timestamp collision).
Read https://www.firebase.com/blog/2015-02-11-firebase-unique-identifiers.html
for more info.
Based on https://gist.github.com/mikelehen/3596a30bd69384624c11
*/
package betterguid