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
Източници
- N4950 — Working Draft, Programming Languages — C++ (C++23)
- [basic.string] Class template basic_string
- [conv.integral] Integral conversions
- [string.find] basic_string searching
- [string.view.find] basic_string_view searching
- [string.substr] basic_string::substr
- [string.cons] basic_string constructors and assignment operators
- [string.append] basic_string::append
- [string.assign] basic_string::assign