AssociativeDataStorageOutputRef::delete_node

Материал из CAMaaS preliminary wiki
Перейти к навигации Перейти к поиску
bool delete_node(const void* pKey, std::uint32_t cbKey, std::nothrow_t); //1
void delete_node(const void* pKey, std::uint32_t cbKey); //2
template <class T>
bool delete_node(const T* pKey, std::uint32_t cbKey, std::nothrow_t); //3
template <class T>
void delete_node(const T* pKey, std::uint32_t cbKey); //4
template <class value_t, class alloc_t>
bool delete_node(const std::vector<value_t, alloc_t>& refKey, std::nothrow_t); //5
template <class value_t, class alloc_t>
void delete_node(const std::vector<value_t, alloc_t>& refKey); //6
template <class traits_t, class alloc_t>
bool delete_node(const std::basic_string<char, traits_t, alloc_t>& refKey, std::nothrow_t); //7
template <class traits_t, class alloc_t>
void delete_node(const std::basic_string<char, traits_t, alloc_t>& refKey); //8
bool delete_node(const char* pszKey, std::nothrow_t); //9
void delete_node(const char* pszKey); //10

Удаляет ключ, идентифицируемый ключом.

  1. Ключ задается обобщенным C-указателем и байтовой длиной. Если узел не найден, возвращается false.
  2. Аналогично, но если узел не найден, генерируется исключение Chusov::Exceptions::NotFoundException.
  3. Поиск осуществляется по ключу, который задан указателем на байтовые данные. Данная перегрузка участвует в процедуре разрешения перегрузки только, если T является целочисленным байтовым типом. Если узел не найден, возвращается false.
  4. Аналогично, но с генерацией исключения Chusov::Exceptions::NotFoundException, если узел с заданным ключом не существует.
  5. Ключ поиска задается вектором байт, задающих ключевые данные. Если ассоциированный с ключом узел не найден, возвращается false.
  6. Аналогично, но с генерацией исключения Chusov::Exceptions::NotFoundException, если узел с заданным ключом не существует.
  7. Ключ поиска задается C++-строкой. Если ассоциированный с ключом узел не найден, возвращается false.
  8. Аналогично, но если узел не найден, генерируется исключение Chusov::Exceptions::NotFoundException.
  9. Ключ поиска задается C-строкой. Если ассоциированный с ключом узел не найден, возвращается false.
  10. Аналогично, но с генерацией исключения Chusov::Exceptions::NotFoundException, если ключ не найден.
Параметры шаблона
T, value_tТипы элемента ключа pKey в перегрузках 3-6. Эти перегрузки участвуют в процедуре разрешения перегрузки, только если типы элементов ключа являются целочисленными и байтовыми.
alloc_tТип менеджера памяти Allocator, используемого для управления временем жизни ключа refKey ключа в перегрузках 5-8. Тип используется только для дедукции типа параметра refKey и игнорируется при делегировании вызова методу IAssociativeDataStorageOutput::DeleteNode.
traits_tТип политики обработки CharTraits символов ключа в перегрузках 7 и 8. Тип используется только для дедукции типа параметра refKey и игнорируется при делегировании вызова методу IAssociativeDataStorageOutput::DeleteNode.
Параметры
[in]pKeyУказатель C, адресующий байты ключа в перегрузках 1-4 метода delete_node.
cbKeyБайтовый размер ключа в перегрузках 1-4.
refKeyСсылка на вектор std::vector байт (перегрузки 5 и 6) или на C++ строку std::basic_string (перегрузки 7 и 8) символов с ключом.
[in]pszKeyC-строка, завершающаяся терминальным нулем, задающая ключ при использовании для адресации данных перегрузкок 9 или 10.
Возвращаемое значение:
Нечетные перегрузки с параметром std::nothrow_t возвращают true, если удаление было завершено, и false - в случае, если узел с заданным ключом не найден.