Simulink.data.dictionary.Entry

Сконфигурируйте запись в словаре данных

Описание

Объект Simulink.data.dictionary.Entry класс представляет одну статью словаря данных. Объект позволяет вам выполнить такие операции, как присвоение записи значения или изменение имени записи.

Прежде чем вы сможете создать новую Simulink.data.dictionary.Entry объект, вы должны создать Simulink.data.dictionary.Section объект, представляющий раздел словаря данных, содержащий целевую запись. Однако после создания Simulink.data.dictionary.Entry объект существует независимо от Simulink.data.dictionary.Section объект. Используйте функцию getSection для создания Simulink.data.dictionary.Section объект.

Создание

Синтаксис

Описание

Функции addEntry, getEntry, и find создать Simulink.data.dictionary.Entry объекты.

Свойства

расширить все

Имя файла, содержащего словарь данных, задается как вектор символов. Изменения, которые вы вносите в это свойство, влияют на представленные записи в словаре данных.

Пример: 'myDictionary.sldd'

Типы данных: char

Дата и время последнего изменения входа, возвращенные в Согласованное универсальное время (UTC) как вектор символов. Это свойство доступно только для чтения.

Имя последнего пользователя для изменения записи, возвращаемое как вектор символов. Это свойство доступно только для чтения.

Имя записи, заданное как вектор символов. Изменения, которые вы вносите в это свойство, влияют на представленные записи в словаре данных.

Типы данных: char

Состояние входа, возвращаемое следующим 'New', 'Modified', 'Unchanged', или 'Deleted'. Состояние допустимо с момента последнего сохранения словаря данных. Если состояние 'Deleted', представленная статья была удалена из своего словаря данных. Это свойство доступно только для чтения.

Функции объекта

deleteEntryУдалите запись в словаре данных
discardChangesОтменить изменения в записи в словаре данных
find Поиск в массиве записей в словаре данных
getValueВозвращает значение записи в словаре данных
setValueУстановите значение записи в словаре данных
showChangesОтображение изменений, внесенных в запись в словаре данных

Примеры

свернуть все

Представление раздела Design Data словаря данных myDictionary_ex_API.sldd с Simulink.data.dictionary.Section объект с именем dDataSectObj.

myDictionaryObj = Simulink.data.dictionary.open('myDictionary_ex_API.sldd');
dDataSectObj = getSection(myDictionaryObj,'Design Data');

Добавить запись myEntry со значением 27 в раздел Проектных данных myDictionary_ex_API.sldd. Присвойте возвращенные Simulink.data.dictionary.Entry объект в переменную e.

e = addEntry(dDataSectObj,'myEntry',27)
e = 

  Entry with properties:

              Name: 'myEntry'
             Value: 27
        DataSource: 'myDictionary_ex_API.sldd'
      LastModified: '2014-Aug-26 18:42:08.439709'
    LastModifiedBy: 'jsmith'
            Status: 'New'

Измените значение myEntry от 27 в вектор символов 'My New Value'.

setValue(e,'My New Value')
e
e = 

  Entry with properties:

              Name: 'myEntry'
             Value: 'My New Value'
        DataSource: 'myDictionary_ex_API.sldd'
      LastModified: '2014-Aug-26 18:45:58.336598'
    LastModifiedBy: 'jsmith'
            Status: 'New'

Представление записи в словаре данных fuelFlow с Simulink.data.dictionary.Entry объект с именем fuelFlowObj. fuelFlow определяется в словаре данных myDictionary_ex_API.sldd.

myDictionaryObj = Simulink.data.dictionary.open('myDictionary_ex_API.sldd');
dDataSectObj = getSection(myDictionaryObj,'Design Data');
fuelFlowObj = getEntry(dDataSectObj,'fuelFlow');

Верните значение записи fuelFlow и присвойте значение переменной fuelFlowValue.

fuelFlowValue = getValue(fuelFlowObj)
fuelFlowValue =

   237

Представление раздела Design Data словаря данных myDictionary_ex_API.sldd с Simulink.data.dictionary.Section объект с именем dDataSectObj. myDictionary_ex_API.sldd ссылается на словарь данных myRefDictionary_ex_API.sldd.

myDictionaryObj = Simulink.data.dictionary.open('myDictionary_ex_API.sldd');
dDataSectObj = getSection(myDictionaryObj,'Design Data');

Создайте Simulink.data.dictionary.Entry объект, представляющий fuelFlow входа, который находится в myDictionary_ex_API.sldd. Назначьте объект переменной e.

e = getEntry(dDataSectObj,'fuelFlow')
e = 

  Entry with properties:

              Name: 'fuelFlow'
             Value: 237
        DataSource: 'myDictionary_ex_API.sldd'
      LastModified: '2014-Sep-05 13:12:06.099278'
    LastModifiedBy: 'jsmith'
            Status: 'Unchanged'

Миграция записи fuelFlow к ссылке данных myRefDictionary_ex_API.sldd путем изменения DataSource свойство e.

e.DataSource = 'myRefDictionary_ex_API.sldd'
e = 

  Entry with properties:

              Name: 'fuelFlow'
             Value: 237
        DataSource: 'myRefDictionary_ex_API.sldd'
      LastModified: '2014-Sep-05 13:12:06.099278'
    LastModifiedBy: 'jsmith'
            Status: 'Modified'

Потому что myDictionary_ex_API.sldd ссылки myRefDictionary_ex_API.slddоба словаря относятся к одной и той же словарной иерархии, что позволяет перенести запись fuelFlow между ними.

Введенный в R2015a