Пакет uuid
Обзор
Пакет uuid предоставляет средства для создания UUID и работы с ними.
Подробности см. в RFC 9562.
Случайные компоненты новых UUID генерируются с помощью криптографически стойкого генератора случайных чисел.
UUID можно создавать с помощью различных алгоритмов. Функция New возвращает новый UUID, созданный с помощью алгоритма, подходящего для большинства задач.
Указатель
Файлы пакета
uuid.go
тип UUID 1.27
UUID — это универсальный уникальный идентификатор, определённый в RFC 9562.
UUID можно сравнивать, например, с помощью оператора ==.
type UUID [16]byte
функция Max 1.27
func Max() UUID
Max возвращает максимальный UUID ffffffff-ffff-ffff-ffff-ffffffffffff.
Максимальный UUID определён в разделе 5.10 RFC 9562.
функция MustParse 1.27
func MustParse(s string) UUID
MustParse возвращает UUID, представленный строкой s.
Функция вызывает панику, если s не является допустимым строковым представлением UUID, определённым функцией Parse.
функция New 1.27
func New() UUID
New возвращает новый UUID.
Программам, которым не нужен конкретный алгоритм генерации UUID, следует использовать New. В настоящее время New эквивалентна NewV4.
функция NewV4 1.27
func NewV4() UUID
NewV4 возвращает новый UUID версии 4.
UUID версии 4 содержат 122 бита случайных данных.
функция NewV7 1.27
func NewV7() UUID
NewV7 возвращает новый UUID версии 7.
UUID версии 7 содержат метку времени в 48 наиболее значащих битах и не менее 62 бит случайных данных.
NewV7 всегда возвращает UUID, отсортированные по возрастанию, за исключением случаев, когда системные часы переводятся назад.
функция Nil 1.27
func Nil() UUID
Nil возвращает нулевой UUID 00000000-0000-0000-0000-000000000000.
Нулевой UUID определён в разделе 5.9 RFC 9562. Обратите внимание, что это не то же самое, что значение nil в Go.
функция Parse 1.27
func Parse(s string) (UUID, error)
Parse возвращает UUID, представленный строкой s.
Функция принимает строки в следующих форматах:
f81d4fae-7dec-11d0-a765-00a0c91e6bf6
{f81d4fae-7dec-11d0-a765-00a0c91e6bf6}
urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6
f81d4fae7dec11d0a76500a0c91e6bf6
Буквы в шестнадцатеричных цифрах могут быть в любом регистре.
функция (UUID) AppendText 1.27
func (u UUID) AppendText(b []byte) ([]byte, error)
AppendText реализует интерфейс encoding.TextAppender. Формат кодирования совпадает с форматом, возвращаемым методом UUID.String
функция (UUID) Compare 1.27
func (u UUID) Compare(v UUID) int
Compare сравнивает UUID u с v. Если u меньше v, функция возвращает -1. Если u больше v, она возвращает +1. Если они равны, она возвращает 0.
При сортировке Compare использует порядок байтов от старшего к младшему, определённый в разделе 6.11 RFC 9562.
функция (UUID) MarshalText 1.27
func (u UUID) MarshalText() ([]byte, error)
MarshalText реализует интерфейс encoding.TextMarshaler. Формат кодирования совпадает с форматом, возвращаемым методом UUID.String
функция (UUID) String 1.27
func (u UUID) String() string
String возвращает строковое представление u.
Используется представление с шестнадцатеричными цифрами в нижнем регистре и дефисами, определённое в RFC 9562.
функция (*UUID) UnmarshalText 1.27
func (u *UUID) UnmarshalText(b []byte) error
UnmarshalText реализует интерфейс encoding.TextUnmarshaler. UUID должен быть представлен в формате, принимаемом функцией Parse.
© Google, Inc.
Licensed under the Creative Commons Attribution License 3.0.
http://golang.org/pkg/uuid/
