malloc_usable_size - ヒープから確保したメモリーブロックのサイズを取得する
#include <malloc.h>
size_t malloc_usable_size (void *ptr);
malloc_usable_size() 関数は、 ptr が指すブロックで使用可能なバイト数を返す。 ptr は、malloc(3) や同様の関数で割り当てられたメモリーブロックへのポインターである。
malloc_usable_size() は ptr が指す割り当て済みメモリーブロックで使用可能なバイト数を返す。 ptr が NULL の場合、 0 が返される。
この節で使用されている用語の説明については、 attributes(7)EN を参照。
| インターフェース | 属性 | 値 |
| malloc_usable_size() | Thread safety | MT-Safe |
malloc_usable_size() が返す値は、 要求された割り当てサイズよりも大きい場合がある。 これは、メモリーアラインメントと最小サイズの制約のためである。 この超過バイトをアプリケーションは悪影響なしで上書きすることができるが、 これを行うのはプログラミングマナーとしてはよいこととは言えない。 アプリケーションの超過バイトの量は、内部の実装に依存する。
この関数の主な使用目的はデバッグと内部調査である。
この man ページは Linux man-pages プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は https://www.kernel.org/doc/man-pages/ に書かれている。