Наборы параметров - История изменений

Aleksandr Dragunkin в 09:50, 20 февраля 2025

2025-02-20T09:50:32Z

← Предыдущая версия		Версия от 12:50, 20 февраля 2025
Строка 99:		Строка 99:
	Формат создаваемого атрибута:		Формат создаваемого атрибута:

			<syntaxhighlight lang="ini" line>
	Scratch-атрибут		Scratch-атрибут
	Группа1;{Число\|Строка} // наименование подстановки с числовыми		Группа1;{Число\|Строка} // наименование подстановки с числовыми
Строка 110:		Строка 111:
	Параметр3=”строка” // простой параметр со значением строка		Параметр3=”строка” // простой параметр со значением строка
	…		…
			</syntaxhighlight>
	===ReadScratch===		===ReadScratch===
	<code>INT '''ReadScratch'''(STRING ''<AttrName>'', VARIANT ''<holder>'')</code>		<code>INT '''ReadScratch'''(STRING ''<AttrName>'', VARIANT ''<holder>'')</code>
Строка 123:		Строка 124:
	===Пример использования функций, указанных выше===		===Пример использования функций, указанных выше===
	[[Файл:Scratch.png\|thumb\|center\|600px\|Scratch-атрибут с набором параметров у объекта]]		[[Файл:Scratch.png\|thumb\|center\|600px\|Scratch-атрибут с набором параметров у объекта]]

	{{macro\|		{{macro\|
			<syntaxhighlight lang="c" line>
	// Инициализируем новый набор параметров.		// Инициализируем новый набор параметров.
	pars=initscratch();		pars=initscratch();
Строка 150:		Строка 153:
	// Завершаем работу с набором параметров		// Завершаем работу с набором параметров
	pars=termscratch(pars);		pars=termscratch(pars);
			</syntaxhighlight>
	}}		}}

Aleksandr Dragunkin в 09:44, 20 февраля 2025

2025-02-20T09:44:26Z

← Предыдущая версия		Версия от 12:44, 20 февраля 2025
Строка 123:		Строка 123:
	===Пример использования функций, указанных выше===		===Пример использования функций, указанных выше===
	[[Файл:Scratch.png\|thumb\|center\|600px\|Scratch-атрибут с набором параметров у объекта]]		[[Файл:Scratch.png\|thumb\|center\|600px\|Scratch-атрибут с набором параметров у объекта]]
			{{macro\|
	// Инициализируем новый набор параметров.		// Инициализируем новый набор параметров.
	pars=initscratch();		pars=initscratch();
Строка 149:		Строка 150:
	// Завершаем работу с набором параметров		// Завершаем работу с набором параметров
	pars=termscratch(pars);		pars=termscratch(pars);
	~~{\| class="prettytable"~~		}}
	\|-
	~~\|valign="top"\|[[image:i.png]]~~		{{Идея\|''Если Вы хотите создать набор параметров и группу, в которой будут параметры числового или строкового типа и параметр(ы) перечисляемого типа, то независимо от нужного порядка создания параметров необходимо сначала добавить в набор подстановку (первый вариант функции ''<code>AddScratch</code>''), затем уже можно добавлять простые параметры в группу.''
	\|''Если Вы хотите создать набор параметров и группу, в которой будут параметры числового или строкового типа и параметр(ы) перечисляемого типа, то независимо от нужного порядка создания параметров необходимо сначала добавить в набор подстановку (первый вариант функции ''<code>AddScratch</code>''), затем уже можно добавлять простые параметры в группу.''		}}
	\|}

	== Вычислить группу набора ==		== Вычислить группу набора ==

Aleksandro: /* WriteScratch */

2024-04-12T14:27:42Z

WriteScratch

