find

Класс: Simulink.data.dictionary.Entry
Пакет: Simulink.data.dictionary

Поиск в массиве записей в словаре данных

Синтаксис

foundEntries = find(targetEntries,PName1,PValue1,...,PNameN,PValueN)
foundEntries = find(targetEntries,PName1,PValue1,...,PNameN,PValueN,options)

Описание

foundEntries = find(targetEntries,PName1,PValue1,...,PNameN,PValueN) ищет массив записей в словаре данных targetEntries использование критериев поиска PName1,PValue1,...,PNameN,PValueN, и возвращает массив записей, совпадающих с критериями. Этот синтаксис совпадает с критериями поиска свойствам целевых записей, которые являются Simulink.data.dictionary.Entry объекты, но не со свойствами их значений. Смотрите Simulink.data.dictionary.Entry для списка свойств записи в словаре данных.

foundEntries = find(targetEntries,PName1,PValue1,...,PNameN,PValueN,options) поиски записей в словаре данных с помощью дополнительных параметров поиска. Например, можно совпадать с критериями поиска значениям целевых записей.

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

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

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

Пример: [myEntryObj1,myEntryObj2,myEntryObj3]

Критерии поиска, заданные как одна или несколько пар "имя-значение", представляющих имена и значения свойств целевых записей в словаре данных. Для списка свойств записи в словаре данных смотрите Simulink.data.dictionary.Entry. Если вы задаете больше чем одну пару "имя-значение", возвращенные записи соответствуют всем критериям.

Если вы включаете '-value' опция, чтобы искать в значениях целевых записей, критерии поиска применяются к значениям записей, а не к самим записям.

Пример: 'LastModifiedBy','jsmith'

Пример: 'DataSource','myRefDictionary_ex_API.sldd'

Дополнительные параметры поиска, заданные как один или несколько следующих поддерживаемых кодов опции.

'-value'Эта опция вызывает find искать только в значениях целевых записей в словаре данных. Задайте эту опцию перед любыми другими критериями поиска или options аргументы.
'-and', '-or'xor, или '-not' логические операторыЭти опции изменяют или комбинируют несколько критериев поиска или другие коды опции.
'-property',propertyNameЭта пара "имя-значение" вызывает find искать записи или значения, которые имеют свойство propertyName независимо от значения свойства. Задайте propertyName как вектор символов.
'-class',classNameЭта пара "имя-значение" вызывает find искать записи или значения, которые являются объектами класса className. Задайте className как вектор символов.
'-isa',classNameЭта пара "имя-значение" вызывает find искать записи или значения, которые являются объектами класса или любого подкласса, выведенного из класса className. Задайте className как вектор символов.
'-regexp'Эта опция позволяет вам использовать регулярные выражения в своих критериях поиска. Эта опция влияет только на критерии поиска, которые следуют за '-regexp'.

Пример: '-value'

Пример: '-value','-property','CoderInfo'

Пример: '-value','-class','Simulink.Parameter'

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

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

Записи в словаре данных, совпадающие с заданными критериями поиска, возвращенными как массив Simulink.data.dictionary.Entry объекты.

Примеры

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

Поиск в массиве записей в словаре данных myEntryObjs для записей, значения которых являются объектами класса Simulink.Parameter.

foundEntries = find(myEntryObjs,'-value','-class','Simulink.Parameter')

Поиск в массиве записей в словаре данных myEntryObjs для записей, которые были в последний раз изменены пользователем jsmith.

foundEntries = find(myEntryObjs,'LastModifiedBy','jsmith')

Поиск в массиве записей в словаре данных myEntryObjs для записей, которые были в последний раз изменены пользователем jsmith или чьи имена начинаются с fuel.

foundEntries = find(myEntryObjs,'LastModifiedBy','jsmith','-or',...
'-regexp','Name','fuel*')

Поиск в массиве записей в словаре данных myEntryObjs для записей, имена которых начинаются с Press.

foundEntries = find(myEntryObjs,'-regexp','Name','Press*')

Поиск в массиве записей в словаре данных myEntryObjs для записей, значениями которых является 273. Если вы находите больше чем одну запись, храните записи в массиве под названием foundEntries.

foundEntries = [];
for i = 1:length(myEntryObjs)
    if getValue(myEntryObjs(i)) == 237
        foundEntries = [foundEntries myEntryObjs(i)];
    end
end

Поиск в массиве записей в словаре данных myEntryObjs для записей, значения которых имеют свойство DataType.

foundEntries = find(myEntryObjs,'-value','-property','DataType')

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