C言語関数:strncmpi





C言語のページでは、次の内容を解説しております。
C言語の入門講座  C言語の文法を中心に、基本的な関数などの解説をしています。
C言語ケーススタディ  C言語での実践的なプログラミングについて解説をしています。
C言語の関数リファレンス  C言語で用意されている関数を解説しています。
C言語で3次元動画プログラム  C言語で3次元タートルグラフィックを使用した3次元の動画プログラムの作成例です。
C言語の検定試験  C言語の文法に関する検定試験を実施することができます。
C言語でゲーム作成  C言語を使用したゲームの作り方を解説したページも用意しております。



2014年10月より個人の方を対象に、Study C無料提供を開始しました。
C言語を勉強中の方は、学習・教育に最適なC言語インタープリタのStudy Cを使ってみてください(個人の方は無料です)。
大学・高専・高校などの教育機関での採用実績も多数あるロングセラー商品Study Cが、個人向けに無料提供を始めました。
インタープリタの手軽さに加え、ゲームや3Dタートルグラフィックで楽しく勉強したりと、C言語の学習を協力にサポートします。
ブロック崩しゲーム 3Dツリー クリスマスツリー
また、このようなボタンの用意されているページでは、掲載しているプログラムをStudy Cに直接ロードし実行したりすることができます。
Study Cにロードする Study Cにロードし編集する Study Cにロードし実行する
Study C無料利用についての詳細は、このページを参照してください。




■strncmpi
英字の大小を区別せず、指定した文字数内で文字列の比較

【分類】
文字列関数

【書式】
int strncmpi(const char *s1, const char *s2, unsigned max);

【パラメータの型と説明】

パラメータ説明
const char *s1文字列1
const char *s2文字列2
unsigned max最大文字数

【機能説明】
文字列s1とs2をアスキーコード順で英文字の大文字/小文字を区別せずに比較します。ただし、比較するのはそれぞれの文字列の先頭からmax文字のみです。
比較した結果に応じて、
    s1がs2よりも小さいときは0より小さい値、
    s1とs2 が等しいときは0、
    s1がs2よりも大きいときは0より大きい値を返します。
strncmpi()関数とstrnicmp()関数は同じ機能の関数です。

UNIXやLinuxでは、strncasecmp()という関数名が使われている場合があります(この関数と同じものです)。 また、コンパイラによってstrnicmp()という関数名も使われています(これもこの関数と同じものです)。

C言語では大文字/小文字を区別や最大文字数指定の有無で次のような類似した関数が用意されています。
・英文字の大文字/小文字を区別する場合は(最大文字数を指定)、strncmp()関数を使用します。
・英文字の大文字/小文字を区別する場合は(最大文字数を指定しない)、strcmp()関数を使用します。
・英文字の大文字/小文字を区別しない場合は(最大文字数を指定)、strnicmpi()関数(本関数)、またはstrnicmp()関数を使用します。
・英文字の大文字/小文字を区別しない場合は(最大文字数を指定しない)、stricmp()関数を使用します。

Study Cを使用している場合は、下記のようにコマンドラインから実行(exprコマンドを使用)して動作を確認することができます。

C:\StudyC\MyProg>expr strncmpi("xyz", "xyz", 5)
<int>0 0x0

C:\StudyC\MyProg>expr strncmpi("abc", "ABC", 3)
<int>0 0x0

C:\StudyC\MyProg>expr strncmpi("abc", "ABD", 2)
<int>0 0

C:\StudyC\MyProg>expr strncmpi("ab", "AB0", 2)
<int>0 0

※↑カーソルキーを押すと入力したコマンドが呼び出されるので文字を変更して試してみてください。
1番目は同じ文字列なので0が返されます。
2番目は大文字/小文字を区別しなければ同じ文字列なので0が返されます。
3番目は1文字目と2文字目は同じ文字(大文字/小文字を区別しなければ)ですが3文字目が異なっています。 ただし、最大で2文字しかチェックを行わないので同一文字列と見なされ0が返されます。 4番目も3文字目が一致していませんが(文字列長が異なります)、最大で2文字しかチェックを行わないので同一文字列と見なされ0が返されます。

strncmpi()関数は、小文字は大文字に変換してから比較を行っています。 大文字から小文字に変換する場合と一部結果が異なります。 stricmp()関数で解説しているので参照してください。

通常のコンパイラを使用する場合の使用例は下記になります(もちろんStudy CでもOKです)。

#include <stdio.h>

main()
{
        printf("%d\n", strncmpi("xyz", "xyz", 5));
        printf("%d\n", strncmpi("abc", "ABC", 3));
        printf("%d\n", strncmpi("abc", "ABD", 2));
        printf("%d\n", strncmpi("ab", "AB0", 2));
}

実行結果は以下になります。
0
0
0
0

【参照関数】
strcmp
strncmp
stricmp
strnicmp