X-Git-Url: http://j8takagi.net/cgi-bin/gitweb.cgi?p=YACASL2.git;a=blobdiff_plain;f=include%2Fcmem.h;h=85cb7203e29b16c04a9559f5cace05e1cc227d3c;hp=c67022642dea2e26f4a1eb862f24cc624276f28f;hb=c2820a4ee2f34c794268b5a61d3223f1c270d39c;hpb=6eb54846c27b216d7602a5107d9383f8f4324d71 diff --git a/include/cmem.h b/include/cmem.h index c670226..85cb720 100644 --- a/include/cmem.h +++ b/include/cmem.h @@ -2,34 +2,52 @@ #define YACASL2_CMEM_H_INCLUDED #include -/* - * 配列のサイズを返す +/** + * @brief 配列のサイズを返すマクロ */ #ifndef ARRAYSIZE #define ARRAYSIZE(array) (sizeof(array)/sizeof(array[0])) #endif /** - * メモリを解放 + * @brief メモリを解放するマクロ */ #ifndef FREE #define FREE(ptr) {free(ptr); ptr = NULL;} #endif /** - * mallocを実行し、0で初期化 + * @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);