X-Git-Url: http://j8takagi.net/cgi-bin/gitweb.cgi?p=YACASL2.git;a=blobdiff_plain;f=include%2Fcmem.h;h=85cb7203e29b16c04a9559f5cace05e1cc227d3c;hp=a38c81d9bf0b1d822e9b116ccf62d81ee9faa7ee;hb=7fbde1700bbe9d8f779033ad3b842d3dceb3e1c6;hpb=7f7bde5dd1305cfc598fe09030c69aad0dc01368 diff --git a/include/cmem.h b/include/cmem.h index a38c81d..85cb720 100644 --- a/include/cmem.h +++ b/include/cmem.h @@ -2,32 +2,53 @@ #define YACASL2_CMEM_H_INCLUDED #include -/* - * 配列のサイズを返す +/** + * @brief 配列のサイズを返すマクロ */ #ifndef ARRAYSIZE #define ARRAYSIZE(array) (sizeof(array)/sizeof(array[0])) #endif /** - * mallocを実行し、0で初期化 + * @brief メモリを解放するマクロ + */ +#ifndef FREE +#define FREE(ptr) {free(ptr); ptr = NULL;} +#endif + +/** + * @brief mallocを実行し、0で初期化する + * * メモリを確保できない場合はエラーを出力して終了 + * + * @return なし + * + * @param size メモリーのサイズ + * @param tag エラーメッセージなどで表示されるタグ */ void *malloc_chk(size_t size, char *tag); /** - * callocを実行 + * @brief 領域の数とサイズを指定してメモリーを確保するcallocを実行する + * * メモリを確保できない場合はエラーを出力して終了 + * + * @return なし + * + * @param nmemb 領域の数 + * @param size 領域1個あたりのメモリーサイズ + * @param tag エラーメッセージなどで表示されるタグ */ void *calloc_chk(size_t nmemb, size_t size, char *tag); /** - * malloc_chkを実行してメモリを確保し、コピーした文字列を返す + * @brief malloc_chkを実行してメモリを確保し、コピーした文字列を返す + * + * @return コピーした文字列 + * + * @param s 文字列 + * @param tag エラーメッセージなどで表示されるタグ */ char *strdup_chk(const char *s, char *tag); -/** - * メモリを解放 - */ -void free_chk(void *ptr, char *tag); #endif