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 OrderedDataStore is basically a GlobalDataStore ile, depolanan değerlerin olumlu sayılar olması gerekir. It exposes a method Class.OrderedDataStore:GetSortedAsync()|GetSortedAsync() which allows inspection of the entries in sorted order using a 1> Class.DataStorePages1> object.
Sıralama depoları versiyonlama ve metin kayıtlarını desteklemiyor, bu yüzden DataStoreKeyInfo hep nil için anahtarlar için bir OrderedDataStore . Eğer versiyonlama ve metin kayıtları desteklemesi gerekiyorsa, bir 2> Class.DataStore2> kullanın.
Sıralama dükkanları, userIds veya SetAsync() için gerekli IncrementAsync() parametresini desteklemiyor.
Sıralama veri depolarının kullanımı hakkında genel bir bakış için Veri Depoları bakın.
Kod Örnekleri
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
Bir DataStorePages nesnesi iade eder.
Bir anahtarın değerini belirli bir veri depolarında ve bir DataStoreKeyInfo durumiade eder.
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Bir anahtarın değerini sağlanan miktar ile artırır (her ikisi de sayı olmalıdır).
Erişilebilir bir versiyonu korurken belirli anahtarı da kaldırır.
Veritabanının belirlenen anahtar için değerini ayarlar.
Bir anahtarın değerini yeni bir değerle belirlenen çağrı işlevinden alır.
Özellikler
Yöntemler
GetSortedAsync
Bir DataStorePages nesnesi iade eder. Sıralama düzeni ascending'dir, her sayfadaki uzunluk pageSize ve minValue / 2> maxValue2>'dir. Results'i filtreleyen özel değişkenlerdir, bunlar 5> 8>veya8> özel değişkenleridir.
Hata kodlarının sınırlarını ve açıklamalarını Veri Depoları bölümünde görün.
Parametreler
Döndürülen veri sayfalarının yukarıda belirtilen sırayla içinde olup olmadığını gösteren bir booleoid.
Her sayfadaki uzunluk.Varsayılan olarak 50. Maksimum değer 100'dir.
Opcional paraître. Eğer ayarlandıysa, değer minValue 'den daha düşük olan veri sayfaları dışarı çıkarılır.
Opcional paraître. Eğer ayarlandıysa, değer maxValue 'den daha büyük olan veri sayfaları dışarı çıkarılır.
Dönüşler
Sunulan argümentlere dayanarak sıralanmış bir DataStorePages nesne.