Scanlab RTC 5 PC Interface Board - list_until

RTC
®
5 PC Interface Board
Rev. 1.9 e
10 Commands And Functions
325
innovators for industry
Undelayed
Short
List Command
list_until
Function terminates repetition of a group of list commands.
Call
list_until( Number )
Parameter Number number of repetitions as an unsigned 32-bit value
(
Number = 0 is treated like Number = 1)
Comments • See chapter 6.5.5 "Loops", page 82.
• Any still-pending delayed short list command will execute first.
• All list commands between this command and the most recent preceding list_repeat
command will be executed
Number number of times.
• Nesting up to 8 list_repeat/list_until loops deep is allowed. Each further list_until
command for which there was no preceding list_repeat command will be ignored.
• An empty loop consisting of list_repeat directly followed by list_until will terminate
immediately and not be repeated.
• If a list terminates (via set_end_of_list or stop_execution or /STOP), then all not-yet-
fully-processed list_repeat/list_until loops will be deleted. However, this won’t occur if
an automatic list change (via auto_change, auto_change_pos or start_loop) is active.
• Complete list_repeat/list_until loops can reside within a list or subroutine. Changing
between lists and subroutines or between different subroutines is not permitted.
Changing between lists is permitted as long as the list change occurs without explicit
list termination (via an automatic list change or via an explicit list jump to another list
with list_jump_pos).
• List jumps into a list_repeat/list_until loop’s body or from inside a loop to a loop-
external location should be avoided. Careless use could compromise loop management
integrity so severely that loops won’t execute as expected. But subroutine calls from
inside a loop are always reliably possible.
RTC
®
4  RTC
®
5 new command
Version info Available beginning with version DLL 536, OUT 536
References list_repeat