List.RemoveValue

RemoveValue (Поиск и удаление значений)
Объект: Список Статус разработки: Реализована Тип: Функция Обращение к БД: Нет Исключения: Виз. объект только для чтения Визуальность: Нет

• Начальная страница
• Общее описание
• Объекты
• Список

Функция удаляет из списка все значения, соответствующие указанному.

Синтаксис

List.RemoveValue(<Значение для удаления>,<Сортировка (INT)>=0)

Аргументы

• <Значение для удаления> - Значение, поиск и удаление которого будет осуществляться
• <Сортировка (INT)>=0 - (необязательный аргумент) Признак того, что список отсортирован по значениям. В случае наличия сортировки удаление будет происходить быстрее, так как поиск будет происходить с учетом сортировки и, если удаляется более одного значения, все они будут удалены одной операцией (в ином случае, потребуется столько операций удаления, сколько значений было найдено).

Примеры

//Создадим список с 11 значениями
a:=List.Create(1,2,3,4,4,5,6,7,8,9,10);
//Список не изменится
a.RemoveValue(11,1);
//Список содержит значения 1,2,3,5,6,7,8,9,10
a.RemoveValue(4,1);

//Создадим несортированный список с 11 значениями
a:=List.Create(11,2,4,6,4,5,6,1,8,3,7);
//Список будет содержать значения 2,4,6,4,5,6,1,8,3,7
a.RemoveValue(11);
//Список содержит значения 2,6,5,6,1,8,3,7
a.RemoveValue(4);