List.Add - Revision history

Admin: 1 revision imported

2021-11-20T17:07:26Z

1 revision imported

1>Admin at 07:40, 12 September 2021

2021-09-12T07:40:36Z

Admin: 1 revision imported

2021-02-07T06:51:40Z

1 revision imported

Admin: /* Примеры */

2019-07-22T11:27:01Z

‎Примеры

New page

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

== Синтаксис ==
<code>
{{Grey|List.}}'''Add'''(''<Значение>''{{Optional|,<Строковое представление (STRING)>,<Индекс иконки (INT)>,<Сортировка (INT)>{{OptionalDefault|{{eq}}0}}}}):''<Позиция добавленного значения (INT)>''
</code>
==== Аргументы ====
* <code>''<Значение>''</code> - Добавляемое значение
* <code>''<Строковое представление (STRING)>''</code> - {{optional}} Строковое представление добавляемого значения
* <code>''<Индекс иконки (INT)>''</code> - {{optional}} Индекс иконки добавляемого значения
* <code>''<Сортировка (INT)>''{{Default|{{eq}}0}}</code> - {{optional}} Возможные значения -- 1 или 0. Если список отсортирован по значениям по неубыванию, функция '''Add''' вставляет новое значение таким образом, чтобы не нарушилась сортировка. Режим может использоваться при необходимости последовательного добавления элементов в список, для которого важна сортировка (к примеру, будет использоваться функция [[List.Find|Find]] с флагом сортировки. Как альтернатива, список можно отсортировать перед началом блока с поиском, но в случае, если в одном блоке происходит и добавление элементов и поиск элементов, данный режим будет работать гораздо быстрее, чем последовательные вызовы сортировки перед каждым поиском (см. пример ниже).
==== Возвращаемое значение ====
В режиме, когда аргумент ''Сортировка'' равен 1, функция возвращает индекс (позицию) добавленного значения. В обычном режиме функция возвращает пустое значение.

== Примеры ==
<pre>
a:=List.Create();			//Список пуст
a.Add(123);				//Список содержит значение 123
a.Add(234,"Второй");			//Список содержит значения 123 и 234, у второго элемента есть строковое представление "Второй"
</pre>

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

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

@@ Line 23: / Line 23: @@
 * <code>''<Строковое представление (STRING)>''</code> - {{optional}} Строковое представление добавляемого значения
 * <code>''<Индекс иконки (INT)>''</code> - {{optional}} Индекс иконки добавляемого значения
-* <code>''<Сортировка (INT)>''{{Default|{{eq}}0}}</code> - {{optional}} Возможные значения -- 1 или 0. Если список отсортирован по значениям по неубыванию, функция '''Add''' вставляет новое значение таким образом, чтобы не нарушилась сортировка. Режим может использоваться при необходимости последовательного добавления элементов в список, для которого важна сортировка (к примеру, будет использоваться функция [[List.Find|Find]] с флагом сортировки. Как альтернатива, список можно отсортировать перед началом блока с поиском, но в случае, если в одном блоке происходит и добавление элементов и поиск элементов, данный режим будет работать гораздо быстрее, чем последовательные вызовы сортировки перед каждым поиском (см. пример ниже).
+* <code>''<Сортировка (INT)>''{{Default|{{eq}}0}}</code> - {{optional}} Если список отсортирован по значениям по неубыванию, функция '''Add''' вставляет новое значение таким образом, чтобы не нарушилась сортировка. Режим может использоваться при необходимости последовательного добавления элементов в список, для которого важна сортировка (к примеру, будет использоваться функция [[List.Find|Find]] с флагом сортировки). Как альтернатива, список можно отсортировать перед началом блока с поиском, но в случае, если в одном блоке происходит и добавление элементов и поиск элементов, данный режим будет работать гораздо быстрее, чем последовательные вызовы сортировки перед каждым поиском (см. пример ниже). Возможные значения:
 ==== Возвращаемое значение ====
-В режиме, когда аргумент ''Сортировка'' равен 1, функция возвращает индекс (позицию) добавленного значения. В обычном режиме функция возвращает пустое значение.
+Функция возвращает индекс (позицию) добавленного значения.
 == Примеры ==

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