Method variables - Revision history

Alex: /* Anonymous functions */

2014-12-18T21:46:38Z

Anonymous functions

@@ Line 639: / Line 639: @@
 The following sorts <code>%names</code> in ascending order of the second through fifth character:
 <p class="code">%names:sort(ascending(substring(2,4)))
 </p>

JAL at 22:17, 25 August 2014

2014-08-25T22:17:05Z

← Older revision		Revision as of 22:17, 25 August 2014
Line 112:		Line 112:
	The options are <var>Function</var> and <var>Subroutine</var>.		The options are <var>Function</var> and <var>Subroutine</var>.
	<var>Function</var> is required if the method (or class variable) returns a value.		<var>Function</var> is required if the method (or class variable) returns a value.
	<var>Subroutine</var> is used if the method does not return a value or is <var>[[Notation conventions for ~~Sirius Mods~~ methods#Calling functions\|Callable]]</var>.		<var>Subroutine</var> is used if the method does not return a value or is <var>[[Notation conventions for methods#Calling functions\|Callable]]</var>.
	<p>		<p>
	Strictly speaking, <var>Function</var> and <var>Subroutine</var> are the classes of the method object that is is referenced by the method variable.		Strictly speaking, <var>Function</var> and <var>Subroutine</var> are the classes of the method object that is is referenced by the method variable.

JAL at 20:41, 17 October 2013

2013-10-17T20:41:30Z

Show changes

JAL: /* See also */

2013-10-14T22:12:38Z

JALWiccan: Automatically generated page update

2013-10-14T20:05:27Z

Automatically generated page update

← Older revision		Revision as of 20:05, 14 October 2013
Line 638:		Line 638:
	</ul>		</ul>

	[[Category:~~Janus SOAP ULI~~ topics]]		[[Category:SOUL object-oriented programming topics]]

JALWiccan: Automatically generated page update

2013-06-03T21:29:05Z

Automatically generated page update

← Older revision		Revision as of 21:29, 3 June 2013
Line 635:		Line 635:
	==See also==		==See also==
	<ul>		<ul>
	<li>[[Janus SOAP essentials]]		<li>[[Janus SOAP ULI essentials]]
	</ul>		</ul>

	[[Category:Janus SOAP ULI topics]]		[[Category:Janus SOAP ULI topics]]

JAL at 16:11, 11 October 2012

2012-10-11T16:11:30Z

← Older revision		Revision as of 16:11, 11 October 2012
Line 1:		Line 1:
	==Summary==		==Summary==
	As of [[Sirius Mods]] version 7.3, [[Janus SOAP User Language Interface]] supports ''method variables''.		As of [[Sirius Mods]] version 7.3, <var class="product">[[Janus SOAP User Language Interface]]</var> supports ''method variables''.
	Method variables are variables that reference methods.		Method variables are variables that reference methods.
	They can be used to invoke varying methods with a particular, unchanging invocation.		They can be used to invoke varying methods with a particular, unchanging invocation.
Line 91:		Line 91:
	<dl>		<dl>
	<dt>%var		<dt>%var
	<dd>The name of the method variable, which can be any name that follows the rules for User Language %variables.		<dd>The name of the method variable, which can be any name that follows the rules for <var class="product">User Language</var> %variables.
	<dt>methodTemplate		<dt>methodTemplate
	<dd>The [[#Method template in method variable declaration\|function or subroutine declaration template]].		<dd>The [[#Method template in method variable declaration\|function or subroutine declaration template]].
Line 120:		Line 120:
	<dd>Identifies the [[#Method class in method variable method template\|class of objects to which the method applies]].		<dd>Identifies the [[#Method class in method variable method template\|class of objects to which the method applies]].
	<dt>methodName		<dt>methodName
	<dd>The method name, which can be any name that follows the rules for User Language %variables, is preceded by its class as necessary, and is followed by its parameters, if any.		<dd>The method name, which can be any name that follows the rules for <var class="product">User Language</var> %variables, is preceded by its class as necessary, and is followed by its parameters, if any.
	<dt>parms		<dt>parms
	<dd>The parameters that are used in invoking the method variable.		<dd>The parameters that are used in invoking the method variable.
Line 177:		Line 177:
	function (myclass):calculate(%x is float) is float		function (myclass):calculate(%x is float) is float
	</pre>		</pre>
	A method variable declared with a return type that is a User Language [[Intrinsic classes\|intrinsic datatype]] might return another intrinsic type when invoked if you assign a method to it that returns the other type.		A method variable declared with a return type that is a <var class="product">User Language</var> [[Intrinsic classes\|intrinsic datatype]] might return another intrinsic type when invoked if you assign a method to it that returns the other type.
	This is because User Language allows the assignment from one intrinsic type to another.		This is because <var class="product">User Language</var> allows the assignment from one intrinsic type to another.

	Most method qualifiers such as AllowNullObject or Implements are derived from the method assigned to a method variable and make no sense on the method template in a method variable declaration.		Most method qualifiers such as AllowNullObject or Implements are derived from the method assigned to a method variable and make no sense on the method template in a method variable declaration.
Line 243:		Line 243:
	<dt>method		<dt>method
	<dd>The name of the method to which the method variable will refer or an [[#Anonymous functions\|anonymous function]].		<dd>The name of the method to which the method variable will refer or an [[#Anonymous functions\|anonymous function]].
	A method name can be either a User Language method (instance method, enhancement method, shared method, or local method), a class member (Variable or read-only Property), or a method variable that fits the [[#method template in method variable declaration]].		A method name can be either a <var class="product">User Language</var> method (instance method, enhancement method, shared method, or local method), a class member (Variable or read-only Property), or a method variable that fits the [[#method template in method variable declaration]].
	</dl>		</dl>
	The source of an assignment to a method variable can even be the invocation of a function that returns a method value that fits the method description.		The source of an assignment to a method variable can even be the invocation of a function that returns a method value that fits the method description.
Line 463:		Line 463:
	Without the anonymous function, you'd have to find the definition of Right3 to see what's actually being assigned to %transform.		Without the anonymous function, you'd have to find the definition of Right3 to see what's actually being assigned to %transform.

	This is another case where User Language's insistence that variables begin with a percent sign comes in handy as it allows the compiler to distinguish an anonymous function from a variable or method reference.		This is another case where <var class="product">User Language</var>'s insistence that variables begin with a percent sign comes in handy as it allows the compiler to distinguish an anonymous function from a variable or method reference.

	Anonymous functions are '''always''' considered to be ''exposed'', that is, variables in the containing context are always visible to the anonymous method.		Anonymous functions are '''always''' considered to be ''exposed'', that is, variables in the containing context are always visible to the anonymous method.
Line 499:		Line 499:
	<ul>		<ul>
	<li>It can only be used via method variables</li>		<li>It can only be used via method variables</li>
	<li>The first argument is an arbitrary User ~~language~~ expression that can return any datatype.		<li>The first argument is an arbitrary <var class="product">User Language</var> expression that can return any datatype.
	The datatype returned, though, must be compatible with the return value of the method template for the method variable to which it is assigned.</li>		The datatype returned, though, must be compatible with the return value of the method template for the method variable to which it is assigned.</li>
	<li>The variable ''%this'' is automatically defined in the expression and holds the value of the object to which the method variable is applied.</li>		<li>The variable ''%this'' is automatically defined in the expression and holds the value of the object to which the method variable is applied.</li>

Alex: /* Anonymous functions */

2012-09-19T12:05:58Z

Anonymous functions

← Older revision		Revision as of 12:05, 19 September 2012
Line 446:		Line 446:
	%transform = right(3)		%transform = right(3)
	</pre>		</pre>
	the compiler knows you must be ~~refering~~ to a function '''name''' and so ~~assume~~ that that function is intended to be part of what's literally being assigned to the method variable.		the compiler knows you must be referring to a function '''name''' and so assumes that that function is intended to be part of what's literally being assigned to the method variable.
	When it sees the open parenthesis after the ''right'' it decides that what's inside the parentheses are intended to be arguments to be passed in the specified invocation of the method.		When it sees the open parenthesis after the ''right'' it decides that what's inside the parentheses are intended to be arguments to be passed in the specified invocation of the method.

JAL2: /* Anonymous methods in collection methods */

2012-01-11T17:54:07Z

Anonymous methods in collection methods

← Older revision		Revision as of 17:54, 11 January 2012
Line 610:		Line 610:

	===Anonymous methods in collection methods===		===Anonymous methods in collection methods===
	As with other method literals, anonymous methods can be useful in collection methods that use method variables to control processing.		As with other method literals, anonymous methods can be useful in [[Collections\|collection]] methods that use method variables to control processing.
	For example, suppose we have class Order, with public float variables ''price'' and ''quantity''.		For example, suppose we have class Order, with public float variables ''price'' and ''quantity''.
	And, suppose we had:		And, suppose we had:

JAL2: /* See also */

2012-01-11T17:52:30Z

← Older revision		Revision as of 22:12, 14 October 2013
Line 635:		Line 635:
	==See also==		==See also==
	<ul>		<ul>
	<li>[[~~Janus SOAP ULI essentials~~]]		<li>[[Object oriented programming in SOUL]]
	</ul>		</ul>

	[[Category:SOUL object-oriented programming topics]]		[[Category:SOUL object-oriented programming topics]]

← Older revision		Revision as of 17:52, 11 January 2012
Line 635:		Line 635:
	==See also==		==See also==
	<ul>		<ul>
	<li>Janus SOAP essentials		<li>[[Janus SOAP essentials]]
	</ul>		</ul>

	[[Category:Janus SOAP ULI topics]]		[[Category:Janus SOAP ULI topics]]