OpenVMS マニュアル

strncmp

2 つの ASCII 文字列の間で maxchar 個以下の文字を比較し，第 1 の文字列に含まれる個々の文字の ASCII 値が第 2 の文字列の値よりも小さい，等しい，または大きいことを示す負の整数，0，または正の整数を返します。

形式

#include <string.h>

int strncmp (const char *str_1, const char *str_2, size_t maxchar);

引数

str_1, str_2

文字列へのポインタ。

maxchar

str_1 と str_2 の両方で検索する文字数の上限 ( 最初の文字を含みます )。maxchar が 0 の場合には，比較は行われず，0 が返されます (文字列は等しいものと見なされます)。

説明

strncmp関数は， str_1 がポイントする文字列の maxchar 個以下の文字を， str_2 がポイントする文字列と比較します。文字列の比較は，null 文字が検出されるか，文字列に違いが発見されるか， maxchar に達するまで行われます。違いが発見された後の文字や null 文字の後の文字は比較されません。

戻り値

< 0	str_1 が str_2 よりも小さいことを示します。
= 0	str_1 が str_2 と等しいことを示します。
> 0	str_1 が str_2 よりも大きいことを示します。

例

#include <string.h> 
#include <stdio.h> 
 
main() 
{ 
    printf( "%d\n", strncmp("abcde", "abc", 3)); 
} 
 

この例をリンクして実行すると，2 つの文字列の先頭の 3 文字が等しいため， 0 が返されます。

$ run tmp 0

#include <string.h> 
#include <stdio.h> 
 
    main() 
    { 
        printf( "%d\n", strncmp("abcde", "abc", 4)); 
    } 
 

この例をリンクして実行すると，2 つの文字列の先頭の 4 文字は等しくないため， 0 よりも大きい値が返されます (第 1 の文字列の "d" が，第 2 の文字列の null 文字と等しくありません)。

$ run tmp 100