Difference between revisions of "Goto"
no edit summary
imported>Odessa (Added example and links to nvse equivalents) |
imported>JT |
||
| Line 1: | Line 1: | ||
{{Function | {{Function | ||
|origin = FOSE1 | |origin = FOSE1 | ||
|summary = Jump to a labeled position in the script previously defined by a call to Label. Execution will return to the label, simulating a loop. Be careful to provide an exit condition to avoid creating infinite loops. | |summary = Jump to ("go to") a labeled position in the script previously defined by a call to Label. Execution will return to the label, simulating a loop. Be careful to provide an exit condition to avoid creating infinite loops. | ||
|name = Goto | |name = Goto | ||
|returnType = void | |returnType = void | ||
| Line 8: | Line 8: | ||
|Name = labelID | |Name = labelID | ||
|Type = int | |Type = int | ||
|Value = 0-255 | |||
}} | }} | ||
|example = int GetNextActor | |example = int GetNextActor | ||
| Line 17: | Line 18: | ||
endif | endif | ||
}} | }} | ||
==Notes== | ==Notes== | ||
*There are 256 available slots for Labels, enabling IDs from 0 to 255 inclusively. Values outside of this range will not work. | * There are 256 available slots for Labels, enabling IDs from 0 to 255 inclusively. Values outside of this range will not work. | ||
*If using NVSE since version 4, | * If using NVSE since version 4, Label/Goto should be replaced by [[While]] or [[Foreach]] in all but exceptional cases, as these are more powerful, readable and reliable. Use of Label/Goto for creating loops should be considered outdated and bad form. | ||
==See Also== | ==See Also== | ||
*[[Label]] | * [[Label]] | ||
*[[While]] | * [[While]] | ||
*[[Foreach]] | * [[Foreach]] | ||
==External Links== | |||
* [http://www.cipscis.com/fallout/tutorials/loops.aspx Loops] | |||
* [http://fose.silverlock.org/fose_command_doc.html#Goto FOSE Documentation] | |||
[[Category:Functions_(FOSE)]] | [[Category:Functions_(FOSE)]] | ||