Códigos O

Los códigos O numerados deben tener un número único para cada subrutina, .Ejemplo de numeración

No deben usarse comentarios en la misma línea que la palabra O, ya que el comportamiento puede cambiar en el futuro.

El comportamiento es indefinido si:

Las subrutinas comienzan en Onnn sub y terminan en Onnn endsub. Las líneas entre Onnn sub y Onnn endsub no se ejecutan hasta que se llama a la subrutina con Onnn call. Cada subrutina debe usar un número único.

Ejemplo de subrutina

Consulte las secciones G53 , G0 y M2 para obtener más información.

Dentro de una subrutina, se puede ejecutar O- return. Esto vuelve al código de llamada inmediatamente, como si se encontrara O-endsub.

Consulte las secciones operadores binarios y parámetros para obtener más información.

O- Call toma hasta 30 argumentos opcionales, que se pasan a la subrutina como #1, #2, …, #N. Los parámetros de #N+1 a #30 tienen el mismo valor como en el contexto de llamada. Al regresar de la subrutina, los valores de los parámetros del 1 al 30 (independientemente del número de argumentos) serán restaurados a los valores que tenían antes de la llamada. Los parámetros #1 - #30 son locales a la subrutina.

Como 1 2 3 se analiza como el número 123, los parámetros deben estar entre corchetes. Lo siguiente llama a una subrutina con 3 argumentos:

Los cuerpos de subrutina no pueden estar anidados. Solo pueden llamarse después de ser definidos. Pueden ser llamados desde otras funciones, y pueden llamarse a sí mismos recursivamente si tiene sentido hacerlo. El maximo nivel de anidación de subrutinas es 10.

Las subrutinas pueden cambiar el valor de los parámetros por encima de #30 y esos cambios serán visible para el código de llamada. Las subrutinas también pueden cambiar el valor de parámetros globales con nombre.

El bucle while tiene dos estructuras: while/endwhile y do/while. En cada caso, el ciclo se cierra cuando la condición while se evalúa como falso. La diferencia es cuando se realiza la condición de prueba. El bucle do/while ejecuta el código en el bucle y luego verifica la condición de prueba. El bucle while/endwhile hace la prueba primero.

Dentro de un ciclo while, O- break sale inmediatamente del ciclo, y O- continue salta inmediatamente a la próxima evaluación de la condición while. Si aún es cierta, el ciclo comienza nuevamente en la parte superior. Si es falsa, sale del bucle.

El condicional if consiste en un grupo de declaraciones con el mismo número o que comienzan con if y terminan con endif. Condiciones opcionales elseif y else puede estar entre el inicio if y el final endif.

Si el condicional if se evalúa como verdadero, entonces se ejecuta el grupo de declaraciones siguiendo al if hasta la siguiente línea condicional.

Si el condicional if se evalúa como falso, entonces las condiciones elseif son evaluadas en orden hasta que una evalúa como verdadera. Si la condición elseif es cierta entonces se ejecutan las declaraciones que siguen al elseif hasta el próximo condicional. Si ninguna de las condiciones if o elseif se evalúa como verdadera, entonces se ejecutan las declaraciones que siguen al else. Cuando una condición es evaluada como verdadero, no se evalúan más condiciones en el grupo.

Se pueden probar varias condiciones mediante declaraciones elseif hasta que la ruta else finalmente se ejecuta si todas las condiciones anteriores son falsas:

repeat ejecutará las declaraciones dentro de repeat/endrepeat el número especificado de veces. El ejemplo muestra cómo puede fresar una serie diagonal de formas a partir de la presente posición.

El O-número puede ser dado por un parámetro y/o cálculo.

Ejemplo de Indirección

Para obtener más información sobre los valores, consulte las siguientes secciones

Para llamar a un archivo separado con una subrutina, nombre el archivo igual que su llamada e incluya un sub y endub en el archivo. El archivo debe estar en el directorio señalado por PROGRAM_PREFIX o SUBROUTINE_PATH en el archivo ini. El nombre del archivo puede incluir letras minúsculas, números, guiones y guiones bajos solamente. Un archivo de subrutina con nombre solo puede contener una única definición de subrutina.

Ejemplo de archivo con nombre

Ejemplo de archivo numerado

En el archivo llamado, debe incluir el sub y el endsub oxxx y el archivo debe ser un archivo válido.

Ejemplo de archivo llamado

Las subrutinas pueden devolver opcionalmente un valor mediante una expresión opcional en una declaración endsub o return.

Ejemplo de valor de retorno

Un valor de retorno de subrutina se almacena en el parámetro con nombre predefinido <_value> y el parámetro predefinido <_value_returned> se establece en 1, para indicar que se ha devuelto un valor. Ambos parámetros son globales y se borran solo antes de la próxima llamada de subrutina.

Las siguientes declaraciones provocan un mensaje de error y abortan el interprete:

 - un return o` endsub` no dentro de una subdefinición  - una etiqueta en repeat que se define en otra parte  - una etiqueta en while que se define en otro lugar y no se refiere a un` do`  - una etiqueta en if definida en otra parte  - una etiqueta indefinida en else o` elseif`  - una etiqueta en else,` elseif` o endif no apunta a un` if` coincidente  - una etiqueta en break o` continue` que no apunta a una coincidencia while o` do`  - una etiqueta en endrepeat o` endwhile` sin hacer referencia a un while o` repeat` correspondiente      Para hacer estos errores advertencias no fatales en stderr, establezca el bit 0x20 en la opción mask [[RS274NGC]FEATURE=` del .ini.