FindFirstChild (Function)

From ROBLOX Wiki
Revision as of 12:31, 11 December 2024 by PRG (talk | contribs) (Created page with "{| |<onlyinclude> {{Function| name = FindFirstChild |arguments = 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. |object = Global |}}</onlyinclude> |} ==Example== <pre> while true do --Starts up a While loop found = game.Workspace:FindFirstChild("Bri...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search
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
  found = game.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:

game:FindFirstChild("Part", true)

It will find the part.