Основы языка

Для целей этой документации мы используем термины CSL и окружение выполнения/платформу взаимозаменяемо

Эта страница — сторона CSL, посвящённая «моделированию данных»: примитивы, struct/классы и шаблоны, которые вы будете использовать для чистого представления состояния игры.

Если вы совсем новичок, начните с Начало работы с CSL. Эта страница предполагает, что вы уже умеете объявлять переменные и писать proc/method.

Примитивные типы

Числа и булевы значения

• Знаковые целые: s8, s16, s32, s64 (псевдоним: int == s64)

• Беззнаковые целые: u8, u16, u32, u64 (псевдоним: uint == u64)

• Вещественные: f32 (псевдоним: float), f64

• Булевы: b8 (псевдоним: bool), b16, b32, b64

health: int = 100;
speed: float = 6.5;
is_dead: bool = false;

Строки

string используется постоянно для идентификаторов, имён и форматирования.

item_id := "sword";
log_info("picked up %", {item_id});

Векторы

v2, v3, v4 — встроенные математические/типовые данные:

pos: v2 = {10, 20};
color: v4 = {1, 0, 0, 1};

Перечисления

Перечисления отлично подходят для читаемых полей «режим/состояние»:

Game_Phase :: enum {
    LOBBY;
    RUNNING;
    POST_GAME;
}

phase := Game_Phase.LOBBY;

if phase == .RUNNING {
    // ...
}

Значения перечислений часто ссылаются с сокращением .VALUE когда компилятор может вывести тип перечисления.

Structs (значимые типы)

Используйте struct для «простых данных», которые вы хотите копировать дешево (конфиги, небольшие фрагменты состояния, дескрипторы).

Damage_Desc :: struct {
    amount: int;
    knockback: v2;
}

hit := Damage_Desc{amount=10, knockback={2, 1}};

Когда использовать struct

• Объект-дескриптор/конфигурация (*_Desc)

• Небольшое, самостоятельное состояние, которое вы хотите копировать по значению

• Данные, которые вы хотите вложить внутрь другого типа

Когда не следует использовать struct

• Большое изменяемое состояние, разделяемое между несколькими системами (используйте класс)

• Объекты «идентичности» (игроки, предметы, долгоживущие объекты) (используйте класс)

Классы (ссылочные типы)

Классы — это ссылочные типы. Создавайте экземпляры с помощью new(...).

Enemy :: class {
    health: int;
    target: v2;
}

e := new(Enemy);
e.health = 50;
e.target = {0, 0};

Наследование

Вы можете наследоваться от других struct/классов:

Weapon_Definition :: class {
    id: string;
    name: string;
}

Gun_Definition :: class : Weapon_Definition {
    fire_rate: float;
}

Используйте наследование, когда есть реальное отношение «является-как». Для большинства игровых данных композиция (поля) проще и легче в сопровождении.

Массивы, срезы и динамические массивы

Вы увидите три распространённых формы:

• Фиксированные массивы: [N]T (размер во время компиляции)

• Срезы / управляемые массивы: []T (вид на массив)

• Динамические массивы: [..]T (изменяемый список)

Пример:

spawn_points: [4]v2 = {{0,0}, {5,0}, {0,5}, {5,5}};

alive_enemy_ids: [..]int;
alive_enemy_ids->append(123);
alive_enemy_ids->append(456);

Для полного руководства см. Массивы и коллекции.

Передача по ссылке (ref)

Если процедуре нужно изменить значение, используйте ref:

apply_damage :: proc(health: ref int, amount: int) {
    health -= amount;
}

hp := 100;
apply_damage(ref hp, 10);

Это особенно полезно для API в «стиле макета», которые поэтапно отсекают/уменьшают прямоугольник:

draw_panel :: proc(rect: ref Rect) {
    header := rect->cut_top(50);
    draw_header(header);
    // rect теперь оставшаяся область для содержимого
}

Приведение типов

Используйте expr.(T):

f := 12.7;
i := f.(int);    // 12
f2 := i.(float); // 12.0

Полиморфизм типов (процедуры в стиле generics)

CSL поддерживает полиморфные процедуры, используя $ для вывода типов в точке вызова:

min :: proc(a: $T, b: T) -> T {
    if a < b return a;
    return b;
}

a := min(10, 20);       // T == int
b := min(1.25, 3.5);    // T == float

Типы как значения (typeid)

typeid — это значение, представляющее тип во время выполнения и/или для полиморфных вызовов:

default_of :: proc($T: typeid) -> T {
    t: T;
    return t;
}

zero := default_of(int);
empty := default_of(string);

Практические рекомендации по моделированию

• Состояние, специфичное для игрока, хранится в Player. Если оно должно различаться между игроками, оно не должно быть глобальным.

• Отдавайте предпочтение небольшим struct для дескрипторов и храните состояние во время выполнения в классах/компонентах.

• Сохраняйте авторитетность данных на сервере. Если это влияет на геймплей, не вычисляйте это только на клиенте.

Для шаблонов, специфичных для игрока, см. Добавление логики игрока. Для стороны ECS см. Сущности и компоненты.