For the complete documentation index, see llms.txt. This page is also available as Markdown.

语言基础

CSL 的基本类型、枚举、结构体、类、引用和多态。

本页是 CSL 的“数据建模”部分:原始类型、结构体/类,以及你将用于干净地表示游戏状态的模式。

如果你是新手,先从 CSL 入门开始。本页假定你已经知道如何声明变量并编写 proc/method.

原始类型

数字和布尔值

  • 有符号整数: s8, s16, s32, s64 (别名: int == s64)

  • 无符号整数: u8, u16, u32, u64 (别名: uint == u64)

  • 浮点数: f32 (别名: float), f64

  • 布尔值: bool

health: int = 100;
speed: float = 6.5;
is_dead: bool = false;
opacity := .75; // 与 0.75 相同

当安全时,CSL 会自动提升数字:较小的有符号整数可以变成更宽的有符号整数,较小的无符号整数可以变成更宽的无符号整数,当目标能够容纳完整范围时,无符号整数可以变成有符号整数,并且 f32 可以变成 f64.

字符串

string 常用于 ID、名称和格式化。

item_id := "sword";
log_info("拾取了 %", {item_id});

first_name := "Ada";
last_name := "Lovelace";
full_name := first_name + " " + last_name;
full_name += "!";

字符串拼接既可用于运行时表达式,也可用于编译期常量。

向量

v2, v3, v4 是内置的数学/数据类型:

枚举

枚举非常适合用于可读性更好的“模式/状态”字段:

枚举值通常用简写 .VALUE 来引用,当编译器可以推断枚举类型时。

结构体(值类型)

对你想廉价拷贝的“纯数据”使用结构体(配置、小型状态块、描述符)。

结构体可以从其他结构体继承。复合字面量会先包含继承字段:

何时使用结构体

  • 一个描述符/配置对象(*_Desc)

  • 你想按值复制的小型、自包含状态

  • 要嵌入到其他类型中的数据

何时不要使用结构体

  • 跨多个系统共享的大型可变状态(使用类)

  • “身份”对象(玩家、物品、长生命周期对象)(使用类)

类(引用类型)

类是引用类型。使用 new(...).

继承

你可以从其他结构体/类继承:

派生类会继承默认字段值。它们可以在类体中通过 field = value 在类体中:

每个派生类都有一个只读的 base 字段,它将同一对象视为其直接父类型。当派生方法覆盖了同名父方法,并且需要显式选择父方法时使用它:

CSL 的方法不是虚函数。接收者的静态类型决定方法查找从哪里开始;基类型的值永远不会调用仅在其派生运行时类型上声明的同名方法。

数组、切片和动态数组

你会看到三种常见形态:

  • 固定数组: [N]T (编译期大小)

  • 切片 / 托管数组: []T (数组视图)

  • 动态数组: [..]T (可调整大小的列表)

示例:

完整指南见 数组与集合.

按引用传递(ref)

如果过程需要修改一个值,使用 ref:

这对于逐步裁剪/缩小矩形的“布局式” API 尤其有用:

类型转换

使用 expr.(T) 或 cast(T)expr:

当目标类型已经已知时, expr.() 和 cast expr 会推断目标类型。

类型多态(泛型风格过程)

CSL 支持使用 $ 在调用点推断类型的多态过程:

类型作为值(typeid)

typeid 是一个在运行时和/或用于多态调用时表示一种类型的值:

类转换只在相关类型之间有效。从派生到基类的转换是免费的;从基类到派生类的转换会验证对象的具体运行时类型,如果它不是请求的类型或其子类之一就会抛出异常。转换空类值会产生空值。使用 value.#type 当你要在多个可能的派生类型之间选择行为时,不要把失败的转换当作类型测试。

实用建模指南

  • 每个玩家的状态都放在 Player. 如果它应该因玩家而异,那它就不该是全局的。

  • 描述符优先使用小结构体 并将运行时状态存储在类/组件中。

  • 在共享的预测路径中运行游戏逻辑。 不要只在 is_local() 或者用 Game.is_server().

关于玩家特定模式,请参见 添加玩家逻辑. 关于世界的 ECS 侧,请参见 实体与组件.

最后更新于