Exponenta Banner

importFromBaseWorkspace

Класс: Simulink. данные. Словарь
Пакет: Simulink. данные

Импортируйте переменные базового рабочего пространства к словарю данных

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

Синтаксис

importedVars = importFromBaseWorkspace (dictionaryObj)
importedVars = importFromBaseWorkspace (dictionaryObj, Имя, Значение)
[importedVars, existingVars] = importFromBaseWorkspace (___)

Описание

importedVars = importFromBaseWorkspace(dictionaryObj) импортирует все переменные от базового рабочего пространства MATLAB до словаря данных dictionaryObj, не перезаписывая существующие записи в словаре. Если какие-либо переменные базового рабочего пространства уже находятся в словаре, функция представляют предупреждение и список.

Этот синтаксис возвращает список имен успешно импортированных переменных. Переменная рассматривается успешно импортированной, только если importFromBaseWorkspace присваивает значение переменной к соответствующей записи в целевом словаре данных.

importedVars = importFromBaseWorkspace(dictionaryObj,Name,Value) импортирует переменные базового рабочего пространства к словарю данных с дополнительными опциями, заданными одним или несколькими аргументами пары Name,Value.

[importedVars,existingVars] = importFromBaseWorkspace(___) дополнительно возвращает список переменных, которые не были перезаписаны. Используйте этот синтаксис, если existingVarsAction установлен в 'none', значение по умолчанию, которое препятствует тому, чтобы были перезаписаны существующие словарные статьи.

Входные параметры

развернуть все

Целевой словарь данных, заданный как объект Simulink.data.Dictionary. Прежде чем вы будете использовать эту функцию, будете представлять целевой словарь с объектом Simulink.data.Dictionary при помощи, например, Simulink.data.dictionary.create или функция Simulink.data.dictionary.open.

Аргументы в виде пар имя-значение

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Имя должно появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Отметьте, чтобы очистить базовое рабочее пространство любых успешно импортированных переменных, заданных как пара, разделенная запятой, состоящая из 'clearWorkspaceVars' и true или false.

Пример: 'clearWorkspaceVars', верный

Типы данных: логический

Действие, чтобы взять для существующих переменных словаря, заданных как пара, разделенная запятой, состоящая из 'existingVarsAction' и 'none', 'error' или 'overwrite'.

Если вы задаете 'none', importFromBaseWorkspace пытается импортировать целевые переменные, но не импортирует или вносит любые изменения в переменные, которые уже находятся в словаре данных.

Если вы задаете 'error', importFromBaseWorkspace возвращает ошибку, не импортируя переменных, если какие-либо целевые переменные уже находятся в словаре данных.

Если вы задаете 'overwrite', importFromBaseWorkspace импортирует все целевые переменные и перезаписывает любые переменные, которые уже находятся в словаре данных.

Пример: 'existingVarsAction', 'ошибка'

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

Имена определенных переменных базового рабочего пространства, чтобы импортировать, заданный как пара, разделенная запятой, состоящая из 'varList' и массива ячеек из символьных векторов или массива строк. Если вы хотите импортировать только одну переменную, задайте имя в массиве ячеек. Если вы не задаете 'varList', importFromBaseWorkspace импортирует все переменные из базового рабочего пространства MATLAB.

Пример: 'varList', {'myVariable', 'fuelFlow'}

Пример: 'varList', {'fuelFlow'}

Типы данных: ячейка

Выходные аргументы

развернуть все

Имена успешно импортированных переменных, возвращенных как массив ячеек из символьных векторов. Переменная рассматривается успешно импортированной, только если importFromBaseWorkspace присваивает значение переменной к соответствующей записи в целевом словаре данных.

Имена целевых переменных, которые не были импортированы из-за их существования в целевом словаре данных, возвратились как массив ячеек из символьных векторов. existingVars имеет содержимое, только если 'existingVarsAction' установлен в 'none', который является также значением по умолчанию. В этом случае importFromBaseWorkspace импортирует только переменные, которые уже не находятся в целевом словаре данных.

Примеры

развернуть все

В базовом рабочем пространстве MATLAB создайте переменные, чтобы импортировать.

a = 'Char Variable';
myVariable = true;
fuelFlow = 324;

