std::mbtowc
De 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. |
Déclaré dans l'en-tête <cstdlib> | ||
int mbtowc(wchar_t* pwc, constchar* s, std::size_t n ) | ||
Convertit un caractère multi-octets dont le premier octet est pointé par
s
d'un caractère large, écrit *pwc
si pwc
n'est pas nul .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.
Si
s
est un pointeur NULL, réinitialise l'état global de conversion et détermine si des séquences de décalage sont utilisés .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.
Sommaire |
[modifier]Paramètres
s | - | pointeur sur le caractère multi-octets 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 | - | limiter le nombre d'octets dans s qui peut être examiné 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 | - | le pointeur de caractère large pour la sortie 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. |
[modifier]Retourne la valeur
Si
s
n'est pas un pointeur NULL, retourne le nombre d'octets qui sont contenues dans le caractère multi-octets ou -1 si les premiers octets pointée par s
ne forment pas un caractère multi-octets valide ou si 0s
est pointée vers le charcter nulle '\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.
Si
s
est un pointeur NULL, réinitialise son état de conversion interne pour représenter l'état initial et 0 revient si l'encodage multi-octets actuelle n'est pas dépendant de l'état (ne pas utiliser des séquences de décalage) ou une valeur non nulle si l'encodage multi-octets actuelle est dépendant de l'état (utilise des séquences de décalage) .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.
[modifier]Notes
Chaque appel à
mbtowc
mises à jour de l'état interne de conversion global (un objet statique de std::mbstate_t type, connu seulement de cette fonction). Si l'encodage multi-octets utilise des états de changement, il faut prendre soin d'éviter les retours en arrière ou plusieurs scans. Dans tous les cas, plusieurs threads ne doit pas appeler mbtowc
sans synchronisation: std::mbrtowc peut être utilisé à la place .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.
[modifier]Exemple
#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);}
Résultat :
zß水𝄋
[modifier]Voir aussi
convertit le caractère multi-octets suivante caractère large, état donné 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. (fonction) | |
renvoie le nombre d'octets dans le prochain caractère multi-octets 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. (fonction) | |
[ virtuel ]Original: virtual The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. | convertit une chaîne de Externt à internt, comme lors de la lecture du fichier 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. (fonction membre virtuelle protégée de std::codecvt ) |
C documentation for mbtowc |