최소값(MinValue)보다 작거나 최대값(MaxValue)보다 클 수 없는 숫자 값을 생성하는 데 사용되는 인스턴스입니다.


아래 예제는 모든 언급된 객체가 존재한다고 가정할 때, DoubleConstrainedValue의 새로운 값을 변경될 때마다 출력합니다. 아래 예제에서는 2를 출력합니다. 이는 DoubleConstrainedValue의 MinValue와 MaxValue 범위 내에 있다고 가정합니다. 그렇지 않으면 변경 사항이 없습니다.

`Class.DoubleConstrainedValue`의 `Class.DoubleConstrainedValue.Value`가 변경될 때마다 발생합니다.


DoubleConstrainedValue.Changed

value

DoubleConstrainedValue.changed

DoubleConstrainedValue

DoubleConstrainedValue.ConstrainedValue

`Class.DoubleConstrainedValue.Value` 속성이 가질 수 있는 가장 높은 숫자입니다.


DoubleConstrainedValue.MaxValue

`Class.DoubleConstrainedValue.Value` 속성이 가질 수 있는 가장 낮은 숫자입니다.


DoubleConstrainedValue.MinValue

`Class.DoubleConstrainedValue.MinValue`와 `Class.DoubleConstrainedValue.MaxValue` 사이에 숫자 값을 보관하는 데 사용됩니다.


DoubleConstrainedValue.Value

모든 'Value Instance' 객체의 기본 클래스입니다.


ValueBase

`Instance`는 Roblox 클래스 계층의 모든 클래스의 기본 클래스입니다
`Class.DataModel` 트리에 포함될 수 있습니다.

루트 `Instance` 객체를 직접 생성할 수는 없지만, 특수한
`Datatype.Instance.new()` 생성자는 코드를 통해 객체를 생성하며,
클래스의 이름을 매개변수로 받아 생성된 객체를 반환합니다.


인스턴스의 조상이 변경되는 것을 감지하기 위해 `Class.Instance.AncestryChanged` 이벤트에 연결하는 방법을 보여줍니다.

ChangingPart의 Parent는 시간이 지남에 따라 다른 값으로 설정됩니다. 부품의 부모는 부품의 조상이므로, `Class.Instance.AncestryChanged` 이벤트는 변경될 때마다 발생합니다.

`Class.Instance.Parent` 속성이 객체 또는 그 조상 중 하나가 변경될 때 발생합니다.

이 이벤트에는 두 개의 매개변수가 포함됩니다: `child`는 실제로 `Class.Instance.Parent`가 변경된 `Class.Instance`를 나타내며, `parent`는 이 인스턴스의 새로운 `Class.Instance.Parent`를 나타냅니다.

이벤트를 사용하여 Studio에서 인스턴스의 삭제를 추적할 수 있으며, Explorer에서의 수동 삭제나 플러그인을 통해서도 가능합니다. `Class.Instance:Destroy()`를 사용하여 인스턴스가 파괴될 때를 감지해야 하는 경우에는 대신 `Class.Instance.Destroying` 이벤트를 사용하세요.


Instance.AncestryChanged

child

`Class.Instance.Parent`가 변경된 `Class.Instance`입니다.


parent

`Class.Instance.Parent`가 변경된 `Class.Instance`의 새로운 `Class.Instance.Parent`입니다.


`Class.Instance.Parent` 속성이 객체 또는 그 조상의 변경될 때 발생합니다.


이 이벤트는 인스턴스의 속성이 변경될 때마다 발생하며, 속성이 `nil`로 설정될 때도 포함됩니다. 변경된 속성의 이름이 연결된 함수에 전달됩니다.

예를 들어, 다음 코드 조각은 부분의 속성 중 하나가 변경될 때 `attributeChanged()` 함수를 발생시킵니다:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "변경됨")
end

part.AttributeChanged:Connect(attributeChanged)
```
특정 주어진 속성이 변경될 때 발생하는 이벤트를 반환하는 `Class.Instance:GetAttributeChangedSignal()`도 참조하십시오.


Instance.AttributeChanged

attribute

`Class.Instance`에서 속성이 변경될 때마다 발생합니다.


이 코드는 객체가 작업 공간에 추가될 때 그 이름을 출력합니다:

이 `Class.Instance`에 객체가 부모로 설정된 후에 발생합니다.

클라이언트에서 서버가 생성한 객체를 감지하기 위해 이 함수를 사용할 때는 `Class.Instance:WaitForChild()`를 사용하여 이 객체의 자손을 인덱스해야 합니다. 이는 객체와 그 자손이 서버에서 클라이언트로 동시에 복제되지 않기 때문입니다. 예를 들어:

```
local Workspace = game:GetService("Workspace")

