名前空間
変種
操作

std::align

提供: cppreference.com
< cpp‎ | memory
 
 
 
動的メモリ管理
未初期化記憶域
(C++17)
ガベージコレクションサポート
その他
(C++20)
(C++11)
align
(C++11)
C のライブラリ
低水準のメモリ管理
 
ヘッダ <memory> で定義
void* align( std::size_t alignment,

             std::size_t size,
             void*& ptr,

             std::size_t& space );
(C++11およびそれ以降)

サイズ space のバッファを指すポインタ ptr が与えられたとき、 size 個のバイトの指定された alignment によってアラインされたポインタを返し、 space 引数をアライメントのために使用されたバイト数だけ減少させます。 最初のアラインされたアドレスが返されます。

この関数は、指定されたアライメントによってアラインされた所望のバイト数をバッファに収めることができるであろう場合にのみ、ポインタを変更します。 バッファが小さすぎる場合、この関数は何もせず、 nullptr を返します。

alignment処理系がサポートしている基本または拡張アライメント (C++17以前)2の乗数 (C++17およびそれ以降)でなければ、動作は未定義です。

目次

[編集] 引数

alignment - 所望のアライメント
size - アラインされる記憶域のサイズ
ptr - 少なくとも space バイトの連続する記憶域へのポインタ
space - 操作するバッファのサイズ

[編集] 戻り値

ptr の調節された値、または提供された空間が小さすぎる場合はmヌルポインタ値。

[編集]

メモリ内に異なる型のオブジェクトを配置するための std::align の使用をデモンストレーションします。

#include <iostream>
#include <memory>
 
template <std::size_t N>
struct MyAllocator
{
    char data[N];
    void* p;
    std::size_t sz;
    MyAllocator() : p(data), sz(N) {}
    template <typename T>
    T* aligned_alloc(std::size_t a = alignof(T))
    {
        if (std::align(a, sizeof(T), p, sz))
        {
            T* result = reinterpret_cast<T*>(p);
            p = (char*)p + sizeof(T);
            sz -= sizeof(T);
            return result;
        }
        return nullptr;
    }
};
 
int main()
{
    MyAllocator<64> a;
 
    // allocate a char
    char* p1 = a.aligned_alloc<char>();
    if (p1)
        *p1 = 'a';
    std::cout << "allocated a char at " << (void*)p1 << '\n';
 
    // allocate an int
    int* p2 = a.aligned_alloc<int>();
    if (p2)
        *p2 = 1;
    std::cout << "allocated an int at " << (void*)p2 << '\n';
 
    // allocate an int, aligned at 32-byte boundary
    int* p3 = a.aligned_alloc<int>(32);
    if (p3)
        *p3 = 2;
    std::cout << "allocated an int at " << (void*)p3 << " (32 byte alignment)\n";
}

出力例:

allocated a char at 0x2ff21a08
allocated an int at 0x2ff21a0c
allocated an int at 0x2ff21a20 (32 byte alignment)

[編集] 関連項目

alignof 演算子 型のアライメント要件を問い合わせます (C++11およびそれ以降) [edit]
alignas 指定子 変数のための記憶域が指定の量でアラインされるべきであることを指定します (C++11) [edit]
指定されたサイズの未初期化記憶域として使用するのに適した型を定義します
(クラステンプレート) [edit]