Espaços nominais
Variantes
    Acções

      std::mbrtowc

      Da cppreference.com
      < cpp‎ | string‎ | multibyte

      This page has been machine-translated from the English version of the wiki using Google Translate.

      The translation may contain errors and awkward wording. Hover over text to see the original version. You can help to fix errors and improve the translation. For instructions click here.

      Click here for the English version of this page

       
      C++
       
      Biblioteca cordas
      Strings terminadas
      Original:
      Null-terminated strings
      The text has been machine-translated via Google Translate.
      You can help to correct and verify the translation. Click here for instructions.
      Cadeias de bytes
      Multibyte cordas
      Cordas de largura
      Classes
      Original:
      Classes
      The text has been machine-translated via Google Translate.
      You can help to correct and verify the translation. Click here for instructions.
       
      Strings terminadas multibyte
      Wide / multibyte conversões
      Original:
      Wide/multibyte conversions
      The text has been machine-translated via Google Translate.
      You can help to correct and verify the translation. Click here for instructions.
      Tipos
      Original:
      Types
      The text has been machine-translated via Google Translate.
      You can help to correct and verify the translation. Click here for instructions.
       
      Definido no cabeçalho <cwchar>
      std::size_t mbrtowc( wchar_t* pwc,

                           const char* s,
                           std::size_t n,

                           std::mbstate_t* ps );
      Converte um caractere multibyte estreita para um caractere largo.
      Original:
      Converts a narrow multibyte character to a wide character.
      The text has been machine-translated via Google Translate.
      You can help to correct and verify the translation. Click here for instructions.
      Se s não é um ponteiro nulo, inspeciona a maioria dos bytes n da cadeia de caracteres multibyte, começando com o byte apontado pelo s para determinar o número de bytes necessários para completar o personagem multibyte seguinte (incluindo as seqüências de turnos). Se a função determina que o caráter de multibyte próximo s é completa e válida, converte-lo para o personagem correspondente de largura e armazena em *pwc (se pwc não é nulo).
      Original:
      If s is not a null pointer, inspects at most n bytes of the multibyte character string, beginning with the byte pointed to by s to determine the number of bytes necessary to complete the next multibyte character (including any shift sequences). If the function determines that the next multibyte character in s is complete and valid, converts it to the corresponding wide character and stores it in *pwc (if pwc is not null).
      The text has been machine-translated via Google Translate.
      You can help to correct and verify the translation. Click here for instructions.
      Se s é um ponteiro nulo, os valores de n e pwc chamada são ignorados e é equivalente a std::mbrtowc(NULL, "", 1, ps).
      Original:
      If s is a null pointer, the values of n and pwc are ignored and call is equivalent to std::mbrtowc(NULL, "", 1, ps).
      The text has been machine-translated via Google Translate.
      You can help to correct and verify the translation. Click here for instructions.
      Se o personagem de largura produzida é o caractere nulo, o estado de conversão armazenado em *ps é o estado deslocamento inicial.
      Original:
      If the wide character produced is the null character, the conversion state stored in *ps is the initial shift state.
      The text has been machine-translated via Google Translate.
      You can help to correct and verify the translation. Click here for instructions.

      Índice

      [editar] Parâmetros

      pwc-
      ponteiro para o local onde o personagem largo resultante será escrito
      Original:
      pointer to the location where the resulting wide character will be written
      The text has been machine-translated via Google Translate.
      You can help to correct and verify the translation. Click here for instructions.
      s-
      ponteiro para a cadeia de caracteres multibyte usado como entrada
      Original:
      pointer to the multibyte character string used as input
      The text has been machine-translated via Google Translate.
      You can help to correct and verify the translation. Click here for instructions.
      n-
      limitar o número de bytes em s que podem ser examinados
      Original:
      limit on the number of bytes in s that can be examined
      The text has been machine-translated via Google Translate.
      You can help to correct and verify the translation. Click here for instructions.
      ps-
      ponteiro para o estado de conversão utilizado ao interpretar a string multibyte
      Original:
      pointer to the conversion state used when interpreting the multibyte string
      The text has been machine-translated via Google Translate.
      You can help to correct and verify the translation. Click here for instructions.

      [editar] Valor de retorno

      O primeiro dos seguintes que se aplica:
      Original:
      The first of the following that applies:
      The text has been machine-translated via Google Translate.
      You can help to correct and verify the translation. Click here for instructions.
      • ​0​ se o personagem convertido de s (e armazenados na pwc se não nulo) foi o caractere nulo
        Original:
        ​0​ if the character converted from s (and stored in pwc if non-null) was the null character
        The text has been machine-translated via Google Translate.
        You can help to correct and verify the translation. Click here for instructions.
      • o número de bytes [1...n] do caractere multibyte convertidos com êxito a partir de s
        Original:
        the number of bytes [1...n] of the multibyte character successfully converted from s
        The text has been machine-translated via Google Translate.
        You can help to correct and verify the translation. Click here for instructions.
      • static_cast<std::size_t>(-2) se os bytes n próximos constituem um incompleta, mas até agora válida personagem, multibyte. Nada é escrito para *pwc.
        Original:
        static_cast<std::size_t>(-2) if the next n bytes constitute an incomplete, but so far valid, multibyte character. Nothing is written to *pwc.
        The text has been machine-translated via Google Translate.
        You can help to correct and verify the translation. Click here for instructions.
      • static_cast<std::size_t>(-1) se ocorre erro de codificação. Nada é escrito para *pwc, o EILSEQ valor é armazenado no errno e o valor de *ps é deixado indeterminado.
        Original:
        static_cast<std::size_t>(-1) if encoding error occurs. Nothing is written to *pwc, the value EILSEQ is stored in errno and the value of *ps is left unspecified.
        The text has been machine-translated via Google Translate.
        You can help to correct and verify the translation. Click here for instructions.

      [editar] Exemplo

      #include <iostream>
