diff --git a/src/main/java/org/jcnc/snow/compiler/parser/ast/CallExpressionNode.java b/src/main/java/org/jcnc/snow/compiler/parser/ast/CallExpressionNode.java index c9109a1..593658e 100644 --- a/src/main/java/org/jcnc/snow/compiler/parser/ast/CallExpressionNode.java +++ b/src/main/java/org/jcnc/snow/compiler/parser/ast/CallExpressionNode.java @@ -7,33 +7,56 @@ import java.util.List; /** * {@code CallExpressionNode} 表示抽象语法树(AST)中的函数调用表达式节点。 *

- * 函数调用表达式用于表示函数或过程的调用操作, - * 包括被调用对象(callee)以及一组参数表达式(arguments)。 + * 函数调用表达式用于表示函数或过程的调用操作,包含被调用对象(callee)以及一组参数表达式(arguments)。 *

* - * @param callee 被调用的表达式节点,通常为函数标识符或成员访问表达式。 - * @param arguments 参数表达式列表,依照调用顺序排列。 + * @param callee 被调用的表达式节点,通常为函数标识符或成员访问表达式,表示函数名或方法名等。 + * @param arguments 参数表达式列表,表示函数调用中传递给函数的实际参数。参数的顺序与调用顺序一致。 + * @param line 当前表达式所在的行号,方便调试和错误定位。 + * @param column 当前表达式所在的列号,用于精确定位错误位置。 */ -public record CallExpressionNode(ExpressionNode callee, List arguments) implements ExpressionNode { +public record CallExpressionNode( + ExpressionNode callee, // 被调用的表达式节点,表示函数或方法名 + List arguments, // 函数调用的参数表达式列表 + int line, // 当前节点所在的行号 + int column // 当前节点所在的列号 +) implements ExpressionNode { /** - * 返回函数调用表达式的字符串形式。 + * 返回函数调用表达式的字符串形式,便于调试与语法树可视化。 *

- * 该格式将输出为类似 {@code foo(a, b, c)} 的形式, - * 便于调试与语法树可视化。 + * 该方法将表达式节点转化为类似 {@code foo(a, b, c)} 的格式,便于查看和理解抽象语法树的结构。 *

* - * @return 表示函数调用的字符串表示 + * @return 表示函数调用的字符串表示,格式为 {@code callee(arguments)}。 */ @Override public String toString() { StringBuilder sb = new StringBuilder(); - sb.append(callee).append("("); + sb.append(callee).append("("); // 拼接函数名和左括号 for (int i = 0; i < arguments.size(); i++) { - sb.append(arguments.get(i)); - if (i + 1 < arguments.size()) sb.append(", "); + sb.append(arguments.get(i)); // 拼接每个参数 + if (i + 1 < arguments.size()) sb.append(", "); // 如果不是最后一个参数,添加逗号和空格 } - sb.append(")"); - return sb.toString(); + sb.append(")"); // 拼接右括号 + return sb.toString(); // 返回拼接好的字符串 + } + + /** + * 获取当前表达式所在的行号。 + * + * @return 当前表达式的行号。 + */ + public int line() { + return line; + } + + /** + * 获取当前表达式所在的列号。 + * + * @return 当前表达式的列号。 + */ + public int column() { + return column; } } diff --git a/src/main/java/org/jcnc/snow/compiler/parser/expression/CallParselet.java b/src/main/java/org/jcnc/snow/compiler/parser/expression/CallParselet.java index 4e8d3a3..eb47b86 100644 --- a/src/main/java/org/jcnc/snow/compiler/parser/expression/CallParselet.java +++ b/src/main/java/org/jcnc/snow/compiler/parser/expression/CallParselet.java @@ -12,8 +12,7 @@ import java.util.List; * {@code CallParselet} 表示函数调用语法的中缀解析器。 *

* 用于处理形如 {@code foo(arg1, arg2)} 的函数调用结构。 - * 在 Pratt 解析器架构中,该解析器在函数名之后接收括号开始的调用参数, - * 构建 {@link CallExpressionNode} 抽象语法树节点。 + * 在 Pratt 解析器架构中,该解析器在函数名之后接收括号开始的调用参数,构建 {@link CallExpressionNode} 抽象语法树节点。 *

*/ public class CallParselet implements InfixParselet { @@ -31,6 +30,11 @@ public class CallParselet implements InfixParselet { List args = new ArrayList<>(); + // 获取当前 token 的行号和列号 + int line = ctx.getTokens().peek().getLine(); + int column = ctx.getTokens().peek().getCol(); + + // 解析函数调用参数 if (!ctx.getTokens().peek().getLexeme().equals(")")) { do { args.add(new PrattExpressionParser().parse(ctx)); @@ -38,7 +42,9 @@ public class CallParselet implements InfixParselet { } ctx.getTokens().expect(")"); // 消费并验证 ")" - return new CallExpressionNode(left, args); + + // 创建 CallExpressionNode 并传递位置信息 + return new CallExpressionNode(left, args, line, column); } /**