Версия:

Модуль uuid

Модуль uuid

Overview

UUID – это Универсальный уникальный идентификатор (Universally unique identifier). Если значение должно быть уникальным в пределах отдельного компьютера или одной базы данных, лучше использовать простой счетчик вместо UUID, поскольку получение UUID затратно по времени (требуется syscall). Что же касается кластеров компьютеров или широко распространенных приложений, лучше использовать UUID.

Index

Ниже приведен перечень всех функций и элементов модуля uuid.

Name Use
uuid.nil Объект nil
uuid()
uuid.bin()
uuid.str()
Получение UUID
uuid.fromstr()
uuid.frombin()
uuid_object:bin()
uuid_object:str()
Получение конвертированного UUID
uuid_object:isnil() Проверка, состоит ли UUID из одних нулей
uuid.nil

Объект nil

uuid.__call()
Return:UUID
Rtype:cdata.
uuid.bin()
Return:UUID
Rtype:16-байтная строка
uuid.str()
Return:UUID
Rtype:36-байтная двоичная строка
uuid.fromstr(uuid_str)
Параметры:
  • uuid_str – UUID в 36-байтной шестнадцатеричной строке
Return:

конвертированный UUID

Rtype:

cdata.

uuid.frombin(uuid_bin)
Параметры:
  • uuid_str – UUID в 16-байтной двоичной строке
Return:

конвертированный UUID

Rtype:

cdata.

object uuid_object
uuid_object:bin([byte-order])

byte-order может быть одним из следующих флагов:

  • „l“ - порядок от младшего к старшему,
  • „b“ - порядок от старшего к младшему,
  • „h“ - порядок зависит от хоста (по умолчанию),
  • „n“ - порядок зависит от сети
Параметры:
  • byte-order (string) – один из 'l', 'b', 'h' или 'n'.
Return:

UUID, сконвертированный из введенного значения формата cdata.

Rtype:

16-байтная двоичная строка

uuid_object:str()
Return:UUID, сконвертированный из введенного значения формата cdata.
Rtype:36-байтная шестнадцатеричная строка
uuid_object:isnil()

Значение UUID из одних нулей может быть выражено как uuid.NULL или uuid.fromstr('00000000-0000-0000-0000-000000000000'). Сравнение со значением из одних нулей также может быть выражено как uuid_with_type_cdata == uuid.NULL.

Return:true (правда), если значение состоит из одних нулей, в противном случае false (ложь).
Rtype:bool

Example

tarantool> uuid = require('uuid')
---
...
tarantool> uuid(), uuid.bin(), uuid.str()
---
- 16ffedc8-cbae-4f93-a05e-349f3ab70baa
- !!binary FvG+Vy1MfUC6kIyeM81DYw==
- 67c999d2-5dce-4e58-be16-ac1bcb93160f
...
tarantool> uu = uuid()
---
...
tarantool> #uu:bin(), #uu:str(), type(uu), uu:isnil()
---
- 16
- 36
- cdata
- false
...