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

CKTIS / C++

std::basic_string::npos — няма съвпадение или до края

Сравни резултата от `find` с `npos`, преди да го използваш като индекс. Като брой елементи в `substr` същата константа означава остатъка от низа.

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

Синтаксис

static constexpr size_type npos = size_type(-1); // member of std::basic_string in <string>
std::basic_string<CharT, Traits, Allocator>::npos
std::string::npos // for std::basic_string<char>

std::basic_string::npos е статичен член constexpr, деклариран в <string>. Инициализаторът size_type(-1) преобразува -1 в най-голямата стойност на беззнаковия тип size_type за съответната специализация. Това не е отрицателно число, нито текущата дължина size(). За std::string използвай std::string::npos.

find връща индекса на първото съвпадение, като броенето започва от нула, или npos, ако няма съвпадение. Запази резултата с auto или в size_type, а не в int, и го сравни с npos преди индексиране или изчисляване на pos + 1. Ако задължителният разделител липсва, отхвърли записа. За разлика от това, стойността по подразбиране pos = npos при rfind не поставя горна граница на позицията на съвпадението; върнатото npos все така означава, че няма съвпадение.

В substr(pos, count) стойността по подразбиране count = npos означава „от pos до края“. Твърде големият брой се ограничава до size() - pos, но pos > size() предизвиква изключение std::out_of_range; при pos == size() резултатът е празен низ. В C++23 и двата претоварени варианта на substr, const & и &&, връщат низ, който притежава данните си, а не изглед.

„До края“ важи и за append(src, pos, n) и assign(src, pos, n), когато източникът е basic_string. За разлика от тях append(ptr, n) и assign(ptr, n) изискват действителен брой елементи, достъпни чрез указателя. Не подавай npos като дължина на буфер. Ако подаваш стойностите от data() и size() на интерфейс, който приема указател и дължина, провери изискванията му за диапазона и времето на живот на данните.

Примери

#include <iostream>
#include <string>

int main() {
    const std::string records[] = {"mode=fast", "mode"};
    for (const auto& record : records) {
        const auto sep = record.find('=');
        if (sep == std::string::npos) {
            std::cout << "missing '='\n";
            continue;
        }
        const auto key = record.substr(0, sep);
        const auto value = record.substr(sep + 1, std::string::npos);
        std::cout << key << ": " << value << '\n';
    }
}

Резултат

mode: fast
missing '='

Първият запис се разделя на ключ `mode` и стойност `fast`, които се отпечатват с двоеточие между тях. Във втория запис липсва `=`, затова програмата съобщава за грешката, преди да изчисли началната позиция на стойността.

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

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

Източници