Simulink.data.dictionary.Entry

데이터 사전 항목 구성

페이지 내 모두 확장

설명

Simulink.data.dictionary.Entry 클래스의 객체는 데이터 사전의 한 항목을 나타냅니다. 이 객체를 사용하면 항목에 값을 할당하거나 항목의 이름을 변경하는 등의 작업을 수행할 수 있습니다.

참고

모델 작업 공간, Simulink® 데이터 사전(설계 데이터 섹션) 또는 MAT 파일과 관련된 대부분의 일반적인 데이터 관리 작업에는 데이터 소스별 함수보다 Simulink.data.DataConnection 객체에서 제공하는 함수를 사용하는 것이 좋습니다. 이러한 객체 함수는 더 적은 코드 라인 수로 데이터를 관리할 수 있는 공통 명령줄 인터페이스를 제공합니다. Simulink.data.connect 함수를 사용하여 데이터 소스에 대한 연결을 만든 다음 Simulink.data.DataConnection 객체가 제공하는 공통 함수 세트를 사용할 수 있습니다. 참조 데이터 사전의 제거 또는 추가와 같은 데이터 소스별 작업의 경우 데이터 소스별 객체를 만든 다음 그 객체에서 제공하는 함수를 사용하여 데이터 소스를 관리합니다. 자세한 내용은 Manage Design Data for Simulink Models Programmatically 항목을 참조하십시오.

새 Simulink.data.dictionary.Entry 객체를 생성하려면 먼저 대상 항목이 포함된 데이터 사전 섹션을 나타내는 Simulink.data.dictionary.Section 객체를 생성해야 합니다. 그러나 Simulink.data.dictionary.Entry 객체는 생성된 후 Simulink.data.dictionary.Section 객체와 독립적으로 존재합니다. Simulink.data.dictionary.Section 객체를 생성하려면 함수 getSection을 사용하십시오.

생성

구문

설명

함수 addEntry, getEntry, find는 Simulink.data.dictionary.Entry 객체를 생성합니다.

속성

모두 확장

데이터 사전을 포함하는 파일 이름으로, 문자형 벡터로 지정됩니다. 이 속성을 변경하면 표현된 데이터 사전 항목에 영향을 미칩니다.

예: 'myDictionary.sldd'

데이터형: char

항목에 대한 마지막 수정 날짜 및 시간으로, 협정 세계시(UTC)를 나타내는 문자형 벡터로 반환됩니다. 이 속성은 읽기 전용입니다.

항목을 수정한 마지막 사용자의 이름으로, 문자형 벡터로 반환됩니다. 이 속성은 읽기 전용입니다.

항목의 이름으로, 문자형 벡터로 지정됩니다. 이 속성을 변경하면 표현된 데이터 사전 항목에 영향을 미칩니다.

데이터형: char

항목의 상태로, 'New', 'Modified', 'Unchanged' 또는 'Deleted'로 반환됩니다. 상태는 마지막 데이터 사전 저장 이후부터 유효합니다. 상태가 'Deleted'이면 표현된 항목이 데이터 사전에서 삭제된 것입니다. 이 속성은 읽기 전용입니다.

객체 함수

deleteEntryDelete data dictionary entry
discardChangesDiscard changes to data dictionary entry
find Search in array of data dictionary entries
getValue데이터 사전 항목의 값 반환하기
setValue데이터 사전 항목의 값 설정
showChangesDisplay changes made to data dictionary entry

예제

모두 축소

dDataSectObj라는 이름의 Simulink.data.dictionary.Section 객체를 사용하여 데이터 사전 myDictionary_ex_API.sldd의 설계 데이터 섹션을 나타냅니다.

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

myDictionary_ex_API.sldd의 설계 데이터 섹션에 값이 27인 항목 myEntry를 추가합니다. 반환된 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'

fuelFlowObj라는 이름의 Simulink.data.dictionary.Entry 객체로 데이터 사전 항목 fuelFlow를 나타냅니다. 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

dDataSectObj라는 이름의 Simulink.data.dictionary.Section 객체를 사용하여 데이터 사전 myDictionary_ex_API.sldd의 설계 데이터 섹션을 나타냅니다. myDictionary_ex_API.sldd는 데이터 사전 myRefDictionary_ex_API.sldd를 참조합니다.

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

myDictionary_ex_API.sldd에 있는 항목 fuelFlow를 나타내는 Simulink.data.dictionary.Entry 객체를 생성합니다. 객체를 변수 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'

e의 DataSource 속성을 수정하여 항목 fuelFlow를 참조 데이터 사전 myRefDictionary_ex_API.sldd로 마이그레이션합니다.

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에 개발됨

참고 항목

| | | |

도움말 항목