Tab.LocateAndGoto - Revision history

Admin: 1 revision imported

2025-12-27T17:07:37Z

1 revision imported

1>Admin at 06:08, 19 December 2025

2025-12-19T06:08:42Z

Admin: 1 revision imported

2025-06-09T11:14:42Z

1 revision imported

1>Admin at 07:02, 2 February 2025

2025-02-02T07:02:39Z

Admin: 1 revision imported

2021-02-07T06:53:35Z

1 revision imported

Admin at 09:14, 9 December 2020

2020-12-09T09:14:37Z

New page

{{infobox function
|name=LocateAndGoto
|object=[[Таблица]]
|caption=Поиск в ячейках
|type=1
|status=2
|db=0
|exception=Неверное имя столбца, невозможно превратить в число, строку
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Таблица]]}}
Функция производит поиск заданного списком столбцов количества значений в таблице. Функция ищет строки, в которых каждый из указанных в первом аргументе функции столбцов, содержит значение, указанное в соответствующем последующем аргументе функции. '''Важно''': в отличие от функции [[Tab.Locate|Locate]], поиск всегда начинается со строки таблицы, следующей за текущей строкой (чтобы поиск начинался с начала таблицы, можно выполнить операцию <code><Таблица>.CurLine:=0</code>). '''Важно''': в отличие от функции [[Tab.FindAndGoto|FindAndGoto]], данная функция возвращает индекс найденной строки, а не признак того, что строка была найдена, не используйте в условии '''без сравнения с нулем''' (<code>If <Таблица>.LocateAndGoto(...)>0 Then</code>)! Поиск может принимать во внимание факт того, что таблица сортирована по всем столбцам поиска по неубыванию, что может значительно ускорить нахождение значения. Если значение найдено, индекс строки где оно было найдено, возвращается в результате функции и обновляет текущую строку таблицы, иначе функция возвращает ноль.

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

==== Возвращаемое значение ====
Возвращается индекс найденной строки, если строка со всеми значениями была найдена, иначе возвращается ноль. Если строка найдена, она также будет отмечена как текущая (''CurLine''), в ином случае, текущая строка не будет изменена.

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

aTab.CurLine:=0;
If aTab.LocateAndGoto("b2,b3",2,3)>0 Then
Message("В первом случае была найдена строка: "+aTab.CurLine);
EndIf;
If aTab.LocateAndGoto("b4",77)>0 Then
Message("Во втором случае была найдена строка: "+aTab.CurLine);
EndIf;
//Функция будет начинать поиск со строки 5, поэтому, первая строка не будет найдена
If aTab.LocateAndGoto("b1",1)=0 Then
Message("В третьем случае, строка не найдена!");
EndIf;

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

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

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

@@ Line 13: / Line 13: @@
 * [[Объекты]]
 * [[Таблица]]}}
-Функция производит поиск заданного списком столбцов количества значений в таблице. Функция ищет строки, в которых каждый из указанных в первом аргументе функции столбцов, содержит значение, указанное в соответствующем последующем аргументе функции. '''Важно''': в отличие от функции [[Tab.Locate|Locate]], поиск всегда начинается со строки таблицы, следующей за текущей строкой (чтобы поиск начинался с начала таблицы, можно выполнить операцию <code><Таблица>.CurLine:=0</code>). '''Важно''': в отличие от функции [[Tab.FindAndGoto|FindAndGoto]], данная функция возвращает индекс найденной строки, а не признак того, что строка была найдена, не используйте в условии '''без сравнения с нулем''' (<code>If <Таблица>.LocateAndGoto(...)>0 Then</code>)! Поиск может принимать во внимание факт того, что таблица сортирована по всем столбцам поиска по неубыванию, что может значительно ускорить нахождение значения. Если значение найдено, индекс строки, где оно было найдено, возвращается в результате функции и обновляет текущую строку таблицы, иначе функция возвращает ноль.
+Функция производит поиск заданного списком столбцов количества значений в таблице. Функция ищет строки, в которых каждый из указанных в первом аргументе функции столбцов, содержит значение, указанное в соответствующем последующем аргументе функции. '''Важно''': в отличие от функции [[Tab.Locate|Locate]], поиск всегда начинается со строки таблицы, следующей за текущей строкой (чтобы поиск начинался с начала таблицы, можно выполнить операцию <code><Таблица>.CurLine:=0</code>). '''Важно''': в отличие от функции [[Tab.FindAndGoto|FindAndGoto]], данная функция возвращает индекс найденной строки, а не признак того, что строка была найдена, не используйте в условии '''без сравнения с нулем''' (<code>If <Таблица>.LocateAndGoto(...)>0 Then</code>)! Поиск может принимать во внимание факт того, что таблица сортирована по всем столбцам поиска по неубыванию, что может значительно ускорить нахождение значения. Если значение найдено, индекс строки, где оно было найдено, возвращается в результате функции и обновляет текущую строку таблицы, иначе функция возвращает ноль. '''Важно:''' для многопотоковых обращений эта функция может вызвать проблемы, так как использует атрибут [[Tab.CurLine|CurLine]], который не рекомендуется использовать в многопоточном режиме (not thread-safe). Если обращение к таблице просходит из разных потоков, лучше использовать функцию [[Tab.Locate|Locate]] или [[Tab.LocateEx|LocateEx]] с нахождением индекса и индексировать ячейки таблицы через этот индекс (к примеру, <code>Таб2["Столбец",аИндекс]</code>).
 == Синтаксис ==

← Older revision	Revision as of 11:14, 9 June 2025
(No difference)

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