Workspace.ChildAdded:Connect(function(child)
	-- 자손이 아직 복제되지 않았을 수 있으므로 WaitForChild() 사용
	local head = child:WaitForChild("Head")
end)
```
이 함수는 `Class.Instance`의 즉각적인 자식에 대해서만 작동합니다. 모든 자손을 감지하는 함수의 경우 `Class.Instance.DescendantAdded`를 사용하세요.

또한 `Class.Instance.ChildRemoved`도 참조하세요.


Instance.ChildAdded

객체가 이 `Class.Instance`에 부모로 설정된 후에 발생합니다.


이 코드 조각은 객체가 작업공간에서 제거될 때 그 이름을 출력합니다:

이 `Class.Instance`에서 자식이 제거된 후에 발생합니다.

제거란 객체의 부모가 이 `Class.Instance`에서 이 `Class.Instance`가 아닌 다른 것으로 변경된 것을 말합니다. 이 이벤트는 자식이 파괴될 때도 발생합니다(`Class.Instance:Destroy()` 사용) 왜냐하면 파괴 함수가 객체의 부모를 `nil`로 설정하기 때문입니다.

이 함수는 `Class.Instance`의 즉각적인 자식에 대해서만 작동합니다. 모든 자손을 감지하는 함수의 경우 `Class.Instance.DescendantRemoving`을 사용하세요.

또한 `Class.Instance.ChildAdded`도 참조하세요.


Instance.ChildRemoved

이 `Class.Instance`에서 자식이 제거된 후에 발생합니다.


다음 예제는 Workspace에 추가되는 모든 객체의 이름을 출력합니다:

이 이벤트는 `Class.Instance`에 자손이 추가된 후에 발생합니다.

모든 자손에 대해 발생하므로, 객체를 `Class.Instance`에 부모로 설정하면 이 객체와 그 모든 자손에 대해 각각 이벤트가 발생합니다.

`Class.Instance`의 **직접적인 자식**만 걱정하는 경우 `Class.Instance.ChildAdded`를 대신 사용하세요.

또한 `Class.Instance.DescendantRemoving`도 참조하세요.


Instance.DescendantAdded

descendant

이 `Class.Instance`에 자손이 추가된 후에 발생합니다.


다음 예제는 Workspace에서 제거되는 하위 항목의 이름을 출력합니다:

이 이벤트는 부모 `Class.Instance`가 **자손** 인스턴스의 부모가 더 이상 자손이 되지 않도록 변경되기 **바로 전에** 발생합니다. `Class.Instance:Destroy()|Destroy()`는 인스턴스의 `Class.Instance.Parent|Parent`를 `nil`로 변경하므로, 부모의 자손에 대해 그 메서드를 호출하는 경우 이 이벤트가 발생합니다.

이 이벤트는 자손이 제거되기 **전**에 발생하므로, 이 이벤트가 발생할 때 자손의 부모는 변경되지 않습니다. 자손이 부모의 **직접적인 자식**인 경우 이 이벤트는 `Class.Instance.ChildRemoved`보다 먼저 발생합니다.

자손이 자식을 가지고 있다면 이 이벤트는 먼저 자손으로 발생하고, 그 다음 자손의 자손이 발생합니다.

##### 경고

이 이벤트는 제거되고 있는 자손 객체와 함께 발생합니다. 자손의 `Class.Instance.Parent|Parent`를 다른 것으로 설정하려고 하면 실패합니다. 아래는 이를 설명하는 예입니다:

```
local Workspace = game:GetService("Workspace")

