OrderedDataStore
*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.
Bir SıralanmışVeriDeposu temelde depolanan değerlerin pozitif sayılar olması koşuluyla olumlu sayılar dır.Sıralanmış sırayla girişlerin incelenmesine izin veren bir yöntemi GetSortedAsync() ortaya çıkarır, bir DataStorePages nesnesi kullanarak.
Sıralanmış veri depoları sürümleme ve metadatayı desteklemiyor, bu nedenle daima bir için anahtarlar için geçerlidir.Versiyonlama ve metadat desteğine ihtiyacınız varsa, bir DataStore kullanın.
Sıralanmış veri depoları, SetAsync() veya IncrementAsync() için seçilen userIds parametresini desteklemez.
Sıralı veri depolarının kullanımına genel bakış için Veri Depolarına bakın.
Kod Örnekleri
This code sample demonstrates usage of an OrderedDataStore and pages.
local DataStoreService = game:GetService("DataStoreService")
local pointsStore = DataStoreService:GetOrderedDataStore("Points")
local function printTopTenPlayers()
local isAscending = false
local pageSize = 10
local pages = pointsStore:GetSortedAsync(isAscending, pageSize)
local topTen = pages:GetCurrentPage()
-- The data in 'topTen' is stored with the index being the index on the page
-- For each item, 'data.key' is the key in the OrderedDataStore and 'data.value' is the value
for rank, data in ipairs(topTen) do
local name = data.key
local points = data.value
print(name .. " is ranked #" .. rank .. " with " .. points .. "points")
end
-- Potentially load the next page...
--pages:AdvanceToNextPageAsync()
end
-- Create some data
pointsStore:SetAsync("Alex", 55)
pointsStore:SetAsync("Charley", 32)
pointsStore:SetAsync("Sydney", 68)
-- Display the top ten players
printTopTenPlayers()
Özet
Özellikler
Yöntemler
- GetSortedAsync(ascending : boolean,pagesize : number,minValue : Variant,maxValue : Variant):DataStorePages
Bir DataStorePages nesnesi döndürür.
Belirtilen veri depolamasındaki bir anahtarın değerini ve bir DataStoreKeyInfo durumdöndürür.
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Verilen miktar ile bir anahtarın değerini artırır (her ikisi de tamsayı olmalıdır).
Belirtilen anahtarı kaldırırken erişilebilir bir sürüm de korur.
Verilen anahtar için veri depolama değerini ayarlar.
Bir anahtarın değerini belirtilen geri çağrı işlevinden yeni bir değerle günceller.
Özellikler
Yöntemler
GetSortedAsync
Bir DataStorePages nesnesi döndürür.Sıralama düzeni artışla belirlenir, her sayfanın uzunluğu sayfa boyutu ve minValue / maxValue sonuçları filtreleyen zorunlu parametrelerdir.
İstek sınırları ve hata kodlarının açıklamaları için Veri depoları bakın.
Parametreler
Döndürülen veri sayfalarının sıralı olup olmadığını gösteren bir mantık değeri. A boolean indicating whether the returned data pages are in ascending order.
Her sayfanın uzunluğu. Varsayılan değer 50'dir. Maksimum izin verilen değer 100'dür.
Opsiyonel parametre. Eğer ayarlanırsa, minValue değerinden daha az olan veri sayfaları dışlanacaktır.
Opsiyonel parametre. Eğer ayarlanırsa, değeri maxValue daha büyük olan veri sayfaları dışlanacaktır.
Dönüşler
Verilen argümanlara dayalı sıralanmış DataStorePages nesne.