matches

Determine if two strings match in Stateflow chart

Since R2021b

Syntax

tf = matches(str1,str2)

tf = matches(str1,str2,IgnoreCase=true)

Description

tf = matches(str1,str2) compares the strings str1 and str2. The operator returns 1 (true) if the strings are identical, and returns 0 (false) otherwise.

tf = matches(str1,str2,IgnoreCase=true) compares strings str1 and str2, ignoring any differences in letter case.

Note

The matches operator is not supported in Stateflow^® charts that use C as the action language. For similar functionality, use strcmp.

Examples

Compare Strings

Return a value of 0 (false) because the strings do not match.

str1 = "Hello, world!";
str2 = "hello, World!";
x = matches(str1,str2);

Compare Strings While Ignoring Case

Return a value of 1 (true) because the strings match when you ignore case.

str1 = "Hello, world!";
str2 = "hello, World!";
x = matches(str1,str2,IgnoreCase=true);

Input Arguments

str1, str2 — Input strings

string scalar

Input strings, specified as string scalars. Enclose literal string 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