refactor: 重构数字字面量扫描逻辑

- 优化了 NumberTokenScanner 类的代码结构
- 改进了数字字面量的扫描逻辑,包括整数和小数部分
- 调整了后缀和非法字符的检查策略
- 优化了错误处理和异常抛出的逻辑
- 移除了未使用的代码和不必要的注释
This commit is contained in:
Luke 2025-07-07 00:02:31 +08:00
parent cb208bb8af
commit 0ea8cb352d

View File

@ -14,8 +14,9 @@ import org.jcnc.snow.compiler.lexer.token.TokenType;
* <li>十进制小数 3.140.5</li>
* <li>单字符类型后缀 2.0f255B合法集合见 SUFFIX_CHARS</li>
* </ol>
* <p>
*
* 如果后续需要支持科学计数法下划线分隔符不同进制等只需扩展现有状态机的转移规则
*
* <pre>
* 状态机简述
* INT_PART --'.'--> DEC_POINT
@ -33,12 +34,14 @@ import org.jcnc.snow.compiler.lexer.token.TokenType;
* <li>FRAC_PART 读取小数部分遇非法字符则结束主体</li>
* <li>END 主体扫描结束进入后缀/尾随字符判定</li>
* </ul>
*
* 错误处理策略
* <ol>
* <li>数字后跟未知字母 42X 抛出 LexicalException</li>
* <li>数字与合法后缀间有空白 3 L 抛出 LexicalException</li>
* <li>小数点后缺失数字 1. 抛出 LexicalException</li>
* </ol>
*
* 支持的单字符类型后缀包括b, s, l, f, d 及其大写形式若需支持多字符后缀可将该集合扩展为 Set<String>
*/
public class NumberTokenScanner extends AbstractTokenScanner {
@ -55,7 +58,7 @@ public class NumberTokenScanner extends AbstractTokenScanner {
* 仅当首字符为数字时NumberTokenScanner 介入处理
*
* @param c 当前待判断字符
* @param ctx 当前 LexerContext可用于进一步判断
* @param ctx 当前 LexerContext
* @return 如果为数字返回 true否则返回 false
*/
@Override
@ -65,31 +68,24 @@ public class NumberTokenScanner extends AbstractTokenScanner {
/**
* 按照有限状态机读取完整数字字面量并对尾随字符进行合法性校验
* <p>
* 主体流程
* <ol>
* <li>整数部分可选小数点和小数部分扫描</li>
* <li>检查合法的类型后缀</li>
* <li>检查非法尾随字符如未知字母空白后缀或非法 '/'</li>
* <li>生成并返回 NUMBER_LITERAL Token</li>
* </ol>
*
* @param ctx 当前 LexerContext提供游标前瞻等功能
* @param ctx 当前 LexerContext
* @param line 源码起始行号1
* @param col 源码起始列号1
* @return NUMBER_LITERAL 类型的 Token
* @throws LexicalException 如果遇到非法格式或未受支持的尾随字符
*/
@Override
protected Token scanToken(LexerContext ctx, int line, int col) {
protected Token scanToken(LexerContext ctx, int line, int col) throws LexicalException {
StringBuilder literal = new StringBuilder();
State state = State.INT_PART;
// 1. 主体扫描 整数 / 小数
/* ───── 1. 主体扫描 —— 整数 / 小数 ───── */
mainLoop:
while (!ctx.isAtEnd() && state != State.END) {
char ch = ctx.peek();
switch (state) {
/* 整数部分 */
case INT_PART:
if (Character.isDigit(ch)) {
literal.append(ctx.advance());
@ -97,86 +93,62 @@ public class NumberTokenScanner extends AbstractTokenScanner {
state = State.DEC_POINT;
literal.append(ctx.advance());
} else {
state = State.END; // 整数已结束
state = State.END;
}
break;
/* 已读到小数点,下一字符必须是数字 */
case DEC_POINT:
if (Character.isDigit(ch)) {
state = State.FRAC_PART;
literal.append(ctx.advance());
} else {
// "1." 语言规范不允许尾点数字
throw new LexicalException("小数点后必须跟数字", line, col);
}
break;
/* 小数部分 */
case FRAC_PART:
if (Character.isDigit(ch)) {
literal.append(ctx.advance());
} else {
state = State.END; // 小数字符串结束
state = State.END;
}
break;
default:
break mainLoop; // 理论不会到达
break mainLoop;
}
}
// 2. 后缀及非法尾随字符检查
/* ───── 2. 后缀及非法尾随字符检查 ───── */
if (!ctx.isAtEnd()) {
char next = ctx.peek();
// 2-A. 合法单字符后缀紧邻不允许空格
/* 2-A. 合法单字符后缀(紧邻数字,不允许空格) */
if (SUFFIX_CHARS.indexOf(next) >= 0) {
literal.append(ctx.advance());
}
// 未知单字符后缀 直接报错
/* 2-B. 未知紧邻字母后缀 —— 报错 */
else if (Character.isLetter(next)) {
throw new LexicalException("未知的数字类型后缀 '" + next + "'", line, col);
}
// 数字 + 空格 + 字母 一律非法
else if (Character.isWhitespace(next) && next != '\n') {
int off = 1;
char look;
// 跳过空白不含换行
while (true) {
look = ctx.peekAhead(off);
if (look == '\n' || look == '\0') break;
if (!Character.isWhitespace(look)) break;
off++;
}
if (Character.isLetter(look)) {
throw new LexicalException("数字字面量后不允许出现空格再跟标识符/后缀", line, col);
}
}
// 其他符号由外层扫描器处理
/* 其余情况交由外层扫描器处理(包括空白及其它符号) */
}
// 3. 生成并返回 Token
/* ───── 3. 生成并返回 Token ───── */
return new Token(TokenType.NUMBER_LITERAL, literal.toString(), line, col);
}
/**
* FSM 内部状态
*/
/** FSM 内部状态定义 */
private enum State {
/**
* 整数部分小数点左侧
*/
/** 整数部分 */
INT_PART,
/**
* 已读到小数点但还未读到第一位小数数字
*/
/** 已读到小数点,但还未读到第一位小数数字 */
DEC_POINT,
/**
* 小数部分小数点右侧
*/
/** 小数部分 */
FRAC_PART,
/**
* 主体结束准备处理后缀或交还控制权
*/
/** 主体结束,准备处理后缀或交还控制权 */
END
}
}