重构

Foundation/c_Array.h

@@ -5,35 +5,38 @@
 #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 c_Array_t {
-    c_size_t length;
-    c_size_t size;
-    uint8_t* array;
-}c_Array_t;
+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* array, c_size_t length, c_size_t size);
+/* ------------------------------------------------------------------------------------------------------------------ */
+/*  */
 
-void c_Array_Destroy(c_Array_t* array);
+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);
 
-c_Array_t* c_Array_New(c_size_t length, c_size_t size);
+// 核心固定数组操作 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);
 
-void c_Array_Delete(c_Array_t** array);
-
-c_size_t c_Array_Size(c_Array_t* array);
-
-c_size_t c_Array_Length(c_Array_t* array);
-
-c_err_t c_Array_Get(c_Array_t* array, c_size_t index, void** data);
-
-c_err_t c_Array_Put(c_Array_t* array, c_size_t index, void* value);
-
-c_err_t c_Array_Resize(c_Array_t* array, c_size_t length);
-
-c_Array_t* c_Array_Copy(c_Array_t* array, c_size_t length);
-
-c_err_t c_Array_CopyTo(const c_Array_t* array, c_Array_t* copy);
+// 内联高频辅助接口
+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*/