CKTIS / C++
std::basic_string::find — търсене на поднизове и задължителни разделители
Намерете първото съвпадение от дадена позиция, проверете за `npos` и задайте дължината на шаблона, ако буферът може да съдържа нулеви символи.
Версия: ISO C++23; implementation support may vary
Синтаксис
// ISO C++23; member declarations of std::basic_string<CharT, Traits, Allocator> in <string>
constexpr size_type find(const basic_string& str, size_type pos = 0) const noexcept;
constexpr size_type find(const CharT* s, size_type pos, size_type count) const;
constexpr size_type find(const CharT* s, size_type pos = 0) const;
constexpr size_type find(CharT ch, size_type pos = 0) const noexcept;
template<class T>
constexpr size_type find(const T& t, size_type pos = 0) const
noexcept(std::is_nothrow_convertible_v<const T&, std::basic_string_view<CharT, Traits>>);
// The template participates only if const T& is implicitly convertible to
// std::basic_string_view<CharT, Traits> but not to const CharT*.std::basic_string::find е член-функция const от <string>, достъпна и за std::string. Тя връща индекс от тип size_type, броен от нула: първата позиция от pos нататък (по подразбиране 0), на която целият шаблон се побира и съвпада. Елементите се сравняват чрез Traits::eq. При UTF-8, съхранен в std::string, индексът брои байтове, а не символи, видими за потребителя.
При липса на съвпадение функцията връща npos, най-голямата стойност на size_type, без да хвърля изключение. Празен шаблон съвпада на позиция pos точно когато pos <= size(); непразен шаблон не може да съвпадне, когато pos >= size(). При задължителен разделител проверете за npos, преди да индексирате, да извлечете подниз или да изчислите отместване. Индекс 0 е валиден резултат.
find(ch, pos) търси един елемент CharT; find(str, pos) използва пълната дължина на обект basic_string. find(p, pos) изисква последователност, завършваща с нулев символ: Traits::length спира при първия нулев символ. find(p, pos, count) използва точно count елемента от шаблона, включително вътрешните нулеви символи. Вторият аргумент е начална позиция, не дължина; count не ограничава низа, в който се търси. Невалиден диапазон, зададен чрез указател, води до неопределено поведение. Проверете дали count не надхвърля броя на достъпните за четене елементи от p нататък.
От C++17 шаблонното претоварване приема const T&, ако е неявно преобразуем към std::basic_string_view<CharT, Traits>, но не и към const CharT*. Изгледът пази дължината си, но не притежава данните. Данните, към които сочи указателят или препраща изгледът, трябва да останат валидни през цялото извикване. За буфер std::vector<char> използвайте data() заедно със size(); не разчитайте на краен нулев символ.
Всички претоварвания са constexpr от C++20. В C++23 вариантите за basic_string и CharT са noexcept, вариантите с указател не са декларирани като noexcept, а шаблонният вариант е noexcept само ако преобразуването към изглед не може да хвърли изключение. Поддръжката може да се различава според реализацията.
Примери
#include <iostream>
#include <string>
#include <string_view>
#include <vector>
int main() {
const std::string record{"A:B:\0=C", 7};
const std::vector<char> separator{':', '\0', '='};
std::cout << "C string: " << record.find(separator.data()) << '\n';
const auto split = record.find(separator.data(), 0, separator.size());
if (split == std::string::npos) {
std::cout << "Missing required separator\n";
return 1;
}
std::cout << "Counted separator: " << split << '\n';
const std::string_view marker{separator.data(), separator.size()};
const auto start = split + 1;
const auto next = record.find(marker, start);
std::cout << "From index " << start << ": ";
if (next == std::string::npos) {
std::cout << "not found\n";
} else {
std::cout << next << '\n';
}
}Резултат
C string: 1 Counted separator: 3 From index 4: not found
Извикването само с указател търси `:` и връща `1`. Извикването с дължина намира целия задължителен разделител `:\0=` на индекс `3`. Търсенето на същия шаблон като изглед от индекс `4` връща `npos`.
Свързани уроци
- C++ · Урок 58 · Напреднало · Версия: 3
Източници
- Draft C++ Standard — basic_string searching [string.find]
- Draft C++ Standard — basic_string_view searching [string.view.find]
- Draft C++ Standard — basic_string_view construction and assignment [string.view.cons]
- Draft C++ Standard — Class template basic_string [basic.string]
- Draft C++ Standard — vector data [vector.data]
- WG21 N4950 — Working Draft, Standard for Programming Language C++