Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

Expression

继承: RefCounted < Object

存储你可以执行的表达式的类。

描述

表达式可以由任何算术运算、内置数学函数调用、传递实例的方法调用或内置类型构造调用组成。

一个使用内置数学函数的示例表达式文本可以是 sqrt(pow(3, 2) + pow(4, 2))

在下面的示例中,我们使用 LineEdit 节点来编写表达式并显示结果。

var expression = Expression.new()

func _ready():
    $LineEdit.text_submitted.connect(self._on_text_submitted)

func _on_text_submitted(command):
    var error = expression.parse(command)
    if error != OK:
        print(expression.get_error_text())
        return
    var result = expression.execute()
    if not expression.has_execute_failed():
        $LineEdit.text = str(result)

教程

方法

Variant

execute ( Array inputs=[], Object base_instance=null, bool show_error=true, bool const_calls_only=false )

String

get_error_text ( ) const

bool

has_execute_failed ( ) const

Error

parse ( String expression, PackedStringArray input_names=PackedStringArray() )


方法说明

Variant execute ( Array inputs=[], Object base_instance=null, bool show_error=true, bool const_calls_only=false )

执行之前由 parse 解析的表达式,并返回结果。在使用返回的对象之前,应该通过调用 has_execute_failed 来检查方法是否失败。

如果你在 parse 中定义了输入变量,你可以在输入数组中以同样的顺序指定它们的值。


String get_error_text ( ) const

如果 parseexecute 失败,则返回错误文本。


bool has_execute_failed ( ) const

如果 execute 失败,返回 true


Error parse ( String expression, PackedStringArray input_names=PackedStringArray() )

解析表达式并返回 Error 代码。

你也可以选择用 input_names 来指定可能出现在表达式中的变量名称,这样就可以在执行表达式时进行绑定。