Workspace.DescendantRemoving:Connect(function(descendant)
	-- 이 함수에서 자손의 부모를 조작하지 마세요!
	-- 이 이벤트는 부모가 조작되었기 때문에 발생하며, 변경 사항이 아직 적용되지 않았습니다
	-- 따라서, 이렇게 부모를 변경하는 것은 문제를 일으킵니다:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
또한 `Class.Instance.DescendantAdded|DescendantAdded`도 참조하세요.


Instance.DescendantRemoving

제거되고 있는 `Class.Instance`입니다.


`Class.Instance`의 자손이 제거되기 바로 전에 발생합니다.


이 샘플은 즉시 신호 동작을 사용할 때, 인스턴스가 파괴될 때 연결된 함수가 대기할 때까지 자리가 유지되는 방법을 보여줍니다.

이 샘플은 지연 신호 동작을 사용할 때 인스턴스가 신호가 발생하기 전에 어떻게 파괴되는지를 보여줍니다.

`Class.Instance`는 연결된 함수가 여전히 사용 중인 동안 메모리에서 삭제되지 않습니다. 그러나 함수가 어느 시점에서 양보하면 `Class.Instance`와 그 자손은 `nil`로 부모가 설정됩니다.

`Class.Workspace.SignalBehavior` 속성이 `Enum.SignalBehavior.Immediate`로 설정된 경우, 이 이벤트는 `Class.Instance` 또는 그 조상이 `Class.Instance:Destroy()`로 파괴되기 바로 전에 발생합니다.

`Class.Workspace.SignalBehavior` 속성이 `Enum.SignalBehavior.Deferred`로 설정된 경우, 이 이벤트는 다음 재개 지점에서 발생하는데, 이는 `Class.Instance` 또는 그 조상이 `Class.Instance:Destroy()`로 파괴된 이후입니다.

`Enum.SignalBehavior.Deferred|Deferred` 동작의 경우, 스크립트를 자신의 `Class.Instance.Destroying` 이벤트에 연결하는 것이 문제가 될 수 있습니다. 왜냐하면 스크립트가 콜백이 호출되기 전에 파괴될 것이기 때문입니다 (즉, 실행되지 않습니다).

Studio에서 `Class.Instance`를 삭제할 때, 예를 들어 [Explorer](/studio/explorer)를 통해 수동으로 삭제하거나 플러그인을 통해 삭제할 때, `Class.Instance`는 파괴되지 않습니다. 대신 부모가 `nil`로 설정되며 이를 `Class.Instance.AncestryChanged`로 추적할 수 있습니다.


Instance.Destroying

`Class.Instance:Destroy()`를 통해 인스턴스가 파괴되기 **바로 전**에 발생하거나 (혹은 이후로 연기됩니다).


이 이벤트는 인스턴스에서 어떤 스타일 속성이 변경될 때마다 발생하며, 속성이 `nil`로 설정될 때도 포함됩니다.

```lua
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("스타일 속성이 변경되었습니다")
end

meterBar:StyledPropertiesChanged():Connect(stylePropertyChanged)
```


Instance.StyledPropertiesChanged

인스턴스에서 어떤 스타일 속성이 변경될 때마다 발생하며, 속성이 `nil`로 설정될 때도 포함됩니다.


Instance.childAdded

이 메서드는 인스턴스에 태그를 적용하며, 태그가 이미 적용된 경우에는 효과가 없습니다.
태그를 성공적으로 추가하면 주어진 태그에 대해 `Class.CollectionService:GetInstanceAddedSignal()`
에 의해 생성된 신호가 발생합니다.

##### 경고

- 클라이언트 측에서 추가된 인스턴스의 태그는 서버가 이후에 태그를 추가하거나 제거하면 
  드롭됩니다. 서버는 모든 태그를 함께 복제하며 이전 태그를 덮어씁니다.

- 인스턴스에 태그를 추가할 때, 태그 기능을 부여하기 위해 일반적으로 일부 리소스, 예를 들어 이벤트
  연결 또는 테이블이 사용됩니다. 메모리 누수를 방지하기 위해 더 이상 태그에 필요하지 않을 경우 
  이를 정리하는 것이 좋습니다(연결 해제, `nil`로 설정 등). `Class.Instance:RemoveTag()`를 호출하거나
  `Class.Instance:Destroy()`를 호출하거나 `Class.CollectionService:GetInstanceRemovedSignal()`   
  의해 반환된 신호에 연결된 함수에서 수행하세요.


Instance:AddTag

인스턴스에 태그를 적용합니다.


이 함수는 인스턴스의 모든 자식과 자손을 파괴합니다.

```
local part = Instance.new("Part")

-- 약간의 반짝임 추가
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

  local sc = Instance.new("Sparkles")
  sc.Parent = sparkles
end

print("Children:", #part:GetChildren())  --> Children: 3

part:ClearAllChildren()

print("Children:", #part:GetChildren())  --> Children: 0
```
모든 자식과 자손을 파괴하지 않으려면 `Class.Instance:GetChildren()` 또는
`Class.Instance:GetDescendants()`를 사용하여 해당 자식/자손을 루프 상에서 선택하여 파괴하세요.
예를 들어, 다음 코드 예제는 `Class.Model`로부터 파생된 모든 `Class.BasePart|BaseParts`를 파괴합니다:

```
local Workspace = game:GetService("Workspace")

local model = Workspace:FindFirstChild("TestModel")

for _, descendant in model:GetDescendants() do
	if descendant:IsA("BasePart") then
		descendant:Destroy()
	end
end
```


Instance:ClearAllChildren

인스턴스의 모든 자식을 파괴합니다.


Class.Instance:Clone()을 사용하여 모델 복제를 시연합니다.

`Clone()`은 인스턴스 및 모든 자손의 복사본을 생성하며,
`Class.Instance.Archivable|Archivable`가 아닌 모든 인스턴스는 무시합니다. 루트 인스턴스의 복사본은
이 메서드에 의해 반환되며 그 인스턴스의 `Class.Instance.Parent|Parent`는 `nil`로 설정됩니다. 인스턴스 자체에
`Class.Instance.Archivable|Archivable`가 `false`로 설정되어 있는 경우, 이 함수는 `nil`을 반환합니다.

`Class.ObjectValue.Value`와 같은 참조 속성이 클론 된 인스턴스에서 설정되면, 복사의
속성 값은 원본의 값에 따라 달라집니다:

- 참조 속성이 **또한** 클론된 인스턴스를 참조하는 경우,
  복사는 그 클론을 참조합니다.
- 참조 속성이 **클론되지 않은** 인스턴스를 참조하는 경우,
  동일한 값이 복사본에 유지됩니다.


Instance:Clone

인스턴스 및 모든 자손의 복사본을 생성하며, `Class.Instance.Archivable|Archivable`가 아닌 인스턴스는 무시합니다.


이 예제는 `Class.Instance:Destroy()` 함수를 사용하여 Part를 파괴하는 방법을 보여줍니다.

이 함수는 더 이상 필요하지 않은 객체를 처리하는 올바른 방법입니다.

`Class.Instance.Parent` 속성을 `nil`로 설정하고,
`Class.Instance.Parent` 속성을 잠그며, 모든 연결을 해제하고, 모든 자식에 대해 `Destroy()`를 호출합니다. 이 함수는 더 이상 필요하지 않은 객체를 처분하는 올바른 방법입니다.

불필요한 객체를 처분하는 것은 매우 중요합니다. 불필요한 객체와 연결이 있는 장소는 메모리를
사용하며 시간이 지남에 따라 심각한 성능 문제를 초래할 수 있습니다.

`Destroy()`를 호출한 후에는 객체(또는 자손)를 참조하는 변수를 `nil`로 설정하는 것이
모범 사례입니다. 이렇게 하면 코드가 객체와 관련된 어떤 것도 접근하지 않도록 방지할 수 있습니다.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- 이렇게 하지 마세요:
print(part.Name)  --> "Hello, world"
-- 위의 코드가 작동하지 않게 하려면:
part = nil
```

`Class.Instance`가 이 방법으로 파괴된 이후에는 재사용할 수 없습니다. `Class.Instance.Parent` 속성이
잠기기 때문입니다. 객체를 **일시적으로** 제거하고 싶다면, `Class.Instance.Parent|Parent`를 `nil`로 설정하세요. 예를 들어:

```
local Workspace = game:GetService("Workspace")

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
정해진 시간 후 객체를 파괴하려면 `Class.Debris:AddItem()`을 사용하세요.


Instance:Destroy

`Class.Instance.Parent` 속성을 `nil`로 설정하고,
`Class.Instance.Parent` 속성을 잠그며, 모든 연결을 해제하고, 모든 자식에 대해 `Destroy()`를 호출합니다.


`Class.Instance.Name`이 주어진 이름과 같은 첫 번째 조상을 반환합니다.

이 함수는 위로 작업하며, 인스턴스의 즉각적인 `Class.Instance.Parent`에서 시작하여
`Class.DataModel`로 올라갑니다. 일치하는 조상을 찾지 못하면 `nil`을 반환합니다.

다음 코드 스니펫은 `Car`라는 이름의 객체의 첫 번째 조상을 찾습니다.

```
local car = object:FindFirstAncestor("Car")
```
특정 클래스의 조상을 찾는 이 함수의 변형에 대한 내용은 `Class.Instance:FindFirstAncestorOfClass()`와
`Class.Instance:FindFirstAncestorWhichIsA()`를 참조하세요.


Instance:FindFirstAncestor

name

찾고자 하는 `Class.Instance.Name`입니다.


`Class.Instance.Name`이 주어진 이름과 같은 첫 번째 조상을 반환합니다.


`Class.Instance`의 첫 번째 조상을 반환하며,
`Class.Object.ClassName`이 주어진 className과 같을 경우.

이 함수는 위로 작업하며, 인스턴스의 즉각적인 `Class.Instance.Parent`에서 시작하여
`Class.DataModel`로 올라갑니다. 일치하는 조상을 찾지 못하면 `nil`을 반환합니다.

이 함수의 일반적인 용도는 `Class.BasePart`에 속하는 `Class.Model`을 찾는 것입니다. 예를 들어:

```
local model = part:FindFirstAncestorOfClass("Model")
```
이 함수는 `Class.Instance:FindFirstAncestor()`의 변형으로,
`Class.Instance.Name` 대신 `Class.Object.ClassName` 속성을 검사합니다. `Class.Instance:FindFirstAncestorWhichIsA()`도
존재하며, 상속을 존중하기 위해 `Class.Object:IsA()` 메서드를 사용합니다.


Instance:FindFirstAncestorOfClass

className

찾고자 하는 `Class.Object.ClassName`입니다.


`Class.Instance`의 첫 번째 조상을 반환하며,
`Class.Object.ClassName`이 주어진 className과 같은 경우.


`Class.Instance`의 첫 번째 조상을 반환하며,
주어진 className에 대해 `Class.Object:IsA()`가 true를 반환하는 경우.

이 함수는 위로 작업하며, 인스턴스의 즉각적인 `Class.Instance.Parent`에서 시작하여
`Class.DataModel`로 올라갑니다. 일치하는 조상을 찾지 못하면 `nil`을 반환합니다.

`Class.Instance:FindFirstAncestorOfClass()`와는 달리 이 함수는
`Class.Object:IsA()`를 사용하여 클래스 상속을 존중합니다. 예를 들어:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
따라서 다음 코드 샘플은 모든 `Class.BasePart` 조상을 반환하며, 그것이 `Class.WedgePart`이든,
`Class.MeshPart`이든, `Class.Part`이든 상관 없습니다.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
또한 `Class.Instance:FindFirstAncestor()`를 참조하세요.


Instance:FindFirstAncestorWhichIsA

`Class.Instance`의 첫 번째 조상을 반환하며,
주어진 className에 대해 `Class.Object:IsA()`가 true를 반환합니다.


아래 코드는 Workspace에서 객체 이름 "Brick"을 찾습니다. 찾으면,
객체의 이름을 "Foo"로 변경합니다.

주어진 이름을 가진 `Class.Instance`의 첫 번째 자식을 반환하며,
그런 자식이 존재하지 않으면 `nil`을 반환합니다. 선택적인 `recursive` 인자가
`true`인 경우, 이 함수는 `Class.Instance`의 즉각적인 자식이 아니라 모든 자손을
검색합니다.

##### 객체의 존재 확인하기

`FindFirstChild()`는 객체가 계속 진행되기 전에 존재하는지 확인할 필요가 있을 경우 필수입니다.
점 연산자를 사용하여 자식을 이름으로 인덱싱하려고 하면 자식이 존재하지 않으면 오류가 발생합니다.

```lua
local Workspace = game:GetService("Workspace")

-- 다음 줄은 파트가 작업 공간에 존재하지 않으면 오류가 발생합니다.
Workspace.Part.Transparency = 0.5
```
더 나은 방법은 먼저 `Part`를 확인하기 위해 `FindFirstChild()`를 사용한 다음,
그것이 필요할 경우 코드로 실행하는 것입니다.

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace:FindFirstChild("Part")
if part then
	part.Transparency = 0.5
end
```

##### 속성과 이름이 일치하는 자식 찾기

때때로 객체의 `Class.Instance.Name|Name`은 그 `Class.Instance.Parent|Parent`의 속성과 동일합니다.
점 연산자를 사용할 때, 속성이 이름이 같으면 자식보다 우선합니다.

다음 예제에서 `Color`라는 이름의 `Class.Folder`가 `Class.Part`에 추가됩니다.
그러나 `Class.Part`도 `Class.Part.Color` 속성을 가지고 있습니다. `part.Color`는 자식
`Class.Folder` 인스턴스가 아니라 `Datatype.Color3` 속성 값을 참조합니다. 
`Class.Instance:FindFirstChild()|FindFirstChild()`를 사용할 때의 장점은 새로운 속성이 도입되더라도
코드에 위험을 주지 않는 것입니다.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- 속성
local c2 = part:FindFirstChild("Color")  -- 자식 폴더
```

##### 성능 노트

`Class.Instance:FindFirstChild()|FindFirstChild()`는 점 연산자를 사용하는 것보다 약 20% 더 오랜 시간이 걸리며,
단순히 객체를 참조를 저장하는 것보다 거의 8배 더 오랜 시간이 걸립니다. 따라서 성능에 의존하는 코드,
예를 들어 빡빡한 루프나 `Class.RunService.Heartbeat` 및 `Class.RunService.PreRender`에 연결된 함수에서는
이 함수를 호출하는 것을 피하세요. 대신 결과를 변수에 저장하거나, 자식의 이름이 주어진 경우 사용 가능한지를 탐지하기 위해
`Class.Instance.ChildAdded|ChildAdded` 또는 `Class.Instance:WaitForChild()|WaitForChild()`를 고려하세요.


Instance:FindFirstChild

검색할 `Class.Instance.Name`입니다.


recursive

검색이 재귀적으로 수행되어야 하는지 여부.


주어진 이름으로 찾은 `Class.Instance`의 첫 번째 자식을 반환합니다.


주어진 `className`과 같은 `Class.Instance`의 첫 번째 자식을 반환합니다.
`Class.Instance:FindFirstChildWhichIsA()`와 달리 이 함수는
클래스가 `className`과 일치하는 객체만 반환하며, 클래스 상속을 무시합니다.
일치하는 자식이 없으면 이 함수는 `nil`을 반환합니다.


Instance:FindFirstChildOfClass

검색할 `Class.Object.ClassName`입니다.


주어진 클래스 이름과 같은 `Class.Instance`의 첫 번째 자식을 반환합니다.


주어진 클래스 이름에 대해 `Class.Object:IsA()`가 true를 반환하는 `Class.Instance`의 첫 번째 자식을 반환합니다.

일치하는 자식이 없으면 이 함수는 `nil`을 반환합니다. 
선택적인 재귀 인자가 true인 경우, 이 함수는 `Class.Instance`의
즉각적인 자식이 아니라 모든 자손을 검색합니다.

`Class.Instance:FindFirstChildOfClass()`와 달리 이 함수는
`Class.Object:IsA()`를 사용하여 클래스 상속을 존중합니다. 예를 들어:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
따라서 다음 코드 샘플은 첫 번째 `Class.BasePart` 자식을 반환합니다.
그것이 `Class.WedgePart`, `Class.MeshPart` 또는 `Class.Part` 여부와 관계없이

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
이름으로 자식을 찾으려는 개발자는 대신 `Class.Instance:FindFirstChild()`를 사용해야 합니다.


Instance:FindFirstChildWhichIsA

주어진 클래스 이름에 대해 `Class.Object:IsA()`가 true를 반환하는 `Class.Instance`의 첫 번째 자식을 반환합니다.


주어진 `Class.Instance.Name`을 가진 첫 번째 자손을 반환합니다.

이 메서드는 비활성화되어 사용할 수 없습니다. 인스턴스의 첫 번째 자손을 찾으려면
대신 `Class.Instance:FindFirstChild()`의 `recursive` 매개변수를 사용하세요.


Instance:FindFirstDescendant

주어진 `Class.Instance.Name`을 가진 첫 번째 자손을 반환합니다.


`Class.Instance`가 `Class.Actor`인 경우, `Class.Actor` 자체가
반환됩니다. 그렇지 않으면 가장 가까운 조상인 `Class.Actor`가 반환됩니다. 
조상 중 `Class.Actor`가 없는 경우 결과는 `nil`입니다.


Instance:GetActor

`Instance`와 연결된 `Class.Actor`를 반환합니다, 있다면.


이 메서드는 주어진 속성 이름에 할당된 값을 반환합니다. 할당된 속성이 없으면 `nil`이 반환됩니다.

예를 들어, 다음 코드 스니펫은 인스턴스의 `InitialPosition` 속성에 값을 설정한 후 이를 가져옵니다:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local initialPosition = instance:GetAttribute("InitialPosition")
print(initialPosition)
```

##### 참조

- 주어진 이름으로 주어진 값을 속성에 설정하는 `Class.Instance:SetAttribute()`.
- 인스턴스의 각 속성에 대한 키-값 쌍의 사전을 반환하는 `Class.Instance:GetAttributes()`.


Instance:GetAttribute

주어진 속성 이름에 할당된 값입니다. 속성이 할당되지 않은 경우에는 `nil`이 반환됩니다.


주어진 속성 이름에 할당된 값을 반환합니다.


이 함수는 `Class.Object.Changed|Changed` 이벤트와 동일하게 작동하는 이벤트를 반환하지만, 특정 주어진 속성이 변경될 때만 발생합니다; 효과적으로는 `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`와 유사하지만 속성에 대한 것입니다.

이 메소드 대신 `Class.Object.Changed|Changed`에 대한 함수와 함께 속성 이름을 확인하는 연결을 사용하는 것이 일반적으로 좋습니다. 동일한 객체에서 동일한 속성 이름으로 이 메소드를 후속 호출하면 동일한 이벤트가 반환됩니다.

다음 코드 예제는 부분의 `InitialPosition` 속성이 변경될 때 `attributeChanged()` 함수를 발생시키는 신호를 반환합니다:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local function attributeChanged()
	print("속성이 변경되었습니다.")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```

`Class.Instance.AttributeChanged`도 참조하십시오. 인스턴스에서 속성이 변경될 때마다 발생합니다.


Instance:GetAttributeChangedSignal

변경 신호가 반환되는 지정된 속성의 이름입니다.


주어진 속성이 변경될 때 발생하는 이벤트입니다.


주어진 속성이 변경될 때 발생하는 이벤트를 반환합니다.


이 메소드는 속성의 이름을 키로 하고 `nil`이 아닌 값을 값으로 가지는 키-값 쌍의 사전을 반환합니다.

예를 들어, 다음 코드 조각은 인스턴스의 속성과 값을 출력합니다:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)
part:SetAttribute("CanUse", true)

