AR/getElementData: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "__NOTOC__ {{Server client function}} هذه الوظيقة تقوم بجلب بيانات الالمنت الموجودة على مفتاح معين. ==Syntax== <syntaxhighlight lang="lua">[lua,n...")
 
No edit summary
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Server client function}}
{{Server client function}}
'''هذه الوظيقة تقوم بجلب بيانات العنصر الموجودة على مفتاح معين.'''


هذه الوظيقة تقوم بجلب بيانات الالمنت الموجودة على مفتاح معين.
==تركيب الجملة البرمجية==
 
==Syntax==
<syntaxhighlight lang="lua">var getElementData ( element theElement, string key [, inherit = true] )</syntaxhighlight>
<syntaxhighlight lang="lua">var getElementData ( element theElement, string key [, inherit = true] )</syntaxhighlight>
{{OOP||[[element]]:getData||setElementData}}
{{OOP||[[element]]:getData||setElementData}}
Line 12: Line 11:
*'''key:'''  اسم مفتاح بيانات العنصر الذي تود جلبها . x ( 31 حرف كحد أقصى للمفتاح )
*'''key:'''  اسم مفتاح بيانات العنصر الذي تود جلبها . x ( 31 حرف كحد أقصى للمفتاح )


===العناصر الاختارية===
===العناصر الاختيارية===
*'''inherit:''' - تفعيل الوظيفة أم لا التي يجب ان تذهب أعلى التسلسل الهرمي للعثور على المفتاح المطلوب في حالة ان العنصر المحدد لا يملكها.
*'''inherit:''' - تفعيل الوظيفة أم لا التي يجب ان تذهب أعلى التسلسل الهرمي للعثور على المفتاح المطلوب في حالة ان العنصر المحدد لا يملكها.


===النواتج===
===النواتج===
هذه الدالة تقوم بإرجاع متغير يحتوي على بيانات العنصر المطلوب، أو خطأ إذا كان العنصر أو بيانات العنصر غير موجودة .
هذه الوظيفة تقوم بإرجاع متغير يحتوي على بيانات العنصر المطلوب، أو خطأ إذا كان العنصر أو بيانات العنصر غير موجودة .


==مثال==
==مثال==
هذا المثال يخزن وقت دخول اللاعب بالميلي ثانية ليسمح لهم بمعرفة كم مدة اتصالهم بأستخدام وظيفة 'joinTime'.
هذا المثال يخزن وقت دخول اللاعب بالميلي ثانية ليسمح لهم بمعرفة كم مدة اتصالهم بوظيفة 'joinTime'.
<section show="true" name="سيرفر" class="server">
<section show="true" name="سيرفر" class="server">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
Line 49: Line 48:
</section>
</section>


==See Also==
==أنظر أيضاً==
{{Element functions}}
{{AR/Element functions}}

Latest revision as of 16:06, 21 August 2016

هذه الوظيقة تقوم بجلب بيانات العنصر الموجودة على مفتاح معين.

تركيب الجملة البرمجية

var getElementData ( element theElement, string key [, inherit = true] )

OOP Syntax Help! I don't understand this!

Method: element:getData(...)
Counterpart: setElementData


العناصر المطلوبة

  • theElement: العنصر الذي تود جلب بياناته .
  • key: اسم مفتاح بيانات العنصر الذي تود جلبها . x ( 31 حرف كحد أقصى للمفتاح )

العناصر الاختيارية

  • inherit: - تفعيل الوظيفة أم لا التي يجب ان تذهب أعلى التسلسل الهرمي للعثور على المفتاح المطلوب في حالة ان العنصر المحدد لا يملكها.

النواتج

هذه الوظيفة تقوم بإرجاع متغير يحتوي على بيانات العنصر المطلوب، أو خطأ إذا كان العنصر أو بيانات العنصر غير موجودة .

مثال

هذا المثال يخزن وقت دخول اللاعب بالميلي ثانية ليسمح لهم بمعرفة كم مدة اتصالهم بوظيفة 'joinTime'.

Click to collapse [-]
سيرفر
function joinTime ( )
    setElementData ( source, "joinTime", getTickCount() ) -- تخزين الوقت الصحيح بالميلي ثانية لدى اللاعب مع المفتاح 'joinTime'
end
-- صنع وظيفتنا لوقت الدخول لتقوم بعملها عندما يدخل لاعب
addEventHandler ( "onPlayerJoin", root, joinTime )

function showJoinTime ( source, commandName, playerName )
	if ( playerName ) then -- تحقق من اسم اللاعب المحدد
		thePlayer = getPlayerFromName ( playerName ) -- جلب عنصر اللاعب للاعب المحدد
		if ( thePlayer ) then -- اذا كان موجوداً ...
			local timeOnline = (getTickCount() - getElementData ( thePlayer, "joinTime" )) / 1000 -- جلب بيانات اللاعب منذ الدخول وحسابها
			outputChatBox ( getPlayerName ( thePlayer ).." joined "..timeOnline.." seconds ago", source ) -- اخراج وقت دخول اللاعب في الشات
		else
			outputChatBox ( "Couldn't find '" .. playerName .. "'", source ) -- عرض خطأ اذا كان اللاعب غير موجود
		end
	else
		-- عرض للاعب الذي قام بكتابة الامر طريقة استخدام الوظيفة ليرى وقت دخول الاشخاص الاخرين
		local timeOnline = (getTickCount() - getElementData ( source, "joinTime" )) / 1000 -- حساب وقت دخول اللاعب
		outputChatBox ( "You joined " ..timeOnline.." seconds ago", source )
		outputChatBox ( "Use 'join_time <player name>' to see other people's join time", source )
	end
end
-- اضافة امر وقت الدخول , مع عنصر اضافي وهو اسم اللاعب
addCommandHandler ( "joinTime", showJoinTime )

أنظر أيضاً