Parle\Lexer::insertMacro()函数—用法及示例

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

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

用法：该函数用于向 Parle 词法分析器中插入一个宏定义。

参数：

1. $name (string)：宏的名称。
2. $definition (string)：宏的定义。

返回值：无返回值。

示例：

$lexer = new Parle\Lexer();

// 定义一个简单的宏
$macroName = 'MY_MACRO';
$macroDefinition = '/\d+/'; // 这个宏用于匹配数字

$lexer->insertMacro($macroName, $macroDefinition);

// 使用宏进行词法分析
$input = '12345';
$tokens = $lexer->tokenize($input);

foreach ($tokens as $token) {
    echo $token['name'] . ': ' . $token['value'] . "\n";
}

输出：

MY_MACRO: 12345

在上面的示例中，我们首先创建了一个 Parle 词法分析器对象 $lexer。然后，我们使用 insertMacro() 函数将一个名为 MY_MACRO 的宏插入到词法分析器中，该宏的定义是一个正则表达式 /\\d+/，用于匹配数字。接下来，我们使用 tokenize() 方法对输入字符串 '12345' 进行词法分析，得到一个包含词法单元的数组 $tokens。最后，我们遍历 $tokens 数组，并输出每个词法单元的名称和值。

需要注意的是，该函数需要 Parle 扩展的版本为 0.8.1 或更高版本。