このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

strncmp

string の先頭 N 文字の比較 (大文字小文字を区別する)

R2021b 以降

構文

tf = strncmp(str1,str2,n)

説明

tf = strncmp(str1,str2,n) は、str1 と str2 の先頭 n 文字を比較します。演算子は、string が同一の場合は 1 (true) を返し、それ以外の場合は 0 (false) を返します。

メモ

演算子 strncmp は、C をアクション言語として使用する Stateflow^® チャートではサポートされません。同様の機能として、strcmp を使用します。

例

string の先頭 N 文字の比較

各 string の先頭 13 文字が一致するため、x は 1 (true) に設定されます。各 string の先頭 14 文字が一致しないため、y は 0 (false) に設定されます。

str1 = "Hello, world!";
str2 = "Hello, world!!!!!!!!!!!!";
x = strncmp(str1,str2,13);
y = strncmp(str1,str2,14);

入力引数

str1, str2 — 入力 string

string スカラー

入力 string。string スカラーとして指定します。リテラル文字列は二重引用符で囲みます。

例: "Hello"

n — チェック対象の文字数

正の整数

チェック対象となる各 string の先頭からの文字数。正の整数として指定します。

制限

• この演算子は Stateflow の構造体フィールドまたはメッセージの使用をサポートしません。Stateflow での構造体の詳細については、Stateflow 構造体を介したバス信号へのアクセスを参照してください。

バージョン履歴

R2021b で導入

参考

matches | strcmp | strcmpi | strncmpi

トピック

• string を使用したテキスト情報の管理
• カスタム C コードとの string データの共有