CKTIS / C++
std::basic_string::size — Elemente einer Zeichenkette zählen
`size()` zählt gespeicherte Elemente, nicht die als Zeichen wahrgenommenen Einheiten. Damit lassen sich Kopierbereiche begrenzen, Indizes prüfen und Felder kürzen.
Version: ISO C++23; implementation support may vary
Syntax
#include <string>
// Member declaration inside std::basic_string<CharT, Traits, Allocator> (C++23):
constexpr size_type size() const noexcept;std::basic_string::size ist eine parameterlose const-Memberfunktion aus <string>. Sie gibt die Anzahl der CharT-Elemente als vorzeichenlosen Typ size_type zurück. Sie läuft in konstanter Zeit O(1), ändert die Zeichenkette nicht, ist noexcept und seit C++20 constexpr. length() liefert denselben Wert; capacity() beschreibt die Speicherkapazität, nicht die Länge des Inhalts.
Eingebettete Nullen zählen mit, das abschließende Nullzeichen nicht. Bei std::string werden char-Elemente gezählt, also C++-Bytes; bei einem std::u8string mit UTF-8-Text sind es char8_t-Codeeinheiten. Das Ergebnis zählt weder Unicode-Codepunkte noch wahrgenommene Zeichen. Beim Kürzen nach Elementanzahl kann eine UTF-8-Sequenz durchschnitten werden.
Für eine exakte Kopie übergib s.data() und s.size() an eine Schnittstelle, die eine Elementanzahl erwartet; eine Schnittstelle, die ein Nullzeichen sucht, stoppt bei der ersten Null. Ist der Zielpuffer in Bytes bemessen, prüfe seine Größe in Bytes: Der Inhalt belegt s.size() * sizeof(CharT) Bytes, ohne das abschließende Nullzeichen. Verwende einen Zeiger aus data() nicht mehr, nachdem die Zeichenkette zerstört oder der Zeiger durch eine Operation ungültig geworden ist.
Prüfe vor dem Lesen eines Elements mit s[i], ob i < s.size() gilt. An Position s.size() steht das abschließende Nullzeichen, kein Inhaltselement. at(i) löst bei i >= s.size() eine std::out_of_range-Ausnahme aus. Um höchstens die letzten vier Elemente zu behalten, verwende s.substr(n - 4) nur, wenn n = s.size() größer als 4 ist; andernfalls behalte die ganze Zeichenkette. So vermeidest du einen Unterlauf bei vorzeichenloser Subtraktion. Ist ein Trennzeichen Pflicht, prüfe das Ergebnis von find() auf npos, bevor du den Anfang des nächsten Felds berechnest.
Beispiele
#include <iostream>
#include <string>
int main() {
const std::string record("ID\0:123456", 10);
const std::string copy(record.data(), record.size());
const auto separator = copy.find(':');
if (separator == std::string::npos) {
return 1;
}
const auto field = copy.substr(separator + 1);
constexpr std::string::size_type width = 4;
const auto n = field.size();
const auto tail = n > width ? field.substr(n - width) : field;
const std::u8string utf8 = u8"\u00E9";
std::cout << static_cast<unsigned int>(record.size()) << '\n'
<< (copy[2] == '\0') << '\n'
<< tail << '\n'
<< static_cast<unsigned int>(utf8.size()) << '\n';
}Ergebnis
10 1 3456 2
`10` zählt die eingebettete Null mit, und `1` bestätigt, dass sie in der Kopie erhalten bleibt. `3456` sind die letzten vier Feldelemente; `2` ist die Anzahl der UTF-8-Codeeinheiten für U+00E9.
Zugehörige Lektionen
- C++ · Lektion 49 · Fortgeschritten · Version: 3
- C++ · Lektion 53 · Fortgeschritten · Version: 3
- C++ · Lektion 58 · Fortgeschritten · Version: 3
Quellen
- C++ working draft — Capacity [string.capacity]
- C++ working draft — Class template basic_string, general [basic.string.general]
- C++ working draft — General requirements [string.require]
- C++ working draft — Constructors and assignment operators [string.cons]
- C++ working draft — Element access [string.access]
- C++ working draft — Accessors [string.accessors]
- C++ working draft — basic_string::substr [string.substr]
- C++ working draft — Searching [string.find]
- C++ working draft — String view searching [string.view.find]
- C++ working draft — String literals [lex.string]
- cppreference — std::basic_string::size and std::basic_string::length