std::mbtowc
Da cppreference.com
 | 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. |
Definido no cabeçalho <cstdlib> | ||
int mbtowc(wchar_t* pwc, constchar* s, std::size_t n ) | ||
Converte um caractere multibyte cujo primeiro byte é apontado por
s a um personagem de largura, escrito para *pwc se pwc não é nulo.Original:
Converts a multibyte character whose first byte is pointed to by
s to a wide character, written to *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.
You can help to correct and verify the translation. Click here for instructions.
Se
s é um ponteiro nulo, redefine o estado de conversão global e determina se as sequências de deslocamento são usados .Original:
If
s is a null pointer, resets the global conversion state and determines whether shift sequences are used.The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
You can help to correct and verify the translation. Click here for instructions.
Índice |
[editar]Parâmetros
| s | - | ponteiro para o caractere multibyte Original: pointer to the multibyte character 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. |
| pwc | - | ponteiro para o caractere de largura para a saída Original: pointer to the wide character for output 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
Se
s não é um ponteiro nulo, retorna o número de bytes que estão contidos no caráter multibyte ou -1 se os primeiros bytes apontado por s não formam um caractere multibyte válido ou 0 se s está apontando para a charcter nulo '\0'.Original:
If
s is not a null pointer, returns the number of bytes that are contained in the multibyte character or -1 if the first bytes pointed to by s do not form a valid multibyte character or 0 if s is pointing at the null charcter '\0'.The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
You can help to correct and verify the translation. Click here for instructions.
Se
s é um ponteiro nulo, redefine seu estado conversão interna para representar o estado deslocamento inicial e 0 retorna se a codificação multibyte atual não é dependente do estado (não usar seqüências de turnos) ou um valor diferente de zero se a codificação multibyte atual é estado-dependente (utiliza seqüências turnos).Original:
If
s is a null pointer, resets its internal conversion state to represent the initial shift state and returns 0 if the current multibyte encoding is not state-dependent (does not use shift sequences) or a non-zero value if the current multibyte encoding is state-dependent (uses shift sequences).The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
You can help to correct and verify the translation. Click here for instructions.
[editar]Notas
Cada chamada para atualizações
mbtowc do estado conversão interna global (um objeto estático de std::mbstate_t tipo, conhecida apenas para esta função). Se a codificação multibyte usa os estados de mudança, os cuidados devem ser tomados para evitar varreduras retrocesso ou múltipla. Em todo o caso, vários segmentos não deve chamar mbtowc sem sincronização: std::mbrtowc pode ser usado em vez.Original:
Each call to
mbtowc updates the internal global conversion state (a static object of type std::mbstate_t, only known to this function). If the multibyte encoding uses shift states, care must be taken to avoid backtracking or multiple scans. In any case, multiple threads should not call mbtowc without synchronization: std::mbrtowc may be used instead.The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
You can help to correct and verify the translation. Click here for instructions.
[editar]Exemplo
#include <iostream>#include <clocale>#include <cstring>#include <cstdlib> int print_mb(constchar* ptr){ std::mbtowc(NULL, 0, 0);// reset the conversion stateconstchar* end = ptr +std::strlen(ptr);int ret;for(wchar_t wc;(ret = std::mbtowc(&wc, ptr, end-ptr))>0; ptr+=ret){std::wcout<< wc;}std::wcout<<'\n';return ret;} int main(){std::setlocale(LC_ALL, "en_US.utf8");// UTF-8 narrow multibyte encodingconstchar* 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:
zß水𝄋
[editar]Veja também
converte o caractere multibyte ao lado de caráter amplo, determinado estado Original: converts the next multibyte character to wide character, 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) | |
retorna o número de bytes no caractere multibyte seguinte Original: returns the number of bytes in the next multibyte 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) | |
[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) |
Documentação C para mbtowc | |
