Update page '2. Заголовочные файлы'

Gregory Lirent 2022-08-17 12:24:12 +03:00
parent f0beb60014
commit 5b996e4d37

@ -29,4 +29,16 @@
Где первые два предоставляют доступ к внутренним реализациям работы с памятью для пользовательского кода (в том числе повторяя или являясь оберткой над функционалом стандартной библиотеки), а последний - предоставляет методы для генерации C-строк (с основанием на значении **vtype**).
#### [include/vtype.h](https://gogs.lirent.ru/lirent/libcdsb/src/master/include/vtype.h)
Помимо декларации типов и перечисления **vtype**, предоставляющего функционал их идентификации, в файле задекларировано 7 следующих базовых групп методов для работы с контейнерами:
- Определение размера контейнера
- `size_t string_size(const vtype_string* x)` принимает указатель на инициализированное значение **vtype_string**, возвращает подсчитанное количество символов в строке (с поддержкой юникода).
- `size_t string_nmemb(const vtype_string* x)` принимает указатель на инициализированное значение **vtype_string**, возвращает подсчитанный размер строки в байтах (также как это сделал бы **strlen**)
- `size_t array_size(const vtype_array* x)` принимает указатель на инициализированное значение **vtype_array**, возвращает количество элементов находящихся внутри контейнера.
- `size_t array_nmemb(const vtype_array* x)` принимает указатель на инициализированное значение **vtype_array**, возвращает размер блока памяти контейнера в байтах.
- `size_t list_size(const vtype_list* x)` принимает указатель на инициализированное значение **vtype_list**, возвращает подсчитанное количество элементов, находящихся внутри контейнера.
- `size_t map_size(const vtype_map* x)` принимает указатель на инициализированное значение **vtype_map**, возвращает подсчитанное количество элементов, находящихся внутри контейнера.
- `size_t vset_size(const vtype_set* x)` принимает указатель на инициализированное значение **vtype_set**, возвращает подсчитанное количество элементов, находящихся внутри контейнера.
- `size_t dict_size(const vtype_dict* x)` принимает указатель на инициализированное значение **vtype_dict**, возвращает количество элементов, находящихся внутри контейнера.
- `size_t dict_capacity(const vtype_dict* x)` принимает указатель на инициализированное значение **vtype_dict**, возвращает текущий размер таблицы, доступной для вставки значений.