From 89d58ffce35f040ea23e58758d5af50c52e20cbc Mon Sep 17 00:00:00 2001 From: Gregory Lirent Date: Wed, 17 Aug 2022 15:26:33 +0300 Subject: [PATCH] Update page '2.1. vtype_array' --- 2.1. vtype_array.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/2.1. vtype_array.md b/2.1. vtype_array.md index 036ba30..de7ae55 100644 --- a/2.1. vtype_array.md +++ b/2.1. vtype_array.md @@ -13,8 +13,19 @@ ##### Базовый блок - `void array_init(vtype_array* x, vtype type)` + - Принимает указатель на область памяти, содержащую инициализируемый контейнер `x`. + - Принимает значение типа `type`, определяющий содержащиеся данные внутри инициализируемого контейнера. - `void* array_at(const vtype_array* s, ssize_t index)` + - Принимает указатель на область памяти, содержащую инициализированное значение **vtype_array** `s`. + - Принимает значение индекса данных `index`, которые следует вернуть. Отрицательные значения индекса указывают на элементы, начианая с последнего (где индекс -1 указывает на последний элемент массива). Если отрицательное значение индекса по модулю превышает размерность массива, то будет считаться, что запрос сделан с индексом равным нулю. + - Возвращает указатель на область памяти, в которой находятся запрошенные данные, либо **NULL**, если индекс выходит за границы области памяти, принадлежащей контейнеру. - `size_t array_slice(vtype_array* x, vtype_array* src, ssize_t index, size_t count, bool cut)` + - Принимает указатель на область памяти, содержащую инициализируемый контейнер `x`. + - Принимает указатель на область памяти, содержащую инициализированное значение **vtype_array** `src`. + - Принимает значение индекса данных `index`, начиная с которого, начать "срез" данных. Отрицательные значения индекса указывают на элементы, начианая с последнего (где индекс -1 указывает на последний элемент массива). Если отрицательное значение индекса по модулю превышает размерность массива, то будет считаться, что запрос сделан с индексом равным нулю. + - Принимает значение количества элементов `count`, которым необходимо инициализировать `x` в рамках "среза" данных `src`, начиная с `index`. В случае, если количество элементов, начиная с `index` меньше `count`, вместо `count` будет использовано количество оставшихся элементов. + - Принимает булевое значение `cut`, сообщающего о необходимости вырезать полученный "срез" данных из `src`. + - Возвращает итоговое количество элементов, вошедших в "срез". - `void array_sort(vtype_array* x)` - `void array_reverse(vtype_array* x)`