Varargin matlab что это
Документация
Список входных параметров переменной длины
Синтаксис
Описание
varargin входная переменная в функциональном операторе определения, который позволяет функции принять любое количество входных параметров. Задайте varargin с помощью символов нижнего регистра и включайте его как последний входной параметр после любых явным образом заявленных входных параметров.
Когда функция выполняется, varargin является 1 N массивом ячеек, где N является количеством входных параметров, которые функция получает после явным образом заявленных входных параметров. Однако, если функция не получает входных параметров после явным образом заявленных входных параметров, то varargin является массивом пустой ячейки.
Примеры
Переменное количество входных параметров функции
Вызовите функцию с несколькими входными параметрами.
varargin и Заявленные Вводы
Вызовите функцию с несколькими входными параметрами.
Вызовите функцию с двумя входными параметрами. varargin является массивом пустой ячейки.
Переменное количество вводов и выводов
Вызовите функцию с двумя входными параметрами и тремя выходными параметрами.
Вызовите функцию снова без вводов или выводов.
Обертка Создания функции
Смотрите также
Представлено до R2006a
Документация MATLAB
Поддержка
© 1994-2019 The MathWorks, Inc.
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.
Документация
Список входных параметров переменной длины
Синтаксис
Описание
varargin входная переменная в функциональном операторе определения, который позволяет функции принять любое количество входных параметров. Задать varargin использование символов нижнего регистра, и включает его как последний входной параметр после любых явным образом заявленных входных параметров.
Когда функция выполняется, varargin 1 N массивом ячеек, где N является количеством входных параметров, которые функция получает после явным образом заявленных входных параметров. Однако, если функция не получает входных параметров после явным образом заявленных входных параметров, то varargin массив пустой ячейки.
Примеры
Переменное количество входных параметров функции
Задайте функцию в файле с именем acceptVariableNumInputs.m это принимает переменное количество входных параметров и отображает значения каждого входа.
Вызовите функцию с несколькими входными параметрами.
varargin и заявленные входные параметры
Задайте функцию в файле с именем definedAndVariableNumInputs.m это ожидает два входных параметров и принимает дополнительное количество входных параметров.
Вызовите функцию с несколькими входными параметрами.
Вызовите функцию с двумя входными параметрами. varargin массив пустой ячейки.
Переменное количество вводов и выводов
Задайте функцию в файле с именем variableNumInputAndOutput.m это принимает переменное количество вводов и выводов.
Вызовите функцию с двумя входными параметрами и тремя выходными параметрами.
Вызовите функцию снова без вводов или выводов.
Обертка Создания функции
В файле в вашей рабочей папке создайте обертку в функцию построения графика, которая строит красную линию. redplot функция признает, что входной параметр переменной длины перечисляет, и возвращает список выходных аргументов переменной длины. Это устанавливает цвет линии на красный, и вперед другие входные значения к plot функция. Эта функциональная обертка позволяет вам передать redplot те же входные параметры как plot и не указывают, что цвет линии является красным.
Используйте redplot построить график.
Вызовите redplot снова, и задайте аргументы ввода и вывода, чтобы передать plot функция.
Расширенные возможности
Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.
Указания и ограничения по применению:
Если вы используете varargin чтобы задать аргумент к точке входа функция (верхнего уровня), генератор кода производит функцию C/C++ с постоянным числом входных параметров. Количество аргументов, которые вы задаете, когда вы генерируете код, определяет постоянное число аргументов.
Индекс в varargin должно быть постоянное время компиляции.
Смотрите также
Открытый пример
У вас есть модифицированная версия этого примера. Вы хотите открыть этот пример со своими редактированиями?
Документация MATLAB
Поддержка
© 1994-2021 The MathWorks, Inc.
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.
Varargin matlab что это
Функция c = cell(n) создает массив ячеек, состоящих из пустых матриц, размера nхn. Сообщение об ошибке возникает в том случае, если n не является скаляром.
Функции c = cell(m, n) и c = cell([m, n]) создают массив ячеек, состоящих из пустых матриц, размера mхn. Аргументы m и n должны быть скалярными.
Функция c = cell(size(A)) создает массив ячеек, состоящих из пустых матриц, того же размера, что и массив A.
Пример.
Сопутствующие функции: ONES, RAND, RANDN, ZEROS.
| Вывести на экран содержимое массива ячеек |
Команда celldisp(C) выводит на экран содержимое массива ячеек.
Пример.
Выведем на экран содержимое следующего массива ячеек размера 2х3:
Сопутствующие функции: CELLPLOT.
| Вывести на экран графическую структуру массива ячеек |
cellplot(C)
cellplot(C, ‘legend’)
handles = cellplot(. )
Команда cellplot(C) выводит в графическое окно содержимое массива ячеек C. Закрашенные прмоугольники соответствуют векторам и массивам, скалярные величины и короткие строки символов выводятся в виде текста.
Команда cellplot(C, ‘legend’) кроме графического изображения выводит описание цветов для различных типов данных.
Функция handles = cellplot(C) выводит в графическое окно содержимое массива ячеек C и возвращает вектор поддержек.
Команда cellplot может выводить только графическую струтктуру для двумерных массивов ячеек.
Пример.
Выведем на экран содержимое следующего массива ячеек размера 2х3:
c <1, 1>= ‘2-by-2’;
c <1, 2>= ‘eigenvalues of eye(2)’;
c <2, 1>= eye(2);
c <2, 2>= eig(eye(2));
cellplot(c, ‘legend’)
Сопутствующие функции: CELLDISP.
| Преобразовать массив строк в массив символьных ячеек |
Функция C = cellstr(S) преобразует массив строк S в массив символьных ячеек C.
Пример.
Задан следующий массив строк S размера 3х4:
S = [‘abc ‘ ;
‘defg’ ;
‘hi ‘]
S = abc
defg
hi
Функция C = cellstr(S) возвращает массив ячеек размера 3х1:
C = cellstr(S)
C = ‘abc’
‘defg’
‘hi’
Сопутствующие функции: ISCELLSTR, STRINGS.
| Установить соответствие между входами и выходами |
[Y1, Y2, Y3. ] = deal(X)
[Y1, Y2, Y3. ] = deal(X1, X2, X3. )
Пример.
Скопировать содержимое массива ячеек C размера 1х4 в 4 выходные переменные:
| 0.9501 | 0.4860 | 0.4565 |
| 0.2311 | 0.8913 | 0.0185 |
| 0.6068 | 0.7621 | 0.8214 |
| 1 | 0 | 0 |
| 0 | 1 | 0 |
| 0 | 0 | 1 |
Скопировать содержимое всех полей name структуры A размера 1х2 в отдельные переменные:
| A.name = ‘Pat’; | A.number = 176554; |
| A(2).name = ‘Tony’; | A(2).number = 901325; |
[name1, name2] = deal(A(:).name)
name1 = Pat
name2 = Tony
Сопутствующие функции: VARARGIN, VARARGOUT, CELL2STRUCT, STRUCT2CELL, NUM2CELL, CAT.
| Выявление массива ячеек |
Сопутствующие функции: функции группы IS*.
| Преобразовать массив чисел в массив ячеек |
C = num2cell(A)
C = num2cell(A, dims)
Функция C = num2cell(A) преобразует массив A в массив ячеек, размещая каждый элемент массива A в отдельной ячейке. Размер массива ячеек будет совпадать с размерами массива A.
Функция C = num2cell(A, dims) преобразует только те элементы массива A в массив ячеек, которые заданы вторым аргументом.
Пример.
Рассмотрим некоторый массив чисел A = rand(3):
A = rand(3)
A =
| 0.4447 | 0.9218 | 0.4057 |
| 0.6154 | 0.7382 | 0.9355 |
| 0.7919 | 0.1763 | 0.9169 |
и применим к нему следующие преобразования:
celldisp(num2cell(A, 2))
ans <1>= 0.4447 0.9218 0.4057
ans <2>= 0.6154 0.7382 0.9355
ans <3>= 0.7919 0.1763 0.9169
celldisp(num2cell(A, [1 3]))
| ans <1>= | ans <2>= | ans <3>= |
| 0.4447 | 0.9218 | 0.4057 |
| 0.6154 | 0.7382 | 0.9355 |
| 0.7919 | 0.1763 | 0.9169 |
В последнем случае столбцы размещены по отдельным ячейкам.
Сопутствующие функции: CAT.
| Преобразовать массив ячеек в массив записей |
lS = cell2struct(C, fields, dim)
Функция S = cell2struct(C, fields, dim) преобразует массив ячеек C в массив записей S вдоль размерности dim, сохраняя размер массива C по этой размерности в записи структуры. Аргумент fields может быть массивом строк или массивом строковых ячеек.
Пример.
Рассмотрим массив ячеек размера 1 по первой размерности и размера 3 по второй
c =
c =
‘tree’ [37.4000] ‘birch’
и преобразуем его по второй размерности в структуру с полями f = <'category', 'height', 'name'>:
f = <'category', 'height', 'name'>;
s = cell2struct(c, f, 2)
s =
category: ‘tree’
height: 37.4000
name: ‘birch’
Сопутствующие функции: FIELDNAMES, STRUCT2CELL.
| Преобразовать массив записей в массив ячеек |
Функция C = struct2cell(S) преобразует массив записей S размера mхn (с p полями) в массив ячеек C размера pхmхn.
Если массив записей S многомерный, то массив ячеек C имеет размер [p size(S)].
Пример.
clear S,
S.category = ‘tree’; S.height = 37.4; S.name = ‘birch’;
S =
category: ‘tree’
height: 37.4000
name: ‘birch
Преобразуем эту структуру в массив ячеек
C = struct2cell(S)
C =
‘tree’
[37.4000]
‘birch’
Сопутствующие функции: CELL2STRUCT, FIELDS.
| Определение списков значений |
Команда help lists выводит на экран следующий комментарий к определению и использованию списков значений при работе с массивами записей и массивами ячеек.
Извлечение множественных данных из массивов записей и массивов ячеек осуществляется с помощью списков значений.
Конструкции вида S(m:n).name, C
Пример.
В результате выполненных операций были сформированы следующие массивы:
whos
Сопутствующие функции: CAT, CELL2STRUCT, DEAL, NUM2CELL, STRUCT2CELL, VARARGIN, VARARGOUT.
| Список входных аргументов переменной длины |
z = function myfun(x, y, varargin)
Переменная varargin позволяет объединить любое количество входных аргументов; она представляет собой массив ячеек, который содержит аргументы-опции вызываемой функции. Эта переменная должна быть последней в списке входов, а ее написание допускается только строчными буквами.
Пример.
function myplot(x, varargin)
plot(x, varargin<:>)
Она объединяет все входные аргументы, начиная со второго в одну переменную varargin. В свою очередь, при обращении к функции plot используется список значений varargin<:>, чтобы передать все задействованные аргументы. Например, при вызове функции myplot в форме:
Сопутствующие функции: VARARGOUT, NARGIN, NARGOUT, INPUTNAME, FUNCTION, LISTS.
| Список выходных аргументов переменной длины |
[z, varargout] = myfun(x, y, n)
Переменная varargout позволяет объединить любое количество выходных аргументов; она представляет собой массив ячеек, который содержит аргументы-опции выхода функции. Эта переменная должна быть последней в списке выходов, а ее написание допускается только строчными буквами.
Переменная varargout не создается при вызове функции; ее необходимо создать при формировании выходов создаваемой М-функции, используя соответствующие операторы цикла, как это показано в нижеследующем примере
Пример.
function [s, varargout] = mysize(x)
nout = max(nargout, 1)-1;
s = size(x);
for i=1:nout,
varargout(i) =
end
Здесь с использованием цикла объединуны все выходные аргументы, начиная со второго в одну переменную varargout.
[s, rows, cols, pages] = mysize(rand(4, 5, 3));
s = [4 5 3], rows = 4, cols = 5, pages = 3.
Сопутствующие функции: VARARGIN, NARGIN, NARGOUT, FUNCTION, LISTS.
Исправляем ошибки: Нашли опечатку? Выделите ее мышкой и нажмите Ctrl+Enter