Additions:
The Return value of a function is the return value of the last command, or the argument of the [[CommandReturn return]] function. Return values can be any type,
including XML and object types. If the return type is numeric it is available as $? when run using command syntax. Any value is available when executed using [[SyntaxFunctionCall Function Call Syntax]]
including XML and object types. If the return type is numeric it is available as $? when run using command syntax. Any value is available when executed using [[SyntaxFunctionCall Function Call Syntax]]
Deletions:
Additions:
See [[SyntaxFunctionCall Function Call Syntax]]
Deletions:
The previous calling convention (as described above) is "procedural" where function calls behave like commands.
Function Call Expressions look like and behave more like traditional language functions.
The return value can be any value type (including XDM values such as sequences, elements etc). Evaluating a function call evaluates to the return value.
Arguments are passed in Function Call expressions with ( arglist ).
For example, A function that concatenates 2 arguments separated by ":"
%%(shell)
function concat()
return "$1:$2" ;
echo concat(hello world)
hello:world
Function call expressions can be assigned to variables
a=concat(hello world)
echo $a
Since they are value expressions they can nest and recurse.
a=concat( concat(this that) another)
this:that:anoother
Arguments are expanded exactly like command execution. The output of the function is shared with the output of the calling shell the same as in procedural calling.
%%(shell)
function list()
echo $*
return $#
a=list(*.c)
echo There were $a .c files
foo.c bar.c spam.c
There were 3 .c files
===Java Objects===
Functions can consume, operate on, and produce [[JavaObjects Java Objects]]
Example:
Note this demonstrates types of function call syntax and passing java objects.
function today()
return jnew( java.util.Date )
function printDate()
date=$1
echo date.toString()
printDate today()
%%
Thu Nov 18 11:15:43 EST 2010
Additions:
[[Functions]]
Additions:
Functions can consume, operate on, and produce [[JavaObjects Java Objects]]
Deletions:
Additions:
===Java Objects===
Functions can consume, operate on, and produce [[NativeJava Java Objects]]
Example:
Note this demonstrates types of function call syntax and passing java objects.
function today()
return jnew( java.util.Date )
function printDate()
date=$1
echo date.toString()
printDate today()
%%
Thu Nov 18 11:15:43 EST 2010
Functions can consume, operate on, and produce [[NativeJava Java Objects]]
Example:
Note this demonstrates types of function call syntax and passing java objects.
function today()
return jnew( java.util.Date )
function printDate()
date=$1
echo date.toString()
printDate today()
%%
Thu Nov 18 11:15:43 EST 2010
Additions:
=====Declaring Functions=====
====Function Call Expressions====
====Function Call Expressions====
Deletions:
Additions:
foo.c bar.c spam.c
Deletions:
bar.c
spam.c
Additions:
Arguments are expanded exactly like command execution. The output of the function is shared with the output of the calling shell the same as in procedural calling.
function list()
echo $*
return $#
a=list(*.c)
echo There were $a .c files
foo.c
bar.c
spam.c
There were 3 .c files
function list()
echo $*
return $#
a=list(*.c)
echo There were $a .c files
foo.c
bar.c
spam.c
There were 3 .c files
Additions:
====Expermental - Function Call Expressions====
Starting with version 1.0.7 functions may be called in 'function call syntax' as a value expression.
The previous calling convention (as described above) is "procedural" where function calls behave like commands.
Function Call Expressions look like and behave more like traditional language functions.
The return value can be any value type (including XDM values such as sequences, elements etc). Evaluating a function call evaluates to the return value.
Arguments are passed in Function Call expressions with ( arglist ).
For example, A function that concatenates 2 arguments separated by ":"
%%(shell)
function concat()
return "$1:$2" ;
echo concat(hello world)
hello:world
Function call expressions can be assigned to variables
a=concat(hello world)
echo $a
Since they are value expressions they can nest and recurse.
a=concat( concat(this that) another)
this:that:anoother
Starting with version 1.0.7 functions may be called in 'function call syntax' as a value expression.
The previous calling convention (as described above) is "procedural" where function calls behave like commands.
Function Call Expressions look like and behave more like traditional language functions.
The return value can be any value type (including XDM values such as sequences, elements etc). Evaluating a function call evaluates to the return value.
Arguments are passed in Function Call expressions with ( arglist ).
For example, A function that concatenates 2 arguments separated by ":"
%%(shell)
function concat()
return "$1:$2" ;
echo concat(hello world)
hello:world
Function call expressions can be assigned to variables
a=concat(hello world)
echo $a
Since they are value expressions they can nest and recurse.
a=concat( concat(this that) another)
this:that:anoother
Additions:
This declares a function "name". The different variations in syntax are equivalent. The body of the function when executed runs in the same context as the parent shell, with the exception of Positional Parameters ($1 ... $N).
Deletions:
Additions:
Variables can be marked local using the "local" keyword. Local variable modifications are scoped to the function (and any function or script it calls) and do not affect the global (or parents) variables of the same name.
The Return value of a function is the return value of the last command, or the argument of the [[CommandReturn return]] function. Return values can be numeric only (signed integer).
The Return value of a function is the return value of the last command, or the argument of the [[CommandReturn return]] function. Return values can be numeric only (signed integer).
Deletions:
The Return value of a function is the return value of the last command, or the argument of the [[CommandReturn return]] function.
Additions:
=====Local Variables=====
As with bash, variables can be marked local using the "local" keyword. Local variable modifications are scoped to the function (and any function or script it calls) and do not affect the global (or parents) variables of the same name.
setit ()
{
local A=$1
echo in setit A is $A
A=Value1
setit Value2
echo Outside of setit A is $A
Results
in setit A is Value2
Outside of setit A is Value1
As with bash, variables can be marked local using the "local" keyword. Local variable modifications are scoped to the function (and any function or script it calls) and do not affect the global (or parents) variables of the same name.
setit ()
{
local A=$1
echo in setit A is $A
A=Value1
setit Value2
echo Outside of setit A is $A
Results
in setit A is Value2
Outside of setit A is Value1
Additions:
Note: prior to version 1.0.5 "function name ()" and "name ()" behaved differently. The former syntax caused all variable references to be local.
From version 1.0.5 onwards this has been fixed to conform to the behaviour of bash/ksh where variables are all global unless the "local" modifier is used.
From version 1.0.5 onwards this has been fixed to conform to the behaviour of bash/ksh where variables are all global unless the "local" modifier is used.
Deletions:
Additions:
Functions can be declared in two forms, with or without the keyword "function". These forms behave identically.
Note: prior to version 1.0.5 "function name ()" and "name ()" behaved differently.
===function name { list; }===
Note: starting with version 1.0.5 local variables can be defined.
Note: prior to version 1.0.5 "function name ()" and "name ()" behaved differently.
===function name { list; }===
Note: starting with version 1.0.5 local variables can be defined.
Deletions:
This declares a function "name". The body of the function when executed runs in the a child shell context. Arguments are passed as positional parameters ($1 .. $N)
This means that variables assigned within the function *do not* have a "side effect" of writing into the global environment for the current shell.
function setit ()
Additions:
======Return Value======
The Return value of a function is the return value of the last command, or the argument of the [[CommandReturn return]] function.
foo ()
{
true ;
foo && echo Is True
Is True
foo ()
return 2 ;
foo
echo $?
2
The Return value of a function is the return value of the last command, or the argument of the [[CommandReturn return]] function.
foo ()
{
true ;
foo && echo Is True
Is True
foo ()
return 2 ;
foo
echo $?
2
No Differences
Additions:
===name () { list; }===
===function name () { list; }===
===function name () { list; }===
Deletions:
=====function name () { list; }=====
