strspn, wcsspn, _mbsspn, _mbsspn_l

Статья
04/10/2013

Возвращает индекс первого символа в строке, не принадлежащий набором символов.

Важно
_mbsspn и _mbsspn_l нельзя использовать в приложениях, выполняемых в среды выполнения Windows.Дополнительные сведения см. в разделе Функции 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
Строка, заканчивающаяся нулевым символом, в которой будет производиться поиск.
strCharSet
Объединения завершенной кодировка.
locale
Языковой стандарт, который необходимо использовать.

Возвращаемое значение

Возвращает целочисленное значение, содержащее длину подстроки в str, которая содержит все символов в strCharSet*.* Если параметр str начинается с символа, которого нет в списке strCharSet*,* функция возвращает 0.

Заметки

Функция strspn возвращает индекс первого символа в str, не принадлежащий набором символов в strCharSet.Поиск не распространяется на завершающий нулевой символ.

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 );
}