std:: wcstombs

Convierte una secuencia de caracteres anchos del array cuyo primer elemento está apuntado por src a su representación multibyte estrecha que comienza en el estado de desplazamiento inicial. Los caracteres convertidos se almacenan en los elementos sucesivos del array char apuntado por dst . No se escriben más de len bytes en el array de destino.

Cada carácter se convierte como si mediante una llamada a std::wctomb , excepto que el estado de conversión de wctomb no se ve afectado. La conversión se detiene si:

• El carácter nulo fue convertido y almacenado.
• Se encontró un wchar_t que no corresponde a un carácter válido en la configuración regional C actual.
• El siguiente carácter multibyte a almacenar excedería len .

Notas

En la mayoría de las implementaciones, esta función actualiza un objeto estático global de tipo std::mbstate_t mientras procesa la cadena, y no puede ser llamada simultáneamente por dos hilos, std:: wcsrtombs debería ser utilizada en tales casos.

POSIX especifica una extensión común: si dst es un puntero nulo, esta función retorna el número de bytes que se escribirían en dst , si se convirtiera. Un comportamiento similar es estándar para std:: wcsrtombs .

Parámetros

Valor de retorno

En caso de éxito, retorna el número de bytes (incluyendo cualquier secuencia de desplazamiento, pero excluyendo el terminador ' \0 ' ) escritos en el array de caracteres cuyo primer elemento está apuntado por dst .

En caso de error de conversión (si se encontró un carácter ancho no válido), retorna static_cast < std:: size_t > ( - 1 ) .

Ejemplo

#include <clocale>
#include <cstdlib>
#include <iostream>
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    // UTF-8 narrow multibyte encoding
    const wchar_t* wstr = L"z\u00df\u6c34\U0001d10b"; // or L"zß水𝄋"
    char mbstr[11];
    std::wcstombs(mbstr, wstr, 11);
    std::cout << "multibyte string: " << mbstr << '\n';
}

multibyte string: zß水𝄋

Véase también