Difference between revisions of "Tab.CopyLine"

From SunFlurry wiki
Jump to: navigation, search
 
m (1 revision imported)
 
(2 intermediate revisions by 2 users not shown)
Line 17: Line 17:
 
== Синтаксис ==
 
== Синтаксис ==
 
<code>
 
<code>
{{Grey|Tab.}}'''CopyLine'''({{Optional|<Индекс копируемой строки (INT)>,<Индекс новой строки (INT)>}})
+
{{Grey|Tab.}}'''CopyLine'''({{Optional|<Индекс копируемой строки (INT)>,<Индекс новой строки (INT)>,<Количество добавляемых строк (INT)>{{Default|{{Eq}}1}}}})
 
</code>
 
</code>
 
==== Аргументы ====
 
==== Аргументы ====
 
* <code>''<Индекс копируемой строки (INT)>''</code> - {{Optional}} Числовой индекс строки, копия которой добавляется в таблицу. Первая строка имеет индекс 1. Если аргумент опущен, будет использована строка с индексом [[Tab.CurLine|CurLine]] (текущая).
 
* <code>''<Индекс копируемой строки (INT)>''</code> - {{Optional}} Числовой индекс строки, копия которой добавляется в таблицу. Первая строка имеет индекс 1. Если аргумент опущен, будет использована строка с индексом [[Tab.CurLine|CurLine]] (текущая).
 
* <code>''<Индекс новой строки (INT)>''</code> - {{Optional}} Числовой индекс добавляемой строки, в которую будут скопированы все значения из указанной в первом аргументе строки. Если аргумент опущен, строка будет добавлена в конец таблицы.
 
* <code>''<Индекс новой строки (INT)>''</code> - {{Optional}} Числовой индекс добавляемой строки, в которую будут скопированы все значения из указанной в первом аргументе строки. Если аргумент опущен, строка будет добавлена в конец таблицы.
 +
* <code>''<Количество добавляемых строк (INT)>''</code> - {{Optional}} Количество копий указанной в первом аргументе строки, которое будет добавлено (по умолчанию добавляется одна строка).
  
 
== Примеры ==
 
== Примеры ==

Latest revision as of 11:33, 25 April 2023

  CopyLine (Работа со строками)
Объект:Таблица
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Нет
Исключения:Невозможно превратить в число, неверные индексы строк
Визуальность:Нет

Функция добавляет новую строку по указанному во втором аргументе индексу (или в конец таблицы, если второй аргумент опущен) и заполняет ее значениями из строки, указанной в первом аргументе (или текущей строки, если первый аргумент опущен). Добавленная строка становится текущей.

Синтаксис

Tab.CopyLine(<Индекс копируемой строки (INT)>,<Индекс новой строки (INT)>,<Количество добавляемых строк (INT)>=1)

Аргументы

  • <Индекс копируемой строки (INT)> - (необязательный аргумент) Числовой индекс строки, копия которой добавляется в таблицу. Первая строка имеет индекс 1. Если аргумент опущен, будет использована строка с индексом CurLine (текущая).
  • <Индекс новой строки (INT)> - (необязательный аргумент) Числовой индекс добавляемой строки, в которую будут скопированы все значения из указанной в первом аргументе строки. Если аргумент опущен, строка будет добавлена в конец таблицы.
  • <Количество добавляемых строк (INT)> - (необязательный аргумент) Количество копий указанной в первом аргументе строки, которое будет добавлено (по умолчанию добавляется одна строка).

Примеры

//Создается и заполняется таблица значений
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.CopyLine(2,4);
//Вставляем строку с индексом 4 и заполняем ее значениями строки с индексом 2.

Message(aTab.Size());
//Выводит число 7

Message(aTab.Get(4,"b1"));
//Выводит число 2