语言基础
CSL 的基本类型、枚举、结构体、类、引用和多态。
本页是 CSL 的“数据建模”部分:原始类型、结构体/类,以及你将用于干净地表示游戏状态的模式。
原始类型
数字和布尔值
有符号整数:
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 是内置的数学/数据类型:
枚举
枚举非常适合用于可读性更好的“模式/状态”字段:
结构体(值类型)
对你想廉价拷贝的“纯数据”使用结构体(配置、小型状态块、描述符)。
结构体可以从其他结构体继承。复合字面量会先包含继承字段:
何时使用结构体
一个描述符/配置对象(
*_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().
最后更新于