std::mblen
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 mblen( const char* s, std::size_t n ); |
||
Détermine la taille, en octets, du caractère multi-octets dont le premier octet est pointé par
s
. Original:
Determines the size, in bytes, of the multibyte character whose first byte is pointed to by
s
. 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 de conversion global et de déterminer si des séquences de décalage sont utilisés .Original:
If
s
is a null pointer, resets the global conversion state and determined 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.
Cette fonction est équivalente à la std::mbtowc((wchar_t*)0, s, n) appel, sauf que l'état de conversion de std::mbtowc n'est pas affecté .
Original:
This function is equivalent to the call std::mbtowc((wchar_t*)0, s, n), except that conversion state of std::mbtowc is unaffected.
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] Notes
Chaque appel à
mblen
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 mblen
sans synchronisation: std::mbrlen peut être utilisé à la place .Original:
Each call to
mblen
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 mblen
without synchronization: std::mbrlen 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] 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. |
[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 0 s
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] Exemple
#include <clocale> #include <string> #include <iostream> #include <cstdlib> #include <stdexcept> // the number of characters in a multibyte string is the sum of mblen()'s // note: the simpler approach is std::mbstowcs(NULL, s.c_str(), s.size()) std::size_t strlen_mb(const std::string& s) { std::size_t result = 0; const char* ptr = &s[0]; const char* end = ptr + s.size(); std::mblen(NULL, 0); // reset the conversion state while (ptr < end) { int next = std::mblen(ptr, end-ptr); if (next == -1) { throw std::runtime_error("strlen_mb(): conversion error"); } ptr += next; ++result; } return result; } int main() { // allow mblen() to work with UTF-8 multibyte encoding std::setlocale(LC_ALL, "en_US.utf8"); // UTF-8 narrow multibyte encoding std::string str = u8"z\u00df\u6c34\U0001d10b"; // or u8"zß水𝄋" // or "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9d\x84\x8b"; std::cout << str << " is " << str.size() << " bytes, but only " << strlen_mb(str) << " characters\n"; }
Résultat :
zß水𝄋 is 10 bytes, but only 4 characters
[modifier] Voir aussi
convertit le caractère multi-octets suivante de caractères larges 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. (fonction) | |
renvoie le nombre d'octets dans le prochain caractère multi-octets, état donné Original: returns the number of bytes in the next multibyte 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) | |
C documentation for mblen
|