[函数]Parle\RLexer::insertMacro()函数—用法及示例

函数名：Parle\RLexer::insertMacro()

适用版本：Parle 0.7.1 及以上版本

用法：Parle\RLexer::insertMacro() 函数用于向词法分析器中插入宏定义。宏定义是一种将特定的输入序列替换为指定的输出序列的规则。通过插入宏定义，可以在词法分析过程中对输入进行预处理，从而简化后续的词法分析工作。

参数：

1. $symbol (string)：宏定义的名称。
2. $expansion (string)：宏定义的替换序列。

示例：

// 创建词法分析器
$lexer = new Parle\RLexer();

// 插入宏定义
$lexer->insertMacro('VERSION', '1.0');
$lexer->insertMacro('GREETING', 'Hello, world!');
$lexer->insertMacro('MULTIPLY', '2 * 3');

// 使用插入的宏定义
$input = 'The current version is VERSION.';
$input = $lexer->expandMacros($input);
echo $input; // 输出：The current version is 1.0.

$input = 'Say GREETING.';
$input = $lexer->expandMacros($input);
echo $input; // 输出：Say Hello, world!.

$input = '2 * 3 equals MULTIPLY.';
$input = $lexer->expandMacros($input);
echo $input; // 输出：2 * 3 equals 6.

注意事项：

• 插入的宏定义可以是任意字符串，可以包含变量、函数调用等。
• 插入的宏定义会在词法分析过程中被替换为对应的替换序列。
• 可以使用 Parle\RLexer::expandMacros() 方法对输入进行宏展开，得到替换后的结果。
• 插入的宏定义仅在当前的词法分析器对象中有效，不会影响其他词法分析器对象。
• 如果需要移除已插入的宏定义，可以使用 Parle\RLexer::removeMacro() 方法。