AR/getAccountData - Revision history

EOFIK: Добавление языков

2021-04-11T20:04:51Z

Добавление языков

← Older revision		Revision as of 20:04, 11 April 2021
Line 50:		Line 50:
	[[en:getAccountData]]		[[en:getAccountData]]
	[[ru:getAccountData]]		[[ru:getAccountData]]
			[[ar:getAccountData]]
			[[pl:getAccountData]]
			[[zh-cn:getAccountData]]

Qaisjp at 08:42, 7 September 2019

2019-09-07T08:42:04Z

← Older revision		Revision as of 08:42, 7 September 2019
Line 2:		Line 2:
	{{Server function}}		{{Server function}}
	__NOTOC__		__NOTOC__
	{{Note\|You '''MUST''' use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents collisions between different scripts.}}		{{Important Note\|You '''MUST''' use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents collisions between different scripts.}}
	This function retrieves a string that has been stored using [[setAccountData]]. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account.		This function retrieves a string that has been stored using [[setAccountData]]. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account.

Qaisjp: tweak note

2019-09-07T08:41:55Z

tweak note

← Older revision		Revision as of 08:41, 7 September 2019
Line 2:		Line 2:
	{{Server function}}		{{Server function}}
	__NOTOC__		__NOTOC__
	{{~~Note_box~~\|~~It is strongly recommended that you~~ use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents collisions between different scripts.}}		{{Note\|You '''MUST''' use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents collisions between different scripts.}}
	This function retrieves a string that has been stored using [[setAccountData]]. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account.		This function retrieves a string that has been stored using [[setAccountData]]. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account.

أبو عزه: /* Example */

2015-02-07T22:12:08Z

Example

← Older revision		Revision as of 22:12, 7 February 2015
Line 22:		Line 22:
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	function onPlayerQuit()		function onPlayerQuit()
	local playerAccount = getPlayerAccount(source) -- ~~get his account~~		local playerAccount = getPlayerAccount(source) -- الحصول على حسابه
	if (playerAccount) then -- if we got the account then		if (playerAccount) then -- if we got the account then
	local playerMoney = getPlayerMoney(source) -- ~~get his money amount~~		local playerMoney = getPlayerMoney(source) -- يحصل على مبلغ من المال
	setAccountData(playerAccount, "piraterpg.money", playerMoney) -- ~~store his current money amount in his account data~~		setAccountData(playerAccount, "piraterpg.money", playerMoney) -- تخزين له مبلغ من المال الحالي في بيانات حسابه
	end		end
	end		end
	addEventHandler("onPlayerQuit", getRootElement(), onPlayerQuit) -- ~~add an event handler~~		addEventHandler("onPlayerQuit", getRootElement(), onPlayerQuit) -- إضافة معالج أحداث

	function onPlayerLogin()		function onPlayerLogin()
Line 34:		Line 34:
	local playerAccount = getPlayerAccount(source) -- get his account		local playerAccount = getPlayerAccount(source) -- get his account
	if (playerAccount) then -- if we got the account then		if (playerAccount) then -- if we got the account then
	local playerMoney = getAccountData(playerAccount, "piraterpg.money") -- ~~get the money amount was store in his account data~~		local playerMoney = getAccountData(playerAccount, "piraterpg.money") -- الحصول تم تخزين كمية من المال في حسابهdata
	-- ~~make sure there was actually a value saved under this key~~ (~~check if playerMoney is not false~~).		-- تأكد من وجود في الواقع قيمة المحفوظة تحت هذا المفتاح (معرفة ما اذا كان لاعب المال ليس كاذبة)ا.
	-- ~~this will for example not be the case when a player plays the gametype for the first time~~		-- هذه الإرادة على سبيل المثال لا يكون الأمر كذلك عندما لاعب يلعب نوع اللعبة للمرة الأولى.
	if (playerMoney) then		if (playerMoney) then
	setPlayerMoney(source, playerMoney)		setPlayerMoney(source, playerMoney)

أبو عزه: /* Required Arguments */

2015-02-07T22:03:36Z

Required Arguments

