imported>Theraze |
imported>Bale |
| Line 1: |
Line 1: |
| | {{ | | {{ |
| − | #vardefine:name|monster_eval}}{{ | + | #vardefine:name|last_item_message}}{{ |
| − | #vardefine:return_type|float}}{{ | + | #vardefine:return_type|string}}{{ |
| | | | |
| | FunctionPage| | | FunctionPage| |
| | + | |
| | name={{#var:name}}| | | name={{#var:name}}| |
| | | | |
| Line 11: |
Line 12: |
| | return_type={{#var:return_type}}| | | return_type={{#var:return_type}}| |
| | return_also={{#var:return_also}}| | | return_also={{#var:return_also}}| |
| − | parameter1={{Param|string|expression}}|
| |
| − | p1desc={{pspan|expression}} is a mathematical expression to be solved.|
| |
| | }}| | | }}| |
| | | | |
| − | function_description= Evaluates an expression in the format used by variable monsters: | + | function_description=Returns the message that KoL reported in the event of error when trying to use an item. If the last item use was successful, then this will return an empty string.| |
| − | | |
| − | * No spaces are allowed within the expression, except as part of a zone/location name.
| |
| − | * + - * / ( ) have their usual mathematical meaning and precedence.
| |
| − | * ^ is exponentiation, with the highest precedence.
| |
| − | * Functions available: ceil(x) floor(x) sqrt(x) min(x,y) max(x,y)
| |
| − | * Preferences function: pref(text)
| |
| − | ** This must be used on preferences with a float value ONLY - merely retrieving an integer pref will corrupt it!
| |
| − | * There could be at most one of each text function in an expression.
| |
| − | ** This is no longer the case however and multiple of the same text functions should now work properly.
| |
| − | * All upper-case letters are reserved for internally-used variables. The ones likely to be of use in user code are:
| |
| − | ** A - player's ascension count
| |
| − | ** MUS - player's adjusted muscle
| |
| − | ** MYS - player's adjusted mysticality
| |
| − | ** MOX - player's adjusted moxie
| |
| − | ** ML - player's monster level adjustment
| |
| − | ** MCD - player's MCD modifier
| |
| − | * This wrapper allows user-defined variables to be used as well, which must have names starting with a lower-case letter (or underscore) to distinguish them from built-in variables. Variables are supplied as a float[string] map.
| |
| − | |
| |
| − | | |
| − | code1={{CodeSample|
| |
| − | title=Code Sample|
| |
| − | description=This script expands monster_eval() to include support for user-defined variables. It is extremely complex, but it is extremely useful to anyone who wants to use monster_eval().|
| |
| − | code=
| |
| − | <syntaxhighlight>
| |
| − | float eval(string expr, float[string] vars) {
| |
| − | buffer b;
| |
| − | matcher m = create_matcher( "\\b[a-z_][a-zA-Z0-9_]*\\b", expr );
| |
| − | while (m.find()) {
| |
| − | string var = m.group(0);
| |
| − | if (vars contains var) {
| |
| − | m.append_replacement(b, vars[var].to_string());
| |
| − | }
| |
| − | // could implement functions, pref access, etc. here
| |
| − | }
| |
| − | m.append_tail(b);
| |
| − | return modifier_eval(b.to_string());
| |
| − | }
| |
| | | | |
| − | # Everything below this line shows how to make use of eval().
| + | needscode=yes| |
| − | # TESTING:
| |
| | | | |
| − | float[string] v;
| + | see_also={{SeeAlso|last_skill_message}}| |
| − | v["pi"] = 3.14159265;
| |
| − | v["ten"] = 10;
| |
| − | print(eval("2+3", v));
| |
| − | print(eval("max(pi^ten,ten^pi)", v));
| |
| − | print(eval("sqrt(pi)*L", v));
| |
| − | print(eval("undefined/2", v));
| |
| | | | |
| − | </syntaxhighlight>}}|
| |
| | }} | | }} |
| | | | |
| − | [[Category:Math and Numbers]] | + | [[Category:Skills and Effects]] |