strcspn， wcscspn， _mbscspn， _mbscspn_l

项目
04/10/2013

返回一个字符的第一个匹配项的索引在属于组字符的字符串的。

重要

_mbschr 和 _mbschr_l不能在运行时的窗口执行的应用程序。有关更多信息，请参见 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 是 null 指针，无效参数调用处理程序，如参数验证所述。如果执行允许继续，该函数返回 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( "", "" );
}