strspn, wcsspn, _mbsspn, _mbsspn_l

Belirtilen karakter kümesine ait olmayan bir dizedeki ilk karakterin dizinini döndürür.

Önemli

_mbsspnve _mbsspn_l Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz. Daha fazla bilgi için bkz. Evrensel Windows Platformu uygulamalarında desteklenmeyen CRT işlevleri.

Sözdizimi

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

Parametreler

str
Arama için null ile sonlandırılan dize.

strCharSet
Null ile sonlandırılan karakter kümesi.

locale
Kullanılacak yerel ayar.

Dönüş değeri

içindeki alt dizenin str uzunluğunu belirten ve tamamen içindeki strCharSetkarakterlerden oluşan bir tamsayı değeri döndürür. içinde olmayan strCharSetbir karakterle başlıyorsa str işlev 0 döndürür.

Açıklamalar

işlevi, strspn içindeki str içindeki karakter kümesine ait olmayan ilk karakterin strCharSetdizinini döndürür. Arama null karakterleri sonlandırmayı içermez.

wcsspn ve _mbsspn geniş karakterli ve çok baytlı sürümleridir strspn. bağımsız değişkenleri wcsspn geniş karakterli dizelerdir. bağımsız değişkenleri _mbsspn çok baytlı karakter dizeleridir. _mbsspn parametrelerini doğrular. veya strstrCharSet iseNULL, parametre doğrulaması bölümünde açıklandığı gibi geçersiz parametre işleyicisi çağrılır. Yürütmenin devam etmesi için izin verilirse, _mbspn olarak ayarlanır errnoEINVAL ve 0 döndürür. strspn ve wcsspn parametrelerini doğrulamaz. Bu üç işlev aynı şekilde davranır.

Çıkış değeri, yerel ayarın LC_CTYPE kategori ayarının ayarından etkilenir. Daha fazla bilgi için bkz. setlocale. Bu işlevlerin son eki olmayan _l sürümleri, bu yerel ayara bağımlı davranış için geçerli yerel ayarı kullanır; son ekine _l sahip sürümler, bunun yerine geçirilen yerel ayar parametresini kullanmaları dışında aynıdır. Daha fazla bilgi için bkz . Yerel Ayar.

Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı değiştirmek için bkz. CRT'de Genel durum.

Genel metin yordamı eşlemeleri

TCHAR.H yordamı	_UNICODE ve _MBCS tanımlanmadı	_MBCS Tanımlanan	_UNICODE Tanımlanan
_tcsspn	strspn	_mbsspn	wcsspn
Yok	Yok	_mbsspn_l	Yok

Gereksinimler

Yordam	Gerekli başlık
strspn	<string.h>
wcsspn	<string.h> veya <wchar.h>
_mbsspn, _mbsspn_l	<mbstring.h>

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Örnek

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

The portion of 'cabbage' containing only a, b, or c is 5 bytes long

Ayrıca bkz.

Dize işleme
Yerel ayar
Çok baytlı karakter dizilerinin yorumlanması
_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
strrchr, wcsrchr, _mbsrchr, _mbsrchr_l