strncmp

Compare first N characters of strings (case sensitive)

Since R2021b

Syntax

tf = strncmp(str1,str2,n)

Description

tf = strncmp(str1,str2,n) compares the first n characters of str1 and str2. The operator returns 1 (true) if the strings are identical and 0 (false) otherwise.

Note

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

Examples

Compare First N Characters of Strings

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

str1 = "Hello, world!";
str2 = "Hello, world!!!!!!!!!!!!";
x = strncmp(str1,str2,13);
y = strncmp(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