X-Git-Url: http://j8takagi.net/cgi-bin/gitweb.cgi?p=YACASL2.git;a=blobdiff_plain;f=include%2Fcerr.h;h=9549de69f1cc44318332d63f0222e91fb98a3ed8;hp=7265b0ed25c476e333e1bcd2a04dcdf0fc6705b3;hb=065d340f994652a9759c496b4c024e1f9a3a6783;hpb=4ee27a568fb9222907a566e59aaefe248f08a8e4 diff --git a/include/cerr.h b/include/cerr.h index 7265b0e..9549de6 100644 --- a/include/cerr.h +++ b/include/cerr.h @@ -1,51 +1,92 @@ #ifndef YACASL2_CERR_H_INCLUDED #define YACASL2_CERR_H_INCLUDED +#include #include #include #include #include #include +#include "cmem.h" -#ifndef ARRAYSIZE -#define ARRAYSIZE(array) (sizeof(array)/sizeof(array[0])) -#endif - -/* mallocを実行し、メモリを確保できない場合は */ -/* エラーを出力して終了 */ -void *malloc_chk(size_t size, char *tag); - -/* エラーの構造体 */ -typedef struct { - int num; /* エラー番号 */ - char *msg; /* エラーメッセージ */ +/** + * @brief エラーを表すデータ型 + */ +typedef struct _CERR { + int num; /**<エラー番号 */ + char *msg; /**<エラーメッセージ */ } CERR; -/* 現在のエラー */ +/** + * @brief 現在のエラー + */ extern CERR *cerr; -/* エラーリスト */ +/** + * @brief エラーリストのデータ型 + */ typedef struct _CERRLIST { - struct _CERRLIST *next; - CERR *cerr; + struct _CERRLIST *next; /**<リスト次項目へのポインタ */ + CERR *cerr; /**<エラーの構造体 */ } CERRLIST; +/** + * @brief エラーリスト + */ extern CERRLIST *cerrlist; enum { - CERRSTRSIZE = 10, /* エラーメッセージ中に挿入できる文字列のサイズ */ - CERRMSGSIZE = 70, /* エラーメッセージのサイズ */ + CERRSTRSIZE = 10, /**<エラーメッセージ中に挿入できる文字列のサイズ */ + CERRMSGSIZE = 70, /**<エラーメッセージのサイズ */ }; -/* エラーリストを作成・追加する */ -bool addcerrlist(int cerrc, CERR cerrv[]); +/** + * @brief エラーを初期化する + * + * @return なし + */ +void cerr_init(); + +/** + * @brief エラーリストを作成・追加する + * + * @return なし + * + * @param cerrc 作成または追加するエラーの数 + * @param cerrv 作成または追加するエラーの配列 + */ +void addcerrlist(int cerrc, CERR cerrv[]); + +/** + * @brief エラーリストを表示する + * + * @return なし + */ +void printcerrlist(); -/* エラー番号とエラーメッセージを設定 */ +/** + * @brief 現在のエラーを設定する + * + * @return なし + * + * @param num エラー番号 + * @param *str エラーメッセージに含まれる文字列 + */ void setcerr(int num, const char *str); -/* エラー番号からメッセージを返す */ +/** + * @brief エラー番号に対応するエラーメッセージを返す + * + * @return エラーメッセージ + * + * @param num エラー番号 + */ char *getcerrmsg(int num); -/* エラーを解放する */ +/** + * @brief エラーリストと現在のエラーを解放する + * + * @return なし + */ void freecerr(); #endif