c/libcdsb
1
0
Fork 0
Code Issues 5 Pull Requests Actions Packages Projects Releases Wiki Activity

Update page '2.1. vtype_array'

Gregory Lirent 2022-08-17 15:26:33 +03:00
parent c04efe6b96
commit 89d58ffce3
1 changed files with 11 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
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)`