Просмотр кода страницы AssociativeDataStorageInputRef::find node

{{DISPLAYTITLE:AssociativeDataStorageInputRef::find_node}}
{{function_begin|unique_interface_ptr<IDataStorage> find_node(const void* pKey, std::uint32_t cbKey, std::nothrow_t) const; //1
DataStorageOwn find_node(const void* pKey, std::uint32_t cbKey) const; //2
template <class T>
unique_interface_ptr<IDataStorage>  find_node(const T* pKey, std::uint32_t cbKey, std::nothrow_t) const; //3
template <class T>
DataStorageOwn find_node(const T* pKey, std::uint32_t cbKey) const; //4
template <class value_t, class alloc_t>
unique_interface_ptr<IDataStorage> find_node(const std::vector<value_t, alloc_t>& refKey, std::nothrow_t) const; //5
template <class value_t, class alloc_t>
DataStorageOwn find_node(const std::vector<value_t, alloc_t>& refKey) const; //6
template <class traits_t, class alloc_t>
unique_interface_ptr<IDataStorage> find_node(const std::basic_string<char, traits_t, alloc_t>& refKey, std::nothrow_t) const; //7
template <class traits_t, class alloc_t>
DataStorageOwn find_node(const std::basic_string<char, traits_t, alloc_t>& refKey) const; //8
unique_interface_ptr<IDataStorage> find_node(const char* pszKey, std::nothrow_t) const; //9
DataStorageOwn find_node(const char* pszKey) const; //10
|{{AssociativeDataStorageInputRef::find_node brief}}
# Ключ задается обобщенным C-указателем и байтовой длиной. Если узел не найден, возвращается пустой указатель.
# Аналогично, но если узел не найден, генерируется исключение {{chsvlib_exception|NotFoundException}}.
# Поиск осуществляется по ключу, который задан указателем на байтовые данные. Данная перегрузка участвует в процедуре разрешения перегрузки только, если {{param|T}} является целочисленным байтовым типом. Если узел не найден, возвращается пустой указатель.
# Аналогично, но с генерацией исключения {{chsvlib_exception|NotFoundException}}, если узел с заданным ключом не существует.
# Ключ поиска задается [https://en.cppreference.com/w/cpp/container/vector вектором] байт, задающих ключевые данные. Если ассоциированный с ключом узел не найден, возвращается пустой указатель.
# Аналогично, но с генерацией исключения {{chsvlib_exception|NotFoundException}}, если узел с заданным ключом не существует.
# Ключ поиска задается [https://en.cppreference.com/w/cpp/string/basic_string C++-строкой]. Если ассоциированный с ключом узел не найден, возвращается пустой указатель.
# Аналогично, но если узел не найден, генерируется исключение {{chsvlib_exception|NotFoundException}}.
# Ключ поиска задается C-строкой. Если ассоциированный с ключом узел не найден, возвращается пустой указатель.
# Аналогично, но с генерацией исключения {{chsvlib_exception|NotFoundException}}, если ключ не найден.}}
{{function template paramlist begin}}
{{function template paramlist add|T, value_t|Типы элемента ключа {{param|pKey}} в перегрузках 3-6. Эти перегрузки участвуют в процедуре разрешения перегрузки, только если типы элементов ключа являются целочисленными и байтовыми.}}
{{function template paramlist add|alloc_t|Тип менеджера памяти {{cpp_concept|Allocator}}, используемого для управления временем жизни ключа {{param|refKey}} ключа в перегрузках 5-8. Тип используется только для дедукции типа параметра {{param|refKey}} и игнорируется при делегировании вызова методу [[IAssociativeDataStorageInput::FindNode]].}}
{{function template paramlist add|traits_t|Тип политики обработки {{cpp_concept|CharTraits}} символов ключа в перегрузках 7 и 8. Тип используется только для дедукции типа параметра {{param|refKey}} и игнорируется при делегировании вызова методу [[IAssociativeDataStorageInput::FindNode]].}}
{{function template paramlist end}}
{{function paramlist begin}}
{{function paramlist add|pKey|Указатель C, адресующий байты ключа в перегрузках 1-4 метода [[AssociativeDataStorageInputRef::find_node|find_node]].|paramdir=[in]}}
{{function paramlist add|cbKey|Байтовый размер ключа в перегрузках 1-4.}}
{{function paramlist add|refKey|Ссылка на вектор [https://en.cppreference.com/w/cpp/container/vector std::vector] байт (перегрузки 5 и 6) или на C++ строку [https://en.cppreference.com/w/cpp/string/basic_string std::basic_string] (перегрузки 7 и 8) символов с ключом.}}
{{function paramlist add|pszKey|C-строка, завершающаяся терминальным нулем, задающая ключ при использовании для адресации данных перегрузкок 9 или 10.|paramdir=[in]}}
{{function paramlist end}}
{{function return_value|Уникальный указатель <source lang="cpp" inline>unique_interface_ptr<IDataStorage></source> или объект [[DataStorageOwn]], которые адресует накопитель данных, связанный с узлом, который найден в результате поиска по ключу. Если ключ не найден, нечетные перегрузки возвращают объект [[unique_interface_ptr]], сконструированный по умолчанию.}}
{{function_end}}