X-Git-Url: http://j8takagi.net/cgi-bin/gitweb.cgi?p=YACASL2.git;a=blobdiff_plain;f=include%2Fcerr.h;h=9549de69f1cc44318332d63f0222e91fb98a3ed8;hp=a4d12462f8560e8261c1936799d8543d3780400d;hb=065d340f994652a9759c496b4c024e1f9a3a6783;hpb=406fd6490ad76b4573b6ce9f8d322d92f13d27d8 diff --git a/include/cerr.h b/include/cerr.h index a4d1246..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 - -/* エラー番号 */ -extern int cerrno; +/** + * @brief エラーを表すデータ型 + */ +typedef struct _CERR { + int num; /**<エラー番号 */ + char *msg; /**<エラーメッセージ */ +} CERR; -/* エラーメッセージ */ -extern char *cerrmsg; +/** + * @brief 現在のエラー + */ +extern CERR *cerr; -/* エラーコード配列 */ -typedef struct { - int num; - char *msg; -} CERRARRAY; - -/* エラーコードリスト */ +/** + * @brief エラーリストのデータ型 + */ typedef struct _CERRLIST { - struct _CERRLIST *next; - CERRARRAY *err; + struct _CERRLIST *next; /**<リスト次項目へのポインタ */ + CERR *cerr; /**<エラーの構造体 */ } CERRLIST; -/* エラーメッセージ */ -extern CERRLIST *cerr; +/** + * @brief エラーリスト + */ +extern CERRLIST *cerrlist; enum { - CERRSTRSIZE = 10, /* エラーメッセージ中に挿入できる文字列のサイズ */ - CERRMSGSIZE = 70, /* エラーメッセージのサイズ */ + CERRSTRSIZE = 10, /**<エラーメッセージ中に挿入できる文字列のサイズ */ + CERRMSGSIZE = 70, /**<エラーメッセージのサイズ */ }; -/* エラーを追加する */ -bool addcerrlist(int cerrc, CERRARRAY 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