Godot 4 Enums en GDScript

En este tutorial aprenderemos que son los Enums en GDScript también conocidos como enumeraciones o enumeradores, además crearemos algunos Enums en Godot 4 🛠️

¿Qué Son Los Enums en GDScript y en La Programación?

• Los enum o enumeraciones son una forma de agrupar constantes relacionadas.
• También son conocidas como  enumeraciones, o listados específicos
• Y solo almacenan números enteros, por eso se conocen como enumeradores

¿Para Qué Sirven Los Enums?

• Se utilizan para almacenar varias constantes de tipo int, como si fueran un diccionario.

• Por ejemplo, puedes almacenar:
  • Los meses del año
  • Los días de la semana
  • Las opciones de un menú

Como almacena constantes, sus valores no cambiaran durante la ejecución.

¿Como crear Enums en GDScript?

Crear enums en gdscript es muy fácil, solo tienes que usar la palabra enum, y después asignarle un nombre como se ve en el siguiente ejemplo

enum My_Options {
	OPTION_1,
	OPTION_2,
	OPTION_3
}

Mostrar Los Valores De Un Enum

Cuando agregas valores a un enúm, se guardan con un número que empieza a incrementarse desde el 0

Para demostrarlo, podemos imprimir sus valores usando el método values() 

enum My_Options {
	OPTION_1,
	OPTION_2,
	OPTION_3
}

func _ready():
	# Mostrar los valores de un enum
	print( My_Options.values() )

Si ejecutamos el ejemplo anterior, obtendremos los datos del enum, dentro de un array

[0, 1, 2]

Acceder al valor de un enum mediante índices

Puedes acceder un valor de un enum mediante un índice de la siguiente manera

enum My_Options {
	OPTION_1,
	OPTION_2,
	OPTION_3
}

func _ready() -> void:
	# Mediante índice
	print( My_Options.values()[1] )

Resultado:

1

Imprimir Las Llaves De Un Enum en GDScript y Godot

También podemos mostrar las llaves de un enum, para hacerlo utilizamos en método keys()

Como en el siguiente ejemplo:

enum My_Options {
	OPTION_1,
	OPTION_2,
	OPTION_3
}

func _ready():
	# Mostrar las llaves de un enum
	print( My_Options.keys() )

Si ejecutamos el ejemplo anterior, obtendremos  las llaves del enum

["OPTION_1", "OPTION_2", "OPTION_3"]

Imprimir El nombre De Un Enum Mediante Keys

Podemos obtener el nombre de un valor del enum accediendo a él, como si fuera un arreglo, aquí tienes algunos ejemplos

enum My_Options {
	OPTION_1,
	OPTION_2,
	OPTION_3
}

func _ready() -> void:
	# Mediante índice
	print( My_Options.keys()[0] )
	# Mediante el indice con valor
	print( My_Options.keys()[My_Options.OPTION_2] )

Si ejecutamos el ejemplo anterior, obtendremos lo siguiente

OPTION_1
OPTION_2

En próximos tutoriales aprenderemos sobre las variables Export Básicas en GDScript.