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 к разделу Design Data 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