Admin: 1 revision imported

2021-11-20T17:07:26Z

1 revision imported

1>Admin: Created page with "{{infobox function |name=AddValue |object=Список |caption=Добавление элемента, если он отсутствовал |type=1 |status=2 |db=0 |exce..."

2021-09-12T07:50:38Z

Created page with "{{infobox function |name=AddValue |object=Список |caption=Добавление элемента, если он отсутствовал |type=1 |status=2 |db=0 |exce..."

New page

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

== Синтаксис ==
<code>
{{Grey|List.}}'''AddValue'''(''<Значение>''{{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}} Если список отсортирован по значениям по неубыванию, функция '''AddValue''' вставляет новое значение таким образом, чтобы не нарушилась сортировка. Режим может использоваться при необходимости последовательного добавления элементов в список, для которого важна сортировка (к примеру, будет использоваться функция [[List.Find|Find]] с флагом сортировки). Как альтернатива, список можно отсортировать перед началом блока с поиском, но в случае, если в одном блоке происходит и добавление элементов и поиск элементов, данный режим будет работать гораздо быстрее, чем последовательные вызовы сортировки перед каждым поиском (см. пример ниже). Возможные значения:
** '''0''' -- Список не был отсортирован, сортировка не будет сохранена.
** '''1''' -- Список был отсортирован, сортировка будет сохранена, если элемент будет добавлен.

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

== Примеры ==
<pre>
//Создаем список из 10 элементов
a:=List.Create(1,2,3,4,5,6,7,8,9,10);
//Функция не добавит элементы в список, будет выведено значение 3 (позиция найденного элемента)
Message(a.AddValue(3,,,1));
//Будет выведено значение 10
Message(a.Size());
//Функция добавит с позицией 6
Message(a.AddValue(5.5,,,1));
//Будет выведено значение 11
Message(a.Size());
</pre>

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

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

List.AddValue - Revision history

Admin: 1 revision imported

1>Admin: Created page with "{{infobox function |name=AddValue |object=Список |caption=Добавление элемента, если он отсутствовал |type=1 |status=2 |db=0 |exce..."