testing_project/Documentation: reference/reference_lua/box_index/examples — Russian @ Weblate: function example() local a, b, c, table_of_selected_tuples, d local replaced

Translation

English

function example()
local a, b, c, table_of_selected_tuples, d
local replaced_tuple, time_field
local formatted_time_field
local fiber = require('fiber')
table_of_selected_tuples = box.space.tester:select{1000}
if table_of_selected_tuples ~= nil then
if table_of_selected_tuples[1] ~= nil then
if #table_of_selected_tuples[1] == 3 then
box.error({code=1, reason='This tuple already has 3 fields'})
end
end
end
replaced_tuple = box.space.tester:replace
{1000, require('uuid').str(), tostring(fiber.time())}
time_field = tonumber(replaced_tuple[3])
formatted_time_field = os.date("%Y-%m-%d %H:%M:%S", time_field)
c = time_field % 1
d = string.sub(c, 3, 6)
formatted_time_field = formatted_time_field .. '.' .. d
return formatted_time_field
end

Russian

Needs editing

Skip

	English	Russian	Actions
	Examples for `box.index`	Примеры для `box.index`
	Example showing use of the box functions	Пример использования функций box
	This example will work with the sandbox configuration described in the preface. That is, there is a space named tester with a numeric primary key. The example function will:	Данный пример сработает на конфигурации из песочницы, описанной в предисловии, то есть создан спейс под названием tester с первичным числовым ключом. Функция в примере выполнит следующие действия:
	select a tuple whose key value is 1000;	выбрать кортеж, значение ключа в котором равно 1000;
	raise an error if the tuple already exists and already has 3 fields;	выдать сообщение об ошибке, если такой кортеж уже существует и содержит 3 поля;
	Insert or replace the tuple with:	вставить или заменить кортеж следующими данными:
	field[1] = 1000	поле [1] = 1000
	field[2] = a uuid	поле [2] = UUID
	field[3] = number of seconds since 1970-01-01;	поле [3] = количество секунд с 01.01.1970;
	Get field[3] from what was replaced;	получить поле [3] из того, что заменили;
	Format the value from field[3] as yyyy-mm-dd hh:mm:ss.ffff;	преобразовать значение из поля [3] в формат yyyy-mm-dd hh:mm:ss.ffff (год-месяц-день час:минута:секунда.десятитысячные доли секунды);
	Return the formatted value.	вернуть преобразованное значение.
	The function uses Tarantool box functions :ref:`box.space...select <box_space-select>`, :ref:`box.space...replace <box_space-replace>`, :ref:`fiber.time <fiber-time>`, :ref:`uuid.str <uuid-str>`. The function uses Lua functions `os.date() <http://www.lua.org/pil/22.1.html>`_ and `string.sub() <http://www.lua.org/pil/20.html>`_.
	function example() local a, b, c, table_of_selected_tuples, d local replaced_tuple, time_field local formatted_time_field local fiber = require('fiber') table_of_selected_tuples = box.space.tester:select{1000} if table_of_selected_tuples ~= nil then if table_of_selected_tuples[1] ~= nil then if #table_of_selected_tuples[1] == 3 then box.error({code=1, reason='This tuple already has 3 fields'}) end end end replaced_tuple = box.space.tester:replace {1000, require('uuid').str(), tostring(fiber.time())} time_field = tonumber(replaced_tuple[3]) formatted_time_field = os.date("%Y-%m-%d %H:%M:%S", time_field) c = time_field % 1 d = string.sub(c, 3, 6) formatted_time_field = formatted_time_field .. '.' .. d return formatted_time_field end	function example() local a, b, c, table_of_selected_tuples, d local replaced_tuple, time_field local formatted_time_field local fiber = require('fiber') table_of_selected_tuples = box.space.tester:select{1000} if table_of_selected_tuples ~= nil then if table_of_selected_tuples[1] ~= nil then if #table_of_selected_tuples[1] == 3 then box.error({code=1, reason='This tuple already has 3 fields'}) end end end replaced_tuple = box.space.tester:replace {1000, require('uuid').str(), tostring(fiber.time())} time_field = tonumber(replaced_tuple[3]) formatted_time_field = os.date("%Y-%m-%d %H:%M:%S", time_field) c = time_field % 1 d = string.sub(c, 3, 6) formatted_time_field = formatted_time_field .. '.' .. d return formatted_time_field end
	... And here is what happens when one invokes the function:	... А вот что происходит, когда вызывается функция:
	tarantool> box.space.tester:delete(1000) --- - [1000, '264ee2da03634f24972be76c43808254', '1391037015.6809'] ... tarantool> example(1000) --- - 2014-01-29 16:11:51.1582 ... tarantool> example(1000) --- - error: 'This tuple already has 3 fields' ...	tarantool> box.space.tester:delete(1000) --- - [1000, '264ee2da03634f24972be76c43808254', '1391037015.6809'] ... tarantool> example(1000) --- - 2014-01-29 16:11:51.1582 ... tarantool> example(1000) --- - error: 'This tuple already has 3 fields' ...
	Example showing a user-defined iterator	Пример с заданным пользователем итератором
	Here is an example that shows how to build one's own iterator. The ``paged_iter`` function is an "iterator function", which will only be understood by programmers who have read the Lua manual section `Iterators and Closures <https://www.lua.org/pil/7.1.html>`_. It does paginated retrievals, that is, it returns 10 tuples at a time from a table named "t", whose primary key was defined with ``create_index('primary',{parts={1,'string'}})``.	Здесь приведен пример того, как создать свой собственный итератор. Функция ``paged_iter`` представляет собой "функцию с итератором", что поймут только разработчики, которые ознакомились с разделом руководства по Lua `Итераторы и замыкания <https://www.lua.org/pil/7.1.html>`_. Она делает постраничную выборку, то есть возвращает 10 кортежей одновременно из таблицы под названием "t", первичный ключ которой определен с помощью ``create_index('primary',{parts={1,'string'}})``.
	function paged_iter(search_key, tuples_per_page) local iterator_string = "GE" return function () local page = box.space.t.index[0]:select(search_key, {iterator = iterator_string, limit=tuples_per_page}) if #page == 0 then return nil end search_key = page[#page][1] iterator_string = "GT" return page end end	function paged_iter(search_key, tuples_per_page) local iterator_string = "GE" return function () local page = box.space.t.index[0]:select(search_key, {iterator = iterator_string, limit=tuples_per_page}) if #page == 0 then return nil end search_key = page[#page][1] iterator_string = "GT" return page end end
	Programmers who use ``paged_iter`` do not need to know why it works, they only need to know that, if they call it within a loop, they will get 10 tuples at a time until there are no more tuples.	Разработчикам, использующим ``paged_iter``, необязательно знать, почему она работает, следует лишь понимать, что вызвав функцию в цикле, можно получать 10 кортежей за раз до тех пор, пока кортежи не кончатся.
	In this example the tuples are merely printed, a page at a time. But it should be simple to change the functionality, for example by yielding after each retrieval, or by breaking when the tuples fail to match some additional criteria.	В данном примере кортежи лишь выводятся по странице за раз. Но легко изменить функцию, например, путем передачи управления после каждой выборки или с помощью прерывания, если кортежи не будут соответствовать дополнительным критериям.
	for page in paged_iter("X", 10) do print("New Page. Number Of Tuples = " .. #page) for i = 1, #page, 1 do print(page[i]) end end	for page in paged_iter("X", 10) do print("New Page. Number Of Tuples = " .. #page) for i = 1, #page, 1 do print(page[i]) end end
	Example showing submodule `box.index` with index type = RTREE for spatial searches	Пример использования `box.index` с индексом типа RTREE для поиска в пространственных данных
	This submodule may be used for spatial searches if the index type is RTREE. There are operations for searching rectangles (geometric objects with 4 corners and 4 sides) and boxes (geometric objects with more than 4 corners and more than 4 sides, sometimes called hyperrectangles). This manual uses the term rectangle-or-box for the whole class of objects that includes both rectangles and boxes. Only rectangles will be illustrated.	Этот вложенный модуль может использоваться для поиска в пространственных данных, если тип индекса -- RTREE. Существуют операции для поиска прямоугольников (геометрические фигуры с 4 углами и 4 сторонами) и параллелепипедов (геометрические фигуры с количеством углов более 4 и количеством сторон более 4, которые иногда называются гиперпрямоугольниками). В данном руководстве используется термин прямоугольник-или-параллелепипед для всего класса объектов, который включает в себя прямоугольники и параллелепипеды. Примерами иллюстрируются только прямоугольники.
	Rectangles are described according to their X-axis (horizontal axis) and Y-axis (vertical axis) coordinates in a grid of arbitrary size. Here is a picture of four rectangles on a grid with 11 horizontal points and 11 vertical points:	Прямоугольники описаны в соответствии с координатами по оси X (горизонтальной оси) и оси Y (вертикальной оси) на сетке произвольного размера. Ниже представлен рисунок четырех прямоугольников на сетке с 11 горизонтальными точками и 11 вертикальными точками:
	X AXIS 1 2 3 4 5 6 7 8 9 10 11 1 2 #-------+ <-Rectangle#1 Y AXIS 3 \| \| 4 +-------# 5 #-----------------------+ <-Rectangle#2 6 \| \| 7 \| #---+ \| <-Rectangle#3 8 \| \| \| \| 9 \| +---# \| 10 +-----------------------# 11 # <-Rectangle#4	X AXIS 1 2 3 4 5 6 7 8 9 10 11 1 2 #-------+ <-Прямоугольник №1 Y AXIS 3 \| \| 4 +-------# 5 #-----------------------+ <-Прямоугольник №2 6 \| \| 7 \| #---+ \| <-Прямоугольник №3 8 \| \| \| \| 9 \| +---# \| 10 +-----------------------# 11 # <-Прямоугольник №4
	The rectangles are defined according to this scheme: {X-axis coordinate of top left, Y-axis coordinate of top left, X-axis coordinate of bottom right, Y-axis coordinate of bottom right} -- or more succinctly: {x1,y1,x2,y2}. So in the picture ... Rectangle#1 starts at position 1 on the X axis and position 2 on the Y axis, and ends at position 3 on the X axis and position 4 on the Y axis, so its coordinates are {1,2,3,4}. Rectangle#2's coordinates are {3,5,9,10}. Rectangle#3's coordinates are {4,7,5,9}. And finally Rectangle#4's coordinates are {10,11,10,11}. Rectangle#4 is actually a "point" since it has zero width and zero height, so it could have been described with only two digits: {10,11}.	Прямоугольники определяются в соответствии со следующей схемой: {верхняя левая координата по оси X, верхняя левая координата по оси Y, нижняя правая координата по оси X, нижняя правая координата по оси Y} -- или коротко: {x1,y1,x2,y2}. Таким образом, на рисунке ... Прямоугольник № 1 начинается в точке 1 по оси X и точке 2 по оси Y, а заканчивается в точке 3 по оси X и точке 4 по оси Y, поэтому его координаты будут следующие: {1,2,3,4}. Координаты Прямоугольника № 2: {3,5,9,10}. Координаты Прямоугольника № 3: {4,7,5,9}. И наконец, координаты Прямоугольника № 4: {10,11,10,11}. Прямоугольник № 4, на самом деле, является точкой, поскольку у него нулевая ширина и нулевая высота, так что его можно описать всего двумя числами: {10,11}.
	Some relationships between the rectangles are: "Rectangle#1's nearest neighbor is Rectangle#2", and "Rectangle#3 is entirely inside Rectangle#2".	Некоторые отношения между прямоугольниками могут быть описаны так: "Прямоугольник №1 является ближайшим соседом Прямоугольника №2", а "Прямоугольник №3 полностью находится внутри Прямоугольника №2".
	Now let us create a space and add an RTREE index.	Сейчас создадим спейс и добавим RTREE-индекс.