Godot - Nodeを検索する

GodotのGDScriptで子Nodeまたは親Nodeを検索する方法です。
get_node()などの他のNodeを参照する方法を用いる方が高速であり、子Nodeや親Nodeを必要とする多くのケースでは検索は必要ではありません。

find_children()にて子孫Nodeの全てからノードを検索する事が可能です。
find_children()の返り値は配列型で、一致するノードが見つからない場合、空の配列を返します。

var nodes = find_children("NodeName")
print(nodes.size())

パターン判定にて「*」は0個以上の文字にマッチします。
「?」は一つの文字にマッチします。

var nodes = find_children("NodeNam*")
print(nodes.size())

var nodes = find_children("NodeNam?")
print(nodes.size())

親Nodeを検索する場合、find_parent()が利用できます。
find_parent()の返り値は配列型で、一致するNodeが見つからない場合、空の配列を返します。

var nodes = find_parent("NodeName")
print(nodes.size())