PegJS 是一种用于构建解析器的解析表达式语言。ts-pegjs 是一个 PegJS 解析器生成器,它使用 TypeScript 语言来构建解析器。ts-pegjs 生成的解析器是类型安全的,并且在编译时就能发现错误。在本教程中,我们将学习如何使用 ts-pegjs 解析表达式。
安装和配置
ts-pegjs 可以使用 NPM 包管理器进行安装,如下所示:
--- ------- -- --------
这将安装 ts-pegjs 并将其添加到全局 npm 工具库中。接下来,您可以按照以下步骤将 ts-pegjs 添加到您的项目中:
- 创建一个新的文件夹来存储您的解析器项目。
- 在命令行中导航到该文件夹,然后运行以下命令:
--- ----
该命令将创建一个 package.json 文件,这是一个 npm 项目的配置文件。您可以根据需要配置项目信息。
- 然后,安装 ts-pegjs 和其 TypeScript 插件:
--- ------- -------- ---------- ----------- ----------
使用 ts-pegjs
使用 ts-pegjs 构建解析器的步骤如下:
- 创建一个 *.peg.ts 文件。这是您的 PEG 文法输入文件。
- 在该文件中定义您的语法和语义规则。
- 运行 ts-pegjs,将输入文件转换为 TypeScript 解析器文件。
- 将 TypeScript 解析器文件添加到您的项目中,并使用解析器来解析输入文本。
示例
让我们使用 ts-pegjs 构建一个解析器,该解析器可以在输入字符串中查找数字,并返回所有找到的数字。我们将定义一个名为 NumberScanner 的类,该类具有如下方法:
------ - -- --- ---- ----------- ----- ------------- - ------- ------- ----------- ------------- - -- ---- --- ------ ----- --- ------- ------ -- --- --- ------ ----------- - -------------- ----- - ------- ------ - ------ -- - ------- -------- --- - ------ ----------- -------- -------- - ------ ------------------------- - -
我们的解析器由 start 和 number 两个规则组成。 start 规则表示从输入文本的开头开始查找数字,并且可以找到任意多个数字。 number 规则表示如何查找一个数字。
在构造函数中,我们使用 ts-pegjs 的 generate 方法将 PEG 文法字符串转换为 TypeScript 代码。 output: "source" 参数告诉 ts-pegjs 生成的代码是字符串格式,而不是编译后的 JavaScript 文件。
最后,我们定义了一个 scan 方法来调用解析器并返回所有找到的数字。现在,我们可以使用以下代码来生成解析器并测试它:
--- ------- - --- ---------------- --- ------ - ----------------- --- ------ -------------------- -- ------- ----- ---- ----
这会在控制台输出所有找到的数字。在输入文本中找到的数字将作为数字数组返回。
使用语义动作
PEG 文法不仅仅是找到模式的方法。我们可以在规则中嵌入 TypeScript 代码片段,以便在找到模式时执行特定的操作。让我们再来一个示例,添加一些语义动作:
----- ----------------- - ------- ------- ----------- ------------- - -- ---- --- ------ ----- --- ------- ------ -- --- --- ------ ----------- - -------------- ----- - -------- -------- - ------------------- - -------- - ---- - ---------------------- - --- ------ - ----- --- ---- - - -- - - ------------- ---- - -- ------------------- --- ---- - ------ -- ------------------ - ---- - ------ -- ------------------ - - ------ ------- - -------------- - ------------ - -------- - ---- - --------------- - --- ------ - ----- --- ---- - - -- - - ------------- ---- - -- ------------------- --- ---- - ------ -- ------------------ - ---- - ------ -- ------------------ - - ------ ------- - ------- - ------ - --- - ----------------- - --- - ------ --------- - ------ - ---- ------ - ------ ---------------- --- - ----------------- --- --- - -- - --- - - - - -------- -- - ------- -------- --- - ------ ------------ -------- ------ - ------ ------------------------- - -
这是一个简单的计算器解析器,用于解析基本算术表达式。相比于上一个示例,我们添加了一个 additive 规则,在该规则中进行了语义操作。
在 additive 规则中,我们为了了解要执行什么操作,使用了两个 JavaScript 变量:left 和 right。左和右是我们使用语法解析器找到的左和右表达式。接下来,我们遍历所有右表达式,并根据加号或减号对左侧进行相应的算术运算。最后,我们返回结果值。
总结
在本教程中,我们介绍了 ts-pegjs,并详细讲解了如何使用它来构建 TypeScript 解析器。我们学习了如何定义 PEG 文法和语义规则,如何运行 ts-pegjs 生成 TypeScript 代码,并如何使用代码来解析输入文本。
我们还了解了如何在规则中添加语义操作,这使得我们可以执行特定的操作而不仅仅是找到模式。这些操作可以将解析器转换为一个有用的工具,用于解析输入文本并执行复杂的操作。
来源:JavaScript中文网 ,转载请联系管理员! 本文地址:https://www.javascriptcn.com/post/5eedc3b2b5cbfe1ea0612145