Tab.RemoveLocated - Revision history

Admin: 1 revision imported

2025-12-27T17:07:38Z

1 revision imported

1>Admin at 15:02, 5 December 2025

2025-12-05T15:02:17Z

Admin: 1 revision imported

2021-02-07T06:53:37Z

1 revision imported

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

2019-08-18T07:02:43Z

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

New page

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

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

==== Аргументы ====
* <code>''<Список наименований столбцов поиска через запятую (STRING)>''</code> - Строка содержит список наименований столбцов поиска через запятую. Регистр наименований не имеет значения. Каждый заданный столбец должен присутствовать в таблице.
* <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);

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

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

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

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

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

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

← Older revision	Revision as of 06:53, 7 February 2021
(No difference)