Файли скриптів Kwave

Загальна структура

Скрипт Kwave складається зі списку рядків, де кожним з рядків може бути:

  • окремою командою,

  • списком команд, де дві або більше команди з’єднано символом «;».

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

  • міткою

  • або порожнім рядком, у якому містяться лише пробіли.

Коментарі і порожні рядки

Усі символи після «#» (окрім випадку, коли цей символ взято у лапки або екрановано) вважаються коментарями, їх буде проігноровано без попередження.

Рядки, у яких містяться лише пробіли або коментарі, також буде проігноровано.

Переривання

Скрипт Kwave перериває роботу або після успішного, без помилок виконання усіх команд, або після повернення командним рядком коду помилки. Спеціальної команди для переривання виконання скрипту не передбачено. Якщо вам хочеться реалізувати можливість переривання скрипту користувачем, ви можете скористатися командою «msgbox(текст)». Ця команда відкриває вікно повідомлення з двома кнопками Гаразд (яка надає змогу продовжити виконання скрипту) і Скасувати (яка повертає код помилки і зупиняє виконання скрипту).

Позначки

Рядки, які складаються лише з ідентифікатора з наступним символом «:», вважаються мітками. На мітки можна згодом посилатися у скрипті за допомогою спеціального ключового слова «GOTO» [2], яке призводить до продовження виконання скрипту з позиції мітки (див. приклад, наведений нижче).

Рядок, що містить мітку, не повинен містити жодних даних (окрім коментарів або пробілів) після «:».

Приклад:

start:  # <= це мітка
                    # щось робимо...
                    msgbox(ще раз?)
                    GOTO start
        



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