Tab.FindAndGoto - Revision history

Admin: 1 revision imported

2025-12-27T17:07:36Z

1 revision imported

1>Admin at 08:12, 12 December 2025

2025-12-12T08:12:16Z

Admin: 1 revision imported

2021-02-07T06:53:29Z

1 revision imported

Admin: /* Аргументы */

2020-03-10T16:42:14Z

‎Аргументы

New page

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

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

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

==== Возвращаемое значение ====
Возвращается единица, если значение найдено, иначе возвращает ноль. Если значение было найдено, также обновляются переменные индекса поиска и/или столбца поиска и индекс текущей строки (''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);

If aTab.FindAndGoto(5,,"b2") Then
Message("Значение столбца b1 строки "+aTab.CurLine+",где в столбце b2 было найдено число 5: "+aTab.b1);
EndIf;

iCol:=0;
If aTab.FindAndGoto(33,2,iCol) Then
Message("Для строки 2 число 33 найдено в столбце "+aTab.GetColumnName(iCol));
EndIf;

iCol:=0;
If aTab.FindAndGoto(77,,iCol) Then
Message("Значение столбца b1 строки "+aTab.CurLine+",где в столбце "+aTab.GetColumnName(iCol)+" было найдено число 77: "+aTab.b1);
EndIf;

//Будет выведено последовательно:
//"Значение столбца b1 строки 3,где в столбце b2 было найдено число 5: 3"
//"Для строки 2 число 33 найдено в столбце B4"
//"Значение столбца b1 строки 5,где в столбце B4 было найдено число 77: 4"
</pre>

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

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

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

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