Admin: 1 revision imported

2021-02-07T06:53:35Z

1 revision imported

Admin at 06:27, 17 August 2019

2019-08-17T06:27:41Z

New page

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

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

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

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

Message("В первом случае была найдена строка: "+aTab.Locate("b2,b3",2,3));
Message("Во втором случае была найдена строка: "+aTab.Locate("b4",77));

//Будет выведено последовательно:
//"В первом случае была найдена строка: 1"
//"Во втором случае была найдена строка: 5"
</pre>

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

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

Tab.Locate - Revision history

Admin: 1 revision imported

Admin at 06:27, 17 August 2019