Main Content

Define String Scalar Inputs

You can define string scalar inputs at the command line or in the MATLAB® Coder™ app. Programmatic specification of string scalar input types by using preconditioning (assert statements) is not supported.

Define String Scalar Types at the Command Line

To define string scalar inputs at the command line, use one of these procedures:

Alternatively, if you have a test file that calls your entry-point function with example inputs, you can determine the input types by using coder.getArgTypes.

Provide an Example String Scalar Input

To provide an example string scalar to codegen, use the -args option:

codegen myFunction -args {"Hello, world"}

Provide a String Scalar Type

To provide a type for a string scalar to codegen:

  1. Define a string scalar. For example:

    s = "mystring";

  2. Create a type from s.

    t = coder.typeof(s);

  3. Pass the type to codegen by using the -args option.

    codegen myFunction -args {t}

Provide a Constant String Scalar Input

To specify that a string scalar input is constant, use coder.Constant with the -args option:

codegen myFunction -args {coder.Constant("Hello, world")}

Provide a Variable-Size String Scalar Input

To specify that a string scalar input has a variable-size:

  1. Define a string scalar. For example:

    s = "mystring";

  2. Create a type from s.

    t = coder.typeof(s);

  3. Assign the StringLength property of the type the upper bound of the string length and set VariableStringLength to true. For example, specify that type t is variable-size with an upper bound of 10.

    t.StringLength = 10;
    t.VariableStringLength = true;

    To specify that t is variable-size with no upper bound:

    t.StringLength = Inf;
    This automatically sets the VariableStringLength property to true.

  4. Pass the type to codegen by using the -args option.

    codegen myFunction -args {t}

Define String Scalar Inputs in the MATLAB Coder App

To define string scalar inputs in the app, use one of these procedures:

See Also

| |

Related Topics