Списки
Список загружает сбор значений в конкретный порядок. Вы можете добавлять значения в конце, или добавлять их где-нибудь в середине списка. Вы можете адресовать величины, которые используют индекс. Также Вы можете отсортировать элементы или в возрастающем или в убывающем порядке. Список может быть использован во многих путях, например, чтобы загружать изменённые значения. Они осуществлены простой подготовкой, но так как это делается в компилированном коде, то это намного быстрее, чем использование массивов. Доступны следующие функции:
ds_list_create()
Создаёт новый список. Функция возвращает целое как id, что должно быть использовано во всех других функциях, чтобы иметь доступ к конкретному списку.
ds_list_destroy(id)
Уничтожает список с заданным id, освобождая используемую память. Не забывайте называть эту функцию, когда у Вас готова структура.
ds_list_clear(id)
Очищает список с заданным id, удаляя все данные из него, но его не уничтожая.
ds_list_copy(id,source)
Копирует список source в список с заданным id.
ds_list_size(id)
Возвращает количество значений загруженных в список.
ds_list_empty(id)
Возвращает, если список пуст. Это так же проверяет, если размер - 0.
ds_list_add(id,val)
Добавляет значение в конец списка.
ds_list_insert(id,pos,val)
Включает значение в позиции pos в списке. Исходное положение является позицией 0, последний размер минус 1.
ds_list_replace(id,pos,val)
Заменяет значение в позиции pos в списке с новым значением.
ds_list_delete(id,pos)
Удаляет значение в позиции pos в списке. (0 - первый элемент.)
ds_list_find_index(id,val)
Обнаруживает позицию, сохраняя указанное значение. Если значение не в списке - возвращает -1.
ds_list_find_value(id,pos)
Возвращает значение, загруженное в указанную позицию списка.
ds_list_sort(id,ascend)
Сортирует значения в списке. Когда возрастает - истина, какие значения отсортированы в порядке возрастания, в противном случае - в порядке убывания.
ds_list_shuffle(id)
Перетасовываются в случайном порядке значения списка.
ds_list_write(id)
Превращает дата-структуру в строку и возвращает эту строку. Строка может использоваться, например, чтобы сохранить ее в файл. Это обеспечивает простой механизм сохранения дата-структур.
ds_list_read(id,str)
Читает дата-структуру из данной строки (которая создана предыдущим запросом).