zzy
3aaf3a3991
- Introduce new SCF (SCC Format) library with header, implementation, and test files - SCF is a minimal executable/linkable format focused on internal linking with external symbol import/export abstraction - Rename lexer and lex_parser packages from 'smcc_' to 'scc_' prefix for consistency - Update hashmap implementation to use 'scc_' prefix for types and structures - Add build configuration for new format library with dependencies on libcore and libutils
70 lines
1.8 KiB
C
70 lines
1.8 KiB
C
/**
|
||
* @file strpool.h
|
||
* @brief 字符串池实现
|
||
*
|
||
* 提供字符串驻留（String Interning）功能，保证相同字符串的唯一性存储
|
||
*/
|
||
|
||
#ifndef __SCC_STRPOOL_H__
|
||
#define __SCC_STRPOOL_H__
|
||
|
||
#include "hashmap.h"
|
||
#include <libcore.h>
|
||
|
||
/**
|
||
* @struct strpool_t
|
||
* @brief 字符串池上下文
|
||
*
|
||
* 组合哈希表和专用内存分配器实现的高效字符串存储池
|
||
*/
|
||
typedef struct strpool {
|
||
scc_hashtable_t ht; /**< 哈希表用于快速查找已存储字符串 */
|
||
} scc_strpool_t;
|
||
|
||
/**
|
||
* @brief 初始化字符串池
|
||
* @param pool 字符串池实例指针
|
||
*/
|
||
void scc_strpool_init(scc_strpool_t *pool);
|
||
|
||
/**
|
||
* @brief 驻留字符串到池中
|
||
* @param pool 字符串池实例指针
|
||
* @param str 要驻留的 C 字符串
|
||
* @return 池中唯一字符串的持久指针
|
||
*
|
||
* @note 返回值生命周期与字符串池一致
|
||
* @note 重复插入相同字符串会返回已有指针
|
||
*/
|
||
const char *scc_strpool_intern(scc_strpool_t *pool, const char *str);
|
||
|
||
/**
|
||
* @brief 销毁字符串池
|
||
* @param pool 字符串池实例指针
|
||
*
|
||
* @warning 销毁后已获取的字符串指针将失效
|
||
* @note 会自动释放所有驻留字符串内存
|
||
*/
|
||
void scc_strpool_drop(scc_strpool_t *pool);
|
||
|
||
/**
|
||
* @typedef scc_hashtable_iter_fn
|
||
* @brief 哈希表迭代回调函数类型
|
||
* @param key 当前键指针
|
||
* @param value 当前值指针
|
||
* @param context 用户上下文指针
|
||
* @return 返回非0停止迭代
|
||
*/
|
||
typedef int (*scc_strpool_iter_fn)(const char *key, char *value, void *context);
|
||
|
||
/**
|
||
* @brief 遍历字符串表所有有效条目
|
||
* @param ht 字符串表实例指针
|
||
* @param iter_func 迭代回调函数
|
||
* @param context 用户上下文指针
|
||
*/
|
||
void scc_strpool_foreach(scc_strpool_t *pool, scc_strpool_iter_fn iter_func,
|
||
void *context);
|
||
|
||
#endif /* __SCC_STRPOOL_H__ */
|