名 前
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 が 返 さ れ る 。
属 性
マ ル チ ス レ ッ デ ィ ン グ (pthreads(7) 参 照 )
malloc_usable_size() 関 数 は ス レ ッ ド セ ー フ で あ る 。
準 拠
こ の 関 数 は GNU に よ る 拡 張 で あ る 。
注 意
malloc_usable_size() が 返 す 値 は 、 要 求 さ れ た 割 り 当 て サ イ ズ よ り も 大 き い 場 合 が あ る 。 こ れ は 、 メ モ リ ー ア ラ イ ン メ ン ト と 最 小 サ イ ズ の 制 約 の た め で あ る 。 こ の 超 過 バ イ ト を ア プ リ ケ ー シ ョ ン は 悪 影 響 な し で 上 書 き す る こ と が で き る が 、 こ れ を 行 う の は プ ロ グ ラ ミ ン グ マ ナ ー と し て は よ い こ と と は 言 え な い 。 ア プ リ ケ ー シ ョ ン の 超 過 バ イ ト の 量 は 、 内 部 の 実 装 に 依 存 す る 。 こ の 関 数 の 主 な 使 用 目 的 は デ バ ッ グ と 内 部 調 査 で あ る 。
関 連 項 目
こ の 文 書 に つ い て
こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。