cKit/Foundation/c_Array.h

#ifndef INCLUDED_C_ARRAY_H
#define INCLUDED_C_ARRAY_H

#ifndef INCLUDED_C_TYPES_H
#include <c_Types.h>
#endif /*INCLUDED_C_TYPES_H*/

#ifndef INCLUDED_C_ALLOCATOR_H
#include <c_Allocator.h>
#endif /*INCLUDED_C_ALLOCATOR_H*/


/* ------------------------------------------------------------------------------------------------------------------ */
/*  */

typedef struct {
    void* array;              // 连续的数据存储区（直接密集存储数据值）
    c_size_t item_size;       // 单个元素的字节大小（例如 sizeof(int)）
    c_size_t size;            // 数组的固定长度（同时也是当前的物理容量）
    c_Allocator_t allocator;  // 内部绑定的自主内存管理器
} c_Array_t;

/* ------------------------------------------------------------------------------------------------------------------ */
/*  */

c_err_t c_Array_Init(c_Array_t* self, c_size_t item_size, c_size_t size, c_Allocator_t* allocator);
void    c_Array_Destroy(c_Array_t* self);

// 核心固定数组操作 API (安全值复制模式)
c_err_t c_Array_Read(const c_Array_t* self, c_size_t index, void* out_item);
c_err_t c_Array_Write(c_Array_t* self, c_size_t index, const void* item);
void*   c_Array_Get(const c_Array_t* self, c_size_t index);
c_err_t c_Array_Fill(c_Array_t* self, const void* item);

// 内联高频辅助接口
C_STATIC_FORCE_INLINE
c_size_t c_Array_Size(const c_Array_t* self) {
    if (!self) return 0;
    return self->size; // O(1) 实时读取，固定不变
}

#endif /*INCLUDED_C_ARRAY_H*/