AR/getElementData

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

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

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 )

أنظر أيضاً