strspn, wcsspn, _mbsspn, _mbsspn_l
Возвращает индекс первого символа в строке, не принадлежащий набором символов.
Важно |
---|
_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 );
}
Эквивалент в .NET Framework
См. также
Ссылки
Интерпретация последовательностей многобайтового символов
_strspnp, _wcsspnp, _mbsspnp, _mbsspnp_l
strcspn, wcscspn, _mbscspn, _mbscspn_l
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