← Предыдущая версия		Версия от 17:27, 12 апреля 2024
Строка 89:		Строка 89:

	Функция '''WriteScratch''' создаёт и приписывает текстовый атрибут с именем <code>''<AttrName>''</code> объекту или рабочей записи по содержимому набора параметров с индексом <code>''<Index>''</code>. Параметр <code>''<holder>''</code> может быть одним из следующих типов:		Функция '''WriteScratch''' создаёт и приписывает текстовый атрибут с именем <code>''<AttrName>''</code> объекту или рабочей записи по содержимому набора параметров с индексом <code>''<Index>''</code>. Параметр <code>''<holder>''</code> может быть одним из следующих типов:
	:<code>OBJECT</code> — владелец - указанный объект;		:<code>OBJECT</code> — '''владелец''' — указанный объект;
	:<code>STRING</code> — владелец - блок с именем заданным строкой <samp>holder</samp>;		:<code>STRING</code> — '''владелец''' — блок с именем заданным строкой <samp>holder</samp>;
	:<code>INT</code> — владелец - рабочая запись.		:<code>INT</code> — '''владелец''' — рабочая запись.

	Функция возвращает		Функция возвращает
Строка 115:		Строка 115:

	По текстовому атрибуту с именем <code>''<AttrName>''</code>, созданному по набору параметров, создать набор параметров. Параметр <code>''<holder>''</code> может быть одним из следующих типов:		По текстовому атрибуту с именем <code>''<AttrName>''</code>, созданному по набору параметров, создать набор параметров. Параметр <code>''<holder>''</code> может быть одним из следующих типов:
	:<code>OBJECT</code> — владелец - указанный объект;		:<code>OBJECT</code> — '''владелец''' — указанный объект;
	:<code>STRING</code> — владелец - блок с именем заданным строкой <samp>holder</samp>;		:<code>STRING</code> — '''владелец''' — блок с именем заданным строкой <samp>holder</samp>;
	:<code>INT</code> — владелец - рабочая запись.		:<code>INT</code> — '''владелец''' — рабочая запись.

	Функция возвращает индекс созданного набора или ноль в случае ошибки.		Функция возвращает индекс созданного набора или ноль в случае ошибки.

Aleksandro в 14:26, 12 апреля 2024

2024-04-12T14:26:56Z

← Предыдущая версия		Версия от 17:26, 12 апреля 2024
Строка 89:		Строка 89:

	Функция '''WriteScratch''' создаёт и приписывает текстовый атрибут с именем <code>''<AttrName>''</code> объекту или рабочей записи по содержимому набора параметров с индексом <code>''<Index>''</code>. Параметр <code>''<holder>''</code> может быть одним из следующих типов:		Функция '''WriteScratch''' создаёт и приписывает текстовый атрибут с именем <code>''<AttrName>''</code> объекту или рабочей записи по содержимому набора параметров с индексом <code>''<Index>''</code>. Параметр <code>''<holder>''</code> может быть одним из следующих типов:
			:<code>OBJECT</code> — владелец - указанный объект;
	<code>OBJECT</code> — владелец - указанный объект;		:<code>STRING</code> — владелец - блок с именем заданным строкой <samp>holder</samp>;
			:<code>INT</code> — владелец - рабочая запись.
	<code>STRING</code> — владелец - блок с именем заданным строкой <samp>holder</samp>;

	<code>INT</code> — владелец - рабочая запись.

	Функция возвращает		Функция возвращает
Строка 118:		Строка 115:

	По текстовому атрибуту с именем <code>''<AttrName>''</code>, созданному по набору параметров, создать набор параметров. Параметр <code>''<holder>''</code> может быть одним из следующих типов:		По текстовому атрибуту с именем <code>''<AttrName>''</code>, созданному по набору параметров, создать набор параметров. Параметр <code>''<holder>''</code> может быть одним из следующих типов:
			:<code>OBJECT</code> — владелец - указанный объект;
	<code>OBJECT</code> — владелец - указанный объект;		:<code>STRING</code> — владелец - блок с именем заданным строкой <samp>holder</samp>;
			:<code>INT</code> — владелец - рабочая запись.
	<code>STRING</code> — владелец - блок с именем заданным строкой <samp>holder</samp>;

	<code>INT</code> — владелец - рабочая запись.

	Функция возвращает индекс созданного набора или ноль в случае ошибки.		Функция возвращает индекс созданного набора или ноль в случае ошибки.

Aleksandro в 14:09, 12 апреля 2024

2024-04-12T14:09:03Z

