SharedTable

새로운 비어있는 SharedTable 를 반환합니다.

local st = SharedTable.new()

제공된 Luau 테이블의 요소와 동일한 새로운 SharedTable를 반환합니다.

제공된 Luau 테이블에 저장할 수 없는 키 또는 값이 포함되어 있으면 SharedTable에 구축된 SharedTable가 실패합니다.이 페이지 상단의 요약에서 SharedTable에 저장할 수 있는 개체 유형 목록을 참조하십시오.Luau 테이블에 값으로 테이블이 포함되어 있으면 해당 테이블이 새로운 SharedTable로 변환됩니다.

local t = {}
t.x = 1
t.y = 2
t.z = {"a", "b", "c"}

local st = SharedTable.new(t)
assert(st.x == 1)
assert(st.y == 2)
assert(st.z[1] == "a")
assert(st.z[2] == "b")
assert(st.z[3] == "c")

일부 경우에는 저장소에 SharedTable를 저장하는 것이 바람직할 수 있습니다. SharedTableRegistry에서.Class.ShareTableRegistry:GetSharedTable() 메서드는 이를 수행하는 편리한 방법을 제공합니다.

원자적으로 모든 요소를 SharedTable에서 제거합니다.

SharedTable가 동결되면 작업이 실패하고 오류가 발생합니다.

local st = SharedTable.new({"a", "b", "c"})
assert(SharedTable.size(st) == 3)

SharedTable.clear(st)
assert(SharedTable.size(st) == 0)

클론의 SharedTable 복사본을 생성하고 클론을 반환합니다.

선택적 deep 인수가 없거나, 있더라도 값이 false 인 경우 얕은 복제본이 생성됩니다.얕은 복제는 상위 수준의 SharedTable 개체만 복사합니다.SharedTable 자체의 모든 값이 SharedTable 인 경우 원래의 SharedTable 및 클론의 SharedTable 모두 동일한 SharedTable 에 참조합니다.

얕은 복제 작업은 원자적이므로 클론 SharedTable 은 다른 스크립트에서 동시에 수정되더라도 원래 SharedTable 의 상태에 대한 일관된 스냅샷을 포함합니다.

선택적 deep 인수가 존재하고 값이 true 인 경우 깊은 복제본이 생성됩니다.깊은 복제는 원래의 SharedTable 와 클론 사이에 공유되는 상태가 없는 구조의 SharedTable 개체를 재귀적으로 복사합니다.

그래프의 각 개체 내의 클론은 원자적이지만, 전체 깊은 클론은 원자적이지 않습니다.따라서 그래프 내의 각 SharedTable 클론에는 복제된 원래 SharedTable 개체의 상태에 대한 일관된 스냅샷이 포함되지만, 그래프가 다른 스크립트에서 동시에 수정되는 경우 다른 SharedTable 개체의 상태가 일관되지 않을 수 있습니다.

복제 중인 SharedTable 개체(들)가 얼어붙을 수도 있고 그렇지 않을 수도 있습니다.어쨌든 새로 생성된 클론은 *얼지 않았습니다 (따라서 수정할 수 있음)*이며동결된 클론을 생성하려면 SharedTable.cloneAndFreeze 함수를 사용하십시오.

얕은 복제와 깊은 복제의 차이를 보여주기 위해, 다음 샘플을 고려하십시오.이 첫 번째 샘플은 얕은 복제본을 만들고 두 번째는 깊은 복제본을 만듭니다.

의 얼어붙은 (읽기 전용) 클론을 생성하고 클론을 반환합니다.이 함수의 동작은 클론이 동결된 것을 제외하고 클론의 동작과 동일합니다.

깊은 복제가 요청되면 모든 복제된 SharedTable 개체가 동결됩니다.

원자적으로 요소의 값을 증가시킵니다.지정된 키가 있는 요소는 SharedTable에 존재해야 하며, 유형은 number여야 합니다.지정된 delta 는 값에 추가되고 원래 값이 반환됩니다.

SharedTable.update 함수는 이 목적으로도 사용할 수 있으며, 이 increment 함수는 편의와 성능을 위해 존재합니다(일반적으로 increment 는 update 보다 훨씬 빠르므로 가능하면 선호되어야 함).다음 두 함수 호출은 동일한 효과가 있습니다:

local st = SharedTable.new()
st["x"] = 1

local oldValue = SharedTable.increment(st, "x", 1)

SharedTable.update(st, "x", function(v)
    oldValue = v
    return v + 1
end)

SharedTable가 동결되면 작업이 실패하고 오류가 발생합니다.

true 이 SharedTable 가 동결되면 반환합니다(읽기 전용).

local st1 = SharedTable.new({"a", "b", "c"})
assert(not SharedTable.isFrozen(st1))

local st2 = SharedTable.cloneAndFreeze(st1)
assert(SharedTable.isFrozen(st2))

공유 테이블에 저장된 요소 수를 반환합니다.공유 테이블을 동시에 수정하는 다른 스크립트가 있으면 반환된 크기가 반환된 후에는 더 이상 올바르지 않을 수 있습니다, 다른 스크립트가 공유 테이블에서 요소를 추가하거나 제거했을 수 있기 때문입니다.

local st = SharedTable.new({"a", "b", "c"})
assert(SharedTable.size(st) == 3)

st[2] = nil
assert(SharedTable.size(st) == 2)

원자적으로 요소의 값을 업데이트합니다.

서로 다른 실행 컨텍스트에서 동시에 실행되는 스크립트에서 SharedTable에 액세스할 때, 액세스가 예측할 수 없게 교차할 수 있습니다.따라서 다음과 같은 코드는 값이 첫 번째 줄에서 읽고 두 번째 줄에서 업데이트되었기 때문에 일반적으로 잘못됩니다:

local oldValue = st["x"]
st["x"] = oldValue .. ",x"

업데이트 함수를 통해 요소에 원자적 업데이트를 수행할 수 있습니다.요소의 현재 값으로 호출할 함수가 필요합니다.그런 다음 함수는 새 값을 계산하고 반환합니다.함수는 다른 스크립트에서 동시에 수정되는 경우 SharedTable가 여러 번 호출될 수 있다는 점에 유의하십시오.

SharedTable가 동결되면 작업이 실패하고 오류가 발생합니다.