strcspn
, wcscspn
, _mbscspn
, _mbscspn_l
傳回字串中屬於字元集之第一個出現的字元索引。
重要
在 Windows 執行階段中執行的應用程式中無法使用 _mbschr
和 _mbschr_l
。 如需詳細資訊,請參閱 CRT functions not supported in Universal Windows Platform apps (通用 Windows 平台應用程式中不支援的 CRT 函式)。
語法
size_t strcspn(
const char *str,
const char *strCharSet
);
size_t wcscspn(
const wchar_t *str,
const wchar_t *strCharSet
);
size_t _mbscspn(
const unsigned char *str,
const unsigned char *strCharSet
);
size_t _mbscspn_l(
const unsigned char *str,
const unsigned char *strCharSet,
_locale_t locale
);
參數
str
以 Null 結束的搜尋字串。
strCharSet
以 Null 結束的字元集。
locale
要使用的地區設定。
傳回值
這些函式會傳回 str
中位於 strCharSet
的第一個字元索引。 如果 str
中沒有位於 strCharSet
的字元,則傳回值會是 str
的長度。
未保留表示錯誤的傳回值。
備註
wcscspn
和 _mbscspn
分別是 strcspn
的寬字元版本和多位元組字元版本。 的引數 wcscspn
是寬字元字串。 的引數和傳回值 _mbscspn
是多位元組字元字串。
_mbscspn
會驗證其參數。 str
如果 或 strCharSet
為 Null 指標,則會叫用不正確參數處理常式,如參數驗證 中所述 。 如果允許繼續執行,則函式會傳回 0 並將 errno
設定為 EINVAL
。 strcspn
和 wcscspn
不會驗證其參數。 除此之外,這三個函式的行為相同。
輸出值會受到 LC_CTYPE
地區設定之類別設定的影響。 如需詳細資訊,請參閱setlocale
。 這些沒有 _l
後置字元的函式版本,會針對此與地區設定相關的行為使用目前的地區設定;具有 _l
後置字元的版本也一樣,只不過它們會改用傳遞的地區設定參數。 如需詳細資訊,請參閱 Locale。
根據預設,此函式的全域狀態會限定于應用程式。 若要變更此行為,請參閱 CRT 中的全域狀態。
泛型文字常式對應
TCHAR.H 常式 | _UNICODE 和 _MBCS 未定義 |
_MBCS 定義 |
_UNICODE 定義 |
---|---|---|---|
_tcscspn |
strcspn |
_mbscspn |
wcscspn |
需求
常式 | 必要的標頭 |
---|---|
strcspn |
<string.h> |
wcscspn |
<string.h > 或 < wchar.h> |
_mbscspn , _mbscspn_l |
<mbstring.h> |
如需相容性詳細資訊,請參閱相容性。
範例
// crt_strcspn.c
#include <string.h>
#include <stdio.h>
void test( const char * str, const char * strCharSet )
{
int pos = strcspn( str, strCharSet );
printf( "strcspn( \"%s\", \"%s\" ) = %d\n", str, strCharSet, pos );
}
int main( void )
{
test( "xyzbxz", "abc" );
test( "xyzbxz", "xyz" );
test( "xyzbxz", "no match" );
test( "xyzbxz", "" );
test( "", "abc" );
test( "", "" );
}
strcspn( "xyzbxz", "abc" ) = 3
strcspn( "xyzbxz", "xyz" ) = 0
strcspn( "xyzbxz", "no match" ) = 6
strcspn( "xyzbxz", "" ) = 6
strcspn( "", "abc" ) = 0
strcspn( "", "" ) = 0
另請參閱
字串操作
地區設定
多位元組字元序列的解譯
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
strrchr
, wcsrchr
, _mbsrchr
, _mbsrchr_l
strspn
, wcsspn
, _mbsspn
, _mbsspn_l
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應