feat(core): 添加字符串长度计算函数并优化数据结构定义

- 在 `core_mem.h` 中新增 `smcc_strlen` 函数，用于计算字符串长度
- 调整 `VEC` 宏定义参数，移除冗余的 name 参数，增强结构体声明一致性
- 修改 `cstring_from_cstr` 返回值字段顺序，保持代码风格统一
- 在 `libcore.h` 中增加日志相关宏定义的保护判断，防止重复定义冲突

runtime/libutils/include/hashmap.h

@@ -0,0 +1,122 @@
+/**
+ * @file hashmap.h
+ * @brief 开放寻址法哈希表实现
+ *
+ * 提供基于向量容器的哈希表实现，支持动态扩容和墓碑机制
+ */
+
+#ifndef __SMCC_HASHMAP_H__
+#define __SMCC_HASHMAP_H__
+
+#include <libcore.h>
+
+/**
+ * @enum hp_entry_state_t
+ * @brief 哈希表条目状态标识
+ */
+typedef enum hashmap_entry_state {
+    ENTRY_EMPTY,    /**< 空槽位（从未使用过） */
+    ENTRY_ACTIVE,   /**< 有效条目（包含键值对） */
+    ENTRY_TOMBSTONE /**< 墓碑标记（已删除条目） */
+} hp_entry_state_t;
+
+/**
+ * @struct hashmap_entry_t
+ * @brief 哈希表条目结构
+ *
+ * @note key/value内存由调用者管理，哈希表不负责其生命周期
+ */
+typedef struct hashmap_entry {
+    const void *key;        /**< 键指针（不可变） */
+    void *value;            /**< 值指针 */
+    u32 hash;               /**< 预计算的哈希值（避免重复计算） */
+    hp_entry_state_t state; /**< 当前条目状态 */
+} hashmap_entry_t;
+
+/**
+ * @struct hashmap_t
+ * @brief 哈希表主体结构
+ *
+ * 使用开放寻址法实现，采用墓碑标记处理删除操作
+ */
+typedef struct smcc_hashmap {
+    VEC(hashmap_entry_t) entries; /**< 条目存储容器 */
+    u32 count;                    /**< 有效条目数量（不含墓碑） */
+    u32 tombstone_count;          /**< 墓碑条目数量 */
+    /**
+     * @brief 哈希函数指针
+     * @param key 键指针
+     * @return 32位无符号哈希值
+     */
+    u32 (*hash_func)(const void *key);
+    /**
+     * @brief 键比较函数指针
+     * @param key1 第一个键指针
+     * @param key2 第二个键指针
+     * @return 相同返回0，不同返回非0
+     */
+    int (*key_cmp)(const void *key1, const void *key2);
+} hashmap_t;
+
+/**
+ * @brief 初始化哈希表结构
+ * @param ht 哈希表实例指针
+ *
+ * @warning 必须设置hash_func和key_cmp后才能使用
+ */
+void hashmap_init(hashmap_t *ht);
+
+/**
+ * @brief 插入/更新键值对
+ * @param ht 哈希表实例指针
+ * @param key 键指针
+ * @param value 值指针
+ * @return 被替换的旧值指针（无替换返回NULL）
+ */
+void *hashmap_set(hashmap_t *ht, const void *key, void *value);
+
+/**
+ * @brief 查找键对应值
+ * @param ht 哈希表实例指针
+ * @param key 查找键指针
+ * @return 找到返回值指针，未找到返回NULL
+ */
+void *hashmap_get(hashmap_t *ht, const void *key);
+
+/**
+ * @brief 删除键值对
+ * @param ht 哈希表实例指针
+ * @param key 要删除的键指针
+ * @return 被删除的值指针（不存在返回NULL）
+ *
+ * @note 实际采用墓碑标记方式删除
+ */
+void *hashmap_del(hashmap_t *ht, const void *key);
+
+/**
+ * @brief 销毁哈希表
+ * @param ht 哈希表实例指针
+ *
+ * @note 仅释放哈希表内部内存，不会释放key/value内存
+ */
+void hashmap_drop(hashmap_t *ht);
+
+/**
+ * @typedef hashmap_iter_fn
+ * @brief 哈希表迭代回调函数类型
+ * @param key 当前键指针
+ * @param value 当前值指针
+ * @param context 用户上下文指针
+ * @return 返回非0停止迭代
+ */
+typedef int (*hashmap_iter_fn)(const void *key, void *value, void *context);
+
+/**
+ * @brief 遍历哈希表所有有效条目
+ * @param ht 哈希表实例指针
+ * @param iter_func 迭代回调函数
+ * @param context 用户上下文指针
+ */
+void hashmap_foreach(hashmap_t *ht, hashmap_iter_fn iter_func, void *context);
+
+#endif // __SMCC_HASHMAP_H__