Skip to content

Latest commit

 

History

History
79 lines (59 loc) · 4.74 KB

README.md

File metadata and controls

79 lines (59 loc) · 4.74 KB

sysu-lexer

实验描述

在本次词法分析实验中,你被希望完成一个词法分析器,产生与 clang -cc1 -dump-tokens 2>&1 相当的内容。预期的代码行数为 200 行,预期的完成时间为 2 小时 ~ 6 小时。

$ ( export PATH=~/sysu/bin:$PATH \
  CPATH=~/sysu/include:$CPATH \
  LIBRARY_PATH=~/sysu/lib:$LIBRARY_PATH \
  LD_LIBRARY_PATH=~/sysu/lib:$LD_LIBRARY_PATH &&
  clang -E tester/functional/000_main.sysu.c |
  clang -cc1 -dump-tokens 2>&1 )
int 'int'        [StartOfLine]  Loc=<tester/functional/000_main.sysu.c:1:1>
identifier 'main'        [LeadingSpace] Loc=<tester/functional/000_main.sysu.c:1:5>
l_paren '('             Loc=<tester/functional/000_main.sysu.c:1:9>
r_paren ')'             Loc=<tester/functional/000_main.sysu.c:1:10>
l_brace '{'             Loc=<tester/functional/000_main.sysu.c:1:11>
return 'return'  [StartOfLine] [LeadingSpace]   Loc=<tester/functional/000_main.sysu.c:2:5>
numeric_constant '3'     [LeadingSpace] Loc=<tester/functional/000_main.sysu.c:2:12>
semi ';'                Loc=<tester/functional/000_main.sysu.c:2:13>
r_brace '}'      [StartOfLine]  Loc=<tester/functional/000_main.sysu.c:3:1>
eof ''          Loc=<tester/functional/000_main.sysu.c:3:2>

可以发现,clang -cc1 -dump-tokens 2>&1 输出的每一行包含:

  1. (一个)有效 token。
  2. (一个)由单引号包裹的匹配串。
  3. (若干)识别上一个有效 token 到这个有效 token 间遇到的无效 token。
  4. (一个)有效 token 的位置。

本目录下提供了一个基于 flex 实现的模板,你可以基于此继续实现完整的逻辑,也可以使用其他的工具实现,如 antlr4,但不得使用其提供的 C 语言模板;也不得使用任何封装好的库直接获得 token,如 libclang

评分规则

本实验的评分分为两部分:基础部分和挑战部分。

  • 对于基础部分的实验,由低到高分别给出三档实验要求,并要求通过对应的自动评测。详见自动评测细则一节。
  • 对于挑战部分的实验,你可以完成挑战方向一节的要求,也可以自行探索;如果可能,请同时编写对应的自动评测脚本。助教将按照你实现的难度给出评分。

如有疑问,参照 clang -cc1 -dump-tokens 2>&1。你需要提交一份实验报告,简要记录你的实验过程、遇到的难点以及解决的方法,并在报告中附上自动评测的结果。

自动评测细则

本次实验的评测项目为 lexer-[0-3]lexer-0 仅用于证明模板(代码与评测脚本)可以正确工作,不计入成绩;其他三个评测项依次检查:

  1. sysu-lexer 是否提取出正确的 token(60 分)。
  2. sysu-lexer 是否提取出正确的 token location(30 分)。
  3. sysu-lexer 是否识别其他无关字符(10 分)。

评测脚本忽略空白符,可以查看评测脚本以了解检查算法,但不得修改评测逻辑而投机取巧。你也可以像这样调用评测脚本,单独执行其中某一个评测项。

( export PATH=~/sysu/bin:$PATH \
  CPATH=~/sysu/include:$CPATH \
  LIBRARY_PATH=~/sysu/lib:$LIBRARY_PATH \
  LD_LIBRARY_PATH=~/sysu/lib:$LD_LIBRARY_PATH &&
  sysu-compiler --unittest=lexer-1 "**/*.sysu.c" )

挑战方向

本节给出一些挑战方向供参考。

  1. 扩展更多 C 语言的 token。
  2. 不借助 flex,并完全使用 SYsU 完成本实验,然后用它作为输入测试功能是否正确,以实现自举。
    • 提示:如果你不知道如何下手的话,仔细回忆老师上课所讲的内容,尤其是正则文法与有限自动机(FA)的等价性
  3. 借助 libclang 实现相同的功能。
  4. 改进这个实验模板(欢迎 PR!)。
  5. Do what you want to do。

你可能会感兴趣的