_mbsspnp、_mbsspnp_l、_strspnp、_wcsspnp
更新 : 2007 年 11 月
指定した一方の文字列の文字のうち、もう一方の文字列にはない最初の文字へのポインタを返します。
unsigned char *_mbsspnp(
const unsigned char *str,
const unsigned char *charset
);
unsigned char *_mbsspnp_l(
const unsigned char *str,
const unsigned char *charset,
_locale_t locale
);
char *_strspnp(
const char *str,
const char *charset
);
wchar_t *_wcsspnp(
const unsigned wchar_t *str,
const unsigned wchar_t *charset
);
パラメータ
str
NULL で終わる検索対象の文字列。charset
NULL で終わる文字セット。locale
使用するロケール。
戻り値
_strspnp、_wcsspnp、および _mbsspnp は、charset の文字セットに含まれない str の最初の文字へのポインタを返します。str が charset に含まれる文字のみで構成されている場合、各関数は NULL を返します。これらのルーチンでは、エラーを示す戻り値は予約されていません。
解説
_mbsspnp 関数は、charset の文字セットに含まれないマルチバイト文字 (str の最初の文字) へのポインタを返します。_mbsspnp は、現在使用されている マルチバイト コード ページ に基づいて、マルチバイト文字シーケンスを認識します。検索には、終端の NULL 文字は含まれません。
str または charset が null ポインタの場合、この関数は、「パラメータの検証」に説明されているように、無効なパラメータ ハンドラを呼び出します。実行の継続が許可された場合、関数は NULL を返し、errno を EINVAL に設定します。
汎用テキスト ルーチンのマップ
Tchar.h のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
---|---|---|---|
_tcsspnp |
_strspnp |
_mbsspnp |
_wcsspnp |
_strspnp と _wcsspnp は、それぞれ _mbsspnp の 1 バイト文字バージョンとワイド文字バージョンです。それ以外については、_strspnp と _wcsspnp の動作は _mbsspnp にとって同じです。これらはこの割り当てにのみ使用し、その他の場合には使用しないでください。詳細については、「汎用テキスト マップの使用」および「汎用テキスト マップ」を参照してください。
_mbsspnp_lは、代わりに渡されるロケール パラメータを使用することを除いて同じです。詳細については、「ロケール」を参照してください。
必要条件
ルーチン |
必須ヘッダー |
---|---|
_mbsspnp |
<mbstring.h> |
_strspnp |
<tchar.h> |
_wcsspnp |
<tchar.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
// crt_mbsspnp.c
#include <mbstring.h>
#include <stdio.h>
int main( void ) {
const unsigned char string1[] = "cabbage";
const unsigned char string2[] = "c";
unsigned char *ptr = 0;
ptr = _mbsspnp( string1, string2 );
printf( "%s\n", ptr);
}
出力
abbage
.NET Framework の相当するアイテム
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。
参照
参照
strspn、wcsspn、_mbsspn、_mbsspn_l
strncat、_strncat_l、wcsncat、wcsncat_l、_mbsncat、_mbsncat_l
strncmp、wcsncmp、_mbsncmp、_mbsncmp_l
strncpy、_strncpy_l、wcsncpy、_wcsncpy_l、_mbsncpy、_mbsncpy_l
_strnicmp、_wcsnicmp、_mbsnicmp、_strnicmp_l、_wcsnicmp_l、_mbsnicmp_l