代表可以在執行上下文之間共享的表狀資料結構。雖然它可以用於各種一般數據存儲，但它專門為與 Parallel Luau 一起使用設計，在那裡它可以用於在不同的 Actor 。
有一些詞彙方式可以在腳本之間傳送共享表。一種方法是將 SharedTable 物件存儲和取回到 SharedTableRegistry 中。註冊允許任何在相同數據模型中的腳本獲得或設置 SharedTable 名稱。另一種方法是使用 Actor:SendMessage() 將共用表傳送到另一個 Actor 內的消訊息中。
像 Luau 表一樣，SharedTable 個對象儲存一組鑰匙值元素對齊。與 Luau 表不同，只有在共用表中儲存選定類型的對象才能與其他在 Roblox 引擎中找到的限制類似。
鑰匙必須是(1)字串或(2)負數小於232的非負整數。其他類型的鑰匙不支持。
值必須具有以下類型之一：Boolean、Number、Vector、String、SharedTable 或可序列化的數據輸入。能夠將 SharedTable 存儲為另一個 SharedTable 的值，允許建立孤立和鏈接的資料結構。
SharedTable 對象是不同的，不同的 SharedTable 對象永遠不會比較等值，即使它們有相同的內容。
像 Luau 表一樣，SharedTable 對象可能被凍結，在此情況下它是閱讀僅限的。嘗試修改凍結的 SharedTable 將會發生錯誤。凍結的 SharedTable 可以先創建一個(非凍結、可修改) SharedTable 包含所需內容,然後呼叫 SharedTable.cloneAndFreeze() 創建一個凍結複製。
範例程式碼
Elements in a SharedTable are accessed in the same way as elements of Luau tables, using the st[k] syntax or, for string keys, st.k.
local st = SharedTable.new()
st[1] = "a"
st["x"] = true
st.y = 5
assert(st[1] == "a")
assert(st["x"] == true)
assert(st.x == true)
assert(st["y"] == 5)
assert(st.y == 5)
-- true is not a valid SharedTable key, so attempting to set that key
-- fails:
assert(not pcall(function() st[true] = 100 end))
-- A function is not a valid SharedTable value, so attempting to set a
-- value to a function fails:
assert(not pcall(function() st["f"] = function() end end))循環 for 可用於在 SharedTable 元素上循環。SharedTable 的元素不會直接循環。相反，淺複製由 SharedTable 製成，其元素被循環。這是為了確保在整個循環期間維持一致的 SharedTable 視圖。因此，下列兩個循環的行為相同。
請注意，這意味著如果 SharedTable 直接從迭代循環的體內存取，其狀態可能與通過迭代觀察到的狀態不一致。
循環順序部分指定。具有數字鍵的元素會在字串鍵元素之前循環。具有數字鍵的元素依照升序排列進行循環。具有字串鍵的元素會在未指定的順序中循環。
local st = SharedTable.new({"a", "b", "c"})
for k, v in SharedTable.clone(st, false) do
print(k, ": ", v)
end
for k, v in st do
print(k, ": ", v)
end概要
建構子
- new()
返回新的、空的 SharedTable 。
返回一個新的 SharedTable 包含與提供的 Luau 表中的元素相等的元素。
函式
移除所有元素的 SharedTable 。
創建並返回提供的 SharedTable 的複製。
創建並返回提供的 SharedTable 的冰凍（僅讀）複製。
添加 delta 到提供的鑰匙與值中，並返回原始值。
如果 SharedTable 被凍結 (只讀)，返回 true 。
返回儲存在 SharedTable 中的元素數量。
透過提供的更新功能，更新值以使用提供的鑰匙。
建構子
new
返回一個新的 SharedTable 包含與提供的 Luau 表中的元素相等的元素。
如果提供的 Luau 表包含任何無法儲存在 SharedTable 中的鑰匙或值，則無法建立 SharedTable 。查看此頁面頂部的總結，以獲得一個列表存儲在 SharedTable 中的對象類型。如果 Luau 表包含任何表作為值，該表將轉換為新的 SharedTable 。
請注意，在某些情況下，可能需要將 SharedTable 存儲在 SharedTableRegistry 中。Class.ShareTableRegistry:GetSharedTable()提供了一種便捷的方式來實現這一目標。
參數
其元素將被儲存在新的 SharedTable 表中的 Luau 表。
函式
clear
原子地移除所有元素的 SharedTable 。
如果 SharedTable 被凍結，操作將失敗，並且會發生錯誤。
參數
要清除的 SharedTable 。
返回
clone
創建一個 SharedTable 的複製並返回複製。
如果選擇的 deep 參數不存在，或者如果存在且其值為 false ，則會創建淺複製。淺複製只複製最高級別的 SharedTable 對物件。如果 SharedTable 本身的任何值是 SharedTable ，那麼原始的 SharedTable 和複製的 SharedTable 都會指向相同的 SharedTable 。
淺複製操作是原子的，因此複製 SharedTable 將包含原始 SharedTable 狀態的一致截圖，即使在同時從其他腳本修改時。
如果可選擇的 deep 參數存在且其值為 true，則會創建深複製。深複製會徹底複製 SharedTable 個對象的結構，使原本的 SharedTable 和複製之間沒有狀態共享。
圖中每個 對象的複製是原子的，但整體深複製不是原子的。因此，圖中每個 SharedTable 的複製將包含與原始 SharedTable 對象相同的狀態截圖，但不同的 SharedTable 對象狀態可能不一致，如果圖正在同時從其他腳本修改時。
被複製的 SharedTable 物件象可能是凍結的（只能讀取）或不是。無論如何，新創建的複製本是不被凍結（因此可修改）。要創建冰凍複製人，請使用 SharedTable.cloneAndFreeze 功能。
為了說明淺複製和深複製之間的差異，請考慮以下樣本。第一個樣本創建了淺複製，第二個創建了深複製。
參數
要複製的 SharedTable 對象。
是否創建深複製 ( true ) 或淺複製 ( false )。
範例程式碼
這個代碼示例創建了一個淺複製的 SharedTable 。
local original = SharedTable.new()
original["a"] = "original a"
original["b"] = "original b"
original["c"] = SharedTable.new()
original["c"]["d"] = "original d"
local clone = SharedTable.clone(original, false)
clone["a"] = "new a"
clone["b"] = "new b"
clone["c"]["d"] = "new d"
assert(original["a"] == "original a")
assert(original["b"] == "original b")
-- 因為這是一個淺複製，原始["c"]和clone["c"]是
-- 相同的共用表對象。
assert(original["c"] == clone["c"])
assert(original["c"]["d"] == "new d")This code sample creates a deep clone of a SharedTable.
local original = SharedTable.new()
original["a"] = "original a"
original["b"] = "original b"
original["c"] = SharedTable.new()
original["c"]["d"] = "original d"
local clone = SharedTable.clone(original, true)
clone["a"] = "new a"
clone["b"] = "new b"
clone["c"]["d"] = "new d"
assert(original["a"] == "original a")
assert(original["b"] == "original b")
-- Because this was a deep clone, clone["c"] is a clone of original["c"];
-- they are distinct SharedTable objects.
assert(original["c"] ~= clone["c"])
assert(original["c"]["d"] == "original d")cloneAndFreeze
創建一個凍結(僅讀)複製的 SharedTable 並返回複製。這個函數的行為與複製的行為相同，除了複製被凍結。
如果要求深複製，那麼所有複製的 SharedTable 對象都會被凍結。
參數
要複製的共用表對象。
是否創建深複製 ( true ) 或淺複製 ( false )。
increment
原子增加元素的值。具有指定鍵的元素必須存在於 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 被凍結，操作將失敗，並且會發生錯誤。
參數
返回
元素的原始值,在 delta 被添加到它之前。
範例程式碼
This code sample demonstrates usage of SharedTable.increment().
local st = SharedTable.new()
st["x"] = 1
local oldValue = SharedTable.increment(st, "x", 1)
assert(oldValue == 1)
assert(st["x"] == 2)
-- The value of the specified key must be a number. If it is not a
-- number, the call will fail:
st["y"] = "test"
assert(not pcall(function() SharedTable.increment(st, "y", 1) end))isFrozen
如果 SharedTable 被凍結 (只讀)，返回 true 。
參數
被要求查詢凍結狀態的 SharedTable 對象。
返回
size
返回共用表中儲存的元素數量。請注意，如果其他腳本同時修改共用表，返回的大小可能在返回後不再正確，因為其他腳本可能已從共用表中添加或移除元素。
參數
要查詢的 SharedTable 對象的尺寸。
返回
update
原子更新元素的值。
當在不同執行上下文中運行的腳本同時存取 SharedTable 時，它們的存取可能會無法預測地交叉。因此，以下代碼通常不正確，因為值可能在第一行閱讀和第二行更新之間發生變化：
更新功能讓您能夠對元素進行原子更新。它需要一個函數，它將使用元素目前的值來呼叫。函數可以計算並返回新值。請注意，如果 SharedTable 被從其他腳本同時修改，那麼該功能可能會被多次呼叫。
如果 SharedTable 被凍結，操作將失敗，並且會發生錯誤。
參數
返回
範例程式碼
This code sample demonstrates usage of SharedTable.update().
local st = SharedTable.new()
st["x"] = "abcd"
SharedTable.update(st, "x", function(v)
assert(v == "abcd")
return v .. "e"
end)
assert(st["x"] == "abcde")