gretl_errors

gretl_errors

Synopsis

enum                GretlError;
void                errmsg                              (int err,
                                                         PRN *prn);
void                warnmsg                             (PRN *prn);
const char *        errmsg_get_with_default             (int err);
const char *        gretl_errmsg_get                    (void);
const char *        gretl_warnmsg_get                   (void);
void                gretl_errmsg_set                    (const char *str);
void                gretl_warnmsg_set                   (const char *str);
void                gretl_errmsg_sprintf                (const char *fmt,
                                                         ...);
void                gretl_warnmsg_sprintf               (const char *fmt,
                                                         ...);
void                gretl_errmsg_set_from_errno         (const char *s);
void                gretl_error_clear                   (void);
void                set_gretl_alarm                     (int val);
void                set_gretl_errno                     (int err);
void                set_gretl_warning                   (int w);
int                 get_gretl_errno                     (void);
int                 check_gretl_errno                   (void);
int                 check_gretl_warning                 (void);
int                 gretl_error_is_fatal                (void);
int                 gretl_errmsg_is_set                 (void);

Description

Details

enum GretlError

typedef enum {
    E_DATA = 2,
    E_SINGULAR,     /* 3 */
    E_DF,           /* 4 */
    E_ZERO,         /* 5 */
    E_TSS,          /* 6 */
    E_ESS,          /* 7 */
    E_NOTIMP,       /* 8 */
    E_UNSPEC,       /* 9 */
    E_SYNTAX,      /* 10 */
    E_PDWRONG,     /* 11 */
    E_FOPEN,       /* 12 */
    E_ALLOC,       /* 13 */
    E_EQN,         /* 14 */
    E_UNKVAR,      /* 15 */
    E_ARGS,        /* 16 */
    E_OLSONLY,     /* 17 */
    E_INVARG,      /* 18 */
    E_PARSE,       /* 19 */
    E_NOVARS,      /* 20 */
    E_NOOMIT,      /* 21 */
    E_NOADD,       /* 22 */
    E_ADDDUP,      /* 23 */
    E_LOGS,        /* 24 */
    E_SQUARES,     /* 25 */
    E_LAGS,        /* 26 */
    E_SQRT,        /* 27 */
    E_HIGH,        /* 28 */
    E_OBS,         /* 29 */
    E_NOCONST,     /* 30 */
    E_BADSTAT,     /* 31 */
    E_NOMERGE,     /* 32 */
    E_NOCONV,      /* 33 */
    E_CANCEL,      /* 34 */
    E_MISSDATA,    /* 35 */
    E_NAN,         /* 36 */
    E_NONCONF,     /* 37 */
    E_TYPES,       /* 38 */
    E_DATATYPE,    /* 39 */
    E_BADOPT,      /* 40 */
    E_NOIDENT,     /* 41 */
    E_EXTERNAL,    /* 42 */
    E_TOOLONG,     /* 43 */
    E_NODATA,      /* 44 */
    E_NOTPD,       /* 45 */
    E_JACOBIAN,    /* 46 */
    E_TOOFEW,      /* 47 */
    E_FUNCERR,     /* 48 : error set by function writer */
    E_DB_DUP,      /* 49 : duplicate vars found when saving to database */
    E_OK,          /* 50 : not really an error */
    E_MAX          /* 51 */
} GretlError; 


errmsg ()

void                errmsg                              (int err,
                                                         PRN *prn);

Prints to prn a specific error message if available, otherwise a generic error message corresponding to the given err.

err :

gretl error code (see error_codes).

prn :

gretl printing struct.

warnmsg ()

void                warnmsg                             (PRN *prn);

If a gretl warning is set, prints a message to prn and zeros the warning signal.

prn :

gretl printing struct.

errmsg_get_with_default ()

const char *        errmsg_get_with_default             (int err);

err :

gretl error code (see gretl_error_codes).

Returns :

a specific error message if available, otherwise a generic error message corresponding to the given err.

gretl_errmsg_get ()

const char *        gretl_errmsg_get                    (void);

Returns :

a specific error message if available, otherwise an empty string.

gretl_warnmsg_get ()

const char *        gretl_warnmsg_get                   (void);

Returns :

the current gretl warning message, or NULL if no warning is currently in place.

gretl_errmsg_set ()

void                gretl_errmsg_set                    (const char *str);

If gretl_errmsg is currently blank, copy the given string into the message space; or if the error message is not blank but sufficient space remains, append str to the message.

str :

an error message.

gretl_warnmsg_set ()

void                gretl_warnmsg_set                   (const char *str);

If copy the given string into the warning message space.

str :

a warning message.

gretl_errmsg_sprintf ()

void                gretl_errmsg_sprintf                (const char *fmt,
                                                         ...);

Append a formatted message to the current gretl error message.

fmt :

format string.

... :

arguments, as to sprintf.

gretl_warnmsg_sprintf ()

void                gretl_warnmsg_sprintf               (const char *fmt,
                                                         ...);

Write a formatted message to the current gretl warning message space.

fmt :

format string.

... :

arguments, as to sprintf.

gretl_errmsg_set_from_errno ()

void                gretl_errmsg_set_from_errno         (const char *s);

If gretl_errmsg is currently blank, copy the string returned by strerror into the message space; or if the error message is not blank but sufficient space remains, append the new error info to the message.

s :

string to prepend to error message, or NULL.

gretl_error_clear ()

void                gretl_error_clear                   (void);

Blank out any previously recorded error message.


set_gretl_alarm ()

void                set_gretl_alarm                     (int val);


set_gretl_errno ()

void                set_gretl_errno                     (int err);


set_gretl_warning ()

void                set_gretl_warning                   (int w);


get_gretl_errno ()

int                 get_gretl_errno                     (void);


check_gretl_errno ()

int                 check_gretl_errno                   (void);


check_gretl_warning ()

int                 check_gretl_warning                 (void);


gretl_error_is_fatal ()

int                 gretl_error_is_fatal                (void);


gretl_errmsg_is_set ()

int                 gretl_errmsg_is_set                 (void);

Returns :

1 if the gretl error message is currently set (not blank), otherwise 0.