Name=Value в вызовах функции

Начиная с R2021a

MATLAB® поддержки два синтаксиса для передающих аргументов name-value.

plot(x,y,LineWidth=2) синтаксис name=value

plot(x,y,"LineWidth",2) разделенный от запятой синтаксис

Используйте name=value синтаксис, чтобы помочь идентифицировать аргументы name-value для функций и ясно отличить имена от значений в списках аргументов name-value.

Большинство функций и методов поддерживают оба синтаксиса, но существуют некоторые ограничения на где и как name=value синтаксис может использоваться:

  • Смешивание name,value и name=value синтаксисы: методические рекомендации должны использовать только один синтаксис в любом вызове заданной функции. Однако, если вы действительно смешиваете name=value и name,value синтаксисы в одном вызове, всем name=value аргументы должны появиться после name,value аргументы. Например, plot(x,y,"Color","red",LineWidth=2) допустимая комбинация, но plot(x,y,Color="red","LineWidth",2) ошибки.

  • Используя позиционные параметры после аргументов name-value: Некоторые функции имеют позиционные параметры, которые появляются после аргументов name-value. Например, этот вызов verifyEqual метод использует RelTol аргумент значения имени, сопровождаемый строкой, ввел:

    verifyEqual(testCase,1.5,2,"RelTol",0.1,...
        "Difference exceeds relative tolerance.")
    Используя name=value синтаксис (RelTol=0.1) вызывает оператор к ошибке. В случаях, где позиционный параметр следует за аргументами name-value, используйте name,value синтаксис.

  • Имена, которые являются недопустимыми именами переменных: Аргументы name-value с именами, которые являются недопустимыми именами переменной MATLAB, не могут использоваться с name=value синтаксис. Смотрите Имена переменных для большего количества информации. Например, аргумент значения имени как "allow-empty",true ошибки, если передано как allow-empty=true. Используйте name,value синтаксис в этих случаях.

Функциональные авторы не должны кодировать по-другому, чтобы поддержать обоих name,value и name=value синтаксисы. Для получения информации об авторской разработке функций, которые принимают аргументы name-value, смотрите Аргументы name-value.

Для просмотра документации необходимо авторизоваться на сайте