RU/getAccountsByData: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
(Форматирование)
 
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{RU/Server function}}
{{RU/Server function}}
{{New feature/item|3.0156|1.5.5|11747|
{{New feature/item|3.156|1.5.5|11747|
Эта функция возвращает [[RU/Table|таблицу]], содержащую все [[RU/Account|учётные записи (аккаунты)]] с указанными ключом и его значением (установленными с помощью [[RU/setAccountData|setAccountData]]).
Эта функция возвращает [[RU/Table|таблицу]], содержащую все [[RU/Account|аккаунты]] с указанными ключом и его значением (установленными с помощью [[RU/setAccountData|setAccountData]]).
}}
}}


Line 9: Line 9:
table getAccountsByData(string dataName, string value)
table getAccountsByData(string dataName, string value)
</syntaxhighlight>  
</syntaxhighlight>  
{{RU/OOP|Эта функция является статической функцией класса [[RU/Account|account]].|[[RU/Account|Account]].getAllByData||}}
{{RU/OOP|Эта функция является статической функцией класса [[RU/Account|account]].|[[RU/Account|account]].getAllByData||}}
===Обязательные аргументы===  
===Обязательные аргументы===  
*'''dataName:''' Название данных (ключ)
*'''dataName:''' Название данных (ключ).
*'''value:''' Значение, которое должно иметь dataName
*'''value:''' Значение, которое должно иметь dataName.


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


==Пример использования==
==Пример использования==
<section name="Сервер" class="server" show="false">  
<section name="Сервер" class="server" show="true">  
'''Пример 1.''' Бесполезный пример, показывающий как это работает. Команда /accountsbydata выводит игроку первый аккаунт из таблицы, содержащий значение "hello" под ключом "test".
'''Пример 1.''' Бесполезный пример, показывающий как это работает. Команда /accountsbydata выводит игроку первый аккаунт из таблицы, содержащий значение "hello" под ключом "test".
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">

Latest revision as of 17:01, 12 April 2021

ADDED/UPDATED IN VERSION 1.5.5 r11747:

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

Синтаксис

table getAccountsByData(string dataName, string value)

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

Примечание: Эта функция является статической функцией класса account.
Метод: account.getAllByData(...)

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

  • dataName: Название данных (ключ).
  • value: Значение, которое должно иметь dataName.

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

  • Таблица, содержащая аккаунты, если есть аккаунты, связанные с указанным значением в dataName.
  • Таблица, ничего не содержащая, если нет аккаунтов, связанных с указанным значением в dataName.
  • false, если указаны недопустимые аргументы.

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

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

Пример 1. Бесполезный пример, показывающий как это работает. Команда /accountsbydata выводит игроку первый аккаунт из таблицы, содержащий значение "hello" под ключом "test".

function accountsByData(thePlayer)
        local account = getPlayerAccount(thePlayer) -- получает аккаунт игрока
        setAccountData(account, "test", "hello") -- добавляет в полученный аккаунт значение "hello" под ключом "test"
        local accounts = getAccountsByData("test", "hello") -- получает таблицу аккаунтов, содержащие значение "hello" под ключом "test"
        outputChatBox(getAccountName(accounts[1]), thePlayer) -- сообщает игроку первый аккаунт из полученной таблицы
end
addCommandHandler("accountsbydata", accountsByData) -- прикрепляет функцию 'accountsByData' к обработчику команды "accountsbydata"

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

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

  • 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 - устанавливает пароль аккаунта