X-Git-Url: http://j8takagi.net/cgi-bin/gitweb.cgi?p=YACASL2.git;a=blobdiff_plain;f=include%2Fcerr.h;h=9549de69f1cc44318332d63f0222e91fb98a3ed8;hp=db9adbecdc2005b80bf046fd381d5613dc6d60b5;hb=065d340f994652a9759c496b4c024e1f9a3a6783;hpb=d1f82970bf7d41db2fea11b08cd8e308f6cb8138 diff --git a/include/cerr.h b/include/cerr.h index db9adbe..9549de6 100644 --- a/include/cerr.h +++ b/include/cerr.h @@ -1,32 +1,37 @@ #ifndef YACASL2_CERR_H_INCLUDED #define YACASL2_CERR_H_INCLUDED +#include +#include +#include +#include +#include #include #include "cmem.h" /** - * エラーの構造体 + * @brief エラーを表すデータ型 */ -typedef struct { - int num; /* エラー番号 */ - char *msg; /* エラーメッセージ */ +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; @@ -36,27 +41,52 @@ enum { }; /** - * エラーの初期化 + * @brief エラーを初期化する + * + * @return なし */ void cerr_init(); /** - * エラーリストを作成・追加する + * @brief エラーリストを作成・追加する + * + * @return なし + * + * @param cerrc 作成または追加するエラーの数 + * @param cerrv 作成または追加するエラーの配列 + */ +void addcerrlist(int cerrc, CERR cerrv[]); + +/** + * @brief エラーリストを表示する + * + * @return なし */ -bool addcerrlist(int cerrc, CERR cerrv[]); +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