ما هو التعداد؟

لا يمكن أن تكون بعض القيم إلا أحد خيارات قليلة: إشارة المرور حمراء أو صفراء أو خضراء، واللاعب في وضع الخمول أو يركض أو يقفز. يمكنك تخزين الخيار كرقم، بحيث يكون 0 للخمول و1 للركض، لكن عندئذٍ سيتعين على كل قارئ تذكّر معنى كل رقم:

var state := 1
if state == 1:
	print("Running")

يمنح التعداد (اختصارًا لـ enumeration) اسمًا لكل خيار. ترقّم GDScript الأسماء نيابةً عنك، بدءًا من 0:

enum State { IDLE, RUN, JUMP }

تكتب الآن State.RUN بدلًا من 1: اسم التعداد، ثم نقطة، ثم الخيار. يوضح الكود معنى ذلك:

var state := State.RUN
if state == State.RUN:
	print("Running")

يُعلَن عن التعداد في المستوى الأعلى من النص البرمجي، بجانب func _ready(): وليس داخله. إن وجود سطر enum داخل دالة خطأ يوقف البرنامج قبل تشغيله:

extends Node

enum State { IDLE, RUN, JUMP }

func _ready():
	var state := State.JUMP
	print(state) # 2

الخيارات ثوابت، لذا فإن State.RUN = 5 يُعد خطأً. يُبلَّغ عن خيار مكتوب بشكل خاطئ مثل State.RUNN قبل تشغيل البرنامج، بينما يمرّ رقم خاطئ مثل 3 بدلًا من 2 دون ملاحظة.