special evaluation - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Mathematics : Evaluation : special evaluation

Special Evaluation Rules

 

Description

Examples

Description

• 

Most Maple procedures have what are known as "standard evaluation rules." These rules govern the way in which arguments passed to a procedure are evaluated before being bound to the formal parameters of the procedure.

  

Standard evaluation rules mean that arguments are evaluated in an unspecified order, in the scope of the caller, before parameter binding occurs. Both last name evaluation and one level evaluation of locals apply to the evaluation of the argument expressions. Thus, procedures called at the top level are passed their arguments after they have been fully evaluated, while those called within other procedures are passed their arguments after they have been evaluated one level.

• 

Some Maple procedures have so-called "special evaluation rules." This means that the arguments are not evaluated according to the standard evaluation rules. Instead, some arguments may not be (fully) evaluated, a specific evaluation order may be prescribed, or a non-standard evaluator may be used to evaluate one or more arguments.

• 

Most procedures that have special evaluation rules are builtin. It is possible, however, for a user to write a procedure with special evaluation rules by using an argument declared to be of one of the types uneval and evaln. This can only be done for a fixed number of named arguments. (There is no way to write a procedure that takes an arbitrary number of unevaluated arguments.) It is not possible to alter the order in which the arguments to a procedure are evaluated. (Often, however, this effect can be achieved by suppressing the evaluation of the arguments, and then evaluating the parameters explicitly within the body of the procedure in the desired order.)

• 

The following builtin user procedures have special evaluation rules.

add

ASSERT

assigned

eval

evalf

evalhf

evaln

if

mul

seq

time

timelimit

traperror

userinfo

 

 

  

 

• 

Writing procedures with special evaluation rules is generally to be avoided unless absolutely necessary for correct operation.

Examples

The following procedure p has its arguments fully evaluated at the top level, but evaluated to only one level when called within the (anonymous) procedure shown.

p := proc( x ) print( x ); end proc;

pprocxprintxend proc

(1)

ab

ab

(2)

b2

b2

(3)

pa

2

(4)

proc()
    local a, b;
    a := b;
    b := 2;
    p(a);
end proc();

b

(5)

Modifying the formal parameter x of p changes it so that it has special evaluation rules.

p := proc( x::uneval ) print( x ); end proc;

pprocx::unevalprintxend proc

(6)

pa

a

(7)

proc()
    local a, b;
    a := b;
    b := 2;
    p(a);
end proc();

a

(8)

The procedure evalf has special evaluation rules because it ensures that its second argument (if provided) is evaluated before its first argument.

evalf( proc() print( FIRST ); Pi end(), proc() print( SECOND ); 15 end() );

SECOND

FIRST

3.14159265358979

(9)

The procedure assigned uses a non-standard evaluator (evaln) when it evaluates its argument.

assignedH2

false

(10)

evalncatH,2

H2

(11)

assignedcatH,2

false

(12)

evalnH2

H2

(13)

assignedH2

false

(14)

H2sin:

evalnH2

H2

(15)

assignedH2

true

(16)

You can control the order of argument evaluation by suppressing it entirely and making the evaluations explicit in the desired order.

p := proc( a::uneval, b::uneval )
    local    ea, eb;
    eb := eval( b ); # evaluate second
    ea := eval( a ); # evaluate first
    [ ea, eb ]
end proc:

p( proc() print(FIRST); 2 end(), proc() print(SECOND); 3 end() );

SECOND

FIRST

2,3

(17)

See Also

add

ASSERT

assigned

builtin

eval

Eval

evala

evalb

evalc

evalf

evalhf

evalm(deprecated)

evaln

evalr

if

last_name_eval

map

map2

mul

procedure

seq

time

timelimit

trace

try

uneval

userinfo

value

zip