main() 函数需要初始化 bracket-lib ,描述期望创建的窗口类型以及游戏循环。初始化过程可能会失败,所以会返回 Result 类型。
Result 是Rust用来处理错误的标准方法。 Result 是一个枚举体——就像 Option 或者之前自己定义的枚举体一样。处理 Result 的方式主要有3种。
match my_result {
Ok (a)=> do_something_useful(a),
Err (a)=> handle_error(a),
}
Result 是一个枚举体——因此可以使用 match 语句来选择一个处理方式。
fn my_function() -> BError {
...
my_result()?;
}
通过 ? 操作符来把错误传递给父函数。
my_result.unwrap()
使用与 option 类型类似的 unwrap 方法——如果有错误出现,则会导致程序崩溃。
使用 unwrap 是最简单的方法,不过一旦有任何错误出现,程序就会崩溃。此外,如果代码中的很多函数都有潜在返回错误的可能性,那么充斥在代码中的 unwrap() 也会使得代码变得难以阅读。为每个可能失败的函数都使用 match 语句的做法同样会导致代码冗长且难以阅读。使用 ? 操作符可以大幅度简化代码并使其易于阅读,唯一要求是你编写的这个函数必须也返回 Result 类型。
bracket-lib 提供了一个名为 BError 的 Result 类型。把 main 函数的返回值改成 BError 类型就可以享受 ? 操作符带来的便利:
fn main() -> BError {
现在,你可以初始化 bracket-lib 了。这个库使用了 建造者模式 (builder pattern)——这是Rust中构建复杂对象时的一种惯用方法。建造者模式发挥了函数链式调用的优点,可以把很多个参数选项分散到独立的函数调用中,相比在单一函数中写很长的参数列表,建造者模式可以提供更具可读性的代码。
建造者模式的起点是一个返回建造者对象的起点构造函数。软件库通常会提供几个常用的起点构造函数。例如, bracket-terminal 提供了一个名为 simple80x50() 的起点构造函数,这是用得最频繁的一种显示模式。
后续对建造者对象的调用会将新的信息不断添加到建造请求中。例如, with_title() 可用于为窗口的标题栏添加文字, with_font() 可用于设置显示字体。
在完成描述所希望创建的对象以后,调用 build() 函数,这将会返回一个开发者希望得到的完整对象,或者返回一个错误。
下一步,将下面的代码添加到 main() 函数中,替换掉原来的 println! 语句:
❶ let context=BTermBuilder::simple80x50() ❷ .with_title("Flappy Dragon") ❸ .build()?;
❶ 以请求构造一个80×50大小的终端窗口作为起点。
❷ 请求将窗口的标题设置为“Flappy Dragon”。
❸ 调用 build() 函数来完成初始化,并且将返回的上下文对象存储到 context 变量中。之所以能够使用 ? 操作符是因为 main() 函数的返回值已经被改成了 BError 类型。
创建好终端窗口的实例后,你需要告诉 bracket-lib 开始执行游戏循环,并且将引擎和所定义的 State 类型变量关联起来,这样 bracket-lib 才能知道 tick() 函数位于哪里:
main_loop(context, State{})
在 main_loop() 函数调用的末尾不用加分号,因为它的返回值是一个 BError 类型的值。因为 main 函数的返回值和 main_loop() 函数的返回值类型相同,所以可以让Rust自动把子函数的结果作为当前函数的返回值。所有出现的错误都会被传递到 main 函数之外——这会导致程序崩溃并显示给定的错误信息。 main_loop 函数启动游戏循环,并且开始在每一帧中调用 tick() 函数。
使用 cargo run 命令运行这个项目,你会看到一个黑底白字的窗口显示着“Hello, Bracket Terminal!”,如图3-4所示。
图3-4
在使用标准输入、输出的程序中,使用 println! 命令可以打印出绝大多数的字符。但是 Bracket-lib 会把字符转换为sprite图形来进行渲染显示,因此只能使用有限的字符集。显示在屏幕上的一个个字符其实是一张张图片—— Bracket-lib 库会根据发送给它的字符找到对应的图片,这些字符由Codepage 437字符集定义。
默认情况下, bracket-lib 使用一种名为Codepage 437的字符集。它是DOS时代PC上的默认字体,并且常用于显示终端的输出。除了字母和数字,它还提供了一些可以用来表示简单游戏元素的符号。完整的字符集参见附录A。
评论 0条