#include <clocale>
#include <cstring>
#include <cwchar>
 
void print_mb(const char* ptr)
{
    std::mbstate_t state = std::mbstate_t(); // initial state
    const char* end = ptr + std::strlen(ptr);
    int len;
    wchar_t wc;
    while((len = std::mbrtowc(&wc, ptr, end-ptr, &state)) > 0) {
        std::wcout << "Next " << len << " bytes are the character " << wc << '\n';
        ptr += len;
    }
}
 
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    // UTF-8 narrow multibyte encoding
    const char* str = u8"z\u00df\u6c34\U0001d10b"; // or u8"zß水𝄋"
                      // or "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9d\x84\x8b";
    print_mb(str);
}

      Saída:

      Next 1 bytes are the character z
Next 2 bytes are the character ß
Next 3 bytes are the character 水
Next 4 bytes are the character 𝄋

      [editar] Veja também

      converte o caractere multibyte ao lado de caracteres largos
      Original:
      converts the next multibyte character to wide character
      The text has been machine-translated via Google Translate.
      You can help to correct and verify the translation. Click here for instructions.

      (função) [edit]
      converte um caractere largo em sua representação multibyte, determinado estado
      Original:
      converts a wide character to its multibyte representation, given state
      The text has been machine-translated via Google Translate.
      You can help to correct and verify the translation. Click here for instructions.

      (função) [edit]
      [virtual]
      Converte uma cadeia de externT a Internt, como quando lendo de um arquivo
      Original:
      converts a string from externT to internT, such as when reading from file
      The text has been machine-translated via Google Translate.
      You can help to correct and verify the translation. Click here for instructions.

      (virtual protegido of std::codecvt função de membro) [edit]
      Documentação C para mbrtowc
      Obtida de "https://pt.cppreference.com/mwiki/index.php?title=cpp/string/multibyte/mbrtowc&oldid=21771"