!1 Evaluator of expressions: $!--!{= =} !2 Syntax '''{{{ $!--!{= [format:] expression =} }}}''' !3 Expression An expression may be a combination of constants, variables, and opertors. All internal calculations use the Java ''double'' numeric type. !3 Format A format is a specifier that describes the rendering of the numeric result. The format specifier is described by the Java 5 String class's .format() method: {{{ %[flags][width][.precision]conversion}}} *!note N.B., The ''[argument_index$]'' specifier is not permitted. Additionally, a formatting locale can be defined by setting the variable ''FORMAT_LOCALE'' to override the default JVM locale. !3 Links * [[format string][http://java.sun.com/j2se/1.5.0/docs/api/java/util/Formatter.html#syntax]] * [[String.format()][http://docs.oracle.com/javase/1.5.0/docs/api/java/lang/String.html#format(java.util.Locale,%20java.lang.String,%20java.lang.Object...)]] * [[String class][http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html]] !3 Examples {{{ $!--!{= 12 + 23 =} renders (sand brackets) as [35] $!--!{=%5.4f:1.414=} : [1.4140] $!--!{=%05X:14+14=} : [0001C] $!--!{= %-10s : 123 =} : [123 ]}}} And when specifying a formatting locale: {{{ !define FORMAT_LOCALE {fr} $!--!{=%5.4f:1.414=} : [1,4140]}}} !3 Operators supported |Comment |!note Spaces between items are optional | |'''Operator'''|'''Argument''' |'''Description''' | |!c ''arg'' |''constant or variable'' |Examples: 3, 12.4, 4E+8, $!--!{VALUE}, $!--!{some.var} | |!c ''expr'' |!c ''expression'' |Any valid combination of arguments and optional operations and parentheses| |!c '''+''' |!c ''expr'' + ''expr'' |Addition | |!c '''-''' |!c -''expr'' |Unary negation | |!c '''-''' |!c ''expr'' - ''expr'' |Subtraction | |!c '''!-*-!'''|!c ''expr'' !-*-! ''expr''|Multiplication | |!c '''/''' |!c ''expr'' / ''expr'' |Division | |!c '''^''' |!c ''expr'' ^ ''expr'' |Exponentiation | |!c '''sin''' |!c sin ''expr'' |Radian Sine of ''expr'' | |!c '''cos''' |!c cos ''expr'' |Radian Cosine of ''expr'' | |!c '''tan ''' |!c cos ''expr'' |Radian Tangent of ''expr'' | |!c '''( )''' |!c ( ''expr'' ) |Parenthetical grouping of an expression | #----------------------------------------------------------------- ----- !3 Test Blank Expressions ''' Build blank expression page ''' !|script | |start|Page Builder | |line |~1a:${==}~ | |line |~1b:${= =}~ | |line |~1c:${= =}~| |page |ExpressionPage | ''' Render it ''' !|Response Requester | |uri |valid?| |ExpressionPage|true | !**> Contents !|Response Examiner| |type |string? | |contents | | !|Response Examiner | |type |wrapped html?| |contents| | ***! ''' Verify results ''' !|Response Examiner | |type |pattern|matches?| |contents|~1a:~ |true | |contents|~1b:~ |true | |contents|~1c:~ |true | #----------------------------------------------------------------- ----- !3 Test Single Argument Expressions ''' Build expression page ''' !|script | |start|Page Builder | |line |!- ~2a:${=3=}~ -! | |line |!- ~2b:${= 4.2 =}~ -! | |line |!- ~2c:${= 2E+1 =}~ -! | |line |!- ~2d:${= 2.3E+42 =}~ -! | |line |!- ~2e:${= 4.2E + 24 =}~ -!| |page |ExpressionPage | ''' Render it ''' !|Response Requester | |uri |valid?| |ExpressionPage|true | !**> Contents !|Response Examiner| |type |string? | |contents | | !|Response Examiner | |type |wrapped html?| |contents| | ***! ''' Verify results ''' !|Response Examiner | |type |pattern |matches?| |contents|~2a:3~ |true | |contents|~2b:4.2~ |true | |contents|~2c:20~ |true | |contents|~2d:2.3E+42~|true | |contents|~2e:4.2E+24~|true | #----------------------------------------------------------------- ----- !3 Test spaces around experssions ''' Build expression page ''' !|script | |start|Page Builder | |line |!- ~3a:${=1+1=}~ -! | |line |!- ~3b:${=2 + 2=}~ -! | |line |!- ~3c:${= 3 + 3=}~ -!| |line |!- ~3d:${=4 + 4 =}~ -!| |line |!- ~3e:${=5 +5 =}~ -! | |page |ExpressionPage | ''' Render it ''' !|Response Requester | |uri |valid?| |ExpressionPage|true | !**> Contents !|Response Examiner| |type |string? | |contents | | !|Response Examiner | |type |wrapped html?| |contents| | ***! ''' Verify results ''' !|Response Examiner | |type |pattern|matches?| |contents|~3a:2~ |true | |contents|~3b:4~ |true | |contents|~3c:6~ |true | |contents|~3d:8~ |true | |contents|~3e:10~|true | #----------------------------------------------------------------- ----- !3 Test each operator ''' Build expression page ''' !|script | |start|Page Builder | |line |!- ~4plus:${= 1 + 2 =}~ -! | |line |!- ~4minus:${= 2 - 3 =}~ -! | |line |!- ~4unary:${= -12 =}~ -! | |line |!- ~4mult:${= 3 * 4 =}~ -! | |line |!- ~4div:${= 4 / 5 =}~ -! | |line |!- ~4exp:${=%2d: 5 ^ 6 =}~ -! | |line |!- ~4sin1:${=%5.4f: sin0.39269875 =}~ -!| |line |!- ~4sin2:${=%5.4f: sin 0.39269875 =}~ -!| |line |!- ~4sin3:${=%5.4f: sin(0.39269875) =}~ -!| |line |!- ~4sin4:${=%5.4f: sin(3.14159/8) =}~ -!| |line |!- ~4sin5:${=%5.4f: sin (3.14159/8) =}~ -!| |line |!- ~4cos:${=%5.4f: cos(3.14159 / 8) =}~ -!| |line |!- ~4tan:${=%5.4f: tan(3.14159 / 8) =}~ -!| |page |ExpressionPage | ''' Render it ''' !|Response Requester | |uri |valid?| |ExpressionPage|true | !**> Contents !|Response Examiner| |type |string? | |contents | | !|Response Examiner | |type |wrapped html?| |contents| | ***! ''' Verify results ''' !|Response Examiner | |type |pattern |matches?| |contents|~4plus:3~ |true | |contents|~4minus:-1~ |true | |contents|~4unary:-12~ |true | |contents|~4mult:12~ |true | |contents|~4div:0.8~ |true | |contents|~4exp:15625~ |true | |contents|~4sin1:0.3827~|true | |contents|~4sin2:0.3827~|true | |contents|~4sin3:0.3827~|true | |contents|~4sin4:0.3827~|true | |contents|~4sin5:0.3827~|true | |contents|~4cos:0.9239~ |true | |contents|~4tan:0.4142~ |true | #----------------------------------------------------------------- ----- !3 Test parentheses ''' Build expression page ''' !|script | |start|Page Builder | |line |!- ~5a:${= 2 * 3 + 4 / 2 - 3 =}~ -!| |line |!- ~5b:${= 2 * ( 3 + 4 ) / 2 - 3 =}~ -!| |line |!- ~5c:${= 2 * ( 3 + 4 ) / ( 2 - 3 ) =}~ -!| |line |!- ~5d:${= 2 * ( 3 + ( 4 / ( 2 - 3 ) ) ) =}~ -!| |page |ExpressionPage | ''' Render it ''' !|Response Requester | |uri |valid?| |ExpressionPage|true | !**> Contents !|Response Examiner| |type |string? | |contents | | !|Response Examiner | |type |wrapped html?| |contents| | ***! ''' Verify results ''' !|Response Examiner | |type |pattern |matches?| |contents|~5a:5~ |true | |contents|~5b:4~ |true | |contents|~5c:-14~|true | |contents|~5d:-2~ |true | #----------------------------------------------------------------- ----- !3 Test formatting ''' Build expression page ''' !|script | |start|Page Builder | |line |!- ~6a:${=%d:2 =}~ -!| |line |!- ~6b:${= %d : 3.2 =}~ -!| |line |!- ~6c:${=%02d: 2 + 1 =}~ -!| |line |!- ~6d:${= %4.4f: 2.2 / 3.4 =}~ -!| |line |!- ~6e:${=%03o: 16 =}~ -!| |line |!- ~6f:${= %03o : 18 =}~ -!| |line |!- ~6g:${=%03x: 26 =}~ -!| |line |!- ~6h:${=%03X: 27 =}~ -!| |line |!- ~6i:${= %-12s : 123 =}~ -!| |line |!- ~6j:${=%TY: 73422123127 =}~ -!| |line |!- ~6k:${=%b: 27 =}~ -!| |line |!- ~6l:${=%b: 0 =}~ -!| |line |!- ~6m:${=%B: 27 =}~ -!| |line |!- ~6n:${=%B: 0 =}~ -!| |line |!- ~6o:${= % d : 3.2 =}~ -!| |page |ExpressionPage | ''' Render it ''' !|Response Requester | |uri |valid?| |ExpressionPage|true | !**> Contents !|Response Examiner| |type |string? | |contents | | !|Response Examiner | |type |wrapped html?| |contents| | ***! ''' Verify results ''' !|Response Examiner | |type |pattern |matches?| |contents|~6a:2~ |true | |contents|~6b:3~ |true | |contents|~6c:03~ |true | |contents|~6d:0.6471~ |true | |contents|~6e:020~ |true | |contents|~6f:022~ |true | |contents|~6g:01a~ |true | |contents|~6h:01B~ |true | |contents|~6i:123         ~|true | |contents|~6j:1972~ |true | |contents|~6k:true~ |true | |contents|~6l:false~ |true | |contents|~6m:true~ |true | |contents|~6n:false~ |true | |contents|~6o: 3~ |true | #----------------------------------------------------------------- ----- !3 Test formatting with specific locale ''' Build expression page ''' !|script | |start|Page Builder | |line |!-!define FORMAT_LOCALE {fr}-! | |line |!- ~7a:${= %4.4f: 2.2 / 3.4 =}~ -!| |page |ExpressionPage | ''' Render it ''' !|Response Requester | |uri |valid?| |ExpressionPage|true | !**> Contents !|Response Examiner| |type |string? | |contents | | !|Response Examiner | |type |wrapped html?| |contents| | ***! ''' Verify results ''' !|Response Examiner | |type |pattern |matches?| |contents|~7a:0,6471~|true | #---[EOT]---