← Older revision		Revision as of 22:03, 7 February 2015
Line 11:		Line 11:

	===Required Arguments===		===Required Arguments===
	*'''theAccount:''' ~~The account you wish to retrieve the data from~~.		*'''theAccount:''' الحساب الذي يرغب في استرداد البيانات منه.
	*'''key:''' ~~The key under which the data is stored~~		*'''key:''' المفتاح الذي بموجبه يتم تخزين البيانات

	===Returns===		===Returns===

أبو عزه: /* Returns */

2015-02-07T22:01:27Z

Returns

← Older revision		Revision as of 22:01, 7 February 2015
Line 15:		Line 15:

	===Returns===		===Returns===
	~~Returns a~~ [[~~string~~]] ~~containing the stored data or~~ ''~~false~~'' ~~if no data was stored under that key.~~
			.بإرجاع [[سلسلة]] تحتوي على البيانات المخزنة أو ''خاطئة'' إذا تم تخزين أية بيانات تحت هذا المفتاح

	==Example==		==Example==

MeowCola at 14:53, 11 September 2014

2014-09-11T14:53:35Z

← Older revision		Revision as of 14:53, 11 September 2014
Line 1:		Line 1:
			{{Translate}}
	{{Server function}}		{{Server function}}
	__NOTOC__		__NOTOC__
Line 47:		Line 48:

	[[en:getAccountData]]		[[en:getAccountData]]
			[[ru:getAccountData]]

TAPL at 14:11, 30 August 2012

2012-08-30T14:11:53Z

← Older revision		Revision as of 14:11, 30 August 2012
Line 46:		Line 46:
	{{AR Account_functions}}		{{AR Account_functions}}

	[[en:~~getAccountName~~]]		[[en:getAccountData]]

TAPL: Created page with "{{Server function}} NOTOC {{Note_box|It is strongly recommended that you use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents co..."

2012-08-30T14:11:20Z

Created page with "{{Server function}} __NOTOC__ {{Note_box|It is strongly recommended that you use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents co..."

New page

{{Server function}}
__NOTOC__
{{Note_box|It is strongly recommended that you use the standard ''module.key'' naming for your keys, as shown in the example below. This prevents collisions between different scripts.}}
This function retrieves a string that has been stored using [[setAccountData]]. Data stored as account data is persistent across user's sessions and maps, unless they are logged into a guest account.

==Syntax==
<syntaxhighlight lang="lua">
string getAccountData ( account theAccount, string key )
</syntaxhighlight>

===Required Arguments===
*'''theAccount:''' The account you wish to retrieve the data from.
*'''key:''' The key under which the data is stored

===Returns===
Returns a [[string]] containing the stored data or ''false'' if no data was stored under that key.

==Example==
For a pirate roleplaying gametype, the amount of money a player has is made persistent by storing it in his account. Note the code uses "piraterpg.money" as key instead of just "money", as the player may be participating in other gametypes that also save his money amount to his account. If both gametypes would use "money" as the account key, they'd overwrite each other's data.
<syntaxhighlight lang="lua">
function onPlayerQuit()
local playerAccount = getPlayerAccount(source) -- get his account
if (playerAccount) then -- if we got the account then
local playerMoney = getPlayerMoney(source) -- get his money amount
setAccountData(playerAccount, "piraterpg.money", playerMoney) -- store his current money amount in his account data
end
end
addEventHandler("onPlayerQuit", getRootElement(), onPlayerQuit) -- add an event handler

function onPlayerLogin()
-- when a player logins, retrieve his money amount from his account data and set it
local playerAccount = getPlayerAccount(source) -- get his account
if (playerAccount) then -- if we got the account then
local playerMoney = getAccountData(playerAccount, "piraterpg.money") -- get the money amount was store in his account data
-- make sure there was actually a value saved under this key (check if playerMoney is not false).
-- this will for example not be the case when a player plays the gametype for the first time
if (playerMoney) then
setPlayerMoney(source, playerMoney)
end
end
end
addEventHandler("onPlayerLogin", getRootElement(), onPlayerLogin) -- add an event handler
</syntaxhighlight>

==See Also==
{{AR Account_functions}}

[[en:getAccountName]]