Tab.CopyTo - Revision history

Admin: 1 revision imported

2025-09-29T07:14:25Z

1 revision imported

1>Admin at 16:54, 30 August 2025

2025-08-30T16:54:40Z

Admin: 1 revision imported

2023-08-07T07:04:17Z

1 revision imported

1>Admin at 12:03, 17 July 2023

2023-07-17T12:03:44Z

Admin: 1 revision imported

2021-04-16T14:18:48Z

1 revision imported

1>Admin at 12:59, 6 April 2021

2021-04-06T12:59:41Z

Admin: 1 revision imported

2021-02-07T06:53:28Z

1 revision imported

Admin: /* Синтаксис */

2019-11-09T08:05:55Z

‎Синтаксис

New page

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

== Синтаксис ==
<code>
{{Grey|Tab.}}'''CopyTo'''({{ByRef|''<Объект в который происходит копирование>''}}{{Optional|,<Индекс начальной строки (INT)>,<Индекс конечной строки (INT)>,<Наименования столбцов копирования через запятую (STRING)>,<Наименования столбцов для фильтрации (STRING)>,<Фильтр столбца 1>,<Фильтр столбца 2>...}})
</code>

==== Аргументы ====
* <code>''<Объект в который происходит копирование>''</code> - {{ByRef}} Переменная, содержащая объект типа таблица или список для копирования значений ячеек текущей таблицы. Если переменная содержит объект любого другого вида, ее значение будет очищено и ей будет присвоена новая пустая таблица, в которую будет производиться копирование. Использование аргумента-переменной позволяет получить эту новую таблицу в переменной, как результат. Ниже дана разница при копировании в таблицу и копировании в список:
** При копировании в таблицу, столбцы для копирования с наименованиями, которые отсутствовали в столбцах таблицы, в которую происходит копирование, будут добавлены в эту таблицу. При копировании строки из таблицы копирования добавляются в конец таблицы, в которую происходит копирование, в каждой из добавленной строк заполняются ячейки со копируемыми столбцами.
** При копировании в список, в него добавляются значения, последовательно из каждого копируемого столбца таблицы для каждой из копируемых строк таблицы.
* <code>''<Индекс начальной строки (INT)>''</code> - {{Optional}} Индекс начальной строки диапазона копирования. Если аргумент опущен, будет использована первая строка исходной таблицы.
* <code>''<Индекс конечной строки (INT)>''</code> - {{Optional}} Индекс конечной строки диапазона копирования. Если аргумент опущен, будет использована последняя строка исходной таблицы.
* <code>''<Наименования столбцов копирования через запятую (STRING)>''</code> - {{Optional}} Аргумент перечисляет наименования столбцов через запятую, которые будут включены в процедуру копирования. Регистр наименований не имеет значения. Каждый заданный столбец должен присутствовать в таблице.
* <code>''<Наименования столбцов для фильтрации (STRING)>''</code> - {{Optional}} Аргумент перечисляет наименования столбцов фильтра через запятую. Количество таких столбцов должно соответствовать количеству аргументов-фильтров, заданных после этого аргумента. Для каждой из копируемых строк таблицы, значения находящиеся в столбцах фильтра сравниваются со значениями аргументов-фильтров, и строки, где значения всех столбцов фильтра равны, используются для копирования.
* <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,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);

aList:=List.Create();
bTab:=Tab.Create();

//В список копируются значения двух столбцов, список будет содержать 12 значений.
aTab.CopyTo(aList,1,aTab.Size(),"b1,b4");

//В таблицу копируются значения всех столбцов, строки которых имеют в столбце b2 число 2, и в столбце b3 число 3.
aTab.CopyTo(bTab,1,aTab.Size(),,"b2,b3",2,3);

For i:=1 To aList.Size() Do
Message("Значение "+i+": "+aList.Get(i));
EndDo;

bTab.Select();
While bTab.Next() Do
Message(""+bTab.b1+"; "+bTab.b2+"; "+bTab.b3+"; "+bTab.b4);
EndDo;

//Будет выведено последовательно:
//"Значение 1: 1"
//"Значение 2: 4"
//"Значение 3: 2"
//"Значение 4: 33"
//"Значение 5: 3"
//"Значение 6: 4"
//"Значение 7: 4"
//"Значение 8: 4"
//"Значение 9: 4"
//"Значение 10: 77"
//"Значение 11: 5"
//"Значение 12: 4"
//"1; 2; 3; 4"
//"2; 2; 3; 33"
//"4; 2; 3; 4"
//"4; 2; 3; 77"
//"5; 2; 3; 4"
</pre>

← Older revision	Revision as of 07:14, 29 September 2025
(No difference)