Откройте словарь данных myDictionary_ex_API.sldd и представляйте его с объектом Simulink.data.Dictionary под названием myDictionaryObj.

myDictionaryObj = Simulink.data.dictionary.open('myDictionary_ex_API.sldd');

Импортируйте все переменные базового рабочего пространства к словарю данных и возвратите список успешно импортированных переменных. Если какие-либо переменные базового рабочего пространства уже находятся в myDictionary_ex_API.sldd, importFromBaseWorkspace представляет предупреждение и список затронутых переменных.

importFromBaseWorkspace(myDictionaryObj);
Warning: The following variables were not imported because 
they already exist in the dictionary:
   fuelFlow

В базовом рабочем пространстве MATLAB создайте переменные, чтобы импортировать.

b = 'Char Variable';
mySecondVariable = true;
airFlow = 324;

Откройте словарь данных myDictionary_ex_API.sldd и представляйте его с объектом Simulink.data.Dictionary под названием myDictionaryObj.

myDictionaryObj = Simulink.data.dictionary.open('myDictionary_ex_API.sldd');

Импортируйте только новые переменные базового рабочего пространства к словарю данных.

importFromBaseWorkspace(myDictionaryObj,'varList',...
{'b','mySecondVariable','airFlow'});

В базовом рабочем пространстве MATLAB создайте переменную, чтобы импортировать.

fuelFlow = 324;

Откройте словарь данных myDictionary_ex_API.sldd и представляйте его с объектом Simulink.data.Dictionary под названием myDictionaryObj. myDictionary_ex_API.sldd уже содержит запись под названием fuelFlow.

myDictionaryObj = Simulink.data.dictionary.open('myDictionary_ex_API.sldd');

Импортируйте переменный fuelFlow и перезапишите соответствующую запись в myDictionary_ex_API.sldd.

importFromBaseWorkspace(myDictionaryObj,'varList',{'fuelFlow'},...
'existingVarsAction','overwrite');

importFromBaseWorkspace присваивает значение переменной базового рабочего пространства fuelFlow к значению соответствующей записи в myDictionary_ex_API.sldd.

Возвратите список переменных, которые не импортируются из базового рабочего пространства MATLAB, потому что они уже находятся в целевом словаре данных.

В базовом рабочем пространстве MATLAB создайте переменные, чтобы импортировать.

fuelFlow = 324;
myNewVariable = 'This is a character vector.'

Откройте словарь данных myDictionary_ex_API.sldd и представляйте его с объектом Simulink.data.Dictionary под названием myDictionaryObj. myDictionary_ex_API.sldd уже содержит запись под названием fuelFlow.

myDictionaryObj = Simulink.data.dictionary.open('myDictionary_ex_API.sldd');

Импортируйте переменные fuelFlow и myNewVariable к словарю данных. Задайте имена для выходных аргументов importFromBaseWorkspace, чтобы возвратить имена успешно и неудачно импортированные переменные.

[importedVars,existingVars] = importFromBaseWorkspace(myDictionaryObj,...
'varList',{'fuelFlow','myNewVariable'})
importedVars = 

    'myNewVariable'


existingVars = 

    'fuelFlow'

importFromBaseWorkspace не импортирует переменный fuelflow, потому что это уже находится в целевом словаре данных.

Советы

  • importFromBaseWorkspace может импортировать переменные MATLAB, созданные из перечислимых типов данных, но не может импортировать определения перечислимых типов. Используйте функцию importEnumTypes, чтобы импортировать перечисленные определения типов к словарю данных. Если вы импортируете переменные перечислимых типов данных к словарю данных, но не импортируете определения перечислимого типа, словарь является менее портативным и не может функционировать правильно, если используется кем-то еще.

Альтернативы

  • Когда вы используете Редактор Simulink, чтобы соединить модель со словарем данных, можно принять решение импортировать образцовые переменные из базового рабочего пространства. Смотрите Перемещают Единственную Модель, чтобы Использовать Словарь для получения дополнительной информации.

  • Можно также использовать окно Model Explorer, чтобы перетащить переменные от базового рабочего пространства в словарь данных.

Смотрите также

|

Темы

Представленный в R2015a

Была ли эта тема полезной?
Документация Simulink
Поддержка