wctomb, _wctomb_l

Makale
02/26/2013

Geniş bir karakter için karşılık gelen çok baytlı karakter dönüştürün.Bu işlevler daha güvenli sürümlerinin kullanılabilir olduğunu; see wctomb_s, _wctomb_s_l.

int wctomb(
   char *mbchar,
   wchar_t wchar 
);
int _wctomb_l(
   char *mbchar,
   wchar_t wchar,
   _locale_t locale
);

Parametreler

mbchar
Çok baytlı karakter adresidir.
wchar
Geniş bir karakter.

Dönüş Değeri

wctomb Geniş karakter dönüştürür çok baytlı bir karakter, bayt sayısını verir (olduğu hiçbir zaman büyük MB_CUR_MAX) geniş karakter.wchar (l '\0'), geniş karakter null karakteri wctomb 1 döndürür.Hedef işaretçi mbchar null, wctomb 0 döndürür.Geçerli yerel ayarı dönüşümü mümkün değilse, wctomb –1 değerini döndürür ve errno ayarlamak EILSEQ.

Notlar

wctomb İşlev dönüştürür, wchar bağımsız değişkenine karşılık gelen çok baytlı karakter at sonucu depolar ve mbchar.Herhangi bir programda herhangi bir noktasından işlevini çağırabilirsiniz.wctombGeçerli yerel ayarı herhangi bir yerel ayara bağımlı davranışını kullanır; _wctomb_laynıdır wctomb dışında bunun yerine geçirilen yerel ayarını kullanır.Daha fazla bilgi için bkz. Yerel ayar.

wctombparametrelerinin geçerliliğini denetler.mbchar Olan NULL, geçersiz parametre işleyicisi, açıklandığı şekilde çağrılır Parametre doğrulama.Yürütülmesine devam etmek için izin verilip verilmediğini errno ayarlamak EINVAL ve işlev-1 değerini döndürür.

Gereksinimler

Yordamı	Gerekli başlık
wctomb	<stdlib.h>

Ek uyumluluk bilgileri için bkz: Uyumluluk giriş.

Örnek

Bu program, wctomb işlevinin davranışı göstermektedir.

// crt_wctomb.cpp
// compile with: /W3
#include <stdio.h>
#include <stdlib.h>

int main( void )
{
   int i;
   wchar_t wc = L'a';
   char *pmb = (char *)malloc( MB_CUR_MAX );

   printf( "Convert a wide character:\n" );
   i = wctomb( pmb, wc ); // C4996
   // Note: wctomb is deprecated; consider using wctomb_s
   printf( "   Characters converted: %u\n", i );
   printf( "   Multibyte character: %.1s\n\n", pmb );
}