Godot 4 Agregar Valores a un Arreglo en GDScript

En este tutorial aprenderemos más de los arreglos y como Agregar Valores a un Arreglo en GDScript el lenguaje de programación más usado en Godot 4 🧩

En capítulos anteriores vimos como crear y leer arreglos en GDScript, ahora veremos como Agregar Valores a un Arreglo en GDScript mediante el índice y también usando algunos métodos.

Agregar Un Valor Al Final Del Array

Agregar valores al final de un array es una operación común y útil en la programación, en GDScript puedes agregar un nuevo valor al final del arreglo de 2 formas usando los siguientes métodos.

Agregar un valor al final del array con append( ) y  push_back( )

Aquí tienes un ejemplo donde agregamos valores al final de un array usando el metodo append y el método push_back

var my_array : Array = ['text', 5,4,3 ]

func _ready():
	#Agrega un valor al final del array
	my_array.append('value with append')
	print(my_array)
	
	my_array.push_back('push_back')
	print(my_array)

Este ejemplo debería dar como resultado

["text", 5, 4, 3, "value with append"]
["text", 5, 4, 3, "value with append", "push_back"]

Agregar Un Array Al Final De Otro Array

Agregar un array al final de otro array es útil en varias situaciones, por ejemplo:

1. Combinar datos: Si tienes dos conjuntos de datos almacenados en dos arrays diferentes y deseas combinarlos en un solo array, puedes agregar un arreglo al final del otro. Esto es útil cuando necesitas procesar o analizar todos los datos juntos.
2. Concatenación de arrays: En algunos casos, es posible que desees concatenar dos secuencias de elementos, como caracteres o números, para crear una secuencia más larga. Agregar un array al final de otro te permite hacer esto fácilmente.
3. Expansión dinámica: Si estás trabajando con estructuras de datos dinámicas, como listas enlazadas o arrays dinámicos, es posible que necesites agregar elementos adicionales a medida que tu programa se ejecuta. Agregar un array al final de otro te permite expandir la estructura de datos según sea necesario.
4. Dividir y unir tareas: En aplicaciones de procesamiento paralelo o distribuido, es posible que necesites dividir un conjunto de datos en partes más pequeñas, procesarlas por separado y luego combinar los resultados. Agregar un array al final de otro te permite unir fácilmente los resultados parciales.

Agregar un array, al final de otro array con append_array( )

var my_array : Array = ['text', 5,4,3 ]
var my_array2 : Array = ['text2', 99 ]

func _ready():
	#Agregar otro array
	my_array.append_array(my_array2)
	print( my_array )

Este ejemplo debería dar como resultado

["text", 5, 4, 3, "text2", 99]

Agregar un array al final de otro array con append()

Puedes usar solo append para agregar un array también, pero el método append array evitará errores,  porque puede evitar que agregues un dato que no sea array.

var my_array : Array = ['text', 5,4,3 ]
var my_array2 : Array = ['text2', 99 ]

func _ready():
	#Agrega un valor al final del array
	my_array.append(my_array2)
	my_array.append_array('0')
	print(my_array)

Si intentamos agregar un dato, que no es un array con el método append_array() nos mostrara un error como el siguiente:

At «append_array()» call, argument 1. The passed argument’s type (String) doesn’t match the function’s expected argument type (Array).

Agregar Un Valor Al Principio Del Array

Agregar un valor al principio de un array es útil en varias situaciones, como por ejemplo:

1. Mantener el orden de los elementos: Si estás trabajando con una estructura de datos donde el orden de los elementos es importante, como una cola o una pila, agregar un elemento al principio del array te permite mantener el orden correcto de los elementos.
2. Procesamiento de datos en orden inverso: En algunos casos, es posible que desees procesar los datos en orden inverso, es decir, desde el último elemento hasta el primero. Agregar un elemento al principio del array te permite hacer esto fácilmente.
3. Implementación de estructuras de datos específicas: Algunas estructuras de datos requieren que los elementos se inserten en posiciones específicas, incluido el principio del array. Agregar un elemento al principio del array te permite implementar estas estructuras de datos de manera eficiente.

Agregar un array al principio de otro array en GDScript con push_front()

var my_array : Array = ['text', 5,4,3 ]

func _ready():
	#Agrega un valor al PRINCIPIO del array
	my_array.push_front('new value: push_front')
	print(my_array)

Este ejemplo debería dar como resultado lo siguiente

["new value: push_front", "text", 5, 4, 3]

Agregar Un Valor En Cualquier Posición Del Array

Podemos Agregar un valor en cualquier posición del array mediante el índice, para eso podemos usar el método insert

Agregar Un Valor al array usando el método insert() en GDScript

Para usar este metodo solo necesitamos agregar la posición, separada de una coma, y el nuevo valor

Pero recuerda, que la posición de los array comienza en cero, así que si en el primer parámetro agregamos el número 1, nos agregará el texto en la posición 2

var my_array : Array = ['text', 5,4,3 ]

func _ready():
	#Agrega un valor EN CUALQUIER POSICIÓN del array
	my_array.insert(1, 'new value : insert')
	print(my_array)

Como se muestra, en este ejemplo, nos agrega los nuevos datos después de la palabra text que se encuentra en el indice 0.

["text", "new value : insert", 5, 4, 3]

Video Sobre Godot 4 Agregar Valores a un Arreglo en GDScript

Con este video podrás entender mejor como Agregar Valores a un Arreglo en GDScript y tendrás más información sobre como insertar un valor en cualquier posición del arreglo.

En próximos tutoriales aprenderemos como eliminar valores de un array o arreglo.