Admin: 1 revision imported

2022-04-18T09:19:33Z

1 revision imported

1>Admin at 10:47, 7 April 2022

2022-04-07T10:47:52Z

Admin: 1 revision imported

2021-11-20T17:07:26Z

1 revision imported

1>Admin at 18:05, 12 August 2021

2021-08-12T18:05:09Z

New page

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

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

== Примеры ==
<pre>
//Демонстрация операции "ADD"
aList:=List.Create("AB",0,0,1,2,3,4,"BA","ABC","BA",7,2,2.5);
bList:=List.Create("AB",1,1,0,2,5,4,"BAD","ABC","AB",2.5,2,1.5,1.5);
//Результат будет содержать: "AB",0,0,1,2,3,4,"BA","ABC","BA",7,2,2.5,5,"BAD",1.5
aList.Combine(bList,"ADD");

//Демонстрация операции "AND"
aList:=List.Create("AB",0,0,1,2,3,4,"BA","ABC","BA",7,2,2.5);
bList:=List.Create("AB",1,1,0,2,5,4,"BAD","ABC","AB",2.5,2,1.5,1.5);
//Результат будет содержать: "AB",0,0,1,2,4,"ABC",2,2.5
aList.Combine(bList,"ADD");

//Демонстрация операции "XOR"
aList:=List.Create("AB",0,0,1,2,3,4,"BA","ABC","BA",7,2,2.5);
bList:=List.Create("AB",1,1,0,2,5,4,"BAD","ABC","AB",2.5,2,1.5,1.5);
//Результат будет содержать: 3,"BA","BA",7,5,"BAD",1.5,1.5
aList.Combine(bList,"ADD");

//Демонстрация операции "SUB"
aList:=List.Create("AB",0,0,1,2,3,4,"BA","ABC","BA",7,2,2.5);
bList:=List.Create("AB",1,1,0,2,5,4,"BAD","ABC","AB",2.5,2,1.5,1.5);
//Результат будет содержать: 3,"BA","BA",7
aList.Combine(bList,"ADD");
</pre>

← Older revision	Revision as of 09:19, 18 April 2022
(No difference)

@@ Line 40: / Line 40: @@
 bList:=List.Create("AB",1,1,0,2,5,4,"BAD","ABC","AB",2.5,2,1.5,1.5);
 //Результат будет содержать: "AB",0,0,1,2,4,"ABC",2,2.5
-aList.Combine(bList,"ADD");
+aList.Combine(bList,"AND");
 //Демонстрация операции "XOR"
@@ Line 46: / Line 46: @@
 bList:=List.Create("AB",1,1,0,2,5,4,"BAD","ABC","AB",2.5,2,1.5,1.5);
 //Результат будет содержать: 3,"BA","BA",7,5,"BAD",1.5,1.5
-aList.Combine(bList,"ADD");
+aList.Combine(bList,"XOR");
 //Демонстрация операции "SUB"
@@ Line 52: / Line 52: @@
 bList:=List.Create("AB",1,1,0,2,5,4,"BAD","ABC","AB",2.5,2,1.5,1.5);
 //Результат будет содержать: 3,"BA","BA",7
-aList.Combine(bList,"ADD");
+aList.Combine(bList,"SUB");
 </pre>

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

List.Combine - Revision history

Admin: 1 revision imported

1>Admin at 10:47, 7 April 2022

Admin: 1 revision imported

1>Admin at 18:05, 12 August 2021