feat(core): 添加字符串长度计算函数并优化数据结构定义
- 在 `core_mem.h` 中新增 `smcc_strlen` 函数,用于计算字符串长度 - 调整 `VEC` 宏定义参数,移除冗余的 name 参数,增强结构体声明一致性 - 修改 `cstring_from_cstr` 返回值字段顺序,保持代码风格统一 - 在 `libcore.h` 中增加日志相关宏定义的保护判断,防止重复定义冲突
This commit is contained in:
@@ -1,48 +1,48 @@
|
||||
/**
|
||||
* @file hashtable.h
|
||||
* @file hashmap.h
|
||||
* @brief 开放寻址法哈希表实现
|
||||
*
|
||||
* 提供基于向量容器的哈希表实现,支持动态扩容和墓碑机制
|
||||
*/
|
||||
|
||||
#ifndef __SMCC_HASHTABLE_H__
|
||||
#define __SMCC_HASHTABLE_H__
|
||||
#ifndef __SMCC_HASHMAP_H__
|
||||
#define __SMCC_HASHMAP_H__
|
||||
|
||||
#include <libcore.h>
|
||||
|
||||
/**
|
||||
* @enum ht_entry_state_t
|
||||
* @enum hp_entry_state_t
|
||||
* @brief 哈希表条目状态标识
|
||||
*/
|
||||
typedef enum hash_table_entry_state {
|
||||
typedef enum hashmap_entry_state {
|
||||
ENTRY_EMPTY, /**< 空槽位(从未使用过) */
|
||||
ENTRY_ACTIVE, /**< 有效条目(包含键值对) */
|
||||
ENTRY_TOMBSTONE /**< 墓碑标记(已删除条目) */
|
||||
} ht_entry_state_t;
|
||||
} hp_entry_state_t;
|
||||
|
||||
/**
|
||||
* @struct hash_entry_t
|
||||
* @struct hashmap_entry_t
|
||||
* @brief 哈希表条目结构
|
||||
*
|
||||
* @note key/value内存由调用者管理,哈希表不负责其生命周期
|
||||
*/
|
||||
typedef struct hash_entry {
|
||||
typedef struct hashmap_entry {
|
||||
const void *key; /**< 键指针(不可变) */
|
||||
void *value; /**< 值指针 */
|
||||
u32 hash; /**< 预计算的哈希值(避免重复计算) */
|
||||
ht_entry_state_t state; /**< 当前条目状态 */
|
||||
} hash_entry_t;
|
||||
hp_entry_state_t state; /**< 当前条目状态 */
|
||||
} hashmap_entry_t;
|
||||
|
||||
/**
|
||||
* @struct hash_table_t
|
||||
* @struct hashmap_t
|
||||
* @brief 哈希表主体结构
|
||||
*
|
||||
* 使用开放寻址法实现,采用墓碑标记处理删除操作
|
||||
*/
|
||||
typedef struct hash_table {
|
||||
VECTOR_HEADER(entries, hash_entry_t); /**< 条目存储容器 */
|
||||
u32 count; /**< 有效条目数量(不含墓碑) */
|
||||
u32 tombstone_count; /**< 墓碑条目数量 */
|
||||
typedef struct smcc_hashmap {
|
||||
VEC(hashmap_entry_t) entries; /**< 条目存储容器 */
|
||||
u32 count; /**< 有效条目数量(不含墓碑) */
|
||||
u32 tombstone_count; /**< 墓碑条目数量 */
|
||||
/**
|
||||
* @brief 哈希函数指针
|
||||
* @param key 键指针
|
||||
@@ -56,7 +56,7 @@ typedef struct hash_table {
|
||||
* @return 相同返回0,不同返回非0
|
||||
*/
|
||||
int (*key_cmp)(const void *key1, const void *key2);
|
||||
} hash_table_t;
|
||||
} hashmap_t;
|
||||
|
||||
/**
|
||||
* @brief 初始化哈希表结构
|
||||
@@ -64,7 +64,7 @@ typedef struct hash_table {
|
||||
*
|
||||
* @warning 必须设置hash_func和key_cmp后才能使用
|
||||
*/
|
||||
void init_hashtable(hash_table_t *ht);
|
||||
void hashmap_init(hashmap_t *ht);
|
||||
|
||||
/**
|
||||
* @brief 插入/更新键值对
|
||||
@@ -73,7 +73,7 @@ void init_hashtable(hash_table_t *ht);
|
||||
* @param value 值指针
|
||||
* @return 被替换的旧值指针(无替换返回NULL)
|
||||
*/
|
||||
void *hashtable_set(hash_table_t *ht, const void *key, void *value);
|
||||
void *hashmap_set(hashmap_t *ht, const void *key, void *value);
|
||||
|
||||
/**
|
||||
* @brief 查找键对应值
|
||||
@@ -81,7 +81,7 @@ void *hashtable_set(hash_table_t *ht, const void *key, void *value);
|
||||
* @param key 查找键指针
|
||||
* @return 找到返回值指针,未找到返回NULL
|
||||
*/
|
||||
void *hashtable_get(hash_table_t *ht, const void *key);
|
||||
void *hashmap_get(hashmap_t *ht, const void *key);
|
||||
|
||||
/**
|
||||
* @brief 删除键值对
|
||||
@@ -91,7 +91,7 @@ void *hashtable_get(hash_table_t *ht, const void *key);
|
||||
*
|
||||
* @note 实际采用墓碑标记方式删除
|
||||
*/
|
||||
void *hashtable_del(hash_table_t *ht, const void *key);
|
||||
void *hashmap_del(hashmap_t *ht, const void *key);
|
||||
|
||||
/**
|
||||
* @brief 销毁哈希表
|
||||
@@ -99,18 +99,17 @@ void *hashtable_del(hash_table_t *ht, const void *key);
|
||||
*
|
||||
* @note 仅释放哈希表内部内存,不会释放key/value内存
|
||||
*/
|
||||
void hashtable_destory(hash_table_t *ht);
|
||||
void hashmap_drop(hashmap_t *ht);
|
||||
|
||||
/**
|
||||
* @typedef hash_table_iter_func
|
||||
* @typedef hashmap_iter_fn
|
||||
* @brief 哈希表迭代回调函数类型
|
||||
* @param key 当前键指针
|
||||
* @param value 当前值指针
|
||||
* @param context 用户上下文指针
|
||||
* @return 返回非0停止迭代
|
||||
*/
|
||||
typedef int (*hash_table_iter_func)(const void *key, void *value,
|
||||
void *context);
|
||||
typedef int (*hashmap_iter_fn)(const void *key, void *value, void *context);
|
||||
|
||||
/**
|
||||
* @brief 遍历哈希表所有有效条目
|
||||
@@ -118,7 +117,6 @@ typedef int (*hash_table_iter_func)(const void *key, void *value,
|
||||
* @param iter_func 迭代回调函数
|
||||
* @param context 用户上下文指针
|
||||
*/
|
||||
void hashtable_foreach(hash_table_t *ht, hash_table_iter_func iter_func,
|
||||
void *context);
|
||||
void hashmap_foreach(hashmap_t *ht, hashmap_iter_fn iter_func, void *context);
|
||||
|
||||
#endif // __SMCC_HASHTABLE_H__
|
||||
#endif // __SMCC_HASHMAP_H__
|
||||
@@ -1,9 +1,8 @@
|
||||
#ifndef __SMCC_UTILS_H__
|
||||
#define __SMCC_UTILS_H__
|
||||
|
||||
#include "hashtable.h"
|
||||
#include "hashmap.h"
|
||||
#include "kllist.h"
|
||||
#include "string.h"
|
||||
#include "strpool.h"
|
||||
#include <libcore.h>
|
||||
|
||||
|
||||
@@ -8,8 +8,7 @@
|
||||
#ifndef __SMCC_STRPOOL_H__
|
||||
#define __SMCC_STRPOOL_H__
|
||||
|
||||
#include "hashtable.h"
|
||||
#include "string.h"
|
||||
#include "hashmap.h"
|
||||
#include <libcore.h>
|
||||
|
||||
/**
|
||||
@@ -19,7 +18,7 @@
|
||||
* 组合哈希表和专用内存分配器实现的高效字符串存储池
|
||||
*/
|
||||
typedef struct strpool {
|
||||
hash_table_t ht; /**< 哈希表用于快速查找已存储字符串 */
|
||||
hashmap_t ht; /**< 哈希表用于快速查找已存储字符串 */
|
||||
} strpool_t;
|
||||
|
||||
/**
|
||||
|
||||
Reference in New Issue
Block a user