メモリマップドファイルには Boost Interprocess Library を使用する。
Boost.Interprocessは、プロセス間通信をサポートするための各種機能を提供しているライブラリである。ライブラリはビルドを必要としないが、Boost DateTime Library を利用している箇所があるため注意すること。
またこのページでManaged Memory Segmentsについての記述は基本的にmanaged_mapped_file以外のクラス(managed_shared_memoryなど)でも同様の動作を行う。
インデックス
存在しているファイルからマッピングする
既に存在しているファイルをマッピングするには、boost::interprocess::file_mappingクラスを用いることで単純にマッピングすることができる。しかしこれだけではファイルにアクセスできないため、boost::interprocess::mapped_regionクラスでビューを作成してアクセスする。
namespace ipc = boost::interprocess;
ipc::file_mapping map("data.dat",ipc::read_only);
ipc::mapped_region view(map,ipc::read_only);
void* ptr = view.get_address(); // マッピングしたファイルの先頭アドレス
std::size_t const size = view.get_size(); // マッピングした領域のサイズ
std::vector<char> dat( size );
memcpy( dat.data(), ptr, size );
また、mapped_regionクラスのコンストラクタ引数でマッピングする領域を指定して、必要な部分のみをビューとして取り出せる。
std::size_t const offset = 0; // マッピング領域の開始位置(ファイル先頭から)
std::size_t const size = 128; // 領域のサイズ
ipc::mapped_region view(map,ipc::read_only,offset,size);
BOOST_ASSERT( size == view.get_size() );
ファイルをテンポラリバッファとして利用する
メモリマップドファイルの機能をテンポラリデータ保存のために利用することもできる。Boost.InterprocessにはManaged Memory Segmentsというオブジェクト生成支援関数群が用意されており、ファイルをテンポラリバッファとして利用するのが簡単になる。
managed_mapped_fileクラスのconstruct()メンバを使用し、find()メンバで検索可能なnamed instanceを生成、unique instanceやanonymous instanceも生成できる。
#include <boost/interprocess/managed_mapped_file.hpp>
#include <iostream>
int main()
{
namespace ipc = boost::interprocess;
ipc::file_mapping::remove( "tmp.dat" );
ipc::managed_mapped_file mfile( ipc::create_only, "tmp.dat", 4096 );
int* p = mfile.construct<int>("MyData")( 42 );
BOOST_ASSERT( *p == 42 );
BOOST_ASSERT( p == mfile.find<int>("MyData").first );
mfile.destroy<int>("MyData");
BOOST_ASSERT( !mfile.find<int>("MyData").first );
int* t = mfile.construct<int>(ipc::anonymous_instance)(42);
BOOST_ASSERT( *t == 42 );
mfile.destroy_ptr(t);
}
ファイルをコンテナにマッピングする
Boost.Interprocessには標準ライブラリと同様の使い方が可能なコンテナが用意されており、コンテナをManaged Memory Segmentsを使ってファイル上に直接構築することができる。また、Boost Multi-Index Containers Libraryも利用可能である。
基本的にはManaged Memory Segmentsクラスから取得できるsegment_managerを使ってアロケータを構築、そのアロケータを使ったコンテナを生成することでコンテナ並びにコンテナの要素をファイル上に構築できる。
#include <boost/interprocess/managed_mapped_file.hpp>
#include <boost/interprocess/containers/vector.hpp>
#include <boost/interprocess/allocators/allocator.hpp>
#include <iostream>
#include <boost/range/algorithm/generate.hpp>
#include <boost/range/algorithm/for_each.hpp>
int main()
{
namespace ipc = boost::interprocess;
typedef ipc::allocator<int,ipc::managed_mapped_file::segment_manager> allocator_t;
typedef ipc::vector<int,allocator_t> vector_t;
ipc::file_mapping::remove( "tmp.dat" );
ipc::managed_mapped_file mfile( ipc::create_only, "tmp.dat", 4096 );
vector_t* vec = mfile.construct<vector_t>("MyVector")(mfile.get_segment_manager());
vec->resize(10);
boost::generate(*vec,[](){ return 42; });
boost::for_each(*vec,[](int i) { std::cout << i << std::endl; } );
}