Tab.Combine - Revision history

Admin: 1 revision imported

2025-12-27T17:07:36Z

1 revision imported

1>Admin at 16:22, 9 November 2025

2025-11-09T16:22:04Z

Admin: 1 revision imported

2023-04-25T09:33:18Z

1 revision imported

1>Admin at 19:06, 17 April 2023

2023-04-17T19:06:07Z

Admin: 1 revision imported

2021-11-20T17:09:02Z

1 revision imported

1>Admin at 18:19, 12 August 2021

2021-08-12T18:19:39Z

New page

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

== Синтаксис ==
<code>
{{Grey|Tab.}}'''Combine'''(''<Таблица для выполнения операции (TAB)>'',''<Наименования или индексы столбцов для сравнения (STRING)>''{{Optional|,<Тип операции (STRING)>{{Default|{{Eq}}"ADD"}},<Таблица сортирована по столбцам поиска (INT)>{{Default|{{Eq}}0}}}})
</code>
==== Аргументы ====
* <code>''<Таблица для выполнения операции (TAB)>''</code> - Объект типа [[Таблица]], с помощью которого будет выполнена операция.
* <code>''<Наименования или индексы столбцов для сравнения (STRING)>''</code> - Строка с наименованиями или индексами столбцов исходной таблицы, которые будут использоваться для сравнения значений исходной и второй таблиц. Вторая таблица должна содержать все столбцы с такими же наименованиями, которые адресуются в исходной таблице этим аргументом.
* <code>''<Тип операции (STRING)>''</code> - {{Optional}} Тип выполняемой операции. Возможны следующие значения:
** '''AND''': Конъюнкция двух таблиц. Результат будет содержать таблицу, значения столбцов поиска которой входили одновременно в исходную и во вторую таблицы. Дублирующиеся строки исходной таблицы будут сохранены, если строка нашлась во второй таблице.
** '''OR''', '''ADD''': Дизъюнкция двух таблиц (по умолчанию) (логическое сложение). Результат будет содержать таблицу, значения столбцов поиска которой входили либо в исходную, либо во вторую таблицу. В результат не добавляются дубли из второй таблицы. Если дубли не имеют значения, быстрее воспользоваться функцией [[Tab.CopyTo|CopyTo]].
** '''XOR''': Неэквивалентность двух таблиц. Результат будет содержать таблицу, значения столбцов поиска которой входили либо в исходную, либо во вторую таблицу, но не одновременно в обе.
** '''SUB''': Логическое вычитание двух таблиц. Соответствует операции <Аргумент 1> XOR (<Аргумент 1> AND <Аргумент 2>). Результат будет содержать таблицу, значения столбцов поиска которой входили в первую таблицу, но не входили во вторую таблицу.
* <code>''<Таблица сортирована по столбцам поиска (INT)>''</code> - {{Optional}} Признак того, что таблица уже сортирована по всем столбоцам поиска по неубыванию (по умолчанию 0). Если таблица сортирована, системе не потребуется сортировать ее перед выполнением операции, тем самым увеличивая скорость выполнения функции. Нужно также заметить, что даже если система сортирует таблицу перед операцией, в результирующей таблице эта виртуальная сортировка будет отсутствовать.

== Примеры ==
<pre>

Function ВывестиТаблицу(aTab,Тип)
Message("");
Message("Демонстрация операции "+Тип+":");
aTab.Select();
While aTab.Next() Do
Message(""+aTab.C1+", "+aTab.C2+", "+aTab.C3);
EndDo;
EndFunction

aTab:=Tab.Create("C1,C2,C3");
aTab.AddLine("C1,C2,C3","AB",0,"A");
aTab.AddLine("C1,C2,C3",0,0,"B");
aTab.AddLine("C1,C2,C3",0,0,"C");
aTab.AddLine("C1,C2,C3",1,1,"D");
aTab.AddLine("C1,C2,C3",2,1,"E");
aTab.AddLine("C1,C2,C3",3,1,"F");
aTab.AddLine("C1,C2,C3",4,1,"G");
aTab.AddLine("C1,C2,C3","BA",2,"H");
aTab.AddLine("C1,C2,C3","ABC",0,"I");
aTab.AddLine("C1,C2,C3","BA",2,"J");
aTab.AddLine("C1,C2,C3",7,0,"K");
aTab.AddLine("C1,C2,C3",2,0,"L");
aTab.AddLine("C1,C2,C3",2.5,0,"M");

bTab:=Tab.Create("C1,C2,C3");
bTab.AddLine("C1,C2,C3",1,0,"A");
bTab.AddLine("C1,C2,C3",1,0,"A");
bTab.AddLine("C1,C2,C3",0,0,"A");
bTab.AddLine("C1,C2,C3",2,1,"A");
bTab.AddLine("C1,C2,C3",5,1,"A");
bTab.AddLine("C1,C2,C3",4,1,"A");
bTab.AddLine("C1,C2,C3","BAD",1,"A");
bTab.AddLine("C1,C2,C3","ABC",2,"B");
bTab.AddLine("C1,C2,C3","AB",0,"A");
bTab.AddLine("C1,C2,C3",2.5,2,"A");
bTab.AddLine("C1,C2,C3",2,0,"A");
bTab.AddLine("C1,C2,C3",1.5,0,"A");
bTab.AddLine("C1,C2,C3",1.5,0,"A");

