Rant3项目教程：深入理解Rant模板参数传递机制-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00405/article/details/148756026

Rant3项目教程：深入理解Rant模板参数传递机制

引言

在文本生成领域，Rant3作为一个强大的模板引擎，提供了灵活的参数传递机制。本文将深入探讨Rant3中的参数传递技术，帮助开发者更好地利用这一特性实现动态文本生成。

Rant参数基础概念

Rant3允许在运行程序时传递命名参数，这些参数在模板范围内可以像临时变量一样使用。这种机制特别适合游戏开发场景，开发者可以将游戏状态信息（如玩家生命值、任务状态、天气等）直接传递给模板，使生成的文本能够根据游戏状态动态调整。

参数传递的三种方法

方法一：键值对直接传递

这是最基础也是最直接的方法，通过创建RantProgramArgs实例并添加键值对来实现。

// 创建Rant引擎实例
var rant = new RantEngine();

// 编译模板字符串
var pgm = RantProgram.CompileString(@"Hello, [in:name]!");

// 创建参数对象并添加参数
var rargs = new RantProgramArgs();
rargs["name"] = "Nicholas";

// 执行模板并输出结果
var output = rant.Do(pgm, args: rargs);
Console.WriteLine(output);
// 输出: "Hello, Nicholas!"

技术要点：

RantProgramArgs是参数容器类
使用索引器语法添加参数
模板中使用[in:参数名]访问参数

方法二：对象属性映射

更面向对象的方式是通过自定义类属性映射生成参数，可以使用RantArgAttribute特性自定义参数名。

定义数据模型类：

class Person
{
    [RantArg("first-name")]  // 自定义参数名
    public string FirstName { get; }
    
    [RantArg("last-name")]   // 自定义参数名
    public string LastName { get; }
    
    [RantArg("age")]         // 基本类型自动转换
    public int Age { get; }

    public Person(string firstName, string lastName, int age)
    {
        FirstName = firstName;
        LastName = lastName;
        Age = age;
    }
}

模板设计：

My name is [in:first-name] [in:last-name], and I'm\s
[if:[lt:[in:age];100];[in:age];ridiculously old].

使用示例：

var rant = new RantEngine();
var pgm = RantProgram.CompileFile("person-template.rant");

// 创建不同参数实例
var person1Args = new RantProgramArgs(new Person("Jimmy", "Dipstick", 33));
var person2Args = new RantProgramArgs(new Person("Old", "Jenkins", 102));

// 输出不同结果
Console.WriteLine(rant.Do(pgm, args: person1Args));
Console.WriteLine(rant.Do(pgm, args: person2Args));

/*
输出:
My name is Jimmy Dipstick, and I'm 33.
My name is Old Jenkins, and I'm ridiculously old.
*/

技术优势：

强类型数据模型
属性到参数的自动映射
支持自定义参数命名
适合复杂数据结构

方法三：匿名对象快速传递

对于简单场景，可以使用匿名对象快速创建参数，这是最简洁的方式。

数学运算模板：

[case:sentence]
[numfmt:verbal;[n:[in:a]]]\s
plus [numfmt:verbal;[n:[in:b]]]\s
equals [numfmt:verbal;[add:[in:a];[in:b]]].

使用示例：

var rant = new RantEngine();
var pgm = RantProgram.CompileFile("math-template.rant");

// 使用匿名对象直接创建参数
Console.WriteLine(rant.Do(pgm, args: new RantProgramArgs(new{ a = 12, b = 26 })));

// 输出: Twelve plus twenty-six equals thirty-eight.

适用场景：

快速原型开发
简单参数传递
临时性参数需求

高级应用技巧

参数类型转换

Rant3会自动处理基本类型的转换：

数值类型(int, float等)自动转换为Rant可识别的数值
布尔值转换为true/false
字符串直接使用

动态参数更新

在实际应用中，可以动态更新参数并重新执行模板：

var args = new RantProgramArgs();
args["score"] = 100;

// 第一次执行
Console.WriteLine(rant.Do(pgm, args));

// 更新参数后再次执行
args["score"] = 200;
Console.WriteLine(rant.Do(pgm, args));