_strspnp、 _wcsspnp、 _mbsspnp、 _mbsspnp_l
特定の文字列内の、別の特定の文字列に含まれていない最初の文字へのポインターを返します。
重要
_mbsspnp および _mbsspnp_l は、Windows ランタイムで実行するアプリケーションでは使用できません。 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない CRT 関数」を参照してください。
構文
char *_strspnp(
const char *str,
const char *charset
);
wchar_t *_wcsspnp(
const unsigned wchar_t *str,
const unsigned wchar_t *charset
);
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
);
パラメーター
str
NULL で終わる検索対象の文字列。
charset
NULL で終わる文字セット。
locale
使用するロケール。
戻り値
_strspnp、_wcsspnp、および_mbsspnpcharsetの文字セットに属していないstrの最初の文字へのポインターを返します。 これらの各関数は、strがcharsetの文字で完全に構成されている場合、NULLを返します。 これらのルーチンでは、エラーを示す戻り値は予約されていません。
解説
_mbsspnp関数は、charsetの文字セットに属していないstrの最初の文字であるマルチバイト文字へのポインターを返します。 _mbsspnp 関数は、現在使用中のマルチバイト コード ページに基づいて、マルチバイト文字列を認識します。 検索には、終端の null 文字は含まれません。
strまたはcharsetが null ポインターの場合、この関数は、「パラメーターの検証」で説明されているように、無効なパラメーター ハンドラー呼び出。 実行の継続が許可された場合、関数は NULL を返し、errno を EINVAL に設定します。
既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。
汎用テキスト ルーチンのマップ
| Tchar.h のルーチン | _UNICODE と _MBCS が定義されていない |
_MBCS が定義されている |
_UNICODE が定義されている |
|---|---|---|---|
_tcsspnp |
_strspnp |
_mbsspnp |
_wcsspnp |
_strspnp と _wcsspnp はそれぞれ、_mbsspnp の 1 バイト文字バージョンとワイド文字バージョンです。 _strspnp_wcsspnpは_mbsspnpと同じように動作します。それ以外の場合は、このマッピングに対してのみ提供されるため、他の理由で使用しないでください。 詳細については、「 汎用テキスト マッピングの使用 および Generic-text マッピングの使用を参照してください。
_mbsspnp_l は、代わりに渡されるロケール パラメーターを使用することを除いて同じものです。 詳細については、「 Locale」を参照してください。
要件
| ルーチンによって返される値 | 必須ヘッダー |
|---|---|
_mbsspnp |
<mbstring.h> |
_strspnp |
<tchar.h> |
_wcsspnp |
<tchar.h> |
互換性の詳細については、「 Compatibility」を参照してください。
例
// 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
関連項目
文字列操作
ロケール
マルチバイト文字のシーケンスの解釈
strspn、 wcsspn、 _mbsspn、 _mbsspn_l
strncat_s、 _strncat_s_l、 wcsncat_s、 _wcsncat_s_l、 _mbsncat_s、 _mbsncat_s_l
strncmp、 wcsncmp、 _mbsncmp、 _mbsncmp_l
strncpy_s、 _strncpy_s_l、 wcsncpy_s、 _wcsncpy_s_l、 _mbsncpy_s、 _mbsncpy_s_l
_strnicmp、 _wcsnicmp、 _mbsnicmp、 _strnicmp_l、 _wcsnicmp_l、 _mbsnicmp_l
strrchr、 wcsrchr、 _mbsrchr、 _mbsrchr_l