//Демонстрация операции ADD:
//AB, 0, A
//0, 0, B
//0, 0, C
//1, 1, D
//2, 1, E
//3, 1, F
//4, 1, G
//BA, 2, H
//ABC, 0, I
//BA, 2, J
//7, 0, K
//2, 0, L
//2.5, 0, M
//1, 0, A
//5, 1, A
//BAD, 1, A
//ABC, 2, B
//2.5, 2, A
//1.5, 0, A
cTab:=aTab.Copy();
cTab.Combine(bTab,"C1,C2","ADD");
ВывестиТаблицу(cTab,"ADD");

//Демонстрация операции AND:
//AB, 0, A
//0, 0, B
//0, 0, C
//2, 1, E
//4, 1, G
//2, 0, L
cTab:=aTab.Copy();
cTab.Combine(bTab,"C1,C2","AND");
ВывестиТаблицу(cTab,"AND");

//Демонстрация операции "XOR":
//1, 1, D
//3, 1, F
//BA, 2, H
//ABC, 0, I
//BA, 2, J
//7, 0, K
//2.5, 0, M
//1, 0, A
//1, 0, A
//5, 1, A
//BAD, 1, A
//ABC, 2, B
//2.5, 2, A
//1.5, 0, A
//1.5, 0, A
cTab:=aTab.Copy();
cTab.Combine(bTab,"C1,C2","XOR");
ВывестиТаблицу(cTab,"XOR");

//Демонстрация операции "SUB":
//1, 1, D
//3, 1, F
//BA, 2, H
//ABC, 0, I
//BA, 2, J
//7, 0, K
//2.5, 0, M
cTab:=aTab.Copy();
cTab.Combine(bTab,"C1,C2","SUB");
ВывестиТаблицу(cTab,"SUB");
</pre>

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

@@ Line 13: / Line 13: @@
 * [[Объекты]]
 * [[Таблица]]}}
-Функция выполняет операцию объединения, заданную вторым аргументом, над текущей таблицей и таблицей, заданной первым аргументом. Результат операции сохраняется в текущей таблице. Аргегаьных операций не выполняется. Функцией удобно пользоваться, когда нет необходимости выполнять аргегатные операции, она проще и быстрее чем функции группы ''Join''. При добавлении строк в исходную таблицу из второй, в новые строки копируются все столбцы второй таблицы с наименованиями, совпадающими с исходной.<br />
+Функция выполняет операцию объединения, заданную вторым аргументом, над текущей таблицей и таблицей, заданной первым аргументом. Результат операции сохраняется в текущей таблице. Аргегатных операций не выполняется. Функцией удобно пользоваться, когда нет необходимости выполнять аргегатные операции, она проще и быстрее чем функции группы ''Join''. При добавлении строк в исходную таблицу из второй, в новые строки копируются все столбцы второй таблицы с наименованиями, совпадающими с исходной.<br />
 {{Функции объединения таблиц}}

← Older revision	Revision as of 09:33, 25 April 2023
(No difference)

@@ Line 28: / Line 28: @@
 ** '''XOR''': Неэквивалентность двух таблиц. Результат будет содержать таблицу, значения столбцов поиска которой входили либо в исходную, либо во вторую таблицу, но не одновременно в обе.
 ** '''SUB''': Логическое вычитание двух таблиц. Соответствует операции <Аргумент 1> XOR (<Аргумент 1> AND <Аргумент 2>). Результат будет содержать таблицу, значения столбцов поиска которой входили в первую таблицу, но не входили во вторую таблицу.
-* <code>''<Таблица сортирована по столбцам поиска (INT)>''</code> - {{Optional}} Признак того, что таблица уже сортирована по всем столбоцам поиска по неубыванию (по умолчанию 0). Если таблица сортирована, системе не потребуется сортировать ее перед выполнением операции, тем самым увеличивая скорость выполнения функции. Нужно также заметить, что даже если система сортирует таблицу перед операцией, в результирующей таблице эта виртуальная сортировка будет отсутствовать.
+* <code>''<Таблица сортирована по столбцам поиска (INT)>''</code> - {{Optional}} Признак того, что таблица уже сортирована по всем столбцам поиска по неубыванию (по умолчанию 0). Если таблица сортирована, системе не потребуется сортировать ее перед выполнением операции, тем самым увеличивая скорость выполнения функции. Нужно также заметить, что даже если система сортирует таблицу перед операцией, в результирующей таблице эта виртуальная сортировка будет отсутствовать.
 == Примеры ==

← Older revision	Revision as of 17:09, 20 November 2021
(No difference)