for name, value in part:GetAttributes() do
	print(name .. " = " .. value)
end
```

`Class.Instance:GetAttribute()`도 참조하십시오. 주어진 속성 이름에 할당된 값을 반환합니다.


Instance:GetAttributes

속성의 이름이 키이고 `nil`이 아닌 값이 값을 가지는 문자열 → 변형 쌍의 사전입니다.


인스턴스의 속성 사전을 반환합니다.


아래 코드는 실행 시 워크스페이스에 있는 모든 객체의 이름을 출력합니다.

이 함수는 인스턴스의 모든 직계 자식, 또는 객체와 `Class.Instance.Parent|Parent`가 동일한 모든 `Class.Instance`를 포함하는 배열(숫자 인덱스 테이블)을 반환합니다. 배열은 숫자 또는 일반 루프를 사용하여 반복할 수 있습니다:

```lua
local Workspace = game:GetService("Workspace")

-- 숫자 for 루프 예제
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. "는 자식 번호 " .. i .. "입니다.")
end
```

```lua
local Workspace = game:GetService("Workspace")

-- 일반 for 루프 예제
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. "는 자식 번호 " .. i .. "입니다.")
end
```
자식들은 그들의 `Class.Instance.Parent|Parent` 속성이 객체에 설정된 순서에 따라 정렬됩니다.

`Class.Instance:GetDescendants()|GetDescendants` 함수도 참조하십시오.


Instance:GetChildren

인스턴스의 자식 객체를 포함하는 배열입니다.


인스턴스의 모든 자식 객체를 포함하는 배열을 반환합니다.


이 함수는 Roblox 내부에서 사용되는 디버그 ID의 코드화된 문자열을 반환합니다. 주의:

- 이 항목은 보호됩니다. `Class.Script`나 `Class.LocalScript`에서 사용하면 오류가 발생합니다.
- 디버그 ID는 디버깅 프로세스에서 사용되는 ID입니다. 이는 디버거가 응용 프로그램이 처리하기 전에 각 명령어를 읽을 수 있도록 합니다. Roblox의 모든 객체는 프로세스처럼 작동하며 필요에 따라 디버깅할 수 있는 모든 실행 명령(또는 '코드')을 가지고 있습니다.
- 이는 비슷한 객체를 구별하는 데 도움이 될 수 있습니다(예: 동일한 이름을 가진 객체).


Instance:GetDebugId

scopeLength

Roblox 내부에서 사용되는 디버그 ID의 코드화된 문자열을 반환합니다.


GetDescendants는 특정 유형의 객체에 속한 모든 자손에게 무언가를 수행하는 데 자주 사용됩니다. 이 예제의 코드는 GetDescendants와
`Class.Instance:IsA()`를 사용하여 작업 공간의 모든 부품을 찾아 녹색으로 변경합니다.

이 객체 메소드는 해당 객체의 모든 자손을 포함하는 배열을 반환합니다. `Class.Instance:GetChildren()`와 달리, 즉시 자식을 반환하는 이 메소드는 객체의 모든 자식과 그 자식의 모든 자식을 찾습니다.


Instance:GetDescendants

인스턴스의 자손을 포함하는 배열입니다.


인스턴스의 모든 자손을 포함하는 배열을 반환합니다.


이 코드 샘플은 `Class.Instance:GetFullName()`의 동작을 보여줍니다.
`DataModel` 계층에 없는 객체에서 호출될 때 함수가 어떻게 작동하는지 보여주며, 
반환값이 특수 문자를 탈출하지 않는 방법도 보여줍니다.

이 코드 샘플은 `Class.Instance:GetFullName()` 함수를 Lua로 다시 구현합니다.

인스턴스의 조상을 설명하는 문자열을 반환합니다. 문자열은 객체와 그 조상들의 `Class.Instance.Name|Name`을 연결하여 마침표로 구분합니다. `Class.DataModel`(`game`)은 고려되지 않습니다. 예를 들어, `Class.Workspace`의 `Class.Part`는 `Class.Workspace.Part`를 반환할 수 있습니다.

`Class.DataModel`의 자손이 아닌 `Class.Instance`에서 호출할 때, 이 함수는 `Class.Instance.Parent|Parent`가 없는 가장 상위 조상까지 모든 조상을 고려합니다.

이 함수는 로깅 및 디버깅에 유용합니다. 반환된 문자열을 유용한 작업을 위해 구문 분석하려고 시도해서는 안 됩니다; 이 함수는 객체 이름에서 마침표(또는 다른 기호)를 이스케이프하지 않습니다. 다시 말해, 출력은 종종 유효한 Luau 식별자인 것처럼 보이지만 보장되지는 않습니다.


Instance:GetFullName

`Class.Instance`의 전체 이름입니다.


인스턴스의 조상을 설명하는 문자열을 반환합니다.


이 메소드는 지정된 속성의 스타일링된 또는 명시적으로 수정된 값을 반환합니다. 스타일링/수정되지 않았다면 기본 속성 값을 반환합니다. 이는 `[GuiObject].Rotation`과 같은 속성 값을 직접 접근하는 것과는 약간 다릅니다. 이는 속성의 기본값 또는 수정된 값을 반환합니다.

```lua
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")

