Difference between revisions of "MC-Basic:VESEXECUTE"

From SoftMC-Wiki
Jump to: navigation, search
m (Text replace - "Versions 3.7.x and higher" to "Since Version 3.7.x")
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
{{Languages|MC-Basic:VESEXECUTE}}
 
{{MC-Basic
 
{{MC-Basic
 
|SHORT FORM=
 
|SHORT FORM=
Line 10: Line 11:
  
 
|DESCRIPTION=
 
|DESCRIPTION=
 +
 
Invocation of Basic interpreter via virtual (internal) entry station.
 
Invocation of Basic interpreter via virtual (internal) entry station.
  
Line 28: Line 30:
 
Multi-line program strings can be assembled by concatenation of single-line command strings.  
 
Multi-line program strings can be assembled by concatenation of single-line command strings.  
 
Each single-line string should be terminated by CRLF (carriage return - line feed) characters.
 
Each single-line string should be terminated by CRLF (carriage return - line feed) characters.
 +
 +
{{Note/Warning| Be careful using VesExecute statement, it activates a process on entry-station priority (2) which can mess with the execution of user programs. Aso note that calling VesExecute from another entry station is not allowed! }}
  
 
|TYPE=
 
|TYPE=
Line 48: Line 52:
  
 
|EXAMPLE=
 
|EXAMPLE=
<pre>
+
?'"`UNIQ--pre-00000001-QINU`"'?
?VESExecute(“dir *.prg”)
 
str1=VESExecute(“Load “+var2”)
 
</pre>
 
 
 
;Example for a multi-line command         
 
<pre>
 
Dim Str as string
 
  
Program
+
;Example for a multi-line command
  Str = Str + "Program" + chr$(0xd) + chr$(0xa)
+
?'"`UNIQ--pre-00000002-QINU`"'?
  Str = Str + "Dim Var As Long = 10" + chr$(0xd) + chr$(0xa)
 
  Str = Str + "Print Var" + chr$(0xd) + chr$(0xa)
 
  Str = Str + "End Program" + chr$(0xd) + chr$(0xa)
 
  Print VesExecute(Str)
 
End Program
 
</pre>
 
  
 
|SEE ALSO=
 
|SEE ALSO=
* [[Axystems:MC-Basic:VESMESSAGE|VESMESSAGE]]
+
* [[MC-Basic:VESMESSAGE|VESMESSAGE]]
  
  
 
}}
 
}}

Latest revision as of 08:17, 27 April 2021

Language: English  • 中文(简体)‎

Invocation of Basic interpreter via virtual (internal) entry station.

Pass to a string the virtual entry station (CLI) and get a response. When VESEXECUTE is executed, it sends the command and waits for the response. While waiting for the response, it reads all the incoming messages from the VES message pipe.

It discards all the non-relevant messages that it reads. This means that if an ASYNC message is printed to the VES message pipe while the VESEXECUTE command is waiting for the response, the user will never get this message since the VESEXECUTE deletes it.

VESExecute returns the first 512 characters of the response string

Return value
Response or Error message. Valid reply has prefix “D:”, while error response has prefix “E:”

Multi-line commands via entry station

Short programs can be transferred via entry station as strings. Multi-line program strings can be assembled by concatenation of single-line command strings. Each single-line string should be terminated by CRLF (carriage return - line feed) characters.

WARNING.svgWARNING
Be careful using VesExecute statement, it activates a process on entry-station priority (2) which can mess with the execution of user programs. Aso note that calling VesExecute from another entry station is not allowed!

Syntax

<string var name> = VESExecute(<string expression>)

Availability

Since Version 3.7.x

Scope

Task

Limitations

Only from task context

Examples

?'"`UNIQ--pre-00000001-QINU`"'?

Example for a multi-line command

?'"`UNIQ--pre-00000002-QINU`"'?

See Also