MtFmt: inc/mm_heap.h 源文件

浏览该文件的文档.
// SPDX-License-Identifier: LGPL-3.0
#if !defined(_INCLUDE_MM_HEAP_H_)
#define _INCLUDE_MM_HEAP_H_ 1
#include "mm_cfg.h"
#include "mm_type.h"
 
MSTR_EXPORT_API(void)
mstr_heap_init_sym(iptr_t heap_memory, usize_t heap_size);
 
MSTR_EXPORT_API(void*)
mstr_heap_allocate_sym(usize_t size, usize_t align);
 
MSTR_EXPORT_API(void*)
mstr_heap_re_allocate_sym(
    void* old_ptr, usize_t new_size, usize_t old_size
);
 
MSTR_EXPORT_API(void) mstr_heap_free_sym(void* memory);
 
MSTR_EXPORT_API(usize_t) mstr_heap_get_free_size(void);
 
MSTR_EXPORT_API(usize_t) mstr_heap_get_high_water_mark(void);
 
MSTR_EXPORT_API(void*)
mstr_heap_realloc_cpimp_sym(
    void* old_ptr, usize_t new_size, usize_t old_size
);
 
MSTR_EXPORT_API(void)
mstr_heap_get_allocate_count(usize_t* alloc_count, usize_t* free_count);
 
#if _MSTR_USE_MALLOC
#define mstr_heap_init(mem, leng) ((void)mem, (void)leng)
 
#define mstr_heap_alloc(s)        _MSTR_MEM_ALLOC_FUNCTION((s))
 
#if MSTR_MEM_REALLOC_FUNCTION_NOT_AVAL
#define mstr_heap_realloc(p, new_s, old_s) \
    mstr_heap_realloc_cpimp_sym((p), (new_s), (old_s))
#else
#define mstr_heap_realloc(p, s, os) _MSTR_MEM_REALLOC_FUNCTION((p), (s))
#endif // MSTR_MEM_REALLOC_FUNCTION_NOT_AVAL
 
#define mstr_heap_free(m)           \
    do {                            \
        _MSTR_MEM_FREE_FUNCTION(m); \
        (m) = NULL;                 \
    } while (0)
#else
#define mstr_heap_init(mem, leng)                           \
    do {                                                    \
        mstr_heap_init_sym((iptr_t)(mem), (usize_t)(leng)); \
    } while (0)
 
#define mstr_heap_alloc(s) (mstr_heap_allocate_sym((s), 4))
 
#define mstr_heap_realloc(p, new_s, old_s) \
    mstr_heap_re_allocate_sym((p), (new_s), (old_s))
 
#define mstr_heap_free(m)      \
    do {                       \
        mstr_heap_free_sym(m); \
        (m) = NULL;            \
    } while (0)
 
#endif // _MSTR_USE_MALLOC
 
#endif // _INCLUDE_MU_HEAP_H_