Main Content

La traduction de cette page n'est pas à jour. Cliquez ici pour voir la dernière version en anglais.

Définitions d’arguments

Accepter un nombre variable d’entrées ou de sorties et vérifier la validité des valeurs

Étant donné que MATLAB® est un langage non typé, la plupart des fonctions ne nécessitent pas de déclaration ni de validation d’argument. Cependant, si votre fonction est largement utilisée et que vous avez besoin de vérifier le type, la taille ou d’autres aspects des entrées pour vous assurer que votre code fonctionne comme prévu, vous pouvez définir un bloc arguments (depuis la version R2019b). Pour de plus amples informations, veuillez consulter Function Argument Validation.

Vous pouvez également vérifier le nombre d’entrées ou de sorties reçues par votre fonction, le nom des variables en entrée et d’autres éléments.

Fonctions

développer tout

Bloc arguments

argumentsDeclare function argument validation (depuis R2019b)

Validation des valeurs numériques

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 (depuis R2020b)

Comparaisons

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

Types de données

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

Taille

mustBeNonemptyValidate that value is nonempty
mustBeScalarOrEmptyValidate that value is scalar or empty (depuis R2020b)
mustBeVectorValidate that value is vector (depuis R2020b)

Plage de valeurs et appartenance à un ensemble

mustBeInRangeValidate that value is in the specified range (depuis R2020b)
mustBeMemberValidate that value is member of specified set

Noms

mustBeFileValidate that path refers to file (depuis R2020b)
mustBeFolderValidate that input path refers to folder (depuis R2020b)
mustBeValidVariableNameValidate that input name is valid variable name (depuis R2020b)

Structure d’arguments nom-valeur

namedargs2cellConvert structure containing name-value pairs to cell array (depuis R2019b)

Entrées

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

Sorties

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 (depuis R2020b)
inputnameVariable name of function input
mfilenameFile name of currently running code
inputParserInput parser for functions

Rubriques

Validation des arguments

Nombre d’arguments

Ignorer des entrées

  • 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.