← Предыдущая версия		Версия от 17:09, 12 апреля 2024
Строка 2:		Строка 2:
	{{Макро}}		{{Макро}}
	----		----
	Наборы параметров - '''scratch''' параметры («параметры-зарубки») – совокупность параметров с присвоенными значениями. Данные наборы параметров могут быть присвоены объекту, записаны в файл, прочитаны из файла. Также в процессе работы с набором параметров можно создать переменные '''K3''' и присвоить им значения из набора параметров. Каждый набор параметров может быть разделен на несколько групп.		Наборы параметров — '''scratch''' параметры («параметры-зарубки») – совокупность параметров с присвоенными значениями. Данные наборы параметров могут быть присвоены объекту, записаны в файл, прочитаны из файла. Также в процессе работы с набором параметров можно создать переменные '''K3''' и присвоить им значения из набора параметров. Каждый набор параметров может быть разделен на несколько групп.

	Параметры могут быть следующих типов:		Параметры могут быть следующих типов:
Строка 8:		Строка 8:
	* Числовые		* Числовые
	* Строковые		* Строковые
	* Подстановки (набор значений из списка «строка – значение»). То есть, например, подстановкой может служить содержимое следующего, например, вида:		* Подстановки (набор значений из списка «строка — значение»). То есть, например, подстановкой может служить содержимое следующего, например, вида:
	:* '''11''' — «стойка»		:* '''11''' — «стойка»
	:* '''12''' — «полка»		:* '''12''' — «полка»
Строка 42:		Строка 42:
	Функция '''AddScratch''' добавляет в набор параметров с индексом <code>''<Index>''</code> новую группу параметров – множество перечисляемых значений (подстановку) с именем <code>''<SubstName>''</code>. Логический параметр <code>''<IsNumber>''</code> определяет, параметры какого типа (числовые – 1 или строковые 2) содержатся в подстановке. Функция возвращает		Функция '''AddScratch''' добавляет в набор параметров с индексом <code>''<Index>''</code> новую группу параметров – множество перечисляемых значений (подстановку) с именем <code>''<SubstName>''</code>. Логический параметр <code>''<IsNumber>''</code> определяет, параметры какого типа (числовые – 1 или строковые 2) содержатся в подстановке. Функция возвращает

	:1 — в случае успешного выполнения		:'''1''' — в случае успешного выполнения
	:0 — в случае ошибки		:'''0''' — в случае ошибки

Aleksandro в 14:08, 12 апреля 2024

2024-04-12T14:08:34Z

← Предыдущая версия		Версия от 17:08, 12 апреля 2024
Строка 9:		Строка 9:
	* Строковые		* Строковые
	* Подстановки (набор значений из списка «строка – значение»). То есть, например, подстановкой может служить содержимое следующего, например, вида:		* Подстановки (набор значений из списка «строка – значение»). То есть, например, подстановкой может служить содержимое следующего, например, вида:
	:* 11 – «стойка»		:* '''11''' — «стойка»
	:* 12 – «полка»		:* '''12''' — «полка»
	:* 14 – «стенка»		:* '''14''' — «стенка»

	В этом случае есть список возможных значений параметра (11, 12, 14) и строк им соответствующих («стойка», «полка», «стенка»). Параметр может принимать только одно значение и только из указанного списка. Аналогией может служить перечисляемый тип данных в языках программирования.		В этом случае есть список возможных значений параметра (11, 12, 14) и строк им соответствующих («стойка», «полка», «стенка»). Параметр может принимать только одно значение и только из указанного списка. Аналогией может служить перечисляемый тип данных в языках программирования.
Строка 33:		Строка 33:

	Функция '''TermScratch''' завершает работу с набором параметров с индексом <code>''<Index>''</code> и освобождает занятые ими ресурсы. Функция возвращает		Функция '''TermScratch''' завершает работу с набором параметров с индексом <code>''<Index>''</code> и освобождает занятые ими ресурсы. Функция возвращает
	:1 — в случае успешного завершения работы с набором		:'''1''' — в случае успешного завершения работы с набором
	:0 — в случае ошибки		:'''0''' — в случае ошибки

	== Чтение и запись наборов параметров ==		== Чтение и запись наборов параметров ==
