Анализ входных параметров функции
parse(p,argList)
анализирует и подтверждает входные параметры в parse(p,argList)
arglist
.
Создайте входную схему синтаксического анализатора, которая проверяет, что необходимый входной параметр является неотрицательным, числовым скаляром. Синтаксис @(x)
создает указатель на анонимную функцию с одним входным параметром.
p = inputParser;
argName = 'num';
validationFcn = @(x) (x > 0) && isnumeric(x) && isscalar(x);
addRequired(p,argName,validationFcn)
Проанализируйте недопустимый входной параметр, такой как -1
:
parse(p,-1)
The value of 'num' is invalid. It must satisfy the function: @(x)(x>0)&&isnumeric(x)&&isscalar(x).
Проанализируйте и подтвердите требуемые и дополнительные входные параметры функции.
Создайте функцию в файле findArea.m
m. Функция findArea
требует входного параметра width
и принимает переменное количество дополнительных входных параметров. Входная схема синтаксического анализатора задает эти условия аргумента:
width
(обязательный аргумент). Поскольку обязательные аргументы позиционны, width
должен быть первым аргументом к функции findArea
. Входной синтаксический анализатор проверяет, что width
является положительным, скалярным, и числовым.
height
(дополнительный аргумент). Поскольку дополнительные аргументы позиционны, если height
является аргументом к функции findArea
, то это должен быть второй аргумент. Входной синтаксический анализатор проверяет, что height
является положительным, скалярным, и числовым.
'units'
и его присваиваемое значение (пара "имя-значение"). Пары "имя-значение" являются дополнительными. Когда вы вызываете функцию findArea
, задаете пары "имя-значение" в любом порядке после позиционных параметров. Входной синтаксический анализатор проверяет, что значение для 'units'
является строкой.
'shape'
и его присваиваемое значение (другая пара "имя-значение"). Входной синтаксический анализатор проверяет, что значение для 'shape'
содержится в массиве expectedShapes
.
function a = findArea(width,varargin) defaultHeight = 1; defaultUnits = 'inches'; defaultShape = 'rectangle'; expectedShapes = {'square','rectangle','parallelogram'}; p = inputParser; validScalarPosNum = @(x) isnumeric(x) && isscalar(x) && (x > 0); addRequired(p,'width',validScalarPosNum); addOptional(p,'height',defaultHeight,validScalarPosNum); addParameter(p,'units',defaultUnits,@isstring); addParameter(p,'shape',defaultShape,... @(x) any(validatestring(x,expectedShapes))); parse(p,width,varargin{:}); a = p.Results.width*p.Results.height; end
Вызывайте функцию findArea
несколько раз. Входной синтаксический анализатор не выдает ошибку ни для одного из этих вызовов функции.
a = findArea(7); a = findArea(7,3); a = findArea(13,'shape','square'); a = findArea(13,'units',"miles",'shape','square');
Вызовите функцию с аргументами, которые не совпадают с входной схемой синтаксического анализатора. Задайте нечисловое значение для входного параметра width
:
a = findArea('text')
Error using findArea (line 14) The value of 'width' is invalid. It must satisfy the function: @(x)isnumeric(x)&&isscalar(x)&&(x>0).
Задайте неподдерживаемое значение для 'shape'
.
a = findArea(4,12,'shape','circle')
Error using findArea (line 14) The value of 'shape' is invalid. Expected input to match one of these values: 'square', 'rectangle', 'parallelogram' The input, 'circle', did not match any of the valid values.
p
Введите схему синтаксического анализатораinputParser
Введите схему синтаксического анализатора, заданную как объект inputParser
.
argList
Вводы, чтобы проанализировать и подтвердитьВводы, чтобы проанализировать и подтвердить, заданный как список, разделенный запятыми. Элементы argList
могут быть любым типом данных. Входной синтаксический анализатор определяет законность аргумента с помощью функции валидации, которую вы задали, когда вы добавили аргументы к входной схеме синтаксического анализатора.
Пример: 'textA', 13, mtxB
Пример: varargin:}
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.