AssociativeDataStorageRef::create node

unique_interface_ptr<IDataStorage> create_node(const void* pKey, std::uint32_t cbKey, std::nothrow_t); //1
DataStorageOwn create_node(const void* pKey, std::uint32_t cbKey); //2
template <class T>
unique_interface_ptr<IDataStorage> create_node(const T* pKey, std::uint32_t cbKey, std::nothrow_t); //3
template <class T>
DataStorageOwn auto create_node(const T* pKey, std::uint32_t cbKey); //4
template <class value_t, class alloc_t>
unique_interface_ptr<IDataStorage> create_node(const std::vector<value_t, alloc_t>& refKey, std::nothrow_t); //5
template <class value_t, class alloc_t>
DataStorageOwn create_node(const std::vector<value_t, alloc_t>& refKey); //6
template <class traits_t, class alloc_t>
unique_interface_ptr<IDataStorage> create_node(const std::basic_string<char, traits_t, alloc_t>& refKey, std::nothrow_t); //7
template <class traits_t, class alloc_t>
DataStorageOwn create_node(const std::basic_string<char, traits_t, alloc_t>& refKey); //8
unique_interface_ptr<IDataStorage> create_node(const char* pszKey, std::nothrow_t); //9
DataStorageOwn create_node(const char* pszKey); //10

Создает новый узел и ассоциирует его с заданным ключом.

Нечетные перегрузки, возвращающие адаптер DataStorageOwn, генерируют исключение Chusov::Exceptions::AlreadyExistsException в случае, если добавление узла с указанным параметрически ключом, превысило бы установленное максимально допустимое количество узлов с одинаковым ключом, которое установлено реализацией. В противоположность им, четные перегрузки с параметром std::nothrow_t, которые возвращают смарт-указатель unique_interface_ptr, в этом случае не генерируют исключения, но возвращают объект unique_interface_ptr, сгенерированный по умолчанию.

1, 2 Ключ задается обобщенным C-указателем и байтовой длиной.

3, 4 Поиск осуществляется по ключу, который задан указателем на байтовые данные. Данная перегрузка участвует в процедуре разрешения перегрузки только, если T является целочисленным байтовым типом.

5, 6 Ключ поиска задается вектором байт, задающих ключевые данные.

7, 8 Ключ поиска задается C++-строкой.

9, 10 Ключ поиска задается C-строкой.

Параметры шаблона

T, value_t	Типы элемента ключа pKey в перегрузках 3-6. Эти перегрузки участвуют в процедуре разрешения перегрузки, только если типы элементов ключа являются целочисленными и байтовыми.
alloc_t	Тип менеджера памяти Allocator, используемого для управления временем жизни ключа refKey ключа в перегрузках 5-8. Тип используется только для дедукции типа параметра refKey и игнорируется при делегировании вызова методу IAssociativeDataStorage::CreateNode.
traits_t	Тип политики обработки CharTraits символов ключа в перегрузках 7 и 8. Тип используется только для дедукции типа параметра refKey и игнорируется при делегировании вызова методу IAssociativeDataStorage::CreateNode.

Параметры

[in]	pKey	Указатель C, адресующий байты ключа в перегрузках 1-4 метода create_node.
	cbKey	Байтовый размер ключа в перегрузках 1-4.
	refKey	Ссылка на вектор std::vector байт (перегрузки 5 и 6) или на C++ строку std::basic_string (перегрузки 7 и 8) символов с ключом.
[in]	pszKey	C-строка, завершающаяся терминальным нулем, задающая ключ при использовании для адресации данных перегрузкок 9 или 10.

Возвращаемое значение:

Уникальный указатель unique_interface_ptr<IDataStorage> или объект DataStorageOwn, которые адресует созданный пустой накопитель данных, связанный с созданным узлом. Если ключ не найден, нечетные перегрузки возвращают объект unique_interface_ptr, сконструированный по умолчанию.