_strspnp, _wcsspnp, _mbsspnp, _mbsspnp_l

傳回指定字串中不在另一個指定字串中的第一個字元指標。

重要

在 Windows 執行階段中執行的應用程式中無法使用 _mbsspnp 和 _mbsspnp_l。 如需詳細資訊，請參閱 CRT functions not supported in Universal Windows Platform apps (通用 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 字元集。 如果 str 由 完全來自 的字元 charset 所組成，則每個函式都會傳回 NULL 。 針對所有這些函式，不保留任何表示錯誤的傳回值。

備註

函 _mbsspnp 式會傳回多位元組字元的指標，該字元是 中 str 不屬於 字元集的第 charset 一個字元。 _mbsspnp 根據目前使用的多位元組字碼頁來辨識多位元組字元序列。 搜尋不包含終止 Null 字元。

str如果 或 charset 為 Null 指標，此函式會叫用不正確參數處理常式，如參數驗證 中所述 。 如果允許繼續執行，函式會傳回 NULL，並將 errno 設為 EINVAL。

根據預設，此函式的全域狀態會限定于應用程式。 若要變更此行為，請參閱 CRT 中的全域狀態。

泛型文字常式對應

Tchar.h 常式	_UNICODE 和 _MBCS 未定義	_MBCS 定義	_UNICODE 定義
_tcsspnp	_strspnp	_mbsspnp	_wcsspnp

_strspnp 和 _wcsspnp 是 _mbsspnp 的單一位元組字元版本和寬字元版本。 _strspnp 和 _wcsspnp 的行為與其他 _mbsspnp 相同;它們僅針對此對應提供，且不應該用於任何其他原因。 如需詳細資訊，請參閱 使用泛型文字對應 和 泛型文字對應 。

_mbsspnp_l 也相同，但是它會改用傳入的地區設定參數。 如需詳細資訊，請參閱 Locale。

需求

常式	必要的標頭
_mbsspnp	<mbstring.h>
_strspnp	<tchar.h>
_wcsspnp	<tchar.h>

如需相容性詳細資訊，請參閱相容性。

範例

// 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