Superx++ Lexicon: xcall statement

xcall

Purpose The xcall statement is used to invoke another Superx++ program from within a Superx++ program. The xcall can pass the same input stream that it has or it can pass another one or none at all to the remote Superx++ program.

Format xcall({file path}, {remote input stream});
xcall({file path}, {remote input stream}) noxout;

noxout (optional) if absent then the contents of the output stream of the remote program will be merged into the output stream of the calling program.

{file path} the path or URL of the Superx++ program to be invoked

{remote input stream} the input stream to be passed from the caller to the remote Superx++ program

Example #1 Consider that the file C:\\MyDir\\MyProg.xml contains the following code:
xpp {
xout("\r\nIn the remote program");
}
Now consider the following caller program code snippet:
xout("In the caller");
xcall("C:\\MyDir\\MyProg.xml", "");
xout("\r\nBack in the caller");
The result is that the following text is written to the output stream of the caller program:
In the caller
In the remote program
Back in the caller

Example #2 Consider that the file C:\\MyDir\\MyProg.xml contains the following code:
xpp {
xout("\r\nIn the remote program");
}
Now consider the following caller program code snippet:
xout("In the caller");
xcall("C:\\MyDir\\MyProg.xml", "") noxout;
xout("\r\nBack in the caller");
The result is that the following text is written to the output stream of the caller program:
In the caller
Back in the caller
The reason for the omission of the output stream contents of the remote program is that the noxout token is specified.

Purpose	The xcall statement is used to invoke another Superx++ program from within a Superx++ program. The xcall can pass the same input stream that it has or it can pass another one or none at all to the remote Superx++ program.
Format	xcall({file path}, {remote input stream}); xcall({file path}, {remote input stream}) noxout;
	noxout	(optional) if absent then the contents of the output stream of the remote program will be merged into the output stream of the calling program.
	{file path}	the path or URL of the Superx++ program to be invoked
	{remote input stream}	the input stream to be passed from the caller to the remote Superx++ program
Example #1	Consider that the file C:\\MyDir\\MyProg.xml contains the following code: xpp { xout("\r\nIn the remote program"); } Now consider the following caller program code snippet: xout("In the caller"); xcall("C:\\MyDir\\MyProg.xml", ""); xout("\r\nBack in the caller"); The result is that the following text is written to the output stream of the caller program: In the caller In the remote program Back in the caller
Example #2	Consider that the file C:\\MyDir\\MyProg.xml contains the following code: xpp { xout("\r\nIn the remote program"); } Now consider the following caller program code snippet: xout("In the caller"); xcall("C:\\MyDir\\MyProg.xml", "") noxout; xout("\r\nBack in the caller"); The result is that the following text is written to the output stream of the caller program: In the caller Back in the caller The reason for the omission of the output stream contents of the remote program is that the noxout token is specified.