Строка 50:		Строка 50:
	Функция '''AddScratch''' добавляет в группу или в подстановку с индексом <code>''<Index>''</code> и именем <code>''<GroupOrSubstName>''</code> простой параметр: имя параметра (<code>''<ParamName>''</code>) и его значение (<code>''<ParamValue>''</code>). Если указанной группы нет в наборе, то она создаётся. В разных группах имена параметров могут совпадать. Повторное добавление параметра осуществит замену его значения. При добавлении параметра в подстановку тип значения параметра должен соответствовать типу, декларированному при создании подстановки. Функция возвращает		Функция '''AddScratch''' добавляет в группу или в подстановку с индексом <code>''<Index>''</code> и именем <code>''<GroupOrSubstName>''</code> простой параметр: имя параметра (<code>''<ParamName>''</code>) и его значение (<code>''<ParamValue>''</code>). Если указанной группы нет в наборе, то она создаётся. В разных группах имена параметров могут совпадать. Повторное добавление параметра осуществит замену его значения. При добавлении параметра в подстановку тип значения параметра должен соответствовать типу, декларированному при создании подстановки. Функция возвращает

	:1 — в случае успешного выполнения		:'''1''' — в случае успешного выполнения
	:0 — в случае ошибки		:'''0''' — в случае ошибки


Строка 58:		Строка 58:
	Функция '''AddScratch''' добавляет в группу набора с индексом <code>''<Index>''</code> и именем <code>''<GroupName>''</code> параметр перечисляемого типа (подстановку с именем <code>''<SubstName>''</code>) с именем <code>''<ParamName>''</code> и значением <code>''<ParamValue>''</code>. Если указанной группы нет в наборе, то она создаётся. В разных группах имена параметров могут совпадать. Повторное добавление параметра осуществит замену его значения. Значение параметра должно быть одним из значений в указанной подстановке. Функция возвращает		Функция '''AddScratch''' добавляет в группу набора с индексом <code>''<Index>''</code> и именем <code>''<GroupName>''</code> параметр перечисляемого типа (подстановку с именем <code>''<SubstName>''</code>) с именем <code>''<ParamName>''</code> и значением <code>''<ParamValue>''</code>. Если указанной группы нет в наборе, то она создаётся. В разных группах имена параметров могут совпадать. Повторное добавление параметра осуществит замену его значения. Значение параметра должно быть одним из значений в указанной подстановке. Функция возвращает

	:1 — в случае успешного выполнения		:'''1''' — в случае успешного выполнения
	:0 — в случае ошибки		:'''0''' — в случае ошибки

	===GetScratch===		===GetScratch===
Строка 66:		Строка 66:
	Функция '''GetScratch''' позволяет получить значение параметра из набора с индексом <code>''<Index>''</code> и именем <code>''<GroupOrSubstName>''</code>. <code>''<ParamName>''</code> содержит строку с именем параметра. <code>''<ParamValue>''</code> получает значение извлеченного параметра. Если набор является подстановкой, то в <code>''<SubstName>''</code> заносится имя подстановки. Иначе в <code>''<SubstName>''</code> заносится пустая строка. Функция возвращает		Функция '''GetScratch''' позволяет получить значение параметра из набора с индексом <code>''<Index>''</code> и именем <code>''<GroupOrSubstName>''</code>. <code>''<ParamName>''</code> содержит строку с именем параметра. <code>''<ParamValue>''</code> получает значение извлеченного параметра. Если набор является подстановкой, то в <code>''<SubstName>''</code> заносится имя подстановки. Иначе в <code>''<SubstName>''</code> заносится пустая строка. Функция возвращает

	:1 — в случае успешного выполнения		:'''1''' — в случае успешного выполнения
	:0 — в случае ошибки		:'''0''' — в случае ошибки

	===DelScratch===		===DelScratch===
Строка 74:		Строка 74:
	Функция '''DelScratch''' удаляет группу или подстановку с именем <code><''GroupOrSubstName>''</code> из набора с индексом <code>''<Index>''</code>. Нельзя удалять подстановку, если на нее ссылается хотя бы один параметр в этом наборе. Функция возвращает		Функция '''DelScratch''' удаляет группу или подстановку с именем <code><''GroupOrSubstName>''</code> из набора с индексом <code>''<Index>''</code>. Нельзя удалять подстановку, если на нее ссылается хотя бы один параметр в этом наборе. Функция возвращает

	:1 — в случае успешного выполнения		:'''1''' — в случае успешного выполнения
	:0 — в случае ошибки		:'''0''' — в случае ошибки


Строка 82:		Строка 82:
	Функция '''DelScratch''' удаляет параметр с именем <code>''<ParamName>''</code> из группы или подстановки с именем <code>''<GroupOrSubstName>''</code> набора с номером <code>''<Index>''</code>. Функция возвращает		Функция '''DelScratch''' удаляет параметр с именем <code>''<ParamName>''</code> из группы или подстановки с именем <code>''<GroupOrSubstName>''</code> набора с номером <code>''<Index>''</code>. Функция возвращает

	:1 — в случае успешного выполнения		:'''1''' — в случае успешного выполнения
	:0 — в случае ошибки		:'''0''' — в случае ошибки

	===WriteScratch===		===WriteScratch===
Строка 97:		Строка 97:

	Функция возвращает		Функция возвращает
	:1 — в случае успешного выполнения		:'''1''' — в случае успешного выполнения
	:0 — в случае ошибки		:'''0''' — в случае ошибки

	Формат создаваемого атрибута:		Формат создаваемого атрибута:
Строка 169:		Строка 169:
	Результат работы команды можно поместить в переменную. Команда возвращает		Результат работы команды можно поместить в переменную. Команда возвращает

	:1 — в случае успешного завершения;		:'''1''' — в случае успешного завершения;
	:0 — в случае ошибки.		:'''0''' — в случае ошибки.

	Пример:		Пример:
Строка 214:		Строка 214:
	Функция '''ScrtchToFile''' сохраняет набор с номером <code>''<Index>''</code> в файл с именем <code>''<FileName>''</code>. У имени файла нет умолчания на расширение. Функция возвращает		Функция '''ScrtchToFile''' сохраняет набор с номером <code>''<Index>''</code> в файл с именем <code>''<FileName>''</code>. У имени файла нет умолчания на расширение. Функция возвращает

	:1 — в случае успешного выполнения		:'''1''' — в случае успешного выполнения
	:0 — в случае ошибки		:'''0''' — в случае ошибки

Aleksandro в 13:47, 1 сентября 2021

2021-09-01T13:47:52Z

← Предыдущая версия		Версия от 16:47, 1 сентября 2021
Строка 1:		Строка 1:
	[[Категория:Макро]]		[[Категория:Макро]]
			{{Макро}}
			----
	Наборы параметров - '''scratch''' параметры («параметры-зарубки») – совокупность параметров с присвоенными значениями. Данные наборы параметров могут быть присвоены объекту, записаны в файл, прочитаны из файла. Также в процессе работы с набором параметров можно создать переменные '''K3''' и присвоить им значения из набора параметров. Каждый набор параметров может быть разделен на несколько групп.		Наборы параметров - '''scratch''' параметры («параметры-зарубки») – совокупность параметров с присвоенными значениями. Данные наборы параметров могут быть присвоены объекту, записаны в файл, прочитаны из файла. Также в процессе работы с набором параметров можно создать переменные '''K3''' и присвоить им значения из набора параметров. Каждый набор параметров может быть разделен на несколько групп.

Строка 219:		Строка 221:

	Функция '''FileToScrtch''' восстанавливает набор из файла с именем <code>''<FileName>''</code>, предварительно созданного функцией '''ScrtchToFile'''. Функция возвращает номер созданного набора в случае успешного выполнения и ноль ('''0''') в случае ошибки.		Функция '''FileToScrtch''' восстанавливает набор из файла с именем <code>''<FileName>''</code>, предварительно созданного функцией '''ScrtchToFile'''. Функция возвращает номер созданного набора в случае успешного выполнения и ноль ('''0''') в случае ошибки.
			----
			{{Макро}}

Aleksandro: Новая страница: «Категория:Макро Наборы параметров - '''scratch''' параметры («параметры-зарубки») – совокуп...»

2021-07-29T17:53:32Z

Новая страница: «Категория:Макро Наборы параметров - '''scratch''' параметры («параметры-зарубки») – совокуп...»

Новая страница

[[Категория:Макро]]
Наборы параметров - '''scratch''' параметры («параметры-зарубки») – совокупность параметров с присвоенными значениями. Данные наборы параметров могут быть присвоены объекту, записаны в файл, прочитаны из файла. Также в процессе работы с набором параметров можно создать переменные '''K3''' и присвоить им значения из набора параметров. Каждый набор параметров может быть разделен на несколько групп.

Параметры могут быть следующих типов:

* Числовые
* Строковые
* Подстановки (набор значений из списка «строка – значение»). То есть, например, подстановкой может служить содержимое следующего, например, вида:
:* 11 – «стойка»
:* 12 – «полка»
:* 14 – «стенка»

В этом случае есть список возможных значений параметра (11, 12, 14) и строк им соответствующих («стойка», «полка», «стенка»). Параметр может принимать только одно значение и только из указанного списка. Аналогией может служить перечисляемый тип данных в языках программирования.

При работе с наборами параметров необходимо придерживаться следующих правил.

* Имя переменной должно быть строкой из букв, цифр и знаков '''$''' и '''_''' длиной до 12 символов, и не должно начинаться с цифры.

* Имя подстановки и имя группы может быть строкой из любых символов кроме ''';''' ''',''' '''“''' и '''='''. Длина имени подстановки и имени группы не должна превышать 32 символов.

Наборы параметров являются достаточно мощным инструментом при работе со сложными параметрическими моделями, одни параметры которых определяются другими параметрами.

== Инициализация набора параметров и завершение работы с набором параметров ==

<code>INT '''InitScratch'''()</code>

Функция '''InitScratch''' инициирует новый набор параметров. Функция возвращает индекс созданного набора или ноль в случае ошибки.

<code>LOGICAL '''TermScratch'''(INT ''<Index>'')</code>

Функция '''TermScratch''' завершает работу с набором параметров с индексом <code>''<Index>''</code> и освобождает занятые ими ресурсы. Функция возвращает
:1 — в случае успешного завершения работы с набором
:0 — в случае ошибки

== Чтение и запись наборов параметров ==
===AddScratch===
<code>LOGICAL '''AddScratch'''(INT ''<Index>'', STRING ''<SubstName>'', LOGICAL ''<IsNumber>'');</code>

Функция '''AddScratch''' добавляет в набор параметров с индексом <code>''<Index>''</code> новую группу параметров – множество перечисляемых значений (подстановку) с именем <code>''<SubstName>''</code>. Логический параметр <code>''<IsNumber>''</code> определяет, параметры какого типа (числовые – 1 или строковые 2) содержатся в подстановке. Функция возвращает

:1 — в случае успешного выполнения
:0 — в случае ошибки

<code>LOGICAL '''AddScratch'''(INT ''<Index>'', STRING ''<GroupOrSubstName>'', STRING ''<ParamName>'', VARIANT ''<ParamValue>'')</code>

Функция '''AddScratch''' добавляет в группу или в подстановку с индексом <code>''<Index>''</code> и именем <code>''<GroupOrSubstName>''</code> простой параметр: имя параметра (<code>''<ParamName>''</code>) и его значение (<code>''<ParamValue>''</code>). Если указанной группы нет в наборе, то она создаётся. В разных группах имена параметров могут совпадать. Повторное добавление параметра осуществит замену его значения. При добавлении параметра в подстановку тип значения параметра должен соответствовать типу, декларированному при создании подстановки. Функция возвращает

:1 — в случае успешного выполнения
:0 — в случае ошибки

<code>LOGICAL '''AddScratch'''(INT ''<Index>'', STRING ''<GroupName>'', STRING ''<ParamName>'', VARIANT ''<ParamValue>'', STRING ''<SubstName>'')</code>

Функция '''AddScratch''' добавляет в группу набора с индексом <code>''<Index>''</code> и именем <code>''<GroupName>''</code> параметр перечисляемого типа (подстановку с именем <code>''<SubstName>''</code>) с именем <code>''<ParamName>''</code> и значением <code>''<ParamValue>''</code>. Если указанной группы нет в наборе, то она создаётся. В разных группах имена параметров могут совпадать. Повторное добавление параметра осуществит замену его значения. Значение параметра должно быть одним из значений в указанной подстановке. Функция возвращает

:1 — в случае успешного выполнения
:0 — в случае ошибки

===GetScratch===
<code>LOGICAL '''GetScratch'''(INT ''<Index>'', STRING ''<GroupOrSubstName>'', STRING ''<ParamName>'', VARNAME ''<ParamValue>'', STRING ''<SubstName>'')</code>

Функция '''GetScratch''' позволяет получить значение параметра из набора с индексом <code>''<Index>''</code> и именем <code>''<GroupOrSubstName>''</code>. <code>''<ParamName>''</code> содержит строку с именем параметра. <code>''<ParamValue>''</code> получает значение извлеченного параметра. Если набор является подстановкой, то в <code>''<SubstName>''</code> заносится имя подстановки. Иначе в <code>''<SubstName>''</code> заносится пустая строка. Функция возвращает

:1 — в случае успешного выполнения
:0 — в случае ошибки

===DelScratch===
<code>LOGICAL '''DelScratch'''(INT ''<Index>'', STRING ''<GroupOrSubstName>'')</code>

Функция '''DelScratch''' удаляет группу или подстановку с именем <code><''GroupOrSubstName>''</code> из набора с индексом <code>''<Index>''</code>. Нельзя удалять подстановку, если на нее ссылается хотя бы один параметр в этом наборе. Функция возвращает

:1 — в случае успешного выполнения
:0 — в случае ошибки

<code>LOGICAL '''DelScratch'''(INT ''<Index>'', STRING ''<GroupOrSubstName>'', STRING ''<ParamName>'')</code>

Функция '''DelScratch''' удаляет параметр с именем <code>''<ParamName>''</code> из группы или подстановки с именем <code>''<GroupOrSubstName>''</code> набора с номером <code>''<Index>''</code>. Функция возвращает

:1 — в случае успешного выполнения
:0 — в случае ошибки

===WriteScratch===
<code>LOGICAL '''WriteScratch'''(INT ''<Index>'', STRING ''<AttrName>'', VARIANT ''<holder>'')</code>

Функция '''WriteScratch''' создаёт и приписывает текстовый атрибут с именем <code>''<AttrName>''</code> объекту или рабочей записи по содержимому набора параметров с индексом <code>''<Index>''</code>. Параметр <code>''<holder>''</code> может быть одним из следующих типов:

<code>OBJECT</code> — владелец - указанный объект;

<code>STRING</code> — владелец - блок с именем заданным строкой <samp>holder</samp>;

<code>INT</code> — владелец - рабочая запись.

Функция возвращает
:1 — в случае успешного выполнения
:0 — в случае ошибки

Формат создаваемого атрибута:

Scratch-атрибут
Группа1;{Число|Строка} // наименование подстановки с числовыми
// или строковыми значениями
Параметр1=Значение
Параметр2=Значение
…
ГруппаN // наименование обычной группы параметров (не подстановки)
Параметр1=Значение;Подстановка // перечисляемый параметр
Параметр2=Значение // простой параметр
Параметр3=”строка” // простой параметр со значением строка
…

===ReadScratch===
<code>INT '''ReadScratch'''(STRING ''<AttrName>'', VARIANT ''<holder>'')</code>

По текстовому атрибуту с именем <code>''<AttrName>''</code>, созданному по набору параметров, создать набор параметров. Параметр <code>''<holder>''</code> может быть одним из следующих типов:

<code>OBJECT</code> — владелец - указанный объект;

<code>STRING</code> — владелец - блок с именем заданным строкой <samp>holder</samp>;

<code>INT</code> — владелец - рабочая запись.

Функция возвращает индекс созданного набора или ноль в случае ошибки.

===Пример использования функций, указанных выше===
[[Файл:Scratch.png|thumb|center|600px|Scratch-атрибут с набором параметров у объекта]]
// Инициализируем новый набор параметров.
pars=initscratch();
// Создаем шаблон текстового атрибута c именем "atrname".
attribute create "atrname" "Пользовательские параметры" text 10 20;
// Добавляем в набор параметров подстановку
// с именем "Панели" числового типа.
NULLOUT=addscratch(pars,"Панели",1);
// Добавляем в созданную подстановку с именем "Панели" параметры
// "Полка", "Стойка", "Стенка" со значениями
// 12, 11, 14 соответственно.
NULLOUT=AddScratch(pars,"Панели","Полка",12);
NULLOUT=AddScratch(pars,"Панели","Стойка",11);
NULLOUT=AddScratch(pars,"Панели","Стенка",14);
// Добавляем в созданный набор параметров с индексом pars
// в группу с именем "Группа панелей" параметр
// перечисляемого типа (подстановку)
// с именем "Виды", значением 12 (одно из
// значений в подстановке) и именем самой подстановки Панели.
// Результатом произведённых операций будет создание
// у указанного объекта scratch-атрибута с именем "atrname".
NULLOUT=addscratch(pars,"Группа панелей","Виды",12,"Панели");
// Записываем набор параметров в атрибут
objident : obj;
NULLOUT=WriteScratch(pars,"atrname",obj);
// Завершаем работу с набором параметров
pars=termscratch(pars);
{| class="prettytable"
|-
|valign="top"|[[image:i.png]]
|''Если Вы хотите создать набор параметров и группу, в которой будут параметры числового или строкового типа и параметр(ы) перечисляемого типа, то независимо от нужного порядка создания параметров необходимо сначала добавить в набор подстановку (первый вариант функции ''<code>AddScratch</code>''), затем уже можно добавлять простые параметры в группу.''
|}

== Вычислить группу набора ==

<code>'''calcvarscr''' ''<Index> <GroupName>''</code>

Команда '''calcvarscr''' вычисляет группу набора параметров с индексом <code>''<Index>''</code> и именем <code>''<GroupName>''</code> — создает переменные, одноименные с параметрами и присваивает им значения из набора.

Результат работы команды можно поместить в переменную. Команда возвращает

:1 — в случае успешного завершения;
:0 — в случае ошибки.

Пример:
<nowiki>#res calcvarscr 1 "Fasad";</nowiki>
<nowiki>=res;</nowiki>
<font color="008800">1</font>

== Получение количества и содержимого набора параметров ==

<code>INT '''CntSubstScr'''(INT <''Index>'')</code>

Функция '''CntSubstScr''' возвращает количество подстановок в наборе параметров с номером <code>''<Index>''</code>. В случае ошибки возвращает '''-1'''.

<code>INT '''NameSubstScr'''(INT ''<Index>'', STRING ARRAY ''<Names>'')</code>

Функция '''NameSubstScr''' заполняет массив <code>''<Names>''</code> именами подстановок набора параметров с номером <code>''<Index>''</code>. Функция возвращает количество заполненных элементов массива

<code>INT '''CntGroupScr'''(INT ''<Index>'')</code>

Функция '''CntGroupScr''' возвращает количество групп в наборе параметров с номером <code>''<Index>''</code>. В случае ошибки функция возвращает '''-1'''.

<code>INT '''NameGroupScr'''(INT ''<Index>'', sttring ARRAY ''<Names>'')</code>

Функция '''NameGroupScr''' заполняет массив <code>''<Names>''</code> именами групп набора параметров с номером <code>''<Index>''</code>. Функция возвращает количество заполненных элементов массива.

<code>INT '''CntVarScr'''(INT ''<Index>'', STRING ''<GroupOrSubstName>'')</code>

Функция '''CntVarScr''' возвращает количество параметров в группе набора или подстановке с номером <code>''<Index>''</code> и именем <code>''<GroupOrSubstName>''</code>. В случае ошибки функция возвращает '''-1'''.

<code>INT '''NameVarScr'''(INT ''<Index>'', STRING ''<GroupOrSubstName>'', string ARRAY ''<Names>'')</code>

Функция '''NameVarScr''' заполняет массив <code>''<Names>''</code> именами параметров в группе набора или подстановке с номером <code>''<Index>''</code> и именем <code>''<GroupOrSubstName>''</code>. Функция возвращает количество заполненных элементов массива.

== Запись и чтение наборов параметров из файла ==

<code>LOGICAL '''ScrtchToFile'''(INT ''<Index>'', STRING ''<FileName>'')</code>

Функция '''ScrtchToFile''' сохраняет набор с номером <code>''<Index>''</code> в файл с именем <code>''<FileName>''</code>. У имени файла нет умолчания на расширение. Функция возвращает

:1 — в случае успешного выполнения
:0 — в случае ошибки

<code>INT '''FileToScrtch'''(STRING ''<FileName>'')</code>

Функция '''FileToScrtch''' восстанавливает набор из файла с именем <code>''<FileName>''</code>, предварительно созданного функцией '''ScrtchToFile'''. Функция возвращает номер созданного набора в случае успешного выполнения и ноль ('''0''') в случае ошибки.