strcspn、wcscspn、_mbscspn、_mbscspn_l

项目
06/09/2015

返回字符串中第一个匹配项的索引，字符的索引也是一组字符的索引。

重要

_mbschr和_mbschr_l不能用于在 Windows 运行时中执行的应用程序。有关详细信息，请参见 CRT functions not supported with /ZW（CRT 函数不支持使用/ZW）。

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
要使用的区域设置。

返回值

这些函数返回在 strCharSet中的str 的第一个字符的索引。如果str中的字符都不在 strCharSet，则返回值是 str的长度。

没有保留任何返回值以指示错误。

备注

wcscspn 和 _mbscspn 是宽字符，属于 strcspn 的多节字字符版本。 wcscspn参数是宽字符字符串；_mbscspn参数的返回值为多字节字符字符串。

_mbscspn验证其参数。如果str 或 strCharSet是空指针，则会调用无效参数处理程序，正如参数验证中所述。如果允许执行继续，则该函数返回 0 并将 errno 设置为 EINVAL。 strcspn 和 wcscspn 不验证其参数。否则这三个函数否则具有相同行为。

输出值受区域设置的 LC_CTYPE 类设置影响；有关更多信息，请参见 setlocale。这些不带 _l 后缀的函数的版本使用为该区域设置相关的行为的当前区域设置；带有 _l 后缀的版本相同，只不过它们使用传递的区域设置参数。有关详细信息，请参阅区域设置。

一般文本例程映射

TCHAR.H 例程	未定义 _UNICODE & _MBCS	已定义 _MBCS	已定义 _UNICODE
_tcscspn	strcspn	_mbscspn	wcscspn
n/a	n/a	_mbscspn_l	n/a

要求

例程	必需的标头
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( "", "" );
}