choco_memory.c File Reference

不定期に発生するメモリ確保、解放に対応するメモリアロケータモジュールの実装 More...

#include <stdalign.h>
#include <stddef.h>
#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include "engine/base/choco_macros.h"
#include "engine/base/choco_message.h"
#include "engine/core/memory/choco_memory.h"

Include dependency graph for choco_memory.c:

Data Structures
struct	memory_system
	メモリシステム内部状態管理構造体 More...

Typedefs
typedef struct memory_system	memory_system_t
	メモリシステム内部状態管理構造体

Functions
memory_system_result_t	memory_system_create (void)
	メモリシステムを起動する
void	memory_system_destroy (void)
	メモリシステムを停止する
memory_system_result_t	memory_system_allocate (size_t size_, memory_tag_t mem_tag_, void **out_ptr_)
	容量size_のメモリを確保し、mem_tag_で指定されたメモリタグのメモリ使用量を更新する
void	memory_system_free (void *ptr_, size_t size_, memory_tag_t mem_tag_)
	ptr_が保持する領域のメモリを解放し、mem_tag_で指定されたメモリタグのメモリ使用量を更新する
void	memory_system_report (void)
	メモリシステムが管理しているメモリ使用量状態を標準出力に出力する

Detailed Description

不定期に発生するメモリ確保、解放に対応するメモリアロケータモジュールの実装

Author

chocolate-pie24

Version

0.1

Date

2025-09-20

Copyright

Copyright (c) 2025 chocolate-pie24

License

MIT License. See LICENSE file in the project root for full license text.

Typedef Documentation

memory_system_t

typedef struct memory_system memory_system_t

メモリシステム内部状態管理構造体

Function Documentation

memory_system_allocate()

memory_system_result_t memory_system_allocate	(	size_t	size_,
		memory_tag_t	mem_tag_,
		void **	out_ptr_
	)

容量size_のメモリを確保し、mem_tag_で指定されたメモリタグのメモリ使用量を更新する

Note

• 割り当ての際にはmemory_tag_tを指定することで、各メモリタグごとの合計割り当てサイズと総メモリ割り当てサイズをトラッキングする
• 本関数を使用する前に、memory_system_createでメモリシステムの初期化を行うこと
• max_align_tでアラインされたメモリが割り当てられる

Parameters

[in]	size_	割り当てサイズ
[in]	mem_tag_	メモリタグ
[out]	out_ptr_	割り当てたメモリ格納先(ダブルポインタを渡す)

使用例:

memory_system_result_t ret = memory_system_create(); // メモリシステム初期化
// エラー処理
 
// メモリ割り当て
void* ptr = NULL;
ret = memory_system_allocate(128, MEMORY_TAG_SYSTEM, &ptr); // 128バイト割り当て
// エラー処理

Return values

MEMORY_SYSTEM_INVALID_ARGUMENT	以下のいずれか メモリシステム未初期化 out_ptr_ == NULL *out_ptr_ != NULL mem_tag_ >= MEMORY_TAG_MAX
MEMORY_SYSTEM_LIMIT_EXCEEDED	以下のいずれか 割り当てサイズを割り当てた結果、mem_tag_allocatedがSIZE_MAX超過 割り当てサイズを割り当てた結果、total_allocatedがSIZE_MAX超過
MEMORY_SYSTEM_NO_MEMORY	メモリ割り当て失敗
MEMORY_SYSTEM_SUCCESS	size_ == 0または割り当てに成功し正常終了

See also

memory_tag_t

memory_system_create

memory_system_create()

memory_system_result_t memory_system_create

(

void

)

メモリシステムを起動する

Note

memory_system_createでは、シングルトンで定義されたメモリシステム状態管理構造体インスタンスを初期化する このため、メモリシステムが既に初期化済みであった場合はMEMORY_SYSTEM_RUNTIME_ERRORを返す memory_system_createを再度実行する際には、memory_system_destroyを呼び出してから使用すること

使用例:

memory_system_result_t ret = memory_system_create();   // メモリシステム内部状態管理構造体インスタンスが初期化される

Return values

MEMORY_SYSTEM_RUNTIME_ERROR	メモリシステムが既に初期化済み
MEMORY_SYSTEM_NO_MEMORY	メモリシステム用のメモリ確保に失敗
MEMORY_SYSTEM_SUCCESS	メモリシステムの初期化に成功し、正常終了

See also

memory_system_destroy

memory_system_destroy()

void memory_system_destroy

(

void

)

メモリシステムを停止する

Note

memory_system_destroyでは、シングルトンで定義されたメモリシステム状態管理構造体インスタンスのメモリを破棄する このため、memory_system_destroyを呼び出した後で、memory_system_allocate, memory_system_freeを呼び出すことはできない 再度memory_system_allocate, memory_system_freeを使用する際には、memory_system_createを実行してからにすること

• 2重destroyは許可する
• この関数を呼び出した時点でメモリシステムが管理しているメモリ使用量が0でない場合は、ワーニングメッセージを出力し、メモリシステムを破棄する

使用例:

memory_system_result_t ret = memory_system_create();
memory_system_destroy();
memory_system_destroy(); // 2重destroyは許可

See also

memory_system_create

memory_system_free()

void memory_system_free	(	void *	ptr_,
		size_t	size_,
		memory_tag_t	mem_tag_
	)

ptr_が保持する領域のメモリを解放し、mem_tag_で指定されたメモリタグのメモリ使用量を更新する

Note

引数にはvoid*型を渡しており、ptr_のメモリ開放後、NULLをセットすることはできない。 この仕様は、標準ライブラリのfree()の仕様に合わせた。なので、呼び出し側でメモリの解放後、NULLをセットすること。

• メモリシステムが未初期化の場合はワーニングを出力し、何もしない
• NULL == ptr_でワーニングを出力し、何もしない
• mem_tag_ >= MEMORY_TAG_MAXでワーニングを出力し、何もしない
• mem_tag_allocatedがマイナスとなる量をfreeしようとするとワーニングを出力し、何もしない
• total_allocatedがマイナスとなる量をfreeしようとするとワーニングを出力し、何もしない

使用例:

memory_system_result_t ret = memory_system_create(); // メモリシステム初期化
 
// メモリ割り当て
void* ptr = NULL;
ret = memory_system_allocate(128, MEMORY_TAG_SYSTEM, &ptr); // 128バイト割り当て
// エラー処理
 
// メモリ解放
memory_system_free(ptr, 128, MEMORY_TAG_SYSTEM);
ptr = NULL;

Parameters

[in]	ptr_	解放メモリアドレス
[in]	size_	解放サイズ
[in]	mem_tag_	メモリタグ

See also

memory_tag_t

memory_system_report()

void memory_system_report

(

void

)

メモリシステムが管理しているメモリ使用量状態を標準出力に出力する

Note

• メモリシステムが未初期化の場合はワーニングを出力し、何もしない

使用例:

memory_system_result_t ret = memory_system_create(); // メモリシステム初期化
 
// メモリ割り当て
void* ptr = NULL;
ret = memory_system_allocate(128, MEMORY_TAG_SYSTEM, &ptr); // 128バイト割り当て
 
// メモリ割り当て状態をレポート
memory_system_report();