local coreSheet = ReplicatedStorage:FindFirstChild("CoreSheet")
local rule = coreSheet:FindFirstChildWhichIsA("StyleRule")
rule.Selector = "TextButton"

-- 버튼 참조
local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

print(button:GetStyled("Rotation")) --> 0 (기본값)
print(button.Rotation) --> 0 (기본값)

-- 스타일 규칙 속성을 통해 회전 적용
rule:SetProperty("Rotation", 30)

print(button:GetStyled("Rotation")) --> 30 (규칙에 따른 스타일 값)
print(button.Rotation) --> 0 (기본값)

-- 스타일 속성을 명시적으로 수정/재정의
button.Rotation = 45

print(button:GetStyled("Rotation")) --> 45 (수정된 값)
print(button.Rotation) --> 45 (수정된 값)
```


Instance:GetStyled

지정된 속성의 스타일링된 또는 명시적으로 수정된 값, 또는 스타일링/수정되지 않았다면 기본 속성 값입니다.


지정된 속성의 스타일링된 또는 명시적으로 수정된 값을 반환합니다. 스타일링/수정되지 않았다면 기본 속성 값을 반환합니다.


이 메소드는 `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` 이벤트와 동일하게 작동하는 이벤트를 반환하지만, 주어진 스타일 속성이 변경될 때만 발생합니다. 이러한 속성 이름을 확인하는 함수와 함께 `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`에 대한 연결 대신 이 메소드를 사용하는 것이 일반적으로 좋습니다. 동일한 객체에서 동일한 속성 이름으로 이 메소드를 후속 호출하면 동일한 이벤트가 반환됩니다.

이 이벤트는 연결된 함수에 인수를 전달하지 않으므로, 변경된 속성의 값은 스크립트 내에서 직접 읽어야 합니다.

```lua
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("스타일 속성이 변경되었습니다!")
end

