Main Content

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

Definiciones de argumentos

Acepte un número variable de entradas y salidas, y compruebe los valores válidos

Puesto que MATLAB® es un lenguaje sin tipificar, la mayoría de las funciones no requieren declaraciones o validación del argumento. Sin embargo, si la función tiene un uso amplio y necesita verificar el tipo, el tamaño u otros aspectos de las entradas para garantizar que el código funciona según lo previsto, puede definir un bloque de arguments (desde la versión R2019b). Para obtener más detalles, consulte Function Argument Validation.

Además, puede comprobar cuántas entradas o salidas recibe la función, los nombres de las variables de entrada y mucho más.

Funciones

expandir todo

Bloque de argumentos

argumentsDeclare function argument validation

Validación de valores numéricos

mustBePositiveValidate that value is positive
mustBeNonpositiveValidate that value is nonpositive
mustBeNonnegativeValidate that value is nonnegative
mustBeNegativeValidate that value is negative
mustBeFiniteValidate that value is finite
mustBeNonNanValidate that value is not NaN
mustBeNonzeroValidate that value is nonzero
mustBeNonsparseValidate that value is nonsparse
mustBeRealValidate that value is real
mustBeIntegerValidate that value is integer
mustBeNonmissingValidate that value is not missing

Comparaciones

mustBeGreaterThanValidate that value is greater than another value
mustBeLessThanValidate that value is less than another value
mustBeGreaterThanOrEqualValidate that value is greater than or equal to another value
mustBeLessThanOrEqualValidate that value is less than or equal to another value

Tipos de datos

mustBeAValidate that value comes from one of specified classes
mustBeNumericValidate that value is numeric
mustBeNumericOrLogicalValidate that value is numeric or logical
mustBeFloatValidate that value is floating-point array
mustBeTextValidate that value is string array, character vector, or cell array of character vectors
mustBeTextScalarValidate that value is single piece of text
mustBeNonzeroLengthTextValidate that value is text with nonzero length
mustBeUnderlyingTypeValidate that value has specified underlying type

Tamaño

mustBeNonemptyValidate that value is nonempty
mustBeScalarOrEmptyValidate that value is scalar or empty
mustBeVectorValidate that value is vector

Pertenencia de intervalos y conjuntos

mustBeInRangeValidate that value is in the specified range
mustBeMemberValidate that value is member of specified set

Nombres

mustBeFileValidate that path refers to file
mustBeFolderValidate that input path refers to folder
mustBeValidVariableNameValidate that input name is valid variable name

Estructura de argumentos nombre-valor

namedargs2cellConvert structure containing name-value pairs to cell array

Entradas

vararginVariable-length input argument list
narginNumber of function input arguments
narginchkValidate number of input arguments

Salidas

varargoutVariable-length output argument list
nargoutNumber of function output arguments
nargoutchkValidate number of output arguments
validateattributesCheck validity of array
validatestringCheck validity of text
validatecolorValidate color values
inputnameVariable name of function input
mfilenameFile name of currently running code
inputParserInput parser for functions

Temas

Valores de argumentos

Ways to Parse Function Inputs

Choose a technique for checking the validity of input arguments.

Function Argument Validation

Declare input argument class and size and enforce restrictions on argument values.

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.

Número de argumentos

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.

Buscar el número de argumentos de funciones

Utilice nargin y nargout para determinar cuántos argumentos de entrada o de salida recibe la función.

Ignorar entradas

Ignorar entradas en definiciones de funciones

Si la función acepta un conjunto predefinido de entradas, pero no utiliza todas las entradas, utilice el operador de tilde (~) para ignorarlas en la definición de función.