strcspn, wcscspn, _mbscspn, _mbscspn_l

Makale
06/09/2015

Bir dizedeki bir karakter kümesine ait olan bir karakterin ilk geçtiği yerin indisini döndürür.

Önemli
_mbschr ve _mbschr_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 strcspn(
   const char *str,
   const char *strCharSet 
);
size_t wcscspn(
   const wchar_t *str,
   const wchar_t *strCharSet 
);
size_t _mbscspn(
   const unsigned char *str,
   const unsigned char *strCharSet 
);
size_t _mbscspn_l(
   const unsigned char *str,
   const unsigned char *strCharSet,
   _locale_t locale
);

Parametreler

str
Null ile sonlandırılmış aranan dize.
strCharSet
Null ile sonlandırılmış karakter kümesi.
locale
Kullanılacak yerel ayar.

Dönüş Değeri

Bu işlevler, ilk karakterin strCharSet'daki indeksini str'ye geri getirir.str öğesindeki karakterlerin hiçbiri strCharSet içinde değilse, dönüş değeri str öğesinin uzunluğudur.

Bir hata gösterecek bir dönüş değeri ayrılmamış.

Notlar

wcscspn ve _mbscspnstrcspn öğesinin geniş karakter ve çok baytlı karakter sürümleridir.Bağımsız değişkenler ve wcscspn geniş karakterli dizelerdir; _mbscspn dizeleri çok baytlı karakter dizeleridir.

_mbscspn kendi parametrelerini doğrular.str veya strCharSet bir null işaretçiyse, Parametre Doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisi çağrılır.Yürütmenin devam etmesine izin verilirse işlev 0 döndürür ve errno öğesini EINVAL olarak ayarlar.strcspn ve wcscspn 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ış
_tcscspn	strcspn	_mbscspn	wcscspn
n/a	n/a	_mbscspn_l	n/a

Gereksinimler

Yordam	Gerekli başlık
strcspn	<string.h>
wcscspn	<string.h> or <wchar.h>
_mbscspn, _mbscspn_l	<mbstring.h>

Ek uyumluluk bilgileri için bkz. Uyumluluk.

Örnek

// crt_strcspn.c

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

void test( const char * str, const char * strCharSet )
{
   int pos = strcspn( str, strCharSet );
   printf( "strcspn( \"%s\", \"%s\" ) = %d\n", str, strCharSet, pos );    
}

int main( void )
{
   test( "xyzbxz", "abc" );
   test( "xyzbxz", "xyz" );
   test( "xyzbxz", "no match" );
   test( "xyzbxz", "" );
   test( "", "abc" );
   test( "", "" );
}