Файлы сценариев Kwave

Общая структура

Сценарий Kwave содержит список строк, в котором каждая строка может быть:

  • одной командой,

  • списком команд, объединённых символом «;»,

  • комментарием,

  • отметкой,

  • либо пустой строкой, содержащей только пробел.

Комментарии и пустые строки

Все символы после «#» (за исключением тех, которые используются в кавычках или при выделении) рассматриваются как комментарии и будут игнорироваться.

Строки, содержащие только пробелы или комментарии, также игнорируются.

Завершение

Сценарий Kwave завершается либо после успешного выполнения всех команд без ошибок, либо после того, как команда выдаёт код ошибки. Специальной команды для прекращения выполнения сценария не существует. Если требуется реализовать возможность завершить сценарий, возможно использовать команду «msgbox(текст)». Это отобразит окно сообщения с двумя кнопками OK (которая позволит сценарию продолжить работу) и Отмена (которая выдаёт код ошибки и останавливает сценарий).

Отметки

Строки, состоящие только из идентификатора, за которым следует символ «:», считаются отметками. На них впоследствии можно будет ссылаться в сценарии с помощью специального ключевого слова GOTO [2] , что позволяет продолжать выполнение сценария с позиции этой отметки (смотрите пример ниже).

Строка с отметкой не должна ничего содержать (кроме комментариев или пробелов) после «:».

Пример:

start:  # <= это отметка
                    # какое-то действие...
                    msgbox(ещё раз?)
                    GOTO start
        



[2] Примечание: Не следует путать ключевое слово «GOTO» с текстовой командой «goto (позиция)» !