Difference between revisions of "Call"

From Wiki
Jump to: navigation, search
(Description)
(Added reference to exit page)
 
(23 intermediate revisions by 9 users not shown)
Line 1: Line 1:
__NOTOC__
+
{{command header|Flow Control}}
== Call ==
+
{{body|call {file} [parameter...]|''call'' command will transfer execution to another script. It will run the script until it meets the [[exit]] command or the end of the file.}}
'''Flow Control'''
+
=== Synopsis ===
+
call {file} [parameter...]
+
  
=== Description ===
 
The call command will transfer execution to another script. It will run the script until it meets the exit command or the end of the file.
 
  
Note:
+
{{Note|Right now EasyUO doesn't really support strings. Therefore, CALL won't work if the path to a file contains any spaces. Use the DOS short filename syntax to get around this problem.
Right now EasyUO doesn't really support strings. Therefore, CALL won't work if the path to a file contains any spaces. Use the DOS short filename syntax to get around this problem.
+
 
  
 
wrong: C:\My Documents\blabla.txt
 
wrong: C:\My Documents\blabla.txt
  
correct: C:\MyDocu~1\blabla.txt
 
  
==== Example ====
+
correct: C:\MyDocu~1\blabla.txt}}
 +
 
 +
 
 +
==Example==
 +
<pre>
 
call subs.txt recall %runebookid %runenum
 
call subs.txt recall %runebookid %runenum
 
halt
 
halt
 +
</pre>
  
==== See Also ====
+
Note: call arguments handling work exactly the same as goSub command. Thus, %0 will hold the number of parameters passed, %1 will hold the first argument passed value and so on. See [http://wiki.easyuo.com/index.php/Exit exit command] page for more infos.
{|
+
 
| Width=200px |
+
EDIT on 23 jan 2008: For those who know nothing about MS-DOS shortcut thing, here's a way to get around it when using paths containing spaces(Tested on Windows Vista):
|}
+
 
----
+
Wrong: C:\My Documents\file.txt
{|
+
 
| Width=200px | [[Main_Page]] || Width=200px | [[Documentation]] || Width=200px |
+
Correct: C:\My , #spc , Documents\file.txt (tested on Windows Vista, compatibility with older systems isn't guaranteed)
[[Documentation#Flow_Control|Flow Control]]
+
 
 +
==Releated Commands==
 +
{| style="background:gainsboro; color:black; border: 2px #aaa solid;"
 +
| Width=250px align=center | [[Exit]]
 
|}
 
|}
 +
=See Also=
 +
{{Flow Control}}

Latest revision as of 10:00, 17 September 2008

Synopsis

call {file} [parameter...]

Description

call command will transfer execution to another script. It will run the script until it meets the exit command or the end of the file.


Note: Right now EasyUO doesn't really support strings. Therefore, CALL won't work if the path to a file contains any spaces. Use the DOS short filename syntax to get around this problem.


wrong: C:\My Documents\blabla.txt


correct: C:\MyDocu~1\blabla.txt


Example

call subs.txt recall %runebookid %runenum
halt

Note: call arguments handling work exactly the same as goSub command. Thus, %0 will hold the number of parameters passed, %1 will hold the first argument passed value and so on. See exit command page for more infos.

EDIT on 23 jan 2008: For those who know nothing about MS-DOS shortcut thing, here's a way to get around it when using paths containing spaces(Tested on Windows Vista):

Wrong: C:\My Documents\file.txt

Correct: C:\My , #spc , Documents\file.txt (tested on Windows Vista, compatibility with older systems isn't guaranteed)

Releated Commands

Exit

See Also

Flow Control

  • Flow control commands allow scripts to make decisions based on the evaluation of boolean expressions.
break Jumps to first statement outside of loop
call Transfers execution to another script file
continue Jumps execution of a loop to next iteration
exit Exits a called script
for Creates a counting loop
gosub Transfers execution to the matching sub
goto Jumps to another part of the script given by a label
halt Stops the script
if Executes code based on the evaluation of an expression
pause Temporarily stops the execution of the current script
repeat..until Creates a loop that checks condition after execution
return Returns from a sub
stop Ends the script
while Creates a loop that checks condition before execution