блочно > Генератор кода

Класс CodeGenerator

Класс генератора кода, который переводит блоки на язык.

Подпись:

export declare class CodeGenerator 

Конструкторы

Конструктор Модификаторы Описание
(конструктор)(имя) Создает новый экземпляр класса CodeGenerator .

Характеристики

Свойство Модификаторы Тип Описание
COMMENT_WRAP число Максимальная длина комментария перед переносом. Не учитывает уровень отступов.
определения_ protected { [ключ: строка]: строка; } Словарь определений, который будет напечатан перед кодом.
forBlock Запись<строка, (блок: Блок , генератор: это) => [строка, число] | строка | ноль>

Словарь функций генератора блоков, сгруппированный по типу блока. Каждая функция генератора блоков принимает два параметра:

- Блок для генерации кода и - вызывающий экземпляр CodeGenerator (или подкласса), чтобы функция могла вызывать методы, определенные ниже (например, BlockToCode) или в соответствующем подклассе (например, JavascripGenerator),

и возвращает:

- кортеж [код, приоритет] (для блоков значений/выражений), или - строка, содержащая сгенерированный код (для блоков операторов), или - значение null, если для блока не должен быть выдан код.

FUNCTION_NAME_PLACEHOLDER_ нить Используется в качестве заполнителя в функциях, определенных с помощью CodeGenerator.provideFunction_. Это не должен быть допустимый код, который может законно появиться в определении функции (или комментарии), и он не должен сбивать с толку анализатор регулярных выражений.
FUNCTION_NAME_PLACEHOLDER_REGEXP_ Регэксп
имена функций_ protected { [ключ: строка]: строка; } Словарь, сопоставляющий желаемые имена функций в определениях с фактическими именами функций (чтобы избежать конфликтов с пользовательскими функциями).
ОТступ нить Метод отступа. По умолчанию используется два пробела, но генераторы языка могут переопределить это, чтобы увеличить отступ или перейти на табуляцию.
INFINITE_LOOP_TRAP строка | нулевой Произвольный код для внедрения в места, которые могут вызвать бесконечные циклы. Любые экземпляры «%1» будут заменены идентификатором блока, в котором произошел сбой. Например checkTimeout(%1);\n
isInitialized логическое | нулевой Был ли вызван метод init. Генераторы, которые устанавливают для этого флага значение false после создания и значение true в init, заставят блокToCode выдать предупреждение, если генератор не был инициализирован. Если этот флаг не трогать, он не будет иметь никакого эффекта.
имя_ нить
имяDB_? Имена (Необязательно) База данных имен переменных и процедур.
ORDER_OVERRIDES число[][] Список пар внешний-внутренний, для которых НЕ требуются круглые скобки.
RESERVED_WORDS_ protected нить Список зарезервированных слов, разделенных запятыми.
STATEMENT_PREFIX строка | нулевой Произвольный код для внедрения перед каждым оператором. Любые экземпляры «%1» будут заменены идентификатором блока инструкции. Например, highlight(%1);\n
STATEMENT_SUFFIX строка | нулевой Произвольный код для внедрения после каждого оператора. Любые экземпляры «%1» будут заменены идентификатором блока инструкции. Например, highlight(%1);\n

Методы

Метод Модификаторы Описание
addLoopTrap(ветвь, блок) Добавьте ловушку бесконечного цикла к содержимому цикла. Добавьте суффикс инструкции в начале блока цикла (сразу после выполнения инструкции цикла) и префикс инструкции в конце блока цикла (сразу перед выполнением инструкции цикла).
addReservedWords(слова) Добавьте одно или несколько слов в список зарезервированных слов для этого языка.
allNestedComments (блок) Рекурсивно просматривайте дерево блоков, возвращая все их комментарии.
blockToCode (блок, opt_thisOnly) Сгенерировать код для указанного блока (и прикрепленных блоков). Генератор должен быть инициализирован перед вызовом этой функции.
закончить (код) Перехватчик для запуска кода в конце генерации кода. Подклассы могут переопределить это, например, добавив к сгенерированному коду операторы импорта или определения переменных.
getProcedureName (имя) Получает уникальное допустимое имя для определяемой пользователем процедуры. Перед вызовом этого метода свойство nameDB_ класса должно быть уже инициализировано. Обычно это делается в функции init класса генератора кода.
getVariableName(nameOrId) Получает уникальное допустимое имя для определяемой пользователем переменной. Перед вызовом этого метода свойство nameDB_ класса должно быть уже инициализировано. Обычно это делается в функции init класса генератора кода.
инициализация (_workspace) Перехватчик для запуска кода до начала генерации кода. Подклассы могут переопределить это, например, для инициализации базы данных имен переменных.
injectId (сообщение, блок) Вставьте идентификатор блока в сообщение, чтобы заменить «%1». Используется для STATEMENT_PREFIX, STATEMENT_SUFFIX и INFINITE_LOOP_TRAP.
prefixLines(текст, префикс) Добавьте общий префикс к каждой строке кода. Предназначен для отступов кода или добавления маркеров комментариев.
обеспечитьФункция_(желаемоеИмя, код)

Определите определяемую разработчиком функцию (а не определяемую пользователем процедуру), которая будет включена в сгенерированный код. Используется для создания частных вспомогательных функций. При первом вызове с заданным желаемым именем код сохраняется и генерируется фактическое имя. Последующие вызовы с тем же желаемым именем не имеют никакого эффекта, но имеют то же возвращаемое значение.

Вызывающая сторона должна убедиться, что одно и то же желаемое имя не используется для разных вспомогательных функций (например, используйте «colorRandom» и «listRandom», а не «random»). Нет опасности столкновения с зарезервированными словами, именами пользовательских переменных или процедур.

Код получает вывод при вызове CodeGenerator.finish().

Scrub_(_block, code, _opt_thisOnly) Общие задачи по генерации кода из блоков. Это вызывается из blockToCode и вызывается для каждого блока, а не только для блоков верхнего уровня. Подклассы могут переопределить это, например, для генерации кода для операторов, следующих за блоком, или для обработки комментариев для указанного блока и любых связанных блоков значений.
скрабNakedValue (строка) Голые значения — это блоки верхнего уровня с выходами, которые ни к чему не подключены. Подклассы могут переопределить это, например, если их язык не допускает голых значений.
операторToCode(блок, имя) Сгенерируйте строку кода, представляющую блоки, прикрепленные к входным данным именованного оператора. Сделайте отступ в коде. В основном используется в генераторах. При попытке сгенерировать код для оценки обратите внимание на использование WorkspaceToCode или BlockToCode.
valueToCode (блок, имя, внешний порядок) Сгенерируйте код, представляющий указанное входное значение.
WorkspaceToCode (рабочая область) Сгенерируйте код для всех блоков в рабочей области на указанном языке.