diff --git a/2.3. vtype_list.md b/2.3. vtype_list.md index 3545c16..3127698 100644 --- a/2.3. vtype_list.md +++ b/2.3. vtype_list.md @@ -44,25 +44,37 @@ ### [include/extra/list.h](https://gogs.lirent.ru/lirent/libcdsb/src/master/include/extra/list.h) ##### Макросы + + - `int list_get_by_index(vtype_list* x, ssize_t index, void* data, CallbackT callback)` + - Принимает указатель на область памяти, содержащую инициализированное значение **vtype_list** `x`. - Принимает значение индекса данных `index`, которые следует вернуть. Отрицательные значения индекса указывают на элементы, начианая с последнего (где индекс -1 указывает на последний элемент массива). Если отрицательное значение индекса по модулю превышает размерность массива, то будет считаться, что запрос сделан с индексом равным нулю. - Принимает указатель на произвольные пользовательские данные `data`. - Принимает указатель на функцию-callback (см. начало текущего документа). - Вызывает callback-функцию cо значением находящимся по запрошенному индексу, в качестве аргумента. - Возвращает -1, если индекс выходит за границы области памяти, принадлежащей контейнеру. В противном случае возвращает значение возвращенное callback-функцией. + + - `int list_pop_by_index(vtype_list* x, ssize_t index, void* data, CallbackT callback)` + - Принимает указатель на область памяти, содержащую инициализированное значение **vtype_list** `x`. - Принимает значение индекса данных `index`, которые следует вернуть. Отрицательные значения индекса указывают на элементы, начианая с последнего (где индекс -1 указывает на последний элемент массива). Если отрицательное значение индекса по модулю превышает размерность массива, то будет считаться, что запрос сделан с индексом равным нулю. - Принимает указатель на произвольные пользовательские данные `data`. - Принимает указатель на функцию-callback (см. начало текущего документа). - Вызывает callback-функцию cо значением находящимся по запрошенному индексу, в качестве аргумента. После чего удаляет данный объект из контейнера. - Возвращает -1, если индекс выходит за границы области памяти, принадлежащей контейнеру. В противном случае возвращает значение возвращенное callback-функцией. + + - `int list_remove_by_index(vtype_list* x, ssize_t index)` + - Принимает указатель на область памяти, содержащую инициализированное значение **vtype_list** `x`. - Принимает значение индекса данных `index`, которые следует вернуть. Отрицательные значения индекса указывают на элементы, начианая с последнего (где индекс -1 указывает на последний элемент массива). Если отрицательное значение индекса по модулю превышает размерность массива, то будет считаться, что запрос сделан с индексом равным нулю. - Возвращает `0`, в случае успешного удаления элемента, или `-1` в случае, если индекс выходит за границы области памяти, принадлежащей контейнеру. + + - `int list_foreach(vtype_list* x, void* data, CallbackT callback)` + - Принимает указатель на область памяти, содержащую инициализированное значение **vtype_list** `x`. - Принимает указатель на произвольные пользовательские данные `data`. - Принимает указатель на функцию-callback (см. начало текущего документа).