strspn， wcsspn， _mbsspn， _mbsspn_l

项目
04/10/2013

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

重要事项
_mbsspn 和 _mbsspn_l 不能在运行时的窗口执行的应用程序。有关更多信息，请参见 CRT 函数不支持与 /ZW。

size_t strspn(
   const char *str,
   const char *strCharSet 
);
size_t wcsspn(
   const wchar_t *str,
   const wchar_t *strCharSet 
);
size_t _mbsspn(
   const unsigned char *str,
   const unsigned char *strCharSet 
);
size_t _mbsspn_l(
   const unsigned char *str,
   const unsigned char *strCharSet,
   _locale_t locale
);

参数

str
搜索的 null 终止的字符串。
strCharSet
null 终止的字符集。
locale
使用的区域设置。

返回值

返回指定完全包含在 strCharSet的字符子字符串的长度整数值。str*。如果 str 从一个字符开始不在 strCharSet，* 该函数返回 0。

备注

strspn 函数返回不属于将 strCharSet的字符第一个字符的索引。str 的。搜索不包括终止 null 字符。

wcsspn 和 _mbsspn 是 strspn**.**的宽字符和多字节字符版本wcsspn 的参数是宽字符字符串；这些 _mbsspn 的多字节字符字符串。_mbsspn 验证其参数。如果 str 或 strCharSet 是NULL，无效参数调用处理程序，如参数验证所述。如果执行允许继续，_mbspn 设置 errno 到 EINVAL 并返回 0。strspn 和 wcsspn 不验证方法的参数。这三个功能否则具有相同的行为。

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

一般文本例程映射

TCHAR.H 实例	未定义的_UNICODE & _MBCS	定义的_MBCS	定义的_UNICODE
_tcsspn	strspn	_mbsspn	wcsspn
无	无	_mbsspn_l	无

要求

实例	必需的标头
strspn	<string.h>
wcsspn	<string.h> 或 <wchar.h>
_mbsspn, _mbsspn_l	<mbstring.h>

有关其他的兼容性信息，请参见中介绍的兼容性。

示例

// crt_strspn.c
// This program uses strspn to determine
// the length of the segment in the string "cabbage"
// consisting of a's, b's, and c's. In other words,
// it finds the first non-abc letter.
//

#include <string.h>
#include <stdio.h>

int main( void )
{
   char string[] = "cabbage";
   int  result;
   result = strspn( string, "abc" );
   printf( "The portion of '%s' containing only a, b, or c "
           "is %d bytes long\n", string, result );
}