diff options
author | kobewi <kobewi4e@gmail.com> | 2021-12-16 13:37:54 +0100 |
---|---|---|
committer | kobewi <kobewi4e@gmail.com> | 2021-12-16 13:37:54 +0100 |
commit | e7722a9a7b036c08ea2817cc827070c27439483e (patch) | |
tree | 4ef1c7f1d8ae9a6f3ca83c0dcd6eecf3d8215d21 | |
parent | 91c05290738aae5662a76f59dd3e4ccfdf5e37ae (diff) |
Mention what happens if find_node() fails
-rw-r--r-- | doc/classes/Node.xml | 2 |
1 files changed, 1 insertions, 1 deletions
diff --git a/doc/classes/Node.xml b/doc/classes/Node.xml index 22ebbb87f3..753492ad34 100644 --- a/doc/classes/Node.xml +++ b/doc/classes/Node.xml @@ -186,7 +186,7 @@ <argument index="1" name="recursive" type="bool" default="true" /> <argument index="2" name="owned" type="bool" default="true" /> <description> - Finds a descendant of this node whose name matches [code]mask[/code] as in [method String.match] (i.e. case-sensitive, but [code]"*"[/code] matches zero or more characters and [code]"?"[/code] matches any single character except [code]"."[/code]). + Finds a descendant of this node whose name matches [code]mask[/code] as in [method String.match] (i.e. case-sensitive, but [code]"*"[/code] matches zero or more characters and [code]"?"[/code] matches any single character except [code]"."[/code]). Returns [code]null[/code] if no matching [Node] is found. [b]Note:[/b] It does not match against the full path, just against individual node names. If [code]owned[/code] is [code]true[/code], this method only finds nodes whose owner is this node. This is especially important for scenes instantiated through a script, because those scenes don't have an owner. [b]Note:[/b] As this method walks through all the descendants of the node, it is the slowest way to get a reference to another node. Whenever possible, consider using [method get_node] instead. To avoid using [method find_node] too often, consider caching the node reference into a variable. |