c/memory/aligned allocのソースを表示

あなたには「このページの編集」を行う権限がありません。理由は以下の通りです:

この操作は、次のグループのいずれかに属する利用者のみが実行できます: 登録利用者、管理者。

このページのソースの閲覧やコピーができます。

{{c/title|aligned_alloc}}
{{c/memory/navbar}}
{{ddcl | header=stdlib.h | since=c11 | 
void *aligned_alloc( size_t alignment, size_t size );
}}

{{tt|alignment}} で指定されたアライメントを持つ {{tt|size}} バイトの未初期化記憶域を確保します。 {{tt|size}} 引数は {{tt|alignment}} の整数倍でなければなりません。

{{tt|aligned_alloc}} はスレッドセーフです。 引数を通して可視となるメモリ位置にのみアクセスし、いかなる静的記憶域にもアクセスしないかのように振る舞います。

メモリ領域を解放する {{lc|free}} または {{lc|realloc}} の以前の呼び出しは、同じメモリ領域またはその一部を確保する {{lc|aligned_alloc}} の呼び出しに対して''同期''します。 この同期は解放関数によるそのメモリに対するいかなるアクセスよりも後でかつ {{tt|aligned_alloc}} によるそのメモリに対するいかなるアクセスよりも前に発生します。 個々の特定のメモリ領域を操作するすべての確保関数および解放関数に単一の全順序が存在します。

=== 引数 ===
{{par begin}}
{{par | alignment | アライメントを指定します。 処理系がサポートしている有効なアライメントでなければなりません }}
{{par | size | 確保するバイト数。 {{tt|alignment}} の整数倍でなければなりません }}
{{par end}}

===戻り値===
成功した場合は、新たに確保されたメモリの先頭を指すポインタを返します。 メモリリークを避けるためには、返されたポインタは {{lc|free()}} または {{tt|realloc()}} で解放しなければなりません。

失敗した場合は、ヌルポインタを返します。

=== ノート ===
{{tt|alignment}} の整数倍でない {{tt|size}} を渡したり、有効でないまたは処理系がサポートしていない {{tt|alignment}} を渡したりすると、関数は失敗し、ヌルポインタを返します (このケースは C11 の発行時点では未定義動作と規定されていましたが、 DR 460 で訂正されました)。 小さなオブジェクトをより厳しいアライメント境界で割り当てる ({{ltt|c/language/_Alignas|alignas}} と同様に) ことができるようサイズの制約を除去することが [http://www.open-std.org/jtc1/sc22/wg14/www/docs/n2072.htm n2072] で提案されています。

「処理系がサポートしている」の例として、 POSIX の関数 [http://pubs.opengroup.org/onlinepubs/9699919799/functions/posix_memalign.html posix_memalign] は2の乗数かつ {{tt|sizeof(void *)}} の倍数である任意の {{tt|alignment}} を受理します。 POSIX ベースの処理系の {{tt|aligned_alloc}} はこの要求を引き継いでいます。

通常の {{lc|malloc}} はあらゆるオブジェクト型に適したメモリアライメントを行います (これは実質的には {{c|alignof(max_align_t)}} にアラインすることを意味しています)。 {{tt|aligned_alloc}} は SSE やキャッシュライン、あるいは仮想メモリのページ境界などに対するオーバーアラインされた確保のために役に立ちます。

===例===
{{example|code=
#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    int *p1 = malloc(10*sizeof *p1);
    printf("default-aligned addr:   %p\n", (void*)p1);
    free(p1);

    int *p2 = aligned_alloc(1024, 1024*sizeof *p2);
    printf("1024-byte aligned addr: %p\n", (void*)p2);
    free(p2);
}
|p=true
|output=
default-aligned addr:   0x1e40c20
1024-byte aligned addr: 0x1e41000
}}

===参考文献===
{{ref std c11}}
{{ref std | section=7.22.3.1 | title=The aligned_alloc function | p=347-348}}
{{ref std end}}

===関連項目===
{{dsc begin}}
{{dsc see cpp | cpp/memory/c/aligned_alloc}}
{{dsc end}}

{{langlinks|ar|cs|de|en|es|fr|it|ko|pl|pt|ru|tr|zh}}

このページで使用されているテンプレート:

c/memory/aligned alloc に戻る。

cppreference.com

検索

名前空間

変種

表示

操作

c/memory/aligned allocのソースを表示

案内

ツール