Admin: 1 revision imported

2025-12-27T17:07:39Z

1 revision imported

1>Admin at 12:11, 17 December 2025

2025-12-17T12:11:25Z

New page

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

== Синтаксис ==
<code>
{{Grey|Tab.}}'''UpdateLineEx'''(''<Наименования столбцов поиска через запятую (STRING)>''{{OptionalByRef|,''<Начальный индекс поиска, результирующий индекс (INT)>''}}{{Optional|,<Значение столбца поиска 1>,<Значение столбца поиска 2>...,<Таблица сортирована по столбцам поиска (INT)>,<Наименования столбцов обновления через запятую (STRING)>,<Значение обновления столбца 1>,<Значение обновления столбца 2>...}}):''<0, если строка добавлена, иначе количество обновленных строк (INT)>''
</code>
==== Аргументы ====
* <code>''<Наименования столбцов поиска через запятую (STRING)>''</code> - Строка содержит список наименований столбцов поиска через запятую. Регистр наименований не имеет значения. Каждый заданный столбец должен присутствовать в таблице. Первый символ этого аргумента может быть знаком <code>+</code> или <code>-</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>), будет происходить поиск с учетом сортировки (ускорение). Пример сравнения скорости работы функции для сортированных и не сортированных таблиц см. ниже. '''Важно''': если таблица не была отсортирована по столбцам поиска, функция не будет работать корректно, если этот аргумент установлен.
* <code>''<Наименования столбцов обновления через запятую (STRING)>''</code> - Наименования столбцов обновления, разделенные запятой. Для всех найденных в таблице строк их значения в этих столбцах будут изменены на значения последующих аргументов. При добавлении строки, ее соответствующие столбцы также будут заполнены этими значениями.
* <code>''<Значение столбца ?>''</code> - {{Optional}} Значения произвольного типа, которыми будут обновлены ячейки наденных строк таблицы, либо заполнены в добавляемой строке.

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

== Примеры ==
<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,4);
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,4);
aTab.AddLine("b1,b2,b3,b4",5,2,3,4);

Message(aTab.UpdateLineEx("b1,b2",,2,2,0,"b3,b4",9,9));
//Выводит число 1 (количество изменненных строк)
//Вторая строка теперь содержит значения: 2,2,9,9.

Message(aTab.UpdateLineEx("b1,b2",,9,9,0,"b3,b4",9,9));
//Выводит число 0
//В таблице добавилась строка со значениями 9,9,9,9.
</pre>

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

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

Tab.UpdateLineEx - Revision history

Admin: 1 revision imported

1>Admin at 12:11, 17 December 2025