The Clonable concept

Уточнение

• Распределяемая куча
• Куча размещаемых

Концепция Clonable введена для формализации требований к копированию объектов, расположенных в куче. ТипTможет быть клонируемым, даже если он не является подходящим или копируемым. Обратите внимание, что многие операции на контейнерах даже не требуют хранения.

Запись

Действительные выражения

namespace boost
{
    template< class T >
    inline T* new_clone( const T& t )
    {
        return new T( t );
    }
    template< class T >
    void delete_clone( const T* t )
    {
        checked_delete( t );
    }
}

The Clone Allocator concept

Концепция Clone Allocator введена для формализации способа управления памятью хранимых объектов (а не указателями на хранимые объекты). Распределитель клонов позволяет пользователям применять пользовательские распределители / распределители для клонированных объектов.

Более подробную информацию можно найти ниже:

namespace boost
{        
    struct heap_clone_allocator
    {
        template< class U >
        static U* allocate_clone( const U& r )
        {
            return new_clone( r );
        }
        template< class U >
        static void deallocate_clone( const U* r )
        {
            delete_clone( r );
        }
    };
}

namespace boost
{
    struct view_clone_allocator
    {
        template< class U >
        static U* allocate_clone( const U& r )
        {
            return const_cast<U*>(&r);
        }
        template< class U >
        static void deallocate_clone( const U* )
        {
            // empty
        }
    };
}

Class hierarchy

Библиотека состоит из следующих типов классов:

1. Адаптер контейнеров Pointer

2. Контейнеры Pointer

Адаптеры контейнера указателя используются, когда вы хотите сделать контейнер указателя, начиная с вашего собственного контейнера. Например, у вас может быть класс карты, который каким-то образом расширяетstd::map; класс адаптера затем позволяет использовать класс карты в качестве основы для нового контейнера указателей.

Библиотека предоставляет адаптер для каждого типа стандартного контейнера, выделенного в виде ссылок ниже:

• reversible_ptr_container
  • ptr_sequence_adapter
    • ptr_vector
    • ptr_list
    • ptr_deque
    • ptr_array
  • ассоциативный_ptr_контейнер
    • ptr_set_adapter
    • ptr_multiset_adapter
    • ptr_map_adapter
    • ptr_multi_map_adapter
      • ptr_set
      • ptr_multi_set
      • ptr_map
      • ptr_multimap

Контейнеры указателей этой библиотеки построены с использованием адаптеров. Существует контейнер указателей для каждого типа стандартного контейнера, выделенного в качестве ссылок ниже.

• обратимый_ptr_контейнер
  • ptr_sequence_adapter
    • ptr_vector
    • ptr_list
    • ptr_deque
    • ptr_array
  • ассоциативный_ptr_контейнер
    • ptr_set_adapter
    • ptr_multiset_adapter
    • ptr_map_adapter
    • ptr_multi_map_adapter
      • ptr_set
      • ptr_multi_set
      • ptr_map
      • ptr_multimap

Serialization

На версии 1.34.0 Boost библиотека поддерживает сериализацию черезBoost.Serialization.

Конечно, для работы с сериализацией требуется, чтобы сам хранимый тип был сериализуем. Для карт, как ключевой тип, так и картографический тип должны быть сериализуемыми.

При работе с сериализацией (и сериализацией полимофических объектов в частности) обращайте особое внимание на эти части Boost. Сериализация:

1. Output/saving requires a const-reference:

   //
   // serialization helper: we can't save a non-const object
   // 
   template< class T >
   inline T const& as_const( T const& r )
   {
       return r;
   }
   ...
   Container cont;
   std::ofstream ofs("filename");
   boost::archive::text_oarchive oa(ofs);
   oa << as_const(cont);
   

   Составьте временную ловушку при сохранении неконстантного значениядля деталей.

2. Derived classes need to call base_object() function:

   struct Derived : Base
   {
       template< class Archive >
       void serialize( Archive& ar, const unsigned int version )
       {
           ar & boost::serialization::base_object<Base>( *this );
           ...
       }   
   };
   

   Подробнее см.Производные классы.

3. You need to use BOOST_CLASS_EXPORT to register the derived classes in your class hierarchy:

   BOOST_CLASS_EXPORT( Derived )
   

   См.Экспортный ключиОтслеживание объектовдля деталей.

Запомните эти три проблемы, и это может избавить вас от некоторых проблем.

Class nullable

Цель класса состоит в том, чтобы просто сказать контейнерам, что нулевые значения должны быть разрешены. Его определение тривиально:

namespace boost
{
    template< class T >
    struct nullable
    {
        typedef T type;
    };  
}

Обратите внимание, чтоnullableне влияет на интерфейс контейнеров (кромеis_null()функций). Например, не имеет смысла делать

boost::ptr_vector< boost::nullable<T> > vec;
vec.push_back( 0 );                      // ok
vec.push_back( new boost::nullable<T> ); // no no!
boost::nullable<T>& ref = vec[0];        // also no no!

Exception classes

Есть три исключения, которые бросает эта библиотека. Исключительная иерархия выглядит следующим образом:

namespace boost
{
    class bad_ptr_container_operation : public std::exception
    {
    public:
        bad_ptr_container_operation( const char* what );
    };
    
    class bad_index : public bad_ptr_container_operation
    {
    public:
        bad_index( const char* what );
    };
    class bad_pointer : public bad_ptr_container_operation
    {
    public:
        bad_pointer();
        bad_pointer( const char* what );
    };
}

Disabling the use of exceptions

По версии 1.34.0 Boost библиотека позволяет полностью отключить исключения. Это означает, что библиотека больше подходит для доменов, где не используются исключения. Кроме того, он немного ускоряет операции. Вместо исключения библиотека просто вызываетBOOST_ASSERT.

Чтобы отключить исключения, просто определите этот макрос перед включением любого заголовка:

#define BOOST_PTR_CONTAINER_NO_EXCEPTIONS 1
#include <boost/ptr_container/ptr_vector.hpp>

Однако рекомендуется определить макрос в командной строке, поэтому вы абсолютно уверены, что все заголовки составлены одинаково. В противном случае вы можете нарушить правило одного определения.

ЕслиBOOST_NO_EXCEPTIONSопределено, затемBOOST_PTR_CONTAINER_NO_EXCEPTIONSтакже определено.

Навигация:

• Домой