OrderedDataStore
*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.
A Sklep z uporządkowanymi danymi jest zasadniczo GlobalDataStore z wyjątkiem, że przechowywane wartości muszą być pozytywnymi liczbami całkowitymi .Ujawnia metodę GetSortedAsync(), która pozwala na inspekcję wpisów w kolejności sortowania za pomocą obiektu DataStorePages.
Sortowane magazyny danych nie wspierają wersjonowania i metadanych, więc DataStoreKeyInfo zawsze jest nil dla kluczy w OrderedDataStore .Jeśli potrzebujesz wsparcia wersjonowania i metadanych, użyj DataStore.
Przechowywane w kolejności bazy danych nie wspierają opcjonalnego parametru userIds dla SetAsync() lub IncrementAsync().
Zobacz Magazyny danych dla przeglądu korzystania z uporządkowanych magazynów danych.
Przykłady kodu
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()
Podsumowanie
Metody
- GetSortedAsync(ascending : boolean,pagesize : number,minValue : Variant,maxValue : Variant):DataStorePages
Zwraca obiekt DataStorePages .
Zwraca wartość klucza w określonym magazynie danych i instancji DataStoreKeyInfo.
- IncrementAsync(key : string,delta : number,userIds : Array,options : DataStoreIncrementOptions):Variant
Zwiększa wartość klucza o podany wynik (oba muszą być liczbami całkowitymi).
Usuwa określony klucz, zachowując jednocześnie dostępną wersję.
Ustawia wartość magazynu danych dla podanego klucza.
Aktualizuje wartość klucza za pomocą nowej wartości z określonej funkcji powrotnej.
Właściwości
Metody
GetSortedAsync
Zwraca obiekt DataStorePages .Kolejność sortowania jest określana przez rosnące , długość każdej strony przez rozmiar strony , a minValue / maxValue są opcjonalnymi parametrami, które filtrują wyniki.
Zobacz Magazyny danych dla ograniczeń wniosków i opisów kodów błędów.
Parametry
Boolean wskazujący, czy zwrócone strony danych są w kolejności malejącej.
Długość każdej strony. Domyślnie jest to 50. Maksymalna dozwolona wartość to 100.
Opcjonalny parametr. Jeśli zostanie ustawiać, strony danych z wartością mniejszą niż minValue zostaną wykluczone.
Opcjonalny parametr. Jeśli zostanie ustawiać, strony danych z wartością większą niż maxValue zostaną wykluczone.
Zwroty
Sortowany obiekt DataStorePages oparty na podanych argumentach.