Namensräume
Varianten
Aktionen

std::mblen

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

 
 
Strings Bibliothek
Null-terminierte Strings
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.
Byte-Strings
Multibyte-Strings
Wide Strings
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.
basic_string
char_traits
 
Nullterminierten Multibyte Strings
Wide / Multibyte Konvertierungen
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.
mbsinit
Types
Original:
Types
The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.
mbstate_t
 
definiert in Header <cstdlib>
int mblen( const char* s, std::size_t n );
Bestimmt die Größe in Byte der Multibyte-Zeichen, dessen erstes Byte wird durch s hingewiesen .
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.
Wenn s ist ein NULL-Zeiger, setzt die globale Umstellung Staat und ermittelt, ob Shift-Sequenzen verwendet werden .
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.
Diese Funktion entspricht dem Aufruf std::mbtowc((wchar_t*)0, s, n), außer dieser Umwandlung Zustand std::mbtowc bleibt unberührt .
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.

Inhaltsverzeichnis

[Bearbeiten] Notes

Jeder Aufruf mblen aktualisiert die interne globale Umstellung Zustand (ein statisches Objekt vom Typ std::mbstate_t, nur um diese Funktion bekannt). Wenn die Multibyte-Kodierung verwendet Verschiebung Staaten, muss darauf geachtet werden Backtracking oder mehrere Scans zu vermeiden. In jedem Fall sollten mehrere Threads nicht nennen mblen ohne Synchronisation: std::mbrlen dürfen stattdessen verwendet werden .
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.

[Bearbeiten] Parameter

s -
Zeiger auf die Multibyte-Zeichen
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 -
Grenze für die Anzahl von Bytes in s, die untersucht werden können
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.

[Bearbeiten] Rückgabewert

Wenn s nicht ein NULL-Zeiger, gibt die Anzahl von Bytes, die in der Multibyte-Zeichen oder -1 enthalten sind, wenn die ersten Bytes, auf die s nicht bilden keine gültige Multibyte-Zeichen oder 0 wenn s am null charcter '\0' zeigen wird .
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.
Wenn ein Null-Zeiger s ist, setzt seinen internen Zustand Umwandlung, um die anfängliche Schaltzustand und kehrt 0 repräsentieren, wenn die aktuelle Multibyte Codierung nicht zustandsabhängigen (verwendet keine Verschiebung Sequenzen) oder einen von Null verschiedenen Wert, falls der aktuelle Multibyte-Kodierung ist state-abhängige (verwendet Schichtfolgen) .
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.

[Bearbeiten] Beispiel

#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";
}

Output:

zß水𝄋 is 10 bytes, but only 4 characters

[Bearbeiten] Siehe auch

wandelt die nächsten Multibyte Zeichen-Zeichen
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.

(Funktion) [edit]
gibt die Anzahl der Bytes in den nächsten Multibyte-Zeichen, gegebenen Zustand
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.

(Funktion) [edit]
C documentation for mblen