meterBar:GetStyledPropertyChangedSignal("AnchorPoint"):Connect(stylePropertyChanged)
```


Instance:GetStyledPropertyChangedSignal

property

변경 사항을 수신 대기할 스타일 속성의 이름입니다.


주어진 스타일 속성이 변경될 때 발생하는 이벤트입니다.


이 메소드는 지정된 인스턴스에 적용된 태그의 배열을 문자열로 반환합니다. Studio의 [속성](/studio/properties) 창에서 또는 런타임에서 `Class.Instance:AddTag()|AddTag()`를 사용하여 태그를 추가할 수 있습니다.

이 메소드는 한 번에 여러 태그로 작업할 때 유용합니다. 그러나 단일 태그의 존재 여부를 확인하기 위해 이 메소드를 사용하는 것은 비효율적입니다. 대신 특정 태그를 확인하기 위해 `Class.Instance:HasTag()|HasTag()`를 사용하세요.


Instance:GetTags

인스턴스에 적용된 모든 태그의 배열을 가져옵니다.


이 메소드는 제공된 태그가 객체에 추가되었으면 `true`를 반환합니다. Studio의 [속성](/studio/properties) 창에서 또는 런타임에 `Class.Instance:AddTag()|AddTag()`를 사용하여 태그를 추가할 수 있습니다.


Instance:HasTag

인스턴스가 주어진 태그를 가지고 있는지 확인합니다.


한 인스턴스가 다른 인스턴스의 조상인지 판별하는 방법을 보여줍니다 `Class.Instance:IsAncestorOf()`

Workspace와 SpawnLocation은 SpawnLocation의 데칼의 조상입니다.
Workspace는 SpawnLocation의 조상입니다.

SpawnLocation과 그 데칼은 Workspace의 자식이며, 조상이 아닙니다.
데칼은 SpawnLocation의 자식이며, 조상이 아닙니다.

주어진 자손의 조상인지 `Class.Instance`가 `true`를 반환합니다.

`Class.Instance`는 객체의 `Class.Instance.Parent` 또는 그 부모의 `Class.Instance.Parent`가 `Class.Instance`에 설정된情况下 조상으로 간주됩니다.

`Class.Instance:IsDescendantOf()`도 참조하십시오.


Instance:IsAncestorOf

주어진 자손의 조상인 경우 `true`입니다.


주어진 자손의 조상이 `Class.Instance`인지 확인합니다.


주어진 조상의 자손인 경우 `true`를 반환합니다.

`nil`을 매개변수로 사용할 수 없으므로 객체가 제거되었는지 확인할 수 없습니다.

`Class.Instance:IsAncestorOf()`도 참조하십시오.


Instance:IsDescendantOf

ancestor

주어진 조상의 자손인 경우 `true`입니다.


주어진 조상의 자손인지 확인합니다.


지정된 속성에 저장된 값이 코드로 인스턴스화된 기본값과 동일한 경우 `true`를 반환합니다. 예를 들어, `Class.TextLabel.TextSize|TextSize` 속성을 출력할 때 값이 `8`이면 `IsPropertyModified("TextSize")`를 호출하면 `false`가 반환됩니다. 이것은 `TextLabel`이 `Instance.new("TextLabel")`을 통해 생성된 경우의 기본값입니다.

이 메소드가 `true`를 반환하면, 스타일링이 속성에 영향을 미치지 않습니다. 속성을 명시적으로 수정하는 것이 스타일링보다 우선합니다.


Instance:IsPropertyModified

속성이 수정되었는지 여부를 나타내는 불리언입니다.


지정된 속성에 저장된 값이 코드로 인스턴스화된 기본값과 동일한 경우 `true`를 반환합니다.


다음 코드는 부품이 제거된 후 데이터 모델에 다시 추가되는 방법을 보여줍니다:

이 함수는 객체의 `Class.Instance.Parent`를 `nil`로 설정하며, 모든 자손도 동일하게 처리합니다.

객체가 제거되기 전에 참조되면 나중에 객체를 검색할 수 있습니다.


Instance:Remove

`Parent`를 `nil`로 설정하며, 모든 자손도 동일하게 처리합니다.


이 메소드는 인스턴스에서 태그를 제거합니다. 객체가 태그를 가지고 있지 않을 경우 오류가 발생하지 않습니다. 태그를 성공적으로 제거하면 `Class.CollectionService:GetInstanceRemovedSignal()` 의해 생성된 신호가 발생합니다.

태그를 추가할 때 태그의 기능을 제공하기 위해 일부 리소스가 사용되는 것이 일반적입니다(예: 이벤트 연결 또는 테이블). 태그에 더 이상 필요하지 않은 경우 메모리 누수를 방지하기 위해 이를 정리하는 것이 좋습니다(연결 끊기, `nil`로 설정 등).


Instance:RemoveTag

인스턴스에서 태그를 제거합니다.


속성을 기본값으로 재설정합니다. 예를 들어, `Class.TextLabel`에서 `ResetPropertyToDefault("Rotation")`를 호출하는 것은 `Class.TextLabel.Rotation|Rotation`을 `0`(속성의 기본값)으로 설정하는 것과 같습니다. 이 메소드는 스타일링이 이 속성의 기본값을 덮어쓸 수 있도록 보장하는 데 사용될 수 있습니다.


Instance:ResetPropertyToDefault

속성을 기본값으로 재설정합니다.


이 메소드는 주어진 이름의 속성을 주어진 값으로 설정합니다. 주어진 값이 `nil`이면 현재 속성이 제거됩니다. 기본값으로 `nil`이 반환됩니다.

예를 들어, 다음 코드 조각은 인스턴스의 `InitialPosition` 속성을 `Datatype.Vector3|Vector3.new(0, 10, 0)`으로 설정합니다:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", Vector3.new(0, 10, 0))
```

