需要注意的是

1. 所有定义 必须 位于 BEGIN 和 END 之间
2. 所有定义 必须 按照它们在源代码中声明的顺序进行定义
3. 所有定义 必须 由单个分号隔开
4. 在 RAP 定义中的每个字段 必须 由空格隔开

运行 view_examples.sh 一次后，我们应该有以下的文件结构

string_from_move_print
├── input
│   └── annotated_source.rs
├── main.rs
└── source.rs

接下来，我们使用 ExternalEvent 注释代码，以描述 Rust 的移动、借用和丢弃语义。在 string_from_move_print 中，我们有四个这样的事件

1. 资源从 String::from() 移动到 x
2. 资源从 y 移动到 x
3. 与 x 绑定的资源丢弃
4. 与 y 绑定的资源丢弃

我们可以在结构化注释中指定事件，如下所示

/* --- BEGIN Variable Definitions ---
Owner x; Owner y;
Function String::from();
 --- END Variable Definitions --- */
fn main() {
    let x = String::from("hello"); // !{ Move(String::from()->x) }
    let y = x; // !{ Move(x->y) }
    println!("{}", y); // print to stdout!
} /* !{
    GoOutOfScope(x),
    GoOutOfScope(y)
} */

每个事件都定义在其发生的那一行，并在 !{ 和 } 定界符内。

事件可以在块注释中注释；然而，块 必须 从事件发生的行开始。此外，在 !{} 定界符内的事件 必须 由单个逗号隔开，并且每个都必须遵循以下格式

ExternalEvents Usage:
    Format: <event_name>(<from>-><to>)
        e.g.: // !{ PassByMutableReference(a->Some_Function()), ... }
    Note: GoOutOfScope and InitRefParam require only the <from> parameter
        e.g.: // !{ GoOutOfScope(x) }

有关可用的 ExternalEvent 的列表，请参阅 附录。

好了！剩下的只是运行程序。只需导航到 src 并运行

cargo run string_from_move_print

现在您的文件夹应该看起来像这样

string_from_move_print
├── input
│   └── annotated_source.rs
├── main.rs
├── source.rs
├── vis_code.svg
└── vis_timeline.svg

恭喜！您已成功生成了您的第一个可视化！最后一步，将您的示例名称添加到 view_examples.sh 下的 targetExamples，然后从 rustviz_mdbook 运行脚本，在浏览器中查看。

附录

ExternalEvent 使用

注意

1. GoOutOfScope、InitRefParam 和 InitOwnerParam 需要一个在 变量定义 部分之前定义的单个参数。（例如：// !{ GoOutOfScope(x) }）
2. 所有其他事件都需要两个参数，a 和 b，它们可以是已定义的（例如：Owner a）或未定义的（None）。