Welcome to the Godot Reference Fork and the Godot Proposals Fork alternatives. Why?


0 0 vote
Article Rating

Inherits: Reference < Object

A class that stores an expression you can execute.


An expression can be made of any arithmetic operation, built-in math function call, method call of a passed instance, or built-in type construction call.

An example expression text using the built-in math functions could be sqrt(pow(3,2) + pow(4,2)).

In the following example we use a LineEdit node to write our expression and show the result.

onready var expression = Expression.new()

func _ready():
    $LineEdit.connect("text_entered", self, "_on_text_entered")

func _on_text_entered(command):
    var error = expression.parse(command, [])
    if error != OK:
    var result = expression.execute([], null, true)
    if not expression.has_execute_failed():
        $LineEdit.text = str(result)


Variantexecute ( Array inputs=[ ], Object base_instance=null, bool show_error=true )
Stringget_error_text ( ) const
boolhas_execute_failed ( ) const
Errorparse ( String expression, PoolStringArray input_names=PoolStringArray( ) )

Method Descriptions

Executes the expression that was previously parsed by parse and returns the result. Before you use the returned object, you should check if the method failed by calling has_execute_failed.

If you defined input variables in parse, you can specify their values in the inputs array, in the same order.

  • String get_error_text ( ) const

Returns the error text if parse has failed.

  • bool has_execute_failed ( ) const

Returns true if execute has failed.

Parses the expression and returns an Error code.

You can optionally specify names of variables that may appear in the expression with input_names, so that you can bind them when it gets executed.

Doc ID missing

Disclaimer: This page has been automaticaly and directly extracted from the official Godot Docs website, the 1970-01-01 at 00:00:00. It’s the English Stable version because it’s what most Godot users should use. The Copyright owners are Juan Linietsky, Ariel Manzur and the Godot community. CC-BY 3.0. Thanks for your patience and generosity.

Notify of
Inline Feedbacks
View all comments
Would love your thoughts, please comment.x