Tab.AddLineSorted - Revision history

Admin: 1 revision imported

2022-03-13T10:10:34Z

1 revision imported

1>Admin at 14:37, 19 December 2021

2021-12-19T14:37:26Z

Admin: 1 revision imported

2021-02-07T06:53:22Z

1 revision imported

Admin at 12:49, 4 September 2019

2019-09-04T12:49:15Z

New page

{{infobox function
|name=AddLineSorted
|object=[[Таблица]]
|caption=Работа со строками
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, неверные имена столбцов
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Таблица]]}}
Функция добавляет новую строку и помечает ее как текущую (т.е. атрибут [[Tab.CurLine|CurLine]] изменяется на индекс добавленной строки). Указанные во втором аргументе столбцы таблицы, в добавленной строке будут заполнены значениями, заданными последующими аргументами. Строка вставляется в таблицу таким образом, чтобы не нарушить сортировку, заданную наименованиями столбцов первого аргумента. '''Важно''': таблица должна быть отсортирована по всем столбцам сортировки последовательно (т.е., должна быть проведена операция <code>aTab.Sort(<Наименования столбцов сортировки через запятую (STRING)></code>, если таблица была не сортирована)), иначе сохранение порядка сортировки не будет работать корректно. '''Важно''': все столбцы сортировки должны присутствовать в столбцах добавления (порядок не важен). Данная функция может использоваться при необходимости последовательного добавления строк в таблицу, для которой важна сортировка (к примеру, будет использоваться функция Find с флагом сортировки. Как альтернатива, таблицу можно отсортировать перед началом блока с поиском, но в случае, если в одном блоке происходит и добавление строк и поиск строк по элементам, данный режим будет работать гораздо быстрее, чем последовательные вызовы сортировки перед каждым поиском (см. пример ниже).

== Синтаксис ==
<code>
{{Grey|Tab.}}'''AddLineSorted'''(''<Наименования столбцов сортировки через запятую (STRING)>'',''<Наименования столбцов добавления через запятую (STRING)>''{{Optional|,<Значение столбца 1>,<Значение столбца 2>...}})
</code>
==== Аргументы ====
* <code>''<Наименования столбцов сортировки через запятую (STRING)>''</code> - Наименования столбцов сортировки, разделенные запятой. Заполняемые столбцы могут не совпадать со столбцами сортировки, однако, все столбца сортировки должны входить в список столбцов добавления, иначе функция не сможет получить все значения, необходимые для нахождения индекса новой строки.
* <code>''<Наименования столбцов добавления через запятую (STRING)>''</code> - Наименования столбцов для заполнения, разделенные запятой. Количество наименований должно совпадать с количеством аргументов, следующих за данным.
* <code>''<Значение столбца ?>''</code> - {{Optional}} Значения произвольного типа, которыми будут заполнены ячейки новой строки таблицы в столбцах, перечисленных во втором аргументе.

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

aTab.AddLineSorted("b1,b2","b1,b2,b3,b4",2,1,3,4);

Message(aTab.CurLine);
//Выводит число 2 (была добавлена строка с индексом 2)
</pre>

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

← Older revision	Revision as of 10:10, 13 March 2022
(No difference)

@@ Line 13: / Line 13: @@
 * [[Объекты]]
 * [[Таблица]]}}
-Функция добавляет новую строку и помечает ее как текущую (т.е. атрибут [[Tab.CurLine|CurLine]] изменяется на индекс добавленной строки). Указанные во втором аргументе столбцы таблицы, в добавленной строке будут заполнены значениями, заданными последующими аргументами. Строка вставляется в таблицу таким образом, чтобы не нарушить сортировку, заданную наименованиями столбцов первого аргумента. '''Важно''': таблица должна быть отсортирована по всем столбцам сортировки последовательно (т.е., должна быть проведена операция <code>aTab.Sort(<Наименования столбцов сортировки через запятую (STRING)></code>, если таблица была не сортирована)), иначе сохранение порядка сортировки не будет работать корректно. '''Важно''': все столбцы сортировки должны присутствовать в столбцах добавления (порядок не важен). Данная функция может использоваться при необходимости последовательного добавления строк в таблицу, для которой важна сортировка (к примеру, будет использоваться функция Find с флагом сортировки. Как альтернатива, таблицу можно отсортировать перед началом блока с поиском, но в случае, если в одном блоке происходит и добавление строк и поиск строк по элементам, данный режим будет работать гораздо быстрее, чем последовательные вызовы сортировки перед каждым поиском (см. пример ниже).
+Функция добавляет новую строку и помечает ее как текущую (т.е. атрибут [[Tab.CurLine|CurLine]] изменяется на индекс добавленной строки). Указанные во втором аргументе столбцы таблицы, в добавленной строке будут заполнены значениями, заданными последующими аргументами. Строка вставляется в таблицу таким образом, чтобы не нарушить сортировку, заданную наименованиями столбцов первого аргумента. '''Важно''': таблица должна быть отсортирована по всем столбцам сортировки последовательно (т.е., должна быть проведена операция <code>aTab.Sort(<Наименования столбцов сортировки через запятую (STRING)>)</code>, если таблица была не сортирована), иначе сохранение порядка сортировки не будет работать корректно. '''Важно''': все столбцы сортировки должны присутствовать в столбцах добавления (порядок не важен). Данная функция может использоваться при необходимости последовательного добавления строк в таблицу, для которой важна сортировка (к примеру, будет использоваться функция Find с флагом сортировки. Как альтернатива, таблицу можно отсортировать перед началом блока с поиском, но в случае, если в одном блоке происходит и добавление строк и поиск строк по элементам, данный режим будет работать гораздо быстрее, чем последовательные вызовы сортировки перед каждым поиском (см. пример ниже).
 == Синтаксис ==

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