Expression

继承: RefCounted < Object

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

描述

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

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

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

GDScriptC#

  1. var expression = Expression.new()
  2. func _ready():
  3. $LineEdit.text_submitted.connect(self._on_text_submitted)
  4. func _on_text_submitted(command):
  5. var error = expression.parse(command)
  6. if error != OK:
  7. print(expression.get_error_text())
  8. return
  9. var result = expression.execute()
  10. if not expression.has_execute_failed():
  11. $LineEdit.text = str(result)
  1. private Expression _expression = new Expression();
  2. public override void _Ready()
  3. {
  4. GetNode<LineEdit>("LineEdit").TextSubmitted += OnTextEntered;
  5. }
  6. private void OnTextEntered(string command)
  7. {
  8. Error error = _expression.Parse(command);
  9. if (error != Error.Ok)
  10. {
  11. GD.Print(_expression.GetErrorText());
  12. return;
  13. }
  14. Variant result = _expression.Execute();
  15. if (!_expression.HasExecuteFailed())
  16. {
  17. GetNode<LineEdit>("LineEdit").Text = result.ToString();
  18. }
  19. }

教程

方法

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 来指定可能出现在表达式中的变量名称,这样就可以在执行表达式时进行绑定。

Previous Next


© 版权所有 2014-present Juan Linietsky, Ariel Manzur and the Godot community (CC BY 3.0). Revision b1c660f7.

Built with Sphinx using a theme provided by Read the Docs.