CKTIS / C++
std::basic_string::substr — podciąg z własnymi danymi
Wytnij fragment łańcucha do nowego obiektu. Dowiedz się, jak działa ograniczanie długości, kiedy pozycja powoduje wyjątek i co zmienia przeciążenie dla r-wartości w C++23.
Wersja: ISO C++23; implementation support may vary
Składnia
// ISO C++23 — member declarations in std::basic_string (<string>)
constexpr basic_string substr(size_type pos = 0, size_type count = npos) const &;
constexpr basic_string substr(size_type pos = 0, size_type count = npos) &&;std::basic_string::substr to funkcja składowa z nagłówka <string>. Wywołanie s.substr(pos, count) zwraca nowy łańcuch tego samego typu, który sam przechowuje swoje dane. pos to indeks od zera, a count to liczba elementów, nie indeks końcowy. Domyślne pos ma wartość 0, a domyślne count to npos, czyli „do końca”.
Jeśli pos <= s.size(), wynik ma std::min(count, s.size() - pos) elementów. Za duże count zostaje ograniczone; pos == s.size() lub count == 0 przy poprawnym pos daje pusty wynik. pos > s.size() powoduje std::out_of_range nawet przy count == 0. Sprawdzaj ujemne dane wejściowe przed konwersją na bez znaku size_type; sprawdzaj też długość przed s.size() - 4, aby uniknąć zawinięcia wyniku odejmowania.
Przed C++23 istniało jedno przeciążenie const, oznaczone jako constexpr od C++20. W C++23 oba przeciążenia są constexpr; obsługa zależy od implementacji biblioteki. const & kopiuje wybrany zakres bez zmiany źródła. && jest wybierane dla nieconstowej r-wartości, np. std::move(s), i może wykorzystać pamięć źródła, ale nie gwarantuje braku alokacji. Po udanym wywołaniu źródło pozostaje w poprawnym, lecz nieokreślonym stanie. Oba przeciążenia domyślnie konstruują alokator wyniku zamiast kopiować s.get_allocator(). Jeśli zostanie zgłoszony wyjątek, źródło pozostaje bez zmian.
Indeksy i długości liczą elementy CharT: dla std::string są to bajty, a dla std::u8string jednostki kodowe UTF-8 typu char8_t. Przycinanie UTF-8 może rozdzielić punkt kodowy. substr zachowuje osadzone elementy zerowe; aby skopiować dokładnie cały zakres, przekaż konstruktorowi s.data() i s.size(), a nie sam wskaźnik. W przeciwieństwie do łańcucha wynik std::basic_string_view::substr nie jest właścicielem danych; używaj go tylko, dopóki pamięć źródłowa pozostaje ważna.
Dla liter i cyfr z podstawowego zestawu znaków s.substr(0, 3) bierze do trzech pierwszych liter, jeśli są na początku, a s.substr(3) bierze resztę, jeśli s.size() >= 3. substr wycina, ale nie filtruje. Dla łańcucha już złożonego z cyfr wybierz digits.substr(digits.size() - 4), gdy ma co najmniej cztery elementy; w przeciwnym razie poprzedź go zerami z std::string(4 - digits.size(), '0').
Przykłady
#include <iostream>
#include <stdexcept>
#include <string>
std::string last_four(const std::string& digits) {
if (digits.size() < 4) {
return std::string(4 - digits.size(), '0') + digits;
}
return digits.substr(digits.size() - 4);
}
int main() {
const std::string label = "ABC12345";
std::cout << label.substr(0, 3) << '\n';
std::cout << label.substr(3, 99) << '\n';
std::cout << last_four(label.substr(3)) << '\n';
std::cout << last_four("7") << '\n';
std::cout << '[' << label.substr(label.size()) << "]\n";
try {
(void)label.substr(label.size() + 1, 0);
} catch (const std::out_of_range&) {
std::cout << "out_of_range\n";
}
}Wynik
ABC 12345 2345 0007 [] out_of_range
Przykład pokazuje prefiks, ograniczenie nadmiernej długości, zachowanie ostatnich czterech cyfr lub dopełnienie zerami z lewej oraz różnicę między pozycją na końcu a pozycją poza końcem.
Powiązane lekcje
- C++ · Lekcja 49 · Zaawansowany · Wersja: 3
- C++ · Lekcja 53 · Zaawansowany · Wersja: 3