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 постоянно используется для идентификаторов, имён и форматирования.

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 выводят целевой тип.

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

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

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

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

Приведения классов допустимы только между связанными типами. Приведения от производного к базовому бесплатны; приведения от базового к производному проверяют конкретный тип объекта во время выполнения и вызывают ошибку, если это не запрошенный тип или один из его подклассов. Приведение нулевого значения класса даёт null. Используйте value.#type когда выбираете поведение среди нескольких возможных производных типов, вместо того чтобы использовать неудачное приведение как проверку типа.

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

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

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

  • Запускайте игровой процесс по общей предсказанной ветке. Не вычисляйте игровое состояние только под is_local() или не защищайте его проверкой Game.is_server().

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

Последнее обновление