strspn
, wcsspn
, _mbsspn
, _mbsspn_l
Belirtilen karakter kümesine ait olmayan bir dizedeki ilk karakterin dizinini döndürür.
Önemli
_mbsspn
ve _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 strCharSet
karakterlerden oluşan bir tamsayı değeri döndürür. içinde olmayan strCharSet
bir 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 strCharSet
dizinini 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 str
strCharSet
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 errno
EINVAL
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