Maple Professional
Maple Academic
Maple Student Edition
Maple Personal Edition
Maple Player
Maple Player for iPad
MapleSim Professional
MapleSim Academic
Maple T.A. - Testing & Assessment
Maple T.A. MAA Placement Test Suite
Möbius - Online Courseware
Machine Design / Industrial Automation
Aerospace
Vehicle Engineering
Robotics
Power Industries
System Simulation and Analysis
Model development for HIL
Plant Modeling for Control Design
Robotics/Motion Control/Mechatronics
Other Application Areas
Mathematics Education
Engineering Education
High Schools & Two-Year Colleges
Testing & Assessment
Students
Financial Modeling
Operations Research
High Performance Computing
Physics
Live Webinars
Recorded Webinars
Upcoming Events
MaplePrimes
Maplesoft Blog
Maplesoft Membership
Maple Ambassador Program
MapleCloud
Technical Whitepapers
E-Mail Newsletters
Maple Books
Math Matters
Application Center
MapleSim Model Gallery
User Case Studies
Exploring Engineering Fundamentals
Teaching Concepts with Maple
Maplesoft Welcome Center
Teacher Resource Center
Student Help Center
Special Evaluation Rules
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 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;
proc() local a, b; a := b; b := 2; p(a); end proc();
Modifying the formal parameter of changes it so that it has special evaluation rules.
p := proc( x::uneval ) print( x ); end proc;
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() );
The procedure assigned uses a non-standard evaluator (evaln) when it evaluates its argument.
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() );
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
Download Help Document