Admin: 1 revision imported

2025-12-27T17:07:38Z

1 revision imported

1>Admin: Created page with "{{infobox function |name=RemoveLocatedEx |object=Таблица |caption=Удаление строк |type=1 |status=2 |db=0 |exception=Неверное имя столб..."

2025-12-05T15:08:19Z

Created page with "{{infobox function |name=RemoveLocatedEx |object=Таблица |caption=Удаление строк |type=1 |status=2 |db=0 |exception=Неверное имя столб..."

New page

{{infobox function
|name=RemoveLocatedEx
|object=[[Таблица]]
|caption=Удаление строк
|type=1
|status=2
|db=0
|exception=Неверное имя столбца, невозможно превратить в число, строку
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Таблица]]}}
Функция производит поиск заданного списком столбцов количества значений в таблице. Строки, подходящие под фильтр поиска, будут удалены из таблицы. Поиск начинается со строки таблицы, заданной вторым аргументом. Поиск может принимать во внимание факт того, что таблица сортирована по всем столбцам поиска по неубыванию, что может значительно ускорить операцию. Строка за последним найденным значением будет возвращена в переменной, заданной вторым аргументом, если таковая присутствует. В отличие от [[Tab.RemoveLocatedEx|RemoveLocatedEx]] функция не использует текущую строку, что позволяет ее применять при работе с нескольми потоками (thread-safe) без необходимости использовать функции, типа [[LockObject]].

== Синтаксис ==
<code>
{{Grey|Tab.}}'''RemoveLocatedEx'''({{Optional|<Наименования столбцов поиска через запятую (STRING)>,{{OptionalByRef|<Начальный индекс поиска, результирующий индекс (INT)>}},<Значение столбца 1>,<Значение столбца 2>...,<Таблица сортирована по столбцам поиска (INT)>}}):''<Удален по крайней мере один элемент (INT)>''
</code>

==== Аргументы ====
* <code>''<Наименования столбцов поиска через запятую (STRING)>''</code> - Строка содержит список наименований столбцов поиска через запятую. Регистр наименований не имеет значения. Каждый заданный столбец должен присутствовать в таблице.
* <code>''<Начальный индекс поиска, результирующий индекс (INT)>''</code> - {{Optional}} {{ByRef}} Переменная, содержащая начальную строку поиска. Если задана, также будет обновлена индексом строки после последней найденной (удаленной) строки.
* <code>''<Значение столбца ?>''</code> - {{Optional}} Произвольные значения, которые необходимо найти в таблице в указанных в первом аргументе столбцах поиска. Количество аргументов должно совпадать с количеством столбцов.
* <code>''<Таблица сортирована по столбцам поиска (INT)>''</code> - {{Optional}} Возможные значения 0 и 1. Если таблица была предварительно отсортирована по всем столбцам поиска по неубыванию (т.е. предварительно выполнена конструкция <code>aTab.Sort(<Столбец1,Столбец2...>)</code>, либо для заполнения таблицы вызывалась функция <code>aTab.AddLineSorted(<Столбец1,Столбец2...>,...)</code>), будет происходить поиск с учетом сортировки (ускорение). Пример сравнения скорости работы функции для сортированных и не сортированных таблиц см. ниже. '''Важно''': если таблица не была отсортирована по столбцам поиска, функция не будет работать корректно, если этот аргумент установлен.

==== Возвращаемое значение ====
Возвращает 1, если по крайней мере одна строка была удалена, иначе возвращает 0.

== Примеры ==
<pre>
//Создается и заполняется таблица значений
aTab:=Tab.Create("b1,b2,b3,b4");

aTab.AddLine("b1,b2,b3,b4",1,2,3,4);
aTab.AddLine("b1,b2,b3,b4",2,2,3,33);
aTab.AddLine("b1,b2,b3,b4",3,5,5,4);
aTab.AddLine("b1,b2,b3,b4",4,2,3,4);
aTab.AddLine("b1,b2,b3,b4",4,2,3,77);
aTab.AddLine("b1,b2,b3,b4",5,2,3,4);

//Удаление будем производить, начиная со строки 2.
aNum:=2;
aTab.RemoveLocatedEx("b3",aNum,3);

aTab.Select();
While aTab.Next() Do
Message(""+aTab.b1+"; "+aTab.b2+"; "+aTab.b3+"; "+aTab.b4);
EndDo;

//Будет выведено последовательно:
//"1; 2; 3; 4"
//"3; 5; 5; 4"
</pre>

=== Сравнение скорости работы функций с сортировкой и функций без сортировки ===
{{Пример поиска множества значений в сортированных таблицах}}

← Older revision	Revision as of 17:07, 27 December 2025
(No difference)

Tab.RemoveLocatedEx - Revision history

Admin: 1 revision imported

1>Admin: Created page with "{{infobox function |name=RemoveLocatedEx |object=Таблица |caption=Удаление строк |type=1 |status=2 |db=0 |exception=Неверное имя столб..."