Пакет: coder.dictionary
Настройка определения словаря встроенного кодера
Объект coder.dictionary.Entry класс представляет одно определение словаря встроенного кодера. В этом API объект называется записью. Информация, представляемая объектом, является определением. В этой документации определение относится к определению объекта ввода.
A coder.Dictionary объект содержит три coder.dictionary.Section объекты, представляющие разделы словаря встроенного кодера: классы хранения, разделы памяти и шаблоны настройки функций. A coder.dictionary.Section объект содержит coder.dictionary.Entry объекты, представляющие определения, хранящиеся в этом разделе словаря встроенного кодера. Имя раздела определяет тип определений кода, содержащихся в разделе. Для доступа к разделам словаря встроенного кодера используйте coder.Dictionary объект. Для доступа к словарным статьям в разделе используйте coder.dictionary.Section объект.
A coder.dictionary.Entry объект имеет эти свойства.
Name - Наименование определения кодаИмя определения словаря кодера, представляемого статьей. Имя должно быть уникальным среди определений в разделе словаря.
DataSource - Место определения кодаМестоположение определения кода. Это свойство доступно только для чтения.
Built-in - Поставляется компанией Simulink ®.
Имя модели - определяется в модели Simulink.
Имя словаря - определяется в словаре данных Simulink.
Имя пакета - определяется в пакете Simulink или в пользовательском пакете.
Для доступа к свойствам определения кода, представляемого записью, используйте getAvailableProperties, get, и set методы. Каждый тип определения кода имеет доступные свойства.
Name - Наименование класса храненияStorageClass1 (по умолчанию) | символьный вектор | строковый скалярИмя класса хранения. Имя должно быть уникальным среди классов хранения в словаре.
Список встроенных и примерных классов хранения, предоставляемых Simulink, см. в разделе Выбор класса хранения для управления представлением данных в сгенерированном коде.
Description - Назначение и функциональность класса храненияПользовательский текст, который можно использовать для описания назначения и функциональных возможностей класса хранения.
DataSource - Место определения кодаМестоположение определения кода. Это свойство доступно только для чтения.
Built-in - Предоставляется компанией Simulink.
Имя модели - определяется в модели Simulink.
Имя словаря - определяется в словаре данных Simulink.
Имя пакета - определяется в пакете Simulink или в пользовательском пакете.
DataAccess - Спецификация для доступа к даннымDirect (по умолчанию) | FunctionСпецификация для доступа к данным, связанным с моделью. Доступ к данным напрямую (Direct) или через настраиваемые get и set функции (Function). Дополнительные сведения см. в разделе Доступ к данным через функции с помощью классов хранения в словаре встроенного кодера.
Установка для этого свойства значения Function:
Наборы DataScope кому Imported.
Означает, что невозможно задать свойства нескольких экземпляров.
Включает следующие свойства:
AccessMode
AllowedAccess
GetFunctionName
SetFunctionName
Устанавливает PreserveDimensions свойство для false. Для сохранения размеров многомерных массивов в создаваемом коде установите DataAccess кому Direct.
DataScope - Спецификация для создания определения данныхExported (по умолчанию) | ImportedСпецификация, определяющая данные сгенерированным кодом (Exported) или импорт (Imported) определение данных из внешнего кода. Встроенные классы хранения и классы хранения в пакетах, таких как Simulink, могут использовать другие параметры области, такие как File.
Установка для этого свойства значения Imported:
Отключает DefinitionFile. Чтобы включить внешний файл исходного кода в процесс построения, используйте параметры конфигурации модели. Пример см. в разделе Настройка интерфейса данных.
Означает, что невозможно установить HeaderFile кому $N.h, хотя вы можете использовать $N токен.
Установка для этого свойства значения Exported, необходимо использовать один из маркеров $N или $R в значении HeaderFile.
Header File - Имя файла заголовка, объявляющего данные$N.h (по умолчанию) | символьный вектор | строковый скалярИмя файла заголовка, объявляющего данные, указанное как имя или правило именования. Правило именования включает комбинацию текста и маркеров. Допустимые маркеры перечислены в этой таблице.
| Символ | Описание |
|---|---|
$R | Имя корневой модели |
$N | Имя связанного элемента данных |
$G | Имя класса хранения |
$U | Текст маркера пользователя, который задается для модели, как описано в разделе Управление форматом идентификатора |
Если установить DataScope кому Exported, необходимо использовать один из маркеров $R или $N в значении этого свойства.
Если установить DataScope кому Imported, значение этого свойства нельзя установить равным $N.h, но вы можете использовать $N токен.
Definition File - имя исходного файла, определяющего данные;$N.c (по умолчанию) | символьный вектор | строковый скалярИмя исходного файла, определяющего данные, указанное как имя или правило именования. Правило именования включает комбинацию текста и маркеров. Допустимые маркеры перечислены в этой таблице.
| Символ | Описание |
|---|---|
$R | Имя корневой модели |
$N | Имя связанного элемента данных |
$G | Имя класса хранения |
$U | Текст маркера пользователя, который задается для модели, как описано в разделе Управление форматом идентификатора |
Настройка DataScope кому Imported отключает DefinitionFile. Чтобы включить внешний файл исходного кода в процесс построения, используйте параметры конфигурации модели. Пример см. в разделе Настройка интерфейса данных.
AccessMode - Спецификация для доступа к данным через функцииValue (по умолчанию) | PointerСпецификация класса хранения для доступа к данным, связанным с моделью, через функции с помощью Value или Pointer. Дополнительные сведения см. в разделе Доступ к данным через функции с помощью классов хранения в словаре встроенного кодера.
Это свойство включается только при установке DataAccess кому Function.
AllowedAccess - Спецификация для обеспечения доступа к данным через функцииReadWrite (по умолчанию) | ReadOnly | WriteOnlyСпецификация класса хранения, разрешающая чтение и запись (ReadWriteтолько для чтенияReadOnly) или только для записи (WriteOnly) доступ к данным.
Это свойство включается только при установке DataAccess кому Function.
GetFunctionName - Наименование get функция, которая извлекает связанные данныеget_$N$M (по умолчанию) | символьный вектор | строковый скалярНазвание get функция, которая извлекает связанные данные, указанные как имя или правило именования. Правило именования включает комбинацию текста и маркеров. Допустимые маркеры перечислены в этой таблице.
| Символ | Описание |
|---|---|
$N | Имя связанного элемента данных (обязательно) |
$R | Имя корневой модели |
$M | Мангальный текст, обеспечивающий уникальность |
$U | Текст маркера пользователя. См. раздел Управление форматом идентификатора. |
Это свойство включается только при установке DataAccess кому Function и AllowedAccess кому ReadWrite или ReadOnly.
SetFunctionName - Наименование set функция, которая изменяет связанные данныеset_$N$M (по умолчанию) | символьный вектор | строковый скалярНазвание set функция, которая извлекает измененные данные, указанные как имя или правило именования. Правило именования включает комбинацию текста и маркеров. Допустимые маркеры перечислены в этой таблице.
| Символ | Описание |
|---|---|
$N | Имя связанного элемента данных (обязательно) |
$R | Имя корневой модели |
$M | Мангальный текст, обеспечивающий уникальность |
$U | Текст маркера пользователя. См. раздел Управление форматом идентификатора. |
Это свойство включается только при установке DataAccess кому Function и AllowedAccess кому ReadWrite или WriteOnly.
DifferentInstanceDataSettings - Спецификация для назначения отдельных параметров хранения для данных одного экземпляра и данных нескольких экземпляровfalse (по умолчанию) | trueСпецификация класса хранения данных для использования либо параметров хранения, заданных для данных одного экземпляра, либо параметров, заданных для данных нескольких экземпляров. При применении класса хранения к элементу данных Embedded Coder Dictionary определяет, является ли он классом хранения с одним экземпляром или классом хранения с несколькими экземплярами по типу данных и по контексту модели в иерархии ссылок на модель.
Выбор этого свойства включает свойства SingleInstanceStorageType, MultiInstanceStorageType, и MultiInstanceStructureTypeName, MultiInstanceStructureInstanceName.
StorageType - Спецификация для агрегирования данных в структуруUnstructured (по умолчанию) | StructuredСпецификация для агрегирования данных, использующих класс хранения, в структуру в сгенерированном коде. Каждый элемент данных отображается в коде как поле структуры. Для создания структуры используйте Structured.
Установка для этого свойства значения Structured позволяет StructureTypeName и StructureInstanceName.
StructureTypeName - Наименование типа структуры$R$N$G$M (по умолчанию) | символьный вектор | строковый скалярИмя типа структуры в созданном коде, указанное как имя или правило именования. Правило именования включает комбинацию текста и маркеров. Допустимые маркеры перечислены в этой таблице.
| Символ | Описание |
|---|---|
$R | Имя корневой модели |
$N | Базовое имя связанной функции, например step |
$G | Имя класса хранения |
$U | Текст маркера пользователя, который задается для модели, как описано в разделе Управление форматом идентификатора |
$M | При необходимости вставляется текст с искажениями имен, чтобы избежать конфликтов имен |
Настройка StorageType кому Structured включает это свойство.
StructureInstanceName - Имя структурной переменной$G$N$M (по умолчанию) | символьный вектор | строковый скалярИмя структурной переменной в созданном коде, указанное как имя или правило именования. Правило именования включает комбинацию текста и маркеров. Допустимые маркеры перечислены в этой таблице.
| Символ | Описание |
|---|---|
$R | Имя корневой модели |
$N | Базовое имя связанной функции, например step |
$G | Имя класса хранения |
$U | Текст маркера пользователя, который задается для модели, как описано в разделе Управление форматом идентификатора |
$M | При необходимости вставляется текст с искажениями имен, чтобы избежать конфликтов имен |
Настройка StorageType кому Structured включает это свойство.
SingleInstanceStorageType - Спецификация для агрегирования данных одного экземпляра в структуруStructured (по умолчанию) | UnstructuredСпецификация для агрегирования данных одного экземпляра, использующих класс хранения, в структуру в сгенерированном коде. Каждый элемент данных отображается в коде как поле структуры. Для создания структуры используйте Structured.
Настройка свойства UseDifferentPropSettingsForInstanceData кому true включает это свойство.
Установка для этого свойства значения Structured включает свойства SingleInstanceStructureTypeName и SingleInstanceStructureInstanceName.
SingleInstanceStructureTypeName - Имя типа структуры для данных одного экземпляра$R$N$G$M (по умолчанию) | символьный вектор | строковый скалярИмя типа структуры в созданном коде, указанное как имя или правило именования. Правило именования включает комбинацию текста и маркеров. Допустимые маркеры перечислены в этой таблице.
| Символ | Описание |
|---|---|
$R | Имя корневой модели |
$N | Базовое имя связанной функции, например step |
$G | Имя класса хранения |
$U | Текст маркера пользователя, который задается для модели, как описано в разделе Управление форматом идентификатора |
$M | При необходимости вставляется текст с искажениями имен, чтобы избежать конфликтов имен |
Настройка SingleInstanceStorageType кому Structured включает это свойство.
SingleInstanceStructureInstanceName - Имя структурной переменной для данных одного экземпляра$G$N$M (по умолчанию) | символьный вектор | строковый скалярИмя структурной переменной в созданном коде, указанное как имя или правило именования. Правило именования включает комбинацию текста и маркеров. Допустимые маркеры перечислены в этой таблице.
| Символ | Описание |
|---|---|
$R | Имя корневой модели |
$N | Базовое имя связанной функции, например step |
$G | Имя класса хранения |
$U | Текст маркера пользователя, который задается для модели, как описано в разделе Управление форматом идентификатора |
$M | При необходимости вставляется текст с искажениями имен, чтобы избежать конфликтов имен |
Настройка SingleInstanceStorageType кому Structured включает это свойство.
MultiInstanceStorageType - Спецификация для агрегирования данных нескольких экземпляров в структуруStructured (по умолчанию)Спецификация для агрегирования данных одного экземпляра, использующих класс хранения, в структуру в сгенерированном коде. Каждый элемент данных отображается в коде как поле структуры. Нельзя изменить значение этого свойства.
Настройка свойства UseDifferentPropSettingsForInstanceData кому true включает это свойство.
MultiInstanceStructureTypeName - Имя типа структуры для многоэкземплярных данных$R$N$G$M (по умолчанию) | символьный вектор | строковый скалярИмя типа структуры в созданном коде, указанное как имя или правило именования. Правило именования включает комбинацию текста и маркеров. Допустимые маркеры перечислены в этой таблице.
| Символ | Описание |
|---|---|
$R | Имя корневой модели |
$N | Базовое имя связанной функции, например step |
$G | Имя класса хранения |
$U | Текст маркера пользователя, который задается для модели, как описано в разделе Управление форматом идентификатора |
$M | При необходимости вставляется текст с искажениями имен, чтобы избежать конфликтов имен |
Настройка свойства UseDifferentPropSettingsForInstanceData кому true включает это свойство.
При установке свойства DataAccess кому Function, невозможно задать это свойство.
MultiInstanceStructureInstanceName - Имя структурной переменной для многоэкземплярных данных$G$N$M (по умолчанию) | символьный вектор | строковый скалярИмя структурной переменной в созданном коде, указанное как имя или правило именования. Правило именования включает комбинацию текста и маркеров. Допустимые маркеры перечислены в этой таблице.
| Символ | Описание |
|---|---|
$R | Имя корневой модели |
$N | Базовое имя связанной функции, например step |
$G | Имя класса хранения |
$U | Текст маркера пользователя, который задается для модели, как описано в разделе Управление форматом идентификатора |
$M | При необходимости вставляется текст с искажениями имен, чтобы избежать конфликтов имен |
Настройка свойства UseDifferentPropSettingsForInstanceData кому true включает это свойство.
При установке свойства DataAccess кому Function, невозможно задать это свойство.
DataInit - Как инициализировать данныеDynamic (по умолчанию) | Static | NoneУказание, что сгенерированные коды инициализируют данные.
Dynamic - Созданный код инициализирует данные как часть функции точки входа инициализации модели.
Static - Созданный код инициализирует данные в той же инструкции, которая определяет и выделяет память для данных. Оператор присвоения отображается в верхней части .c или .cpp исходный файл, вне функции.
None - Созданный код не инициализирует данные.
Если установить Const кому true, нельзя установить для этого свойства значение Dynamic.
Установка для этого свойства значения Dynamic устанавливает свойство Const кому false.
MemorySection - Расположение в памяти для выделения данныхNone (по умолчанию) | coder.dictionary.Entry объектРасположение в памяти для выделения данных, указанное как coder.dictionary.Entry объект, представляющий раздел памяти, существующий в словаре встроенного кодера. Дополнительные сведения о разделах памяти см. в разделе Управление данными и размещением функций в памяти путем вставки прагматиков.
PreserveDimensions - Спецификация для сохранения размеров многомерных массивовfalse (по умолчанию) | trueСпецификация класса хранения для сохранения размеров многомерных массивов в созданном коде. Дополнительные сведения см. в разделе Сохранение размеров многомерных массивов в сгенерированном коде.
Const - Применяемая спецификация const определительfalse (по умолчанию) | trueСпецификация для применения const квалификатор данных.
При выборе этого свойства невозможно задать DataInit кому Dynamic.
Настройка DataInit кому Dynamic \ задает для этого свойства значениеfalse.
Volatile - Применяемая спецификация volatile определительfalse (по умолчанию) | trueСпецификация для применения volatile квалификатор данных.
OtherQualifier - Спецификация для применения пользовательского квалификатораСпецификация для применения пользовательского квалификатора к данным. Например, некоторые архитектуры памяти поддерживают квалификаторы far и huge.
Не использовать это свойство для применения ключевого слова static. Вместо этого используйте встроенный класс хранения FileScope, который нельзя применить в редакторе сопоставлений кода. См. раздел Выбор класса склада для представления контроллинговых данных в сгенерированном коде.
AccessibleByParameters - Разрешить ли использование с параметрами моделиfalse (по умолчанию) | trueСпецификация, указывающая, следует ли разрешить использование класса хранения с параметрами модели.
Настройка DataInit кому Static устанавливает для этого свойства значение true.
Настройка DataInit кому Dynamic устанавливает для этого свойства значение false.
Чтобы задать значение этого свойства, установите DataInit кому None.
AccessibleBySignals - Разрешить ли использование с модельными сигналамиtrue (по умолчанию) | falseСпецификация, указывающая, следует ли разрешить использование класса хранения с модельными сигналами.
Настройка DataInit кому Dynamic устанавливает для этого свойства значение true.
Настройка DataInit кому Static устанавливает для этого свойства значение false.
Чтобы задать значение этого свойства, установите DataInit кому None.
Name - Наименование шаблона функцииFunctionTemplate1 (по умолчанию) | символьный вектор | строковый скалярИмя шаблона. Имя должно быть уникальным среди шаблонов функций в словаре. Embedded Coder ® содержит встроенные шаблоны, перечисленные в этой таблице.
| Шаблон | Описание |
|---|---|
ModelFunction | В редакторе сопоставлений кодов используйте функции начальной точки для инициализации, выполнения, завершения и сброса (см. раздел Настройка генерации кода по умолчанию для функций). |
UtilityFunction | В редакторе сопоставлений кодов используйте для общих служебных функций (см. раздел Настройка генерации кода по умолчанию для функций). |
Description - Назначение и функциональность шаблона функцииПользовательский текст, который можно использовать для описания назначения и функциональных возможностей шаблона функции.
FunctionName - Наименования создаваемых функций$R$N (по умолчанию) | символьный вектор | строковый скалярИмена функций в сгенерированном коде, указанные как правило именования. Правило именования включает комбинацию текста и маркеров. Допустимые маркеры перечислены в этой таблице.
| Символ | Описание |
|---|---|
$R | Имя корневой модели |
$N | Базовое имя связанной функции, например step |
$U | Текст маркера пользователя, который задается для модели, как описано в разделе Управление форматом идентификатора |
$C | Для общих служебных функций контрольная сумма вставляется во избежание конфликтов имен |
$M | При необходимости вставляется текст с искажениями имен, чтобы избежать конфликтов имен |
MemorySection - Местоположение в памяти для назначения функцииNone (по умолчанию) | coder.dictionary.Entry объектРасположение в памяти для назначения функции, указанное как coder.dictionary.Entry объект, представляющий раздел памяти, существующий в словаре встроенного кодера. Дополнительные сведения о разделах памяти см. в разделе Управление данными и размещением функций в памяти путем вставки прагматиков.
Name - Наименование раздела памятиИмя раздела памяти. Имя должно быть уникальным среди разделов памяти в словаре. Встроенный кодер содержит встроенные разделы памяти, перечисленные в этой таблице.
| Раздел памяти | Описание |
|---|---|
MemConst | Применение квалификатора типа склада const к данным. |
MemVolatile | Применение квалификатора типа склада volatile к данным. |
MemConstVolatile | Применение квалификаторов типа склада const и volatile к данным. |
Description - Назначение и функциональность секции памятиПользовательский текст, который можно использовать для описания назначения и функциональности раздела памяти.
Comment - Комментарий для вставки в созданный кодКомментарий кода, который генератор кода включает с прагматиками или другими украшениями, которые вы указываете с помощью PreStatement и PostStatement.
PreStatement - Код для вставки перед кодом данных или функцииКод, например, прагматики, для вставки перед определениями и объявлениями данных или функций, находящихся в разделе памяти.
Вы можете использовать маркер $R для представления имени модели, использующей раздел памяти.
При установке StatementsSurround кому EachVariable, вы можете использовать маркер $N для представления имени каждой переменной или функции, использующей раздел памяти.
PostStatement - Код для вставки после данных или кода функцииКод, например, прагматики, для вставки после определений и описаний данных или функций, находящихся в разделе памяти.
Вы можете использовать маркер $R для представления имени модели, использующей раздел памяти.
При установке StatementsSurround кому EachVariable, вы можете использовать маркер $N для представления имени каждой переменной или функции, использующей раздел памяти.
StatementsSurround - Спецификация для переноса данных и функций по отдельности или в группуEachVariable (по умолчанию) | AllVariablesСпецификация для вставки операторов кода (PreStatement и PostStatement):
Вокруг каждой переменной и функции, которая использует раздел памяти. Выбрать EachVariable.
Один раз, вокруг всей секции памяти. Созданный код агрегирует определения переменных и функций в смежный блок кода и окружает блок инструкциями. Выбрать AllVariables.
get | Получение значения свойства определения кода |
set | Задать значение свойства определения кода |
getAvailableProperties | Возвращаемые свойства для определения кода |
deleteEntry | Удалить статью словаря встроенного кодера |
valid | Определить, coder.dictionary.Entry объект представляет допустимое определение кода |
Открытие модели rtwdemo_roll и представить Embedded Coder Dictionary с помощью coder.Dictionary объект coderDictionary. Этот объект используется для доступа к разделу «Классы хранения» словаря, который содержит определения классов хранения.
rtwdemo_roll
coderDictionary = coder.dictionary.open('rtwdemo_roll');Создать coder.dictionary.Section объект, представляющий раздел «Классы хранения» словаря встроенного кодера.
storageClassesSect = getSection(coderDictionary, 'StorageClasses');Добавление определения с именем MyStorageClass в раздел Классы хранения. В определении класса хранения используются параметры свойств по умолчанию. Эти параметры можно изменить с помощью set функция.
newEntry = addEntry(storageClassesSect,'MyStorageClass')newEntry =
Entry with properties:
Name: 'MyStorageClass'
DataSource: 'rtwdemo_roll'
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.