Calling SOUL $functions - Revision history

JAL: add category

2018-04-20T19:02:28Z

add category

← Older revision		Revision as of 19:02, 20 April 2018
Line 16:		Line 16:

	"Callability" is an optional approach; it does not replace %variable assignment. The callable $functions are indicated as such on their function page. Typically they are $functions that do more than simply return a value, and the value they return is primarily an indicator of whether the function completed successfully. <var>[[$ListCnt]]</var>, for example, is a (non-callable) $function because the function's purpose is to return a list count to the SOUL program.		"Callability" is an optional approach; it does not replace %variable assignment. The callable $functions are indicated as such on their function page. Typically they are $functions that do more than simply return a value, and the value they return is primarily an indicator of whether the function completed successfully. <var>[[$ListCnt]]</var>, for example, is a (non-callable) $function because the function's purpose is to return a list count to the SOUL program.

			[[Category:SOUL]]

JAL: JAL moved page Calling Sirius Mods $functions to Calling SOUL $functions: remove "Sirius Mods"

2016-11-23T21:44:11Z

JAL moved page Calling Sirius Mods $functions to Calling SOUL $functions: remove "Sirius Mods"

← Older revision	Revision as of 21:44, 23 November 2016
(No difference)

JAL at 19:40, 1 August 2014

2014-08-01T19:40:47Z

← Older revision		Revision as of 19:40, 1 August 2014
Line 1:		Line 1:
	Many of the ~~Sirius~~ $functions can be invoked using a ~~User Language~~ CALL statement instead of assigning the function result to a %variable. For example:		Many of the [[SOUL]] $functions can be invoked using a <var>CALL</var> statement instead of assigning the function result to a %variable. For example:

	<p class="code">		<p class="code">%L = $LISTNEW
	%L = $LISTNEW		$LISTADD(%L, 'Once upon a midnight dreary')
	$LISTADD(%L, 'Once upon a midnight dreary')		$LISTADD(%L, 'As I pondered weak and weary')
	$LISTADD(%L, 'As I pondered weak and weary')		CALL $LIST_PRINT(%L)
	CALL $LIST_PRINT(%L)
	</p>		</p>

	You can CALL such $functions and still test for their return code, if necessary. For		You can <var>CALL</var> such $functions and still test for their return code, if necessary. For
	example:		example:

	<p class="code">		<p class="code">CALL $LIST_PRINT(%L)
	CALL $LIST_PRINT(%L)		IF $LIST_PRINT(%L) THEN
	IF $LIST_PRINT(%L) THEN		...
	...
	</p>		</p>

	"Callability" is an optional approach; it does not replace %variable assignment. The callable $functions are indicated as such on their function page. Typically they are $functions that do more than simply return a value, and the value they return is primarily an indicator of whether the function completed successfully. [[$ListCnt]], for example, is a (non-callable) $function because the function's purpose is to return a list count to the ~~User Language~~ program.		"Callability" is an optional approach; it does not replace %variable assignment. The callable $functions are indicated as such on their function page. Typically they are $functions that do more than simply return a value, and the value they return is primarily an indicator of whether the function completed successfully. <var>[[$ListCnt]]</var>, for example, is a (non-callable) $function because the function's purpose is to return a list count to the SOUL program.

JAL2 at 16:17, 6 June 2012

2012-06-06T16:17:26Z

← Older revision		Revision as of 16:17, 6 June 2012
Line 1:		Line 1:
	~~As of version 6.5 of the [[Sirius Mods]], many~~ of the Sirius $functions can be invoked using a User Language CALL statement instead of assigning the function result to a %variable. For example:		Many of the Sirius $functions can be invoked using a User Language CALL statement instead of assigning the function result to a %variable. For example:

	<p class="code">		<p class="code">

Alan: Created page with "As of version 6.5 of the Sirius Mods, many of the Sirius $functions can be invoked using a User Language CALL statement instead of assigning the function result to a %variabl..."

2011-02-09T13:03:26Z

Created page with "As of version 6.5 of the Sirius Mods, many of the Sirius $functions can be invoked using a User Language CALL statement instead of assigning the function result to a %variabl..."

New page

As of version 6.5 of the [[Sirius Mods]], many of the Sirius $functions can be invoked using a User Language CALL statement instead of assigning the function result to a %variable. For example:

<p class="code">
%L = $LISTNEW
$LISTADD(%L, 'Once upon a midnight dreary')
$LISTADD(%L, 'As I pondered weak and weary')
CALL $LIST_PRINT(%L)
</p>

You can CALL such $functions and still test for their return code, if necessary. For
example:

<p class="code">
CALL $LIST_PRINT(%L)
IF $LIST_PRINT(%L) THEN
...
</p>

"Callability" is an optional approach; it does not replace %variable assignment. The callable $functions are indicated as such on their function page. Typically they are $functions that do more than simply return a value, and the value they return is primarily an indicator of whether the function completed successfully. [[$ListCnt]], for example, is a (non-callable) $function because the function's purpose is to return a list count to the User Language program.