База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::basic_string::substr — подниз със собствени данни

Извлечи част от низ в нов низ, който притежава данните си. Виж как се ограничава дължината, кога началната позиция предизвиква изключение и какво променя претоварването за rvalue в C++23.

Версия: ISO C++23; implementation support may vary

Синтаксис

// 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 е член-функция, декларирана в <string>. s.substr(pos, count) връща нов низ от същия тип, който притежава данните си. pos е начален индекс, броен от нула; count е брой елементи, а не краен индекс. По подразбиране pos е 0, а count е npos, тоест „до края“.

При pos <= s.size() резултатът съдържа std::min(count, s.size() - pos) елемента. Прекалено голямо count се ограничава до наличните елементи. pos == s.size() или count == 0 при валидно pos дава празен низ. pos > s.size() хвърля std::out_of_range дори при count == 0. Проверявай за отрицателни входни стойности преди преобразуване към беззнаковия тип size_type и проверявай дължината преди s.size() - 4, за да избегнеш превъртане при беззнаковото изваждане.

Преди C++23 има едно претоварване const, което е constexpr от C++20. В C++23 и двете претоварвания са constexpr; поддръжката може да зависи от библиотеката. const & копира избрания диапазон, без да променя източника. && се избира за неконстантна rvalue, например std::move(s), и може да използва повторно паметта на източника, но не е гарантирано, че няма да задели памет. След успешно извикване източникът е валиден, но в неспецифицирано състояние. И двете претоварвания конструират алокатора на резултата по подразбиране, вместо да копират s.get_allocator(). При изключение източникът не се променя.

Позициите и дължините броят елементи CharT: байтове при std::string и кодови единици на UTF-8 от тип char8_t при std::u8string. Изрязването на UTF-8 може да раздели кодова точка. substr запазва вградените нулеви елементи; за точно копиране на целия диапазон подай и s.data(), и s.size() на конструктора на низа, а не само указателя. Резултатът от std::basic_string_view::substr само сочи към данните; използвай го, докато паметта, към която сочи, остава валидна.

За букви и цифри от основния набор от знаци s.substr(0, 3) взема до три букви, ако са в началото, а s.substr(3) взема остатъка при s.size() >= 3. substr извлича диапазон, но не филтрира. Ако низът вече съдържа само цифри и има поне четири елемента, използвай digits.substr(digits.size() - 4); иначе добави отпред нулите от std::string(4 - digits.size(), '0').

Примери

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

Резултат

ABC
12345
2345
0007
[]
out_of_range

Примерът показва префикс, ограничаване на броя елементи, запазване на последните четири цифри или допълване с нули отляво и разликата между начало на извличането в края на низа и след него.

Свързани уроци

  • C++ · Урок 49 · Напреднало · Версия: 3
  • C++ · Урок 53 · Напреднало · Версия: 3

Източници