_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_lwcsncat_s、_wcsncat_s_l、、_mbsncat_s、_mbsncat_s_l
strncmp、 、 wcsncmp、 _mbsncmp_mbsncmp_l
strncpy_s、、_strncpy_s_lwcsncpy_s、_wcsncpy_s_l、、_mbsncpy_s、_mbsncpy_s_l
_strnicmp、、_wcsnicmp_mbsnicmp、_strnicmp_l、、_wcsnicmp_l、_mbsnicmp_l
strrchr、 、 wcsrchr、 _mbsrchr_mbsrchr_l