@@ Line 25: / Line 25: @@
 ** При копировании в список, в него добавляются значения, последовательно из каждого копируемого столбца таблицы для каждой из копируемых строк таблицы.
 * <code>''<Индекс начальной строки (INT)>''</code> - {{Optional}} Индекс начальной строки диапазона копирования. Если аргумент опущен, будет использована первая строка исходной таблицы.
-* <code>''<Количество строк для копирования (INT)>''</code> - {{Optional}} Количество строк для копирования. Если аргумент опущен, будет произведено копирование от начального идекса до конца исходной таблицы.
+* <code>''<Количество строк для копирования (INT)>''</code> - {{Optional}} Количество строк для копирования. Если аргумент опущен, будет произведено копирование от начального индекса до конца исходной таблицы.
-* <code>''<Наименования столбцов копирования через запятую (STRING)>''</code> - {{Optional}} Аргумент перечисляет наименования столбцов через запятую, которые будут включены в процедуру копирования. Регистр наименований не имеет значения. Каждый заданный столбец должен присутствовать в таблице.
+* <code>''<Наименования столбцов копирования через запятую (STRING)>''</code> - {{Optional}} Аргумент перечисляет наименования столбцов через запятую, которые будут включены в процедуру копирования. Регистр наименований не имеет значения. Каждый заданный столбец должен присутствовать в таблице. Если аргумент не задан, будут копироваться все столбцы таблицы.
 * <code>''<Наименования столбцов для фильтрации (STRING)>''</code> - {{Optional}} Аргумент перечисляет наименования столбцов фильтра через запятую. Количество таких столбцов должно соответствовать количеству аргументов-фильтров, заданных после этого аргумента. Для каждой из копируемых строк таблицы, значения находящиеся в столбцах фильтра сравниваются со значениями аргументов-фильтров, и строки, где значения всех столбцов фильтра равны, используются для копирования.
 * <code>''<Фильтр столбца ?>''</code> - {{Optional}} Произвольные значения фильтров столбцов. Количество таких аргументов должно совпадать с количеством столбцов-фильтров в предыдущем аргументе. Строка будет участвовать в копировании, если все значения фильтров совпадают с значениями соответствующих столбцов этой строки.

← Older revision	Revision as of 07:04, 7 August 2023
(No difference)

← Older revision	Revision as of 14:18, 16 April 2021
(No difference)

@@ Line 13: / Line 13: @@
 * [[Объекты]]
 * [[Таблица]]}}
-Функция позволяет произвести копирование ячеек указанного столбца из текущей таблицы в заданный список, либо ячеек, указанных столбцов из текущей таблицы в заданную таблицу. Строки для копирования могут быть ограничены определенным диапазоном и выбраны с помощью заданного фильтра.
+Функция позволяет произвести копирование ячеек указанного столбца из текущей таблицы в заданный список, либо ячеек, указанных столбцов из текущей таблицы в заданную таблицу. Строки для копирования могут быть ограничены определенным диапазоном и выбраны с помощью заданного фильтра. Существующие строки в таблице, в которую производится копирование, не изменяются, новые строки добавляются в конец таблицы.
 == Синтаксис ==
@@ Line 22: / Line 22: @@
 ==== Аргументы ====
 * <code>''<Объект в который происходит копирование>''</code> - {{ByRef}} Переменная, содержащая объект типа таблица или список для копирования значений ячеек текущей таблицы. Если переменная содержит объект любого другого вида, ее значение будет очищено и ей будет присвоена новая пустая таблица, в которую будет производиться копирование. Использование аргумента-переменной позволяет получить эту новую таблицу в переменной, как результат. Ниже дана разница при копировании в таблицу и копировании в список:
-** При копировании в таблицу, столбцы для копирования с наименованиями, которые отсутствовали в столбцах таблицы, в которую происходит копирование, будут добавлены в эту таблицу. При копировании строки из таблицы копирования добавляются в конец таблицы, в которую происходит копирование, в каждой из добавленной строк заполняются ячейки со копируемыми столбцами.
+** При копировании в таблицу, столбцы для копирования с наименованиями, которые отсутствовали в столбцах таблицы, в которую происходит копирование, будут добавлены в эту таблицу. При копировании строки из таблицы копирования добавляются в конец таблицы, в которую происходит копирование, в каждой добавленной строке заполняются только ячейки с копируемыми столбцами.
 ** При копировании в список, в него добавляются значения, последовательно из каждого копируемого столбца таблицы для каждой из копируемых строк таблицы.
 * <code>''<Индекс начальной строки (INT)>''</code> - {{Optional}} Индекс начальной строки диапазона копирования. Если аргумент опущен, будет использована первая строка исходной таблицы.

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