Admin: 1 revision imported

2025-12-27T17:07:37Z

1 revision imported

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

2025-12-19T06:13:15Z

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

New page

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

== Синтаксис ==
<code>
{{Grey|Tab.}}'''LocateEx'''(''<Список наименований столбцов поиска через запятую (STRING)>''{{OptionalByRef|,<Начальный индекс поиска, результирующий индекс (INT)>}}{{Optional|,<Значение поиска столбца 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>), будет происходить поиск с учетом сортировки (ускорение). Пример сравнения скорости работы функции для сортированных и не сортированных таблиц см. ниже. '''Важно''': если таблица не была отсортирована по столбцам поиска, сортированный поиск не будет работать корректно.

==== Возвращаемое значение ====
Возвращается индекс найденной строки, если строка со всеми значениями была найдена, иначе возвращается ноль.

== Примеры ==
<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);

i:=0;
While aTab.LocateEx("b2,b3",i,2,3)>0 Do
Message("Найдена строка "+i);
i:=i+1;
EndDo;

//Будет выведено последовательно:
//Найдена строка 1
//Найдена строка 2
//Найдена строка 4
//Найдена строка 5
//Найдена строка 6
</pre>

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

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

Tab.LocateEx - Revision history

Admin: 1 revision imported

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