diff --git a/1.2. Работа с памятью.md b/1.2. Работа с памятью.md index 51feebf..7de3f74 100644 --- a/1.2. Работа с памятью.md +++ b/1.2. Работа с памятью.md @@ -1 +1,29 @@ -## Работа с памятью +## Работа с памятью + +Управление памятью в проекте осуществляется исключительно при помощи функций описанных в [include/extra/memory.h](https://gogs.lirent.ru/lirent/libcdsb/src/master/include/extra/memory.h) и [include/extra/cstring.h](https://gogs.lirent.ru/lirent/libcdsb/src/master/include/extra/cstring.h) + +Вот их полный список: + +- `void* libcdsb_aalloc (size_t a, size_t n)` +- `void* libcdsb_malloc (size_t n)` +- `void* libcdsb_calloc (size_t n, size_t c)` +- `void* libcdsb_realloc(void *p, size_t n)` +- `char* libcdsb_strdup (const char* s)` +- `char* libcdsb_strndup(const char* s, size_t n)` +- `void* libcdsb_memndup(const void* m, size_t n)` + +высвобождение памяти осуществляется системным вызовом + +- `void libcdsb_free(void* s)` + +В случае необходимости изменения принципов работы с памятью, данные символы могут быть подменены пользовательским решением: гарантированно, что иные символы не будут использованы для выделения памяти. + +Отдельным пунктом, можно обозначить служебную структуру **stack_t**, а также методы для работы с ней: + +- `void libcdsb_stack_init (stack_t* stack)` +- `void libcdsb_stack_push (stack_t* stack, void* value)` +- `void* libcdsb_stack_pop (stack_t* stack)` +- `void libcdsb_stack_flush(stack_t* stack)` + +Выделение памяти для этой структуры носит исключительный характер, так как `void libcdsb_stack_push (stack_t* stack, void* value)` использует вызов `void* malloc (size_t n)`. Высвобождение памяти в `void* libcdsb_stack_pop (stack_t* stack)` и `void libcdsb_stack_flush(stack_t* stack)` осуществляется вызовом `void free(void* s)`. +