strspn, wcsspn, _mbsspn, _mbsspn_l

Makale
06/09/2015

Bir dizedeki bir karakter kümesine ait olmayan ilk karakterin indisini döndürür.

Önemli
_mbsspn ve _mbsspn_l Windows Çalışma Zamanı'nda yürütülen uygulamalarda kullanılamazlar.Daha fazla bilgi için bkz /ZW ile desteklenmeyen CRT işlevleri.

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
Aramak için null ile sonlandırılmış dize.
strCharSet
Null ile sonlandırılmış karakter kümesi.
locale
Kullanılacak yerel ayar.

Dönüş Değeri

str içindeki yalnızca strCharSet içindeki karakterleri içeren alt dizenin uzunluğunu belirten bir tamsayı değeri döndürür. str, strCharSet içinde olmayan bir karakterle başlıyorsa işlev 0 değerini döndürür.

Notlar

strspn işlevi, strCharSet'daki bir karakter grubuna ait olmayan, str'daki ilk karakterin dizinini geri götürüyor.Arama boş karakterlerin sonlandırılmasını içermez.

wcsspn ve _mbsspn, strspn**.** öğesinin geniş karakter ve çok baytlı karakter sürümleridir. Bağımsız değişkenler ve wcsspn geniş karakterli dizelerdir; _mbsspn dizeleri çok baytlı karakter dizeleridir._mbsspn kendi parametrelerini doğrular.str veya strCharSet öğesi NULL ise, Parametre Doğrulama içinde açıklandığı şekilde geçersiz parametre işleyicisi çağrılır.Yürütmenin devam etmesine izin verilirse, _mbspnerrno öğesini EINVAL olarak ayarlar ve 0 döndürür.strspn ve wcsspn kendi parametrelerini doğrulamazlar.Bu üç işlev, aynı şekilde davranır.

Çıkış değeri, yerel ayarın LC_CTYPE kategori ayarından etkilenir; daha fazla bilgi için, bkz. setlocale.Bu işlevlerin, _l sonekine sahip olmayan sürümleri, yerel ayara bağlı davranışı için, geçerli yerel ayarı kullanır; _l sonekine sahip sürümler, bunun yerine iletilmiş yerel ayar parametresini kullanması hariç aynıdır.Daha fazla bilgi için bkz. Yerel Ayar.

Genel Metin Yordam Eşleşmeleri

TCHAR.H yordamı	_UNICODE & _MBCS tanımlanmamış	_MBCS tanımlanmış	_UNICODE tanımlanmış
_tcsspn	strspn	_mbsspn	wcsspn
n/a	n/a	_mbsspn_l	n/a

Gereksinimler

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

Ek uyumluluk bilgileri 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 );
}