Admin: 1 revision imported

2021-02-07T06:53:29Z

1 revision imported

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

2020-03-10T16:42:31Z

‎Аргументы

New page

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

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

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

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

iStr:=0;
If aTab.Find(5,iStr,"b2") Then
Message("Для столбца b2 число 5 найдено в строке "+iStr);
EndIf;

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

iStr:=0;
iCol:=0;
If aTab.Find(77,iStr,iCol) Then
Message("Число 77 было найдено в строке "+iStr+" столбца "+aTab.GetColumnName(iCol));
EndIf;

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

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

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

Tab.Find - Revision history

Admin: 1 revision imported

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