List.SetByName - Revision history

Admin: 1 revision imported

2021-11-20T17:07:28Z

1 revision imported

1>Admin at 14:02, 30 July 2021

2021-07-30T14:02:57Z

Admin: 1 revision imported

2021-02-07T06:51:44Z

1 revision imported

Admin at 14:33, 28 July 2019

2019-07-28T14:33:24Z

New page

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

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

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

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

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

@@ Line 22: / Line 22: @@
 * <code>''<Строковое представление (STRING)>''</code> - Строковое представление изменяемого значения. Если в списке отсутствует значение с указанным представлением, оно будет добавлено. При наличии сортировки по строковым значениям, добавление происходит без нарушение сортировки.
 * <code>''<Значение>''</code> - Значение, на которое будет происходить изменение
-* <code>''<Сортировка (INT)>''{{Default|{{eq}}0}}</code> - {{optional}} Возможные значения -- 1 или 0. Если список отсортирован по строковым представлениям по неубыванию, функция производит поиск по сортированным значениям (ускорение). Если в списке отсутствует значение с указанным представлением, добавление происходит без нарушение сортировки. Сортировка по наименованию больших списков при использовании индексирования по именам рекомендуется, так как такой подход может сильно ускорить работу с такими списками (см. ниже для примера).
+* <code>''<Сортировка (INT)>''{{Default|{{eq}}0}}</code> - {{optional}} Если список отсортирован по строковым представлениям по неубыванию, функция производит поиск по сортированным значениям (ускорение). Если в списке отсутствует значение с указанным представлением, добавление происходит без нарушение сортировки. Сортировка по наименованию больших списков при использовании индексирования по именам рекомендуется, так как такой подход может сильно ускорить работу с такими списками (см. ниже для примера). Возможные значения:
 * <code>''<Без учета регистра (INT)>{{Default|{{eq}}0}}''</code> - {{optional}} Возможные значения: 0 -- при поиске будет учитываться регистр, 1 (по умолчанию) -- при поиске не будет учитываться регистр (замедление). '''Внимание:''' в больших массивах функция без учета регистра (программа приводит строковые представления к верхнему регистру при каждом сравнении) значение параметра по умолчанию будет значительно замедлять выполнение функции.

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