_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
クリックし _mbsspnp
、.. の文字 str
セットに属していない最初の文字 charset
へのポインターを返します。 これらの各関数は、次のNULL
文字charset
で構成されている場合str
に返されます。 これらのルーチンでは、エラーを示す戻り値は予約されていません。
解説
この関数は _mbsspnp
、内の文字セットに属していない最初の文字 str
であるマルチバイト文字へのポインターを返します charset
。 _mbsspnp
関数は、現在使用中のマルチバイト コード ページに基づいて、マルチバイト文字列を認識します。 検索には、終端の null 文字は含まれません。
null ポインターのcharset
str
場合は、「パラメーターの検証」で説明されているように、この関数は無効なパラメーター ハンドラーを呼び出します。 実行の継続が許可された場合、関数は NULL
を返し、errno
を EINVAL
に設定します。
既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。
汎用テキスト ルーチンのマップ
Tchar.h のルーチン | _UNICODE と _MBCS が定義されていない |
_MBCS が定義されている |
_UNICODE が定義されている |
---|---|---|---|
_tcsspnp |
_strspnp |
_mbsspnp |
_wcsspnp |
_strspnp
と _wcsspnp
はそれぞれ、_mbsspnp
の 1 バイト文字バージョンとワイド文字バージョンです。 _strspnp
それ以外の場合と _wcsspnp
同じように _mbsspnp
動作します。これらは、このマッピングに対してのみ提供され、他の理由で使用しないでください。 詳細については、「汎用テキスト マッピングと汎用テキスト マッピングの使用」を参照してください。
_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
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示