wctomb

wctomb是一則函式，wctomb將一個寬字元轉化為多位元組字元。

函式介紹

函式作用

wctomb將一個寬字元轉化為多位元組字元

函式返回值

If wctomb converts the wide character to a multibyte character, it returns the number of bytes (which is never greater than MB_CUR_MAX) in the wide character. Ifwchar is the wide-character null character (L'\0'), wctomb returns 1. If the conversion is not possible in the current locale, wctomb returns –1.

函式參數說明

mbchar

The address of a multibyte character

wchar

A wide character

Remarks

The wctomb function converts its wchar argument to the corresponding multibyte character and stores the result at mbchar. You can call the function from any point in any program.

函式套用舉例

Example

/* WCTOMB.CPP illustrates the behavior of the wctomb function */

#include <stdio.h>

#include <stdlib.h>

void main( void )

{

int i; wchar_t wc = L'a';

char *pmbnull = NULL;

char *pmb = (char *)malloc( sizeof( char ) );

printf( "Convert a wide character:\n" );

i = wctomb( pmb, wc );

printf( "\tCharacters converted: %u\n", i );

printf( "\tMultibyte character: %.1s\n\n", pmb );

printf( "Attempt to convert when target is NULL:\n" );

i = wctomb( pmbnull, wc );

printf( "\tCharacters converted: %u\n", i );

printf( "\tMultibyte character: %.1s\n", pmbnull );}

Output

Convert a wide character: Characters converted: 1 Multibyte character: aAttempt to convert when target is NULL: Characters converted: 0 Multibyte character: (