zzy
0e7dec202a
移除了 libs/lex_parser 目录下的所有头文件和源文件，包括： - lex_parser.h 和 lex_parser.c 核心解析功能 - 所有测试文件（test_char.c, test_identifier.c, test_number.c, test_skip_block_comment.c, test_skip_line.c, test_string.c） 更新了 lexer 模块的依赖配置，将 lex_parser 替换为 sstream， 同时更新了 lexer.h 中的相关包含头文件和数据结构定义， 简化了 scc_lexer_t 结构体的字段。
101 lines
2.8 KiB
C
101 lines
2.8 KiB
C
/**
|
||
* @file lexer.h
|
||
* @brief C语言词法分析器核心数据结构与接口
|
||
*/
|
||
|
||
#ifndef __SCC_LEXER_H__
|
||
#define __SCC_LEXER_H__
|
||
|
||
#include "lexer_token.h"
|
||
#include <scc_core.h>
|
||
#include <scc_sstream.h>
|
||
|
||
/**
|
||
* @brief 词法分析器核心结构体
|
||
*
|
||
* 封装词法分析所需的状态信息和缓冲区管理
|
||
*/
|
||
typedef struct scc_lexer {
|
||
scc_sstream_ring_t stream_ref;
|
||
int jump_macro;
|
||
} scc_lexer_t;
|
||
|
||
void scc_lexer_init(scc_lexer_t *lexer, scc_sstream_ring_t *stream_ref);
|
||
|
||
/**
|
||
* @brief 获取原始token
|
||
* @param[in] lexer 词法分析器实例
|
||
* @param[out] token 输出token存储位置
|
||
*
|
||
* 此函数会返回所有类型的token，包括空白符等无效token
|
||
*/
|
||
void scc_lexer_get_token(scc_lexer_t *lexer, scc_lexer_tok_t *token);
|
||
|
||
/**
|
||
* @brief 获取有效token
|
||
* @param[in] lexer 词法分析器实例
|
||
* @param[out] token 输出token存储位置
|
||
*
|
||
* 此函数会自动跳过空白符等无效token，返回对语法分析有意义的token
|
||
*/
|
||
void scc_lexer_get_valid_token(scc_lexer_t *lexer, scc_lexer_tok_t *token);
|
||
|
||
typedef SCC_VEC(scc_lexer_tok_t) scc_lexer_tok_vec_t;
|
||
|
||
typedef struct scc_lexer_stream scc_lexer_stream_t;
|
||
struct scc_lexer_stream {
|
||
scc_lexer_t *lexer;
|
||
scc_lexer_tok_vec_t toks; // 循环缓冲区
|
||
usize curr_pos; // 当前读取位置（逻辑位置）
|
||
usize probe_pos; // 已填充位置（逻辑位置）
|
||
cbool need_comment;
|
||
|
||
/// @brief 向前读取n个token
|
||
const scc_lexer_tok_t *(*peek)(scc_lexer_stream_t *stream, usize n);
|
||
|
||
/// @brief 指针推进到offset
|
||
void (*advance)(scc_lexer_stream_t *stream, usize offset);
|
||
|
||
/// @brief 销毁并释放资源
|
||
void (*drop)(scc_lexer_stream_t *stream);
|
||
};
|
||
|
||
/**
|
||
* @brief 将词法分析器转换成流式输出(自带缓冲区)
|
||
* @param[in] lexer 已经词法分析器实例
|
||
* @param[out] stream 输出流对象指针
|
||
* @param[in] need_comment 输出时是否需要注释
|
||
*/
|
||
void scc_lexer_to_stream(scc_lexer_t *lexer, scc_lexer_stream_t *stream,
|
||
cbool need_comment);
|
||
|
||
static inline const scc_lexer_tok_t *
|
||
scc_lexer_stream_current(scc_lexer_stream_t *stream) {
|
||
Assert(stream != null);
|
||
return stream->peek(stream, 0);
|
||
}
|
||
|
||
static inline const scc_lexer_tok_t *
|
||
scc_lexer_stream_peek(scc_lexer_stream_t *stream, usize n) {
|
||
Assert(stream != null);
|
||
return stream->peek(stream, n);
|
||
}
|
||
|
||
static inline void scc_lexer_stream_consume(scc_lexer_stream_t *stream) {
|
||
Assert(stream != null);
|
||
return stream->advance(stream, 1);
|
||
}
|
||
|
||
static inline void scc_lexer_stream_advance(scc_lexer_stream_t *stream,
|
||
usize n) {
|
||
Assert(stream != null);
|
||
return stream->advance(stream, n);
|
||
}
|
||
|
||
static inline void scc_lexer_stream_drop(scc_lexer_stream_t *stream) {
|
||
Assert(stream != null);
|
||
return stream->drop(stream);
|
||
}
|
||
|
||
#endif /* __SCC_LEXER_H__ */
|