1 files changed, 96 insertions, 0 deletions
diff --git a/src/boost/libs/interprocess/example/doc_where_allocate.cpp b/src/boost/libs/interprocess/example/doc_where_allocate.cpp
new file mode 100644
index 00000000..c8f14f16
--- /dev/null
+++ b/src/boost/libs/interprocess/example/doc_where_allocate.cpp
@@ -0,0 +1,96 @@
+//////////////////////////////////////////////////////////////////////////////
+//
+// (C) Copyright Ion Gaztanaga 2006-2012. Distributed under the Boost
+// Software License, Version 1.0. (See accompanying file
+// LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+//
+// See http://www.boost.org/libs/interprocess for documentation.
+//
+//////////////////////////////////////////////////////////////////////////////
+#include <boost/interprocess/detail/config_begin.hpp>
+#include <boost/interprocess/detail/workaround.hpp>
+//[doc_where_allocate
+#include <boost/interprocess/managed_shared_memory.hpp>
+#include <boost/interprocess/containers/vector.hpp>
+#include <boost/interprocess/containers/string.hpp>
+#include <boost/interprocess/allocators/allocator.hpp>
+//<-
+#include "../test/get_process_id_name.hpp"
+//->
+
+int main ()
+{
+   using namespace boost::interprocess;
+   //Typedefs
+   typedef allocator<char, managed_shared_memory::segment_manager>
+      CharAllocator;
+   typedef basic_string<char, std::char_traits<char>, CharAllocator>
+      MyShmString;
+   typedef allocator<MyShmString, managed_shared_memory::segment_manager>
+      StringAllocator;
+   typedef vector<MyShmString, StringAllocator>
+      MyShmStringVector;
+
+   //Open shared memory
+   //Remove shared memory on construction and destruction
+   struct shm_remove
+   {
+   //<-
+   #if 1
+      shm_remove() { shared_memory_object::remove(test::get_process_id_name()); }
+      ~shm_remove(){ shared_memory_object::remove(test::get_process_id_name()); }
+   #else
+   //->
+      shm_remove() { shared_memory_object::remove("MySharedMemory"); }
+      ~shm_remove(){ shared_memory_object::remove("MySharedMemory"); }
+   //<-
+   #endif
+   //->
+   } remover;
+   //<-
+   (void)remover;
+   //->
+
+   //<-
+   #if 1
+   managed_shared_memory shm(create_only, test::get_process_id_name(), 10000);
+   #else
+   //->
+   managed_shared_memory shm(create_only, "MySharedMemory", 10000);
+   //<-
+   #endif
+   //->
+
+   //Create allocators
+   CharAllocator     charallocator  (shm.get_segment_manager());
+   StringAllocator   stringallocator(shm.get_segment_manager());
+
+   //This string is in only in this process (the pointer pointing to the
+   //buffer that will hold the text is not in shared memory).
+   //But the buffer that will hold "this is my text" is allocated from
+   //shared memory
+   MyShmString mystring(charallocator);
+   mystring = "this is my text";
+
+   //This vector is only in this process (the pointer pointing to the
+   //buffer that will hold the MyShmString-s is not in shared memory).
+   //But the buffer that will hold 10 MyShmString-s is allocated from
+   //shared memory using StringAllocator. Since strings use a shared
+   //memory allocator (CharAllocator) the 10 buffers that hold
+   //"this is my text" text are also in shared memory.
+   MyShmStringVector myvector(stringallocator);
+   myvector.insert(myvector.begin(), 10, mystring);
+
+   //This vector is fully constructed in shared memory. All pointers
+   //buffers are constructed in the same shared memory segment
+   //This vector can be safely accessed from other processes.
+   MyShmStringVector *myshmvector =
+      shm.construct<MyShmStringVector>("myshmvector")(stringallocator);
+   myshmvector->insert(myshmvector->begin(), 10, mystring);
+
+   //Destroy vector. This will free all strings that the vector contains
+   shm.destroy_ptr(myshmvector);
+   return 0;
+}
+//]
+#include <boost/interprocess/detail/config_end.hpp>