summaryrefslogtreecommitdiff
path: root/doc/classes/Node.xml
diff options
context:
space:
mode:
authorRĂ©mi Verschelde <remi@verschelde.fr>2021-12-16 15:14:28 +0100
committerGitHub <noreply@github.com>2021-12-16 15:14:28 +0100
commitfeff06b5e7a54def7caae5e2ebda51394f8cea47 (patch)
tree373489f0a0d5e1d3e6aaded2a9229ec7c9892f21 /doc/classes/Node.xml
parentbe83968b6ba8bd91c18f4446ded4706a0094d773 (diff)
parente7722a9a7b036c08ea2817cc827070c27439483e (diff)
Merge pull request #55992 from KoBeWi/node_hide_and_seek
Diffstat (limited to 'doc/classes/Node.xml')
-rw-r--r--doc/classes/Node.xml2
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.