Godot 4 Obtener valores de un Array en GDScript

En este tutorial aprenderemos más de los arreglos y como Obtener valores de un Array en GDScript el lenguaje de programación más usado en Godot 4

En el capítulo anterior vimos como crear arreglos en GDScript, ahora veremos como obtener los valores que guardamos en esos arreglos mediante el índice y también usando algunos métodos.

¿Como leer los arreglos en GDScript?

•Los valores o datos del array son conocidos como elementos.

•Y la cantidad de elementos se le denomina tamaño o rango.

•Cada elemento tiene un número, llamado índice, para identificarlo y acceder a su valor.

Obtener valores de un array en GDScript mediante el índice

Para acceder al primer índice se hace empezando desde 0.

Por ejemplo, para obtener el primer valor del arreglo deberíamos hacerlo accediendo al número 0

Y si quisieras el número 5, deberías acceder con el índice 1 por ejemplo:

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

func _ready():
	#Mostrar sus distintos indices
	print(my_array[0] )
	print(my_array[1] )
	print(my_array[2] )
	print(my_array[3] )

Puedes copiar este código y ejecutarlo en la consola de Godot Engine

Error: Out of bounds get index ‘5’ (on base: ‘Array’)

Si intentas acceder a un índice que no existe

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

func _ready():
	#Error si accedes a un valor que no existe
	print(my_array[5] )

Te mostrará el siguiente error, porque solo hay 3 índices en este arreglo

Error: Out of bounds get index ‘5’ (on base: ‘Array’)

Obtener el primer valor de un array con el método front

Además de obtener el primer valor del array usando el índice 0, puedes obtener el primer valor del arreglo usando el método front()

Ejemplo del método back()

El método front devuelve el primer elemento del array. Imprime un error y devuelve nulo si la matriz está vacía.

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

func _ready():
	# Primer valor de un array
	print( my_array.front() )

	# Detiene la ejecución del Proyecto si el array está vacío	
	#print( my_array2[0] )

Pero recuerda que usar el método front no es lo mismo que escribir array[0]. Si el arreglo vacio, el acceso por índice detendrá la ejecución del proyecto cuando se ejecute desde el editor.

Obtener el último valor de un array con el método back

Además de obtener el primer valor del array usando el índice -1, puedes obtener el ultimo valor del arreglo usando el método back()

Ejemplo del método back()

El método back devuelve el último elemento del array. Imprime un error y devuelve nulo si la matriz está vacía.

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

func _ready():
	# Último valor de un array
	print( my_array.back() )

	# Detiene la ejecución del Proyecto si el array está vacío	
	#print( my_array2[-1] )

Pero recuerda que usar el método back no es lo mismo que escribir array[-1]. Si la matriz está vacía, el acceso por índice detendrá la ejecución del proyecto cuando se ejecute desde el editor.

Obtener un valor aleatorio de un array con el método pick_random 

Puedes tener un valor random que se encuentre en un arreglo usando el método pick_random

Ejemplo del método pick_random 

Este ejemplo Imprime cualquiera de los cuatro números.

var array: Array[int] = [1, 2, 3, 4]

func _ready():
	# Prints either of the four numbers.
	print( array.pick_random() )

Ejemplo de Vectores dentro de Arreglos en GDScript y Godot

Para obtener el valor de un vector 2d que se encuentra dentro de un array podemos usar los siguientes ejemplos:

Aquí accedemos al valor del primer índice, y después accedemos a la coordenada X, así que deberíamos obtener el número 1

var array_with_vector_2d = [
	Vector2(1,0),
	Vector2(0,10),
]

func _ready():
	print(array_with_vector_2d[0].x )

Aquí accedemos al valor del segundo índice, y después accedemos a la coordenada Y, así que deberíamos obtener el número 10

var array_with_vector_2d = [
	Vector2(1,0),
	Vector2(0,10),
]

func _ready():
	print(array_with_vector_2d[1].y )

Video sobre Godot 4 Obtener valores de un Array en GDScript

Con este video podrás entender mejor como obtener valores de un array en GDScript y tendrás más información sobre como acceder a los valores de un arreglo en cualquier posición.

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