Definition von Argumenten

Eine variable Anzahl von Eingaben oder Ausgaben akzeptieren, auf gültige Werte prüfen

Da MATLAB^® eine schwach typisierte Sprache ist, erfordern die meisten Funktionen keine Argumentdeklarationen oder -validierung. Wenn Ihre Funktion jedoch breit genutzt wird und Sie den Typ, die Größe oder andere Aspekte von Eingaben überprüfen möchten, um sicherzustellen, dass Ihr Code wie erwartet funktioniert, können Sie einen arguments-Block definieren (seit R2019b). Weitere Informationen finden Sie unter Function Argument Validation.

Zusätzlich können Sie prüfen, wie viele Eingaben oder Ausgaben Ihre Funktion empfängt, die Namen der Eingabevariablen und mehr.

Funktionen

alle erweitern

Deklaration und Validierung von Argumenten

Argument-Block

arguments Declare function argument validation (Seit R2019b)

Validieren von numerischen Werten

`mustBePositive`	Validate that value is positive
`mustBeNonpositive`	Validate that value is nonpositive
`mustBeNonnegative`	Validate that value is nonnegative
`mustBeNegative`	Validate that value is negative
`mustBeFinite`	Validate that value is finite
`mustBeNonNan`	Validate that value is not NaN
`mustBeNonzero`	Validate that value is nonzero
`mustBeNonsparse`	Validate that value is nonsparse
`mustBeSparse`	Validate that value is sparse (Seit R2023b)
`mustBeReal`	Validate that value is real
`mustBeInteger`	Validate that value is integer
`mustBeNonmissing`	Validate that value is not missing (Seit R2020b)

Vergleiche

`mustBeGreaterThan`	Validate that value is greater than another value
`mustBeLessThan`	Validate that value is less than another value
`mustBeGreaterThanOrEqual`	Validate that value is greater than or equal to another value
`mustBeLessThanOrEqual`	Validate that value is less than or equal to another value

Datentypen

`mustBeA`	Validate that value comes from one of specified classes (Seit R2020b)
`mustBeNumeric`	Validate that value is numeric
`mustBeNumericOrLogical`	Validate that value is numeric or logical
`mustBeFloat`	Validate that value is floating-point array (Seit R2020b)
`mustBeText`	Validate that value is string array, character vector, or cell array of character vectors (Seit R2020b)
`mustBeTextScalar`	Validate that value is single piece of text (Seit R2020b)
`mustBeNonzeroLengthText`	Validate that value is text with nonzero length (Seit R2020b)
`mustBeUnderlyingType`	Validate that value has specified underlying type (Seit R2020b)

Größe

`mustBeNonempty`	Validate that value is nonempty
`mustBeScalarOrEmpty`	Validate that value is scalar or empty (Seit R2020b)
`mustBeVector`	Validate that value is vector (Seit R2020b)

Bereichs- und Satz-Zugehörigkeit

`mustBeInRange`	Validate that value is in the specified range (Seit R2020b)
`mustBeMember`	Validate that value is member of specified set

Namen

`mustBeFile`	Validate that path refers to file (Seit R2020b)
`mustBeFolder`	Validate that input path refers to folder (Seit R2020b)
`mustBeValidVariableName`	Validate that input name is valid variable name (Seit R2020b)

Name-Wert-Argumentstruktur

namedargs2cell Convert structure containing name-value pairs to cell array (Seit R2019b)

Argumentlisten mit variabler Länge

Eingaben

`varargin`	Variable-length input argument list
`nargin`	Number of function input arguments
`narginchk`	Validate number of input arguments

Ausgaben

`varargout`	Variable-length output argument list
`nargout`	Number of function output arguments
`nargoutchk`	Validate number of output arguments

Zusätzliche Prüfungen

`validateattributes`	Check validity of array
`validatestring`	Check validity of text
`validatecolor`	Validate color values (Seit R2020b)
`inputname`	Variable name of function input
`mfilename`	Filename of currently running code
`inputParser`	Input parser for functions

Themen

Validierung von Argumenten

Function Argument Validation

Declare argument class and size, and enforce restrictions on argument values.
Argument Validation Functions

Validate specific requirements of arguments using validation functions. Write your own functions to check for specific argument requirements.
- Use Validation Functions to Avoid Unwanted Class and Size Conversions
- Use nargin Functions During Argument Validation
Check Function Inputs with validateattributes
This example shows how to verify that the inputs to your function conform to a set of requirements using the validateattributes function.
Parse Function Inputs

Define required and optional inputs, assign defaults to optional inputs, and validate all inputs to a custom function using the Input Parser.
- Input Parser Validation Functions

Anzahl von Argumenten

Support Variable Number of Inputs
Define a function that accepts a variable number of input arguments using varargin. The varargin argument is a cell array that contains the function inputs, where each input is in its own cell.
Support Variable Number of Outputs
Define a function that returns a variable number of output arguments using varargout. Output varargout is a cell array that contains the function outputs, where each output is in its own cell.
Find Number of Function Arguments

Use nargin and nargout to determine how many input or output arguments your function receives.
- Validate Number of Function Arguments
- Checking Number of Arguments in Nested Functions

Ignorierte Eingaben

Ignore Inputs in Function Definitions
If your function accepts a predefined set of inputs, but does not use all the inputs, use the tilde (~) operator to ignore them in your function definition.