RU/getAllAccountData: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
m (Форматирование)
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{RU/Server function}}
{{RU/Server function}}
Эта функция возвращает таблицу, содержащую все данные пользователя для указанного [[RU/Account|аккаунта]]
Эта функция возвращает [[RU/Table|таблицу]], содержащую все данные пользователя для указанного [[RU/Account|аккаунта]].
 
==Синтаксис==
==Синтаксис==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
table getAllAccountData ( account theAccount )
table getAllAccountData(account theAccount)
</syntaxhighlight>
</syntaxhighlight>
{{RU/OOP||[[account]]:getAllData|data|}}
{{RU/OOP||[[RU/Account|account]]:getAllData|data|}}
===Обязательные аргументы===  
===Обязательные аргументы===  
*'''theAccount:''' Аккаунт, из которого вы хотите получить все данные.
*'''theAccount:''' [[RU/Account|Аккаунт]], из которого вы хотите получить все данные.


===Возвращает===
===Возвращаемые значения===
Возвращает [[RU/Table|таблицу]], содержащую все пользовательские данные. Эта таблица может быть пустой.
*'''[[RU/Table|Таблица]]''', ''содержащая все данные аккаунта'', если аккаунт хранит какие-либо данные.
*'''[[RU/Table|Таблица]]''', ''ничего не содержащая'', если аккаунт не хранит какие-либо данные.
*'''[[RU/Boolean|false]]''', если аккаунт не был найден.


==Пример использования==
==Пример использования==
<section name="Сервер" class="server" show="true">
'''Пример 1.''' Этот пример выводит все данные, хранящиеся на аккаунте пользователя при помощи команды /getall.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function printAllData ( thePlayer )
function printAllData (thePlayer)
    local playerAccount = getPlayerAccount( thePlayer ) -- получает аккаунт игрока
        local playerAccount = getPlayerAccount(thePlayer) -- получает аккаунт игрока
    if ( playerAccount ) then -- если мы получили аккаунт то
        if (playerAccount) then -- если аккаунт получен, то
        local data = getAllAccountData( playerAccount ) -- получить данные
                local data = getAllAccountData(playerAccount) -- получает таблицу с данными аккаунта
        count = 0
                count = 0
        for _ in pairs(data) do count = count + 1 end -- посчитать
                for _ in pairs(data) do count = count + 1 end -- считает количество полученных данных полученной таблицы
        outputChatBox ( "table holds " .. count .. " entries" ) -- вывести количество записей
                outputChatBox("Аккаунт содержит " .. count .. " записей") -- выводит количество данных аккаунта в чат
        if ( data ) then -- если таблица с данными содержит записи
                if (data) then -- если таблица с данными не пуста, то
            for k,v in pairs ( data ) do
                        for k,v in pairs(data) do -- перебирает все данные таблицы
                outputChatBox(k..": "..v) -- вывести ключ и его значение для каждой записи данных аккаунта
                                outputChatBox(k..": "..v) -- выводит ключ и его значение для каждой записи данных аккаунта в чат
            end
                        end
                end
         end
         end
    end
end
end
addCommandHandler( "getall", printAllData ) -- добавить обработчик команд для команды 'getall'
addCommandHandler("getall", printAllData) -- прикрепляет функцию 'printAllData' к обработчику команды "getall"
</syntaxhighlight>
</syntaxhighlight>
</section>


==Требования==
==Требования==
Line 38: Line 44:
{{RU/Account functions}}
{{RU/Account functions}}


[[en:GetAllAccountData]]
[[en:getAllAccountData]]
[[ru:getAllAccountData]]
[[zh-cn:GetAllAccountData]]
[[zh-cn:GetAllAccountData]]

Latest revision as of 14:59, 12 April 2021

Эта функция возвращает таблицу, содержащую все данные пользователя для указанного аккаунта.

Синтаксис

table getAllAccountData(account theAccount)

Синтаксис ООП Помогите! Я не понимаю, что это!

Метод: account:getAllData(...)
Переменная: .data

Обязательные аргументы

  • theAccount: Аккаунт, из которого вы хотите получить все данные.

Возвращаемые значения

  • Таблица, содержащая все данные аккаунта, если аккаунт хранит какие-либо данные.
  • Таблица, ничего не содержащая, если аккаунт не хранит какие-либо данные.
  • false, если аккаунт не был найден.

Пример использования

Click to collapse [-]
Сервер

Пример 1. Этот пример выводит все данные, хранящиеся на аккаунте пользователя при помощи команды /getall.

function printAllData (thePlayer)
        local playerAccount = getPlayerAccount(thePlayer) -- получает аккаунт игрока
        if (playerAccount) then -- если аккаунт получен, то
                local data = getAllAccountData(playerAccount) -- получает таблицу с данными аккаунта
                count = 0
                for _ in pairs(data) do count = count + 1 end -- считает количество полученных данных полученной таблицы
                outputChatBox("Аккаунт содержит " .. count .. " записей") -- выводит количество данных аккаунта в чат
                if (data) then -- если таблица с данными не пуста, то
                        for k,v in pairs(data) do -- перебирает все данные таблицы
                                outputChatBox(k..": "..v) -- выводит ключ и его значение для каждой записи данных аккаунта в чат
                        end
                end
        end
end
addCommandHandler("getall", printAllData) -- прикрепляет функцию 'printAllData' к обработчику команды "getall"

Требования

Минимально поддерживаемый сервер 1.3.0-9.03804
Минимально поддерживаемый клиент n/a

Примечание: Использование этой функции требует указания минимальной версии в разделе <min_mta_version> meta.xml ресурса. Пример: <min_mta_version server="1.3.0-9.03804" />


Смотрите также

Серверные функции

  • addAccount - регистрирует аккаунт
  • copyAccountData - копирует данные аккаунта в другой
  • getAccount - получает аккаунт указанного пользователя
  • getAccountByID - получает аккаунт с указанным ID
  • getAccountData - получает указанные данные аккаунта
  • getAccountID - получает ID указанного аккаунта
  • getAccountIP - получает IP указанного аккаунта
  • getAccountName - получает имя аккаунта
  • getAccountPlayer - получает активного пользователя аккаунта
  • getAccountSerial - получает серийный номер аккаунта
  • getAccounts - получает все зарегистрированные аккаунты
  • getAccountsByData - получает аккаунты с указанными сохранёнными данными
  • getAccountsByIP - получает аккаунт с указанным IP
  • getAccountsBySerial - получает все аккаунты с указанным серийным номером
  • getAllAccountData - получает все данные аккаунта
  • getPlayerAccount - получает аккаунт указанного игрока
  • isGuestAccount - проверяет, является ли аккаунт гостевым
  • logIn - авторизует игрока под указанный аккаунт
  • logOut - выходит из аккаунта указанного игрока
  • removeAccount - удаляет аккаунт
  • setAccountData - сохраняет данные в аккаунте
  • setAccountName - устанавливает имя аккаунту
  • setAccountPassword - устанавливает пароль аккаунта