Una lista guarda una colección de valore en un orden determinado. Puedes añadir valores a la lista a la posición que desees. Por eso, puedes acceder acceder a los valores usando un índice de su posición en la lista. También puedes ordenar los elementos de forma ascendente o descendente. Las listas se pueden usar para muchas cosas, por ejemplo, para guardar valores que cambian. Las listas se han programado usando arrays, pero al estar definidas en código compilado son mucho más rápidas que los arrays.
ds_list_create()Crea
una nueva lista. La función devuelve un número entero con la id de la lista para
usarla en las diferentes funciones. Puedes crear varias listas.
ds_list_destroy(id)
Destruye la lista, liberando la memoria usada. No olvides usar esta función
cuando ya no necesites la lista.
ds_list_clear(id)
Limpia la lista, borrando
todos los valores que contiene pero no la destruye.
ds_list_size(id)
Devuelve el número de valores en la lista.
ds_list_empty(id)
Devuelve true si la lista está vacía. Es lo mismo que chequear si el
número de valores en la lista es cero.
ds_list_add(id,val)
Inserta el valor al final de la lista.
ds_list_insert(id,pos,val)
Inserta el valor en la posición pos. La primera posición es 0 y la última
es igual al tamaño de la lista menos 1.
ds_list_replace(id,pos,val) Reemplaza el valor en la posición pos por val. ds_list_delete(id,pos) Elimina el valor en la posición pos.
ds_list_find_index(id,val)
Devuelve la posición en la lista del valor val.
Si no
encuentra el valor en la lista devuelve -1.
ds_list_find_value(id,pos)
Devuelve el valor en al posición pos.
ds_list_sort(id,ascend)
Ordena los valores de la lista. Si ascend es true o 1 los ordena
de forma ascendente, en caso contrario los ordena de manera descendente.