La función wcstombs () en C ++ convierte una cadena de caracteres ancha en una secuencia multibyte equivalente.
La función wcstombs () se define en el archivo de encabezado.
prototipo de wcstombs ()
size_t wcstombs (char * dest, const wchar_t * src, size_t max);
La función wcstombs () toma tres argumentos y devuelve un valor entero.
Esta función convierte la cadena de caracteres ancha cuyo primer elemento apunta src a su representación multibyte.
El resultado se almacena en la ubicación de memoria señalada por dest. El parámetro max representa el número máximo de caracteres anchos que se convertirán.
El mecanismo de conversión es el mismo que el del útero, excepto que el estado de conversión del útero no se ve afectado. La conversión se detiene si:
- Se encuentra un carácter nulo, que luego se convierte y almacena.
- Se encontró un wchar_t que no corresponde a un carácter válido en la configuración regional actual de C.
- Se ha convertido el número máximo de caracteres anchos.
Parámetros de wcstombs ()
- dest: puntero a la matriz de caracteres multibyte resultante.
- src: puntero al primer elemento del carácter ancho que se convierte en carácter multibyte.
- max: Número máximo de caracteres anchos a convertir.
wcstombs () Valor de retorno
- Si la conversión es exitosa, wcstombs () devuelve el número de caracteres multibyte excluyendo el carácter de terminación (es decir, ' 0') que se escribe en la matriz de destino.
- Si ocurre algún error durante la conversión, devuelve -1.
Ejemplo: ¿Cómo funciona la función wcstombs ()?
#include #include using namespace std; int main() ( wchar_t src() = L"Welcome To Programiz.com"; char dest(50); int num; num = wcstombs(dest, src, 50); cout << "Number of wide character converted = " << num << endl; cout << "Multibyte Character String = " << dest << endl; return 0; )
Cuando ejecute el programa, una posible salida será:
Número de caracteres anchos convertidos = 24 cadenas de caracteres multibyte = Bienvenido a Programiz.com