##### 제한 사항

이름 규칙 및 제한:

- 이름은 알파벳 및 숫자 문자만 사용할 수 있습니다.
  - 마침표, 하이픈, 슬래시 및 밑줄을 포함할 수 있습니다.
- 공백이나 고유 기호(예: @, ~, !)는 허용되지 않습니다.
- 문자열은 100자 이하이어야 합니다.
- 이름은 **RBX**로 시작할 수 없습니다. 호출자가 Roblox 핵심 스크립트일 때만 허용됩니다(로블록스 전용).

지원되지 않는 유형에 속성을 설정하려고 하면 오류가 발생합니다.

##### 또한 참조하십시오

- `Class.Instance:GetAttribute()`는 주어진 속성 이름에 할당된 값을 반환합니다.
- `Class.Instance:GetAttributes()`는 각 인스턴스의 속성에 대한 키-값 쌍의 사전을 반환합니다.


Instance:SetAttribute

지정된 속성에 설정할 값입니다.


주어진 이름의 속성을 주어진 값으로 설정합니다.


다음 코드는 "Part"라는 이름의 인스턴스가
Workspace에 추가될 때까지 기다립니다.

주어진 이름의 `Class.Instance` 자식을 반환합니다. 자식이 존재하지 않으면 현재 스레드를 잠금 상태로 두고 기다립니다. `timeOut` 매개변수가 지정되면 이 메소드는 지정된 초수를 초과하면 시간 초과로 간주하고 `nil`을 반환합니다.

