Коди O

O-коди забезпечують контроль потоку в NC-програмах. Кожен блок має відповідний номер, який використовується після O. Необхідно ретельно підбирати O-номери. O-коди використовують букву «O», а не цифру нуль як перший символ у номері, наприклад O100 або o100. O-коди також іноді називають o-словами, і ці терміни є взаємозамінними.

There are two categories of o-codes with different scoping rules:

Subroutine definitions (sub/endsub, call) are global. Each subroutine must have a unique number or name across the entire program and all called files.

Control flow (if/endif, while/endwhile, do/while, repeat/endrepeat, break, continue) are local to the subroutine or main program where they appear. The interpreter automatically scopes them, so o100 if inside o<helper> does not conflict with o100 if in the main program or in any other subroutine. You can safely reuse the same o-numbers for control flow in different subroutines.

Within a single subroutine body (or the main program), each o-number should still be used for only one control flow block.

Коментарі в тому ж рядку, що й слово на літеру «о», не слід використовувати, оскільки така поведінка може змінитися в майбутньому.

Поведінка невизначена, якщо:

Підпрограми починаються з oNNN sub і закінчуються oNNN endsub. Рядки між oNNN sub і oNNN endsub не виконуються, поки підпрограма не буде викликана за допомогою oNNN call. Кожна підпрограма повинна використовувати унікальний номер.

Див. розділи G53, G0 та M2 для отримання додаткової інформації.

Всередині підпрограми можна виконати o-return. Це негайно повертає викликаючу програму, так само, як якщо б було виявлено o-endsub.

Див. розділи Бінарні оператори та Параметри для отримання додаткової інформації.

o- Call приймає до 30 необов’язкових аргументів, які передаються до підпрограми як #1, #2 , …, #N. Параметри від #N+1 до #30 мають те саме значення, що і в контексті виклику. Після повернення з підпрограми значення параметрів від #1 до #30 (незалежно від кількості аргументів) будуть відновлені до значень, які вони мали до виклику. Параметри #1 - #30 є локальними для підпрограми.

Оскільки 1 2 3 розбирається як число 123, параметри мають бути взяті в квадратні дужки. Наступна команда викликає підпрограму з 3 аргументами:

Subroutine definitions may not be nested. Defining a subroutine inside another subroutine is not allowed and will produce an error. For example, the following is invalid:

However, calling a subroutine from within another subroutine is perfectly valid. It is the sub/endsub definition that cannot be nested, not the call:

Other O-code control flow such as if/endif, while/endwhile, do/while, and repeat/endrepeat may be used freely inside subroutines.

Subroutines may only be called after they are defined. They may be called from other functions, and may call themselves recursively if it makes sense to do so. The maximum subroutine nesting level is 10.

Підпрограми можуть змінювати значення параметрів вище #30, і ці зміни будуть видимі для викличного коду. Підпрограми також можуть змінювати значення global named parameters (тобто параметрів, імена яких починаються з символу підкреслення "_").

Цикл «while» має дві структури: «while/endwhile» і «do/while». У кожному випадку цикл завершується, коли умова «while» оцінюється як хибна. Різниця полягає в тому, коли виконується умова перевірки. Цикл «do/while» виконує код у циклі, а потім перевіряє умову перевірки. Цикл «while/endwhile» спочатку виконує перевірку.

У циклі while оператор «o-break» негайно виходить із циклу, а оператор «o-continue» негайно переходить до наступної оцінки умови «while». Якщо вона все ще є істинною, цикл починається знову з початку. Якщо вона є хибною, цикл завершується.

Умова «if» складається з групи операторів з однаковим номером «o», які починаються з «if» і закінчуються «endif». Опціональні умови «elseif» і «else» можуть бути між початковим «if» і кінцевим «endif».

Якщо умова «if» має значення true, то виконується група операторів, що йдуть після «if» до наступного рядка умови.

Якщо умова «if» оцінюється як хибна, то умови «elseif» оцінюються по порядку, поки одна з них не буде оцінена як істинна. Якщо умова «elseif» є істинною, то виконуються оператори, що йдуть за «elseif» аж до наступного умовного рядка. Якщо жодна з умов «if» або «elseif» не оцінюється як істинна, то виконуються оператори, що йдуть за «else». Коли умова оцінюється як істинна, інші умови в групі більше не оцінюються.

Кілька умов можна перевірити за допомогою операторів elseif, доки шлях else нарешті не буде виконано, якщо всі попередні умови хибні:

Команда «repeat» виконає оператори всередині repeat/endrepeat задану кількість разів. У цьому прикладі показано, як можна фрезерувати діагональний ряд фігур, починаючи з поточної позиції.

o-число може бути задане параметром та/або розрахунком.

Щоб отримати додаткові відомості про обчислення значень, див. наступні розділи:

To call a separate file with a subroutine name the file the same as your call and include a sub and endsub in the file. The file must be in the directory pointed to by PROGRAM_PREFIX or SUBROUTINE_PATH in the INI file. The file name can include lowercase letters, numbers, dash, and underscore only. A named subroutine file can contain only a single subroutine definition. Do not place additional numbered subroutine definitions (e.g. o100 sub) in the same file as a named subroutine. Numbered subroutines share a global namespace and can silently conflict across files. If you need helper subroutines, place each one in its own file.

У викликаному файлі необхідно включити oxxx sub та endsub, а сам файл має бути коректним.

Підпрограми можуть необов’язково повертати значення за допомогою необов’язкового виразу в операторі endsub або return.

Значення, яке повертає підпрограма, зберігається в <_value> predefined named parameter , а попередньо визначений параметр <_value_returned> встановлюється на 1, щоб вказати, що значення було повернуто. Обидва параметри є глобальними і очищаються безпосередньо перед наступним викликом підпрограми.

Наступні оператори викликають повідомлення про помилку та переривають роботу інтерпретатора:

Щоб ці помилки не були фатальними попередженнями на stderr, встановіть біт 0x20 в ініціальній опції маски [RS274NGC]FEATURE=.