La traducción de esta página está obsoleta. Haga clic aquí para ver la última versión en inglés.

Argumentos de entrada y salida

Admitir listas de argumentos de longitud variable, comprobar argumentos, declarar argumentos de validación

Las funciones pueden aceptar números variables de entradas y salidas mediante una sola firma de función. MATLAB^® ofrece numerosas técnicas para comprobar el número, el tipo, el tamaño y otros aspectos de las entradas para garantizar que las funciones funcionan como se espera, para proporcionar mensajes de error útiles en los casos en que las entradas no sean válidas.

Funciones

expandir todo

Lista de argumentos variables

`nargin`	Number of function input arguments
`nargout`	Number of function output arguments
`varargin`	Variable-length input argument list
`varargout`	Variable-length output argument list

Comprobar argumentos

`narginchk`	Validate number of input arguments
`nargoutchk`	Validate number of output arguments
`validateattributes`	Check validity of array
`validatestring`	Check validity of text
`validatecolor`	Validate color values
`inputParser`	Input parser for functions
`inputname`	Variable name of function input
`mfilename`	File name of currently running code

Bloque de argumentos

`arguments`	Declare function argument validation
`namedargs2cell`	Convert structure containing name-value pairs to cell array

Funciones de validación

Validación de atributos de valor numérico

`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
`mustBeReal`	Validate that value is real
`mustBeInteger`	Validate that value is integer
`mustBeNonmissing`	Validate that value is not missing

Validación de la comparación

`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

Validación del tipo de datos

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

Validación de tamaño

`mustBeNonempty`	Validate that value is nonempty
`mustBeScalarOrEmpty`	Validate that value is scalar or empty
`mustBeVector`	Validate that value is vector

Validación de miembros y rango

`mustBeMember`	Validate that value is member of specified set
`mustBeInRange`	Validate that value is in the specified range

Texto con validación de significado especial

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

Temas

Comprobar número de argumentos

Find Number of Function Arguments

Use nargin and nargout to determine how many input or output arguments your function receives.

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.

Validate Number of Function Arguments

Check if your custom function receives a valid number of input or output arguments. MATLAB performs some argument checks automatically. For other cases, you can use narginchk or nargoutchk.

Checking Number of Arguments in Nested Functions

There are special considerations for using varargin, varargout, nargin, and nargout with nested functions.

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.

Ignorar los valores de salida de una función

Este ejemplo muestra cómo solicitar valores de salida específicos de una función.