8.3.22. ruby_eval

8.3.22.1. Summary

ruby_eval command evaluates Ruby script and returns the result.

8.3.22.2. Syntax

ruby_eval has one required parameter:

ruby_eval script

8.3.22.3. Usage

You can execute any scripts which mruby supports by calling ruby_eval.

Here is an example that just calculate 1 + 2 as Ruby script.

Execution example:

register ruby/eval
# [[0, 1337566253.89858, 0.000355720520019531], true]
ruby_eval "1 + 2"
# [[0, 1337566253.89858, 0.000355720520019531], {"value": 3}]

Register ruby/eval plugin to use ruby_eval command in advance.

Note that ruby_eval is implemented as an experimental plugin, and the specification may be changed in the future.

8.3.22.4. Parameters

This section describes all parameters.

8.3.22.4.1. script

It specifies the Ruby script which you want to evaluate.

8.3.22.5. Return value

ruby_eval returns the evaluated result with metadata such as exception information (Including metadata isn't implemented yet):

[HEADER, {"value": EVALUATED_VALUE}]

HEADER

See Output format about HEADER.

EVALUATED_VALUE

EVALUATED_VALUE is the evaludated value of ruby_script.

ruby_eval supports only a number for evaluated value for now. Supported types will be increased in the future.

8.3.22.6. See also