startsWith

Determine if string starts with substring in Stateflow chart

Since R2021b

Syntax

tf = startsWith(str,substr)

tf = startsWith(str,substr,IgnoreCase=true)

Description

tf = startsWith(str,substr) returns 1 (true) if the string str starts with the substring substr, and returns 0 (false) otherwise.

tf = startsWith(str,substr,IgnoreCase=true) checks if str starts with substr, ignoring any differences in letter case.

Note

The startsWith operator is not supported in Stateflow^® charts that use C as the action language.

Examples

Determine If String Starts with Substring

Return a value of 0 (false) because the string "Hello, world!" does not start with the substring "hello".

str = "Hello, world!";
substr = "hello";
x = startsWith(str,substr);

Determine If String Starts with Substring While Ignoring Case

Return a value of 1 (true) because the string "Hello, world!" starts with the substring "hello" when you ignore case.

str = "Hello, world!";
substr = "hello";
x = startsWith(str,substr,IgnoreCase=true);

Input Arguments

str — Input string

string scalar

Input string, specified as a string scalar. Enclose literal strings with double quotes.

Example: "Hello"

substr — Substring

string scalar

Substring, specified as a string scalar. Enclose literal strings with double quotes.

Example: "Hello"

Limitations

• This operator does not support the use of Stateflow structure fields or messages. For more information about structures in Stateflow, see Access Bus Signals.

Version History

Introduced in R2021b