Parle\RParser::consume()函数—用法及示例

函数名称：Parle\RParser::consume()

适用版本：Parle\RParser v1.0.0 及以上版本

函数描述：该函数用于在解析器中消耗输入流中的字符，并根据已定义的语法规则执行语法分析。

用法示例：

// 创建解析器实例
$parser = new Parle\RParser();

// 设置语法规则
$parser->set_grammar($grammar);

// 设置输入流
$input = "1 + 2 * 3";
$parser->consume($input);

// 执行语法分析
$result = $parser->parse();

// 输出语法分析结果
var_dump($result);

说明：

1. 首先，我们需要创建一个 Parle\RParser 的实例对象。
2. 然后，我们需要使用 set_grammar() 方法来设置解析器的语法规则。语法规则可以通过 Parle\Grammar 对象或者类似BNF（巴科斯范式）的字符串来定义。
3. 接下来，我们需要准备输入流（字符串）。在示例中，我们使用了一个简单的数学表达式作为输入。
4. 最后，我们调用 consume() 方法，将输入流传递给解析器，使其开始消耗字符并执行语法分析。
5. 解析完成后，我们可以调用 parse() 方法来获取语法分析结果。在示例中，我们使用 var_dump() 函数将结果输出到浏览器控制台。

注意事项：

• 在调用 consume() 方法之前，必须先设置解析器的语法规则，否则将会抛出异常。
• consume() 方法可以多次调用，以便解析长字符串或多个输入流。
• 如果解析器遇到语法错误，将会抛出 Parle\Exception 异常。
• 请确保你已经正确安装了 Parle 扩展，并在代码中引入了相关的命名空间（use Parle\RParser）。