LAMBDA
|
WNSupported in Synergy .NET on Windows
|
|
|
[ASYNC] LAMBDA name ([param_id [, ...param_id]]) expression
or
[ASYNC] LAMBDA name ([param_id [, ...param_id]]) BEGIN . . . END
Arguments
ASYNC
(optional) Lambda function will perform asynchronous processing.
name
The name of the lambda function. (a)
param_id
(optional) A parameter to pass to the lambda function.
expression
The expression to be evaluated.
Discussion
The LAMBDA statement provides a way to generate inline methods that have access to variables within the method in which the lambda is declared. A lambda function can take any number of parameters, and it returns the value of a single expression. It can contain any variables that are currently in scope, with the following exceptions:
- Fields that are in a group, in a named record, or overlayed
- Parameters that are BYREF, OUT, INOUT, or a parameter group
The method generated by a lambda function is at the same scope level as the routine in which it is declared. For example, if the routine is a class routine, the method generated by the lambda function will be a class routine.
When accessing local variables, be aware that the lifetime of those variables changes from local scope to the scope outside of the method in which they are declared. If you’re writing to local variables in a threading scenario, such as WPF, make sure the access is thread-safe. |
You can use a lambda function in the following ways:
- Pass a lambda function as an argument value to a routine that takes a delegate type. For example,
mymethod(myadd)
- Pass a lambda function as an event handler. For example,
addhandler(classvar.event1, myadd)
- Assign a lambda function to a delegate and then call the delegate, providing the necessary arguments. For example,
delegate deleg1, int parm1, int enddelegate record dvar, @deleg1 proc dvar = myadd x = dvar(5)
- Cast a lambda function to a declared delegate type and provide the necessary arguments for that delegate. For example,
x = ((deleg1)myadd)(5)
If a lambda is to perform asynchronous processing, it must be marked as ASYNC. Asynchronous processing means that a process can occur independently of other processes instead of being required to occur in direct succession. Within an asynchronous lambda, you may specify one or more AWAIT statements, which wait for the corresponding asynchronous task to complete. See Asynchronous processing (.NET) and AWAIT for more information.
Inline lambdas
Lambdas can also be inline functions. An inline lambda can be used anywhere a regular lambda can be used (for example, data fields in routines, parameters, and class fields), and it has the following syntax:
lambda(param_id,...) {expression},...
In the following example, an unnamed lambda is created and a pointer to it is stored in fld1.
namespace ns1 delegate deleg1, int parm1, string enddelegate class class1 public static fld1, @deleg1, lambda(arg) {arg.Length+101} endclass endnamespace
You can then invoke the lambda like this:
x = ns1.class1.fld1("hi")
Here’s another example for a data field assignment:
data var1, @deleg1 ; Assignment var1 = lambda(arg) {arg.Length+20} x = var1("go")
Examples
record i, int proc lambda myadd(x, y) begin mreturn x + y end end