FindFirstChild (Function): Difference between revisions

From Goodblox Wiki
Jump to navigationJump to search
No edit summary
mNo edit summary
 
Line 1: Line 1:
{{CatUp|Functions}}
{{CatUp|Functions}}
 
<onlyinclude>{{Function|
{|
|<onlyinclude>{{Function|
name                  = FindFirstChild
name                  = FindFirstChild
|arguments            = [[String]] '''Name''', [[Bool]] '''recursive'''
|arguments            = [[String]] '''Name''', [[Bool]] '''recursive'''
Line 9: Line 7:
|object              = Global
|object              = Global
}}</onlyinclude>
}}</onlyinclude>
|}


==Example==
==Example==
Line 23: Line 20:


==Recursive==
==Recursive==
Recursive sets whether the function should look inside of objects in the calling object, as well as the calling object.
Recursive sets whether the function should look inside of objects in the calling object, as well as the calling object.



Latest revision as of 20:39, 23 September 2021

Function
Syntax FindFirstChild( String Name, Bool recursive )
Returns Instance found object
Description: Returns the first child found with a name of Name. Returns nil if no such child exists.
In Object: Global


Example

while true do  --Starts up a While loop
      local found = workspace:FindFirstChild("Brick")  --This looks in the Workspace for anything named "Brick", and sets the variable "found" to whatever object it finds.
     
     if found ~= nil then  -- This makes sure that it actually found something. If the variable is nothing, then it ends.
          found.Name = "blah"  --Sets the object's name to "blah"
     end  --End the If loop
end  --End the While loop

Recursive

Recursive sets whether the function should look inside of objects in the calling object, as well as the calling object.

For example, if there is a part in workspace called "Part" and you use:

workspace:FindFirstChild("Part", true)

It will find the part.