##### 주요 사용 방법

`Class.Instance:WaitForChild()|WaitForChild()`는 `Class.LocalScript`에서 클라이언트 코드 작업을 할 때 매우 중요합니다. Roblox 엔진은 서버에서 클라이언트로 객체가 복제되는 시간이나 순서를 보장하지 않습니다. 또한 경험이 `Class.Workspace.StreamingEnabled`가 true로 설정된 경우에는 플레이어의 캐릭터로부터 멀리 떨어진 `Class.BasePart|BaseParts`가 클라이언트로 스트리밍되지 않을 수 있으며, 그로 인해 존재하지 않는 객체의 인덱싱 시 스크립트가 중단될 수 있습니다.

##### 참고 사항

- 호출 시 주어진 이름의 자식이 존재하면 이 함수는 잠금을 걸지 않습니다.
- `Class.Instance:FindFirstChild()`는 존재한다고 가정되는 객체에 대해 `Class.Instance:WaitForChild()|WaitForChild()`보다 더 효율적인 대안입니다.
- 이 메소드 호출이 반환되지 않고 5초를 초과하면, 지정된 `timeOut` 매개변수가 없으면 스레드가 무한정 잠금 상태로 있을 수 있다는 경고가 출력됩니다.


Instance:WaitForChild

childName

찾으려는 `Class.Instance.Name`입니다.


timeOut

선택적 시간 초과 매개변수입니다.


주어진 이름의 `Class.Instance` 자식을 반환합니다. 자식이 존재하지 않으면 현재 스레드를 잠금 상태로 두고 기다립니다.


자식 함수는 객체의 자식 배열을 반환합니다.


Instance:children

자식 객체/인스턴스의 배열입니다.


객체의 자식 배열을 반환합니다.


Instance:clone

Instance:destroy

Instance:findFirstChild

Instance:getChildren

Instance:isDescendantOf

Instance:remove

Instance

이 속성은 인스턴스가 경험이 발행되거나 저장될 때, 또는 `Class.Instance:Clone()|Clone()`
가 인스턴스의 조상 중 하나에서 호출될 때 포함되어야 하는지를 결정합니다. 인스턴스에 직접
`Class.Instance:Clone()|Clone()`을 호출하면 그 인스턴스가 **아니면**
`Class.Instance.Archivable|Archivable`인 경우 `nil`을 반환합니다.

스튜디오에서 **중복(Duplicate)** 또는 **복사/붙여넣기** 옵션을 사용하여 객체를 복사하면,
자신의 `Class.Instance.Archivable|Archivable` 속성을 무시하고 복사의
`Class.Instance.Archivable|Archivable`를 `true`로 설정합니다.

```
local part = Instance.new("Part")
print(part:Clone())  --> Part
part.Archivable = false
print(part:Clone())  --> nil
```


Instance.Archivable

`Class.Instance` 및 그 자손이 `Class.Instance:Clone()`을 사용하여
클론될 수 있는지와 저장/발행될 수 있는지를 결정합니다.


`Instance`는 Roblox 클래스 계층의 모든 클래스의 기본 클래스입니다
`Class.DataModel` 트리에 포함될 수 있습니다.


/reference/engine/classes/DoubleConstrainedValue.yaml