Формат файлов XML для ограничений

Для более точного анализа Polyspace^® можно задать ограничения на глобальные переменные, входные параметры функции и заблокированные функции. Можно задать ограничения в пользовательском интерфейсе десктопных решений Polyspace или в командной строке как XML-файл. Для общего рабочего процесса смотрите, Задают Внешние Ограничения.

Эта тема описывает детали ограничительной схемы XML-файла. Вы обычно запрашиваете эту информацию, только если вы создаете ограничение XML с нуля. Если при запуске верификацию однажды, программное обеспечение автоматически генерирует ограничительный файл шаблона drs-template.xml в вашей папке результатов. Вместо того, чтобы создать ограничительный XML-файл с нуля, легче отредактировать этот XML-файл шаблона, чтобы задать ваши ограничения. Для некоторых примеров см.:

Для другого объяснения какой среднее значение XML-тэгов, смотрите Внешние Ограничения для Анализа Polyspace.

Можно также видеть информацию в этой теме и базовую XML-схему в polyspaceroot\polyspace\drs. Здесь, polyspaceroot является папкой установки Polyspace, например, C:\Program Files\Polyspace\R2019a.

Описание синтаксиса — элементы XML

Ограничительный файл содержит следующие элементы XML:

Элемент <global> — Объявляет глобальную область видимости и является корневым элементом XML-файла.
Элемент <file> — Объявляет осциллограф файла. Должен быть заключен в элемент <global>. Может заключить любое объявление переменной или объявление функции. Статические переменные должны быть заключены в элемент файла, чтобы избежать конфликтов.
Элемент <scalar> — Объявляет целое число или переменную с плавающей точкой. Может быть заключен в любой распознанный элемент, но не может заключить элемент. Наборы init/permanent/global утверждают на переменных.
Элемент <pointer> — Объявляет переменную указателя. Может заключить любые другие объявления переменной (включая себя), чтобы задать резкие объекты. Задает то, какое значение записано в указатель (NULL или не), сколько объектов выделяется и как резкие объекты инициализируются.
Элемент <array> — Объявляет переменную типа массив. Может заключить любое другое определение переменной (включая себя), чтобы задать членов массива.
Элемент <struct> — Объявляет переменную структуры или объект (экземпляр класса). Может заключить любое другое определение переменной (включая себя), чтобы задать поля структуры.
Элемент <function> — Объявляет осциллограф функционального или метода класса. Может заключить любое определение переменной, чтобы задать аргументы и возвращаемое значение функции. Аргументы нужно назвать arg1, arg2, …argn, и возвращаемое значение должно быть названо return.

Следующие примечания применяются к определенным полям в каждом элементе XML:

(*) — Поля, используемые только графический интерфейсом пользователя. Эти поля не обязательны для верификации, чтобы принять области значений. Полевая строка содержит номер строки, где переменная объявляется в исходном коде, complete_type содержит строку с полным типом переменной, и base_type используется графический интерфейсом пользователя, чтобы вычислить min и макс. значения. Полевой комментарий используется, чтобы добавить информацию о любом узле.
(**) — имя поля обязательно для элементов осциллографа <file> and <function> (за исключением указателей функции). Для других элементов имя должно быть задано при объявлении корневого символа или поля struct.
(***) — Если больше чем один атрибут применяется к переменной, атрибуты должны быть разделены пробелом. Только статический атрибут обязателен, чтобы избежать конфликтов между статическими переменными, имеющими то же имя. Атрибут может быть задан многократно без влияния.
(****) — Этот элемент используется только графический интерфейсом пользователя, чтобы определить, какие режимы init позволены для текущего элемента (согласно его типу). Значение работает маской, где следующие значения добавляются, чтобы задать, какие режимы позволены:
- 1: режим “NO” позволен.
- 2: режим “INIT” позволен.
- 4: режим “PERMANENT” позволен.
- 8: режим “MAIN_GENERATOR” позволен.
Например, значение “10” означает, что режимы “INIT” и “MAIN_GENERATOR” позволены. Чтобы видеть, как это значение вычисляется, обратитесь к Допустимым Режимам и Значениям по умолчанию.
(*****) — Указатель подэлемента массива (т.е. резкий объект) будет учтен, только если init_pointed равен ОДНОМУ, MULTI, SINGLE_CERTAIN_WRITE или MULTI_CERTAIN_WRITE.
(******) — SINGLE_CERTAIN_WRITE или MULTI_CERTAIN_WRITE доступны для параметров и возвращаемых значений заблокированных функций, только если они - указатели. Если значение параметров или возвращаемое значение являются структурой, и структура имеет поле указателя, они также доступны для поля указателя.

Элемент `<file>`

Поле	Синтаксис
`name`	`filepath_or_filename`
`comment`	`string`

Элемент `<scalar>`

Поле	Синтаксис
`имя`	`name`
`строка`	`line`
`base_type` *()**	`intx uintx floatx`
`Атрибуты`	`энергозависимый экстерн статичный const`
`complete_type` *()**	`type`
`init_mode`	`MAIN_GENERATOR ПРОИГНОРИРОВАТЬ INIT ПОСТОЯННЫЙ отключенный неподдерживаемый`
`init_modes_allowed` *()**	`single value` ()
`init_range`	`range` `отключенный неподдерживаемый`
`global_ assert`	`ДА НЕТ отключенный неподдерживаемый`
`assert_range`	`range` `отключенный неподдерживаемый`
`comment` *()**	`string`

Элемент `<pointer>`

Поле	Синтаксис
`Имя`	`name`
`строка`	`line`
`Атрибуты`	`энергозависимый экстерн статичный const`
`complete_type` *()**	`type`
`init_mode`	`MAIN_GENERATOR ПРОИГНОРИРОВАТЬ INIT ПОСТОЯННЫЙ отключенный неподдерживаемый`
`init_modes_allowed` *()**	`single value` ()
`initialize_ pointer`	Может быть: `Пустой указатель Не ПУСТОЙ Пустой указатель`
`number_ allocated`	`single value` `отключенный неподдерживаемый`
`init_pointed` (**)	`MAIN_GENERATOR` `NONE` `SINGLE` `MULTI` `SINGLE_CERTAIN_WRITE` `MULTI_CERTAIN_WRITE` `disabled`
`comment`	`string`

`<array>` and `<struct>` Элементы

Поле	Синтаксис
`Имя`	`name`
`строка`	`line`
`complete_type` *()**	`type`
`атрибуты`	`энергозависимый экстерн статичный const`
`comment`	`string`

Элемент `<function>`

Поле	Синтаксис
`Имя`	`name`
`строка`	`line`
`main_generator_called`	`MAIN_GENERATOR ДА НЕТ отключенный`
`атрибуты`	`статичный экстерн неиспользованный`
`comment`	`string`

Допустимые режимы и значения по умолчанию

Осциллограф	Ввод		Режимы Init	Режим Gassert	Инициализируйте указатель	Init выделяется	Значение по умолчанию
Глобальные переменные	Базовый тип	Дисквалифицированный / статический / const скаляр	MAIN_ ГЕНЕРАТОР ПРОИГНОРИРОВАТЬ INIT ПОСТОЯННЫЙ	ДА НЕТ			Основной иждивенец генератора
		Энергозависимый скаляр	ПОСТОЯННЫЙ	отключенный			Min PERMANENT макс.
		Скаляр экстерна	ПОСТОЯННЫЙ INIT	ДА НЕТ			Min INIT макс.
	Struct ()	Поле Struct	Обратитесь к типу поля
	Массив	Элемент массива	Обратитесь к типу элемента
Глобальные переменные	Указатель	Дисквалифицированный / статический / const скаляр	MAIN_ ГЕНЕРАТОР ПРОИГНОРИРОВАТЬ INIT		Может быть NULL Не ПУСТОЙ Пустой указатель	'none' Единственный МНОГО	Основной иждивенец генератора
		Энергозависимый указатель	не- поддерживаемый		не- поддерживаемый	не- поддерживаемый
		Указатель экстерна	ПРОИГНОРИРОВАТЬ INIT		Может быть NULL Не ПУСТОЙ Пустой указатель	'none' Единственный МНОГО	INIT Может быть NULL макс. МНОГО
		Резкий энергозависимый скаляр	не- поддерживаемый	не- поддерживаемый
		Резкий скаляр экстерна	INIT	не- поддерживаемый			INIT min..
		Указанные другие скаляры	MAIN_ ГЕНЕРАТОР INIT	не- поддерживаемый			MAIN_ ГЕНЕРАТОР иждивенец
		Резкий указатель	MAIN_ ГЕНЕРАТОР INIT/	не- поддерживаемый	Может быть NULL Не ПУСТОЙ Пустой указатель	'none' Единственный МНОГО	MAIN_ ГЕНЕРАТОР иждивенец
		Резкая функция	не- поддерживаемый	не- поддерживаемый
Параметры функции	Функция Userdef	Скалярные параметры	MAIN_ ГЕНЕРАТОР INIT	не- поддерживаемый			INIT min..
		Параметры указателя	MAIN_ ГЕНЕРАТОР INIT	не- поддерживаемый	Может быть NULL Не ПУСТОЙ Пустой указатель	'none' Единственный МНОГО	INIT Может быть NULL макс. МНОГО
		Другие параметры	Обратитесь к типу параметра
	Заблокированная функция	Скалярный параметр	отключенный	не- поддерживаемый
		Параметры указателя	отключенный		отключенный	'none' Единственный МНОГО SINGLE_CERTAIN_WRITE MULTI_CERTAIN_WRITE	МНОГО
		Резкие параметры	ПОСТОЯННЫЙ	не- поддерживаемый			ПОСТОЯННЫЙ min..
		Резкие параметры const	отключенный	не- поддерживаемый
Функциональный возврат	Функция Userdef	Возврат	отключенный	не- поддерживаемый	отключенный	отключенный
	Заблокированная функция	Скалярный возврат	ПОСТОЯННЫЙ	не- поддерживаемый			ПОСТОЯННЫЙ min..
	Заблокированная функция	Указатель возвращается	ПОСТОЯННЫЙ	не- поддерживаемый	Может быть NULL Не ПУСТОЙ Пустой указатель	'none' Единственный МНОГО SINGLE_CERTAIN_WRITE MULTI_CERTAIN_WRITE	ПОСТОЯННЫЙ Может быть NULL макс. MULTI

Документация