contains

Determine if string contains substring

Since R2021b

Syntax

tf = contains(str,substr)

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

Description

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

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

Note

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

Examples

Determine if String Contains Substring

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

str = "Hello, world!";
substr = "World";
x = contains(str,substr);

Determine if String Contains Substring While Ignoring Case

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

str = "Hello, world!";
substr = "World";
x = contains(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 Through Stateflow Structures.

Version History

Introduced in R2021b