LDArray
Класс LDArray (Массив LitDev) предназначен для создания и работы с одномерным массивом, который обрабатывается намного быстрее, чем стандартные массивы MS Small Basic. Индексы массива начинаются с 1. Это очень полезно для массивов с более чем 1000 элементов. Ошибка при выполнении методов класса приводит к возврату значения «FAILED».
Методы класса LDArray:
Copy()
Copy()LDArray.Copy(array1, array2)
Копирует один массив в другой (уже существующий) массив. Размеры двух массивов должны быть одинаковыми.
array1 — Имя исходного массива для копирования.
array2 — Имя массива, в который будет выполнено копирование.
Возвращает: «FAILED» или «» в случае успеха.
CopyNew()
LDArray.CopyNew(array)
Копирует массив в новый массив, который создаётся при выполнении метода.
array — Имя исходного массива для копирования.
Возвращает: Имя копии массива или «FAILED».
CopyToSBArray()
LDArray.CopyToSBArray(array)
Копирует массив типа LDArray в стандартный массив MS Small Basic. Обратная операция («из MS Small Basic в LDArray») невозможна, поскольку индексы массивов MS Small Basic не обязательно являются непрерывно следующими друг за другом целыми числами. Также обратите внимание, что массив MS Small Basic не может содержать пустое строковое значение, поэтому такие элементы не будут скопированы.
array — Имя массива.
Возвращает: Имя массива MS Small Basic или «FAILED».
Count()
LDArray.Count(array)
Возвращает количество непустых элементов в массиве.
array — Имя массива.
Возвращает: Количество непустых значений в массиве.
Create()
LDArray.Create(maxSize)
Создаёт новый массив (можно использовать для чисел или символьных строк).
maxSize — Максимальное количество элементов в массиве.
Возвращает: Имя массива или «FAILED».
CreateFromIndices()
LDArray.CreateFromIndices(sbArray)
Создаёт новый массив из индексов стандартного массива MS Small Basic.
sbArray — Массив MS Small Basic.
Возвращает: Имя нового массива или «FAILED».
CreateFromValues()
LDArray.CreateFromValues(sbArray)
Создаёт новый массив из значений стандартного массива MS Small Basic.
sbArray — Массив MS Small Basic.
Возвращает: Имя нового массива или «FAILED».
Delete()
LDArray.Delete(array)
Удаляет существующий массив (обычно это не требуется, но может сохранять память, если создано много массивов).
array — Имя удаляемого массива.
Возвращает: «FAILED» или «» в случае успеха.
GetIndex()
LDArray.GetIndex(sbArray,value)
Получает индекс первого встреченного элемента с заданным значением в массиве MS Small Basic.
sbArray — Массив MS Small Basic.
value — Значение для поиска.
Возвращает: Индекс элемента с заданным значением в массиве, или если таких элементов нет — «FAILED».
GetValue()
LDArray.GetValue(array,index)
Получает значение элемента массива с заданным индексом.
array — Имя массива.
index — Индекс, по которому нужно получить значение (индексы начинаются с 1).
Возвращает: Значение элемента массива с заданным индексом или «FAILED».
Load()
LDArray.Load(array,fileName)
Загрузжает массив из файла.
array — Массив для загрузки данных. Массив уже должен существовать.
fileName — Путь к файлу для загрузки данных в массив.
Возвращает: Количество загруженных элементов.
Save()
LDArray.Save(array,fileName)
Сохраняет массив в файл.
array — Массив для сохранения.
fileName — Путь к файлу для сохранения файла.
Возвращает: Количество сохраненных элементов.
Search()
LDArray.Search(array,searchstring,match)
Получает массив индексов, элементы которых имеют значения, совпадающие со строкой для поиска. Поиск является чувствительным к регистру. Входной массив не изменяется, и массив соответствия должен быть предварительно создан с тем же размером, что и проверяемый массив.
array — Массив для проверки совпадений.
searchstring — Строка для поиска.
match — Массив для хранения индекса совпадающих значений.
Возвращает: Количество найденных совпадений.
SetValue()
LDArray.SetValue(array,index,value)
Задаёт значение элемента массива с заданным индексом.
array — Имя массива.
index — Индекс элемента массива, которому нужно задать значение (индексы начинаются с 1).
value — Значение.
Возвращает: «FAILED» или «» в случае успеха.
Sort()
LDArray.Sort(array)
Выполняет сортировку массива типа LDArray. По умолчанию сортировка производится по строковому значению, поэтому элемент со значением «10» предшествует элементу со значением «2». Чтобы отсортировать массив по числовым значениям, все значения элементов массива должны быть числами или пустыми строками. После сортировки пустые строки помещаются в конце отсортированного массива. После завершения работы исходный массив заменяется отсортированным массивом.
array — Массив для сортировки.
Возвращает: «FAILED» или «» в случае успеха.
SortIndex()
LDArray.SortIndex(array,index)
Получает массив индексов в порядке сортировки массива. По умолчанию сортировка производится по строковому значению, поэтому элемент с индексом «10» предшествует элементу с индексом «2». Чтобы отсортировать массив по числовым значениям индексов, все индексы элементов массива должны быть числами или пустыми строками. После сортировки пустые строки помещаются в конце отсортированного массива. Исходный массив не изменяется, массив для отсортированных индексов должен быть предварительно создан того же размера, что и сортируемый массив.
array — Массив для сортировки индекса.
index — Массив, который удерживает индексный порядок отсортированного массива.
Возвращает: «FAILED» или «» в случае успеха.
Список всех классов библиотеки LitDev
Поделиться: