strncmpi

Compare first N characters of strings (case insensitive)

Since R2021b

Syntax

tf = strncmpi(str1,str2,n)

Description

tf = strncmpi(str1,str2,n) compares the first n characters of str1 and str2, ignoring any differences in letter case. The operator returns 1 (true) if the strings are identical and 0 (false) otherwise.

Note

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

Examples

Compare First N Characters While Ignoring Case

Set x to 1 (true) because the first 13 characters in the strings match when you ignore case. Set y to 0 (false) because the first 14 characters in the strings do not match.

str1 = "Hello, world!";
str2 = "hello, World!!!!!!!!!!!!";
x = strncmpi(str1,str2,13);
y = strncmpi(str1,str2,14);

Input Arguments

str1, str2 — Input strings

string scalar

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

Example: "Hello"

n — Number of characters checked

positive integer

Number of characters checked, starting at the beginning of each string, specified as a positive integer.

Limitations

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

Version History

Introduced in R2021b