Expression

儲存你可以執行的運算式的類。

說明

運算式可以由任何算數運算、內建數學函式呼叫、傳遞實例的方法呼叫或內建型別建構呼叫組成。

一個使用內建數學函式的範例運算式文字可以是 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)

private Expression _expression = new Expression();

public override void _Ready()
{
    GetNode<LineEdit>("LineEdit").TextSubmitted += OnTextEntered;
}

private void OnTextEntered(string command)
{
    Error error = _expression.Parse(command);
    if (error != Error.Ok)
    {
        GD.Print(_expression.GetErrorText());
        return;
    }
    Variant result = _expression.Execute();
    if (!_expression.HasExecuteFailed())
    {
        GetNode<LineEdit>("LineEdit").Text = result.ToString();
    }
}

教學

運算式求值

方法

Variant	execute(inputs: Array = [], base_instance: Object = null, show_error: bool = true, const_calls_only: bool = false)
String	get_error_text() const
bool	has_execute_failed() const
Error	parse(expression: String, input_names: PackedStringArray = PackedStringArray())

方法說明

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

執行之前由 parse() 解析的運算式，並返回結果。在使用返回的物件之前，應該通過呼叫 has_execute_failed() 來檢查方法是否失敗。

如果你在 parse() 中定義了輸入變數，你可以在輸入陣列中以同樣的順序指定它們的值。

String get_error_text() const 🔗

如果 parse() 或 execute() 失敗，則返回錯誤文字。

bool has_execute_failed() const 🔗

如果 execute() 失敗，返回 true。

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

解析運算式並返回 Error 程式碼。

你也可以選擇用 input_names 來指定可能出現在運算式中的變數名稱，這樣就可以在執行運算式時進行綁定。