次の方法で共有


_memicmp、_memicmp_l

更新 : 2007 年 11 月

2 つのバッファ内の文字を比較します。大文字と小文字は区別しません。

int _memicmp(
   const void *buf1,
   const void *buf2,
   size_t count 
);
int _memicmp_l(
   const void *buf1,
   const void *buf2,
   size_t count,
   _locale_t locale
);

パラメータ

  • buf1
    最初のバッファ。

  • buf2
    2 番目のバッファ。

  • count
    文字数。

  • locale
    使用するロケール。

戻り値

戻り値は、2 つのバッファの関係を示します。

戻り値

buf1 と buf2 の最初の count バイト数の関係

< 0

buf1 は buf2 より小さい。

0

buf1 と buf2 は等しい。

> 0

buf1 は buf2 より大きい。

_NLSCMPERROR

エラーが発生しました。

解説

_memicmp 関数は、2 つのバッファ buf1 と buf2 の最初の count 文字数をバイト単位で比較します。大文字と小文字は区別されません。

buf1 または buf2 が null ポインタの場合、この関数は、「パラメータの検証」に説明されているように、無効なパラメータ ハンドラを呼び出します。実行の継続が許可された場合、関数は _NLSCMPERROR を返し、errno を EINVAL に設定します。

_memicmp は、ロケールに依存する動作に現在のロケールを使用します。_memicmp_l は、渡されたロケールを代わりに使用することを除いて同じです。詳細については、「ロケール」を参照してください。

必要条件

ルーチン

必須ヘッダー

_memicmp

<memory.h> または <string.h>

_memicmp_l

<memory.h> または <string.h>

互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。

使用例

// crt_memicmp.c
// This program uses _memicmp to compare
// the first 29 letters of the strings named first and
// second without regard to the case of the letters.

#include <memory.h>
#include <stdio.h>
#include <string.h>

int main( void )
{
   int result;
   char first[] = "Those Who Will Not Learn from History";
   char second[] = "THOSE WHO WILL NOT LEARN FROM their mistakes";
   // Note that the 29th character is right here ^

   printf( "Compare '%.29s' to '%.29s'\n", first, second );
   result = _memicmp( first, second, 29 );
   if( result < 0 )
      printf( "First is less than second.\n" );
   else if( result == 0 )
      printf( "First is equal to second.\n" );
   else if( result > 0 )
      printf( "First is greater than second.\n" );
}

Compare 'Those Who Will Not Learn from' to 'THOSE WHO WILL NOT LEARN FROM'
First is equal to second.

.NET Framework の相当するアイテム

適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

参照

参照

バッファ操作

_memccpy

memchr、wmemchr

memcmp、wmemcmp

memcpy、wmemcpy

memset、wmemset

_stricmp、_wcsicmp、_mbsicmp、_stricmp_l、_wcsicmp_l、_mbsicmp_l

_strnicmp、_wcsnicmp、_mbsnicmp、_strnicmp_l、_wcsnicmp_l、_mbsnicmp_l