/* err/gsl_message.h

 * 

 * Copyright (C) 1996, 1997, 1998, 1999, 2000, 2007 Gerard Jungman, Brian Gough

 * 

 * This program is free software; you can redistribute it and/or modify

 * it under the terms of the GNU General Public License as published by

 * the Free Software Foundation; either version 3 of the License, or (at

 * your option) any later version.

 * 

 * This program is distributed in the hope that it will be useful, but

 * WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU

 * General Public License for more details.

 * 

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

 */

#ifndef __GSL_MESSAGE_H__

#define __GSL_MESSAGE_H__

#include <gsl/gsl_types.h>

#undef __BEGIN_DECLS

#undef __END_DECLS

#ifdef __cplusplus

# define __BEGIN_DECLS extern "C" {

# define __END_DECLS }

#else

# define __BEGIN_DECLS /* empty */

# define __END_DECLS /* empty */

#endif

__BEGIN_DECLS

/* Provide a general messaging service for client use.  Messages can

 * be selectively turned off at compile time by defining an

 * appropriate message mask. Client code which uses the GSL_MESSAGE()

 * macro must provide a mask which is or'ed with the GSL_MESSAGE_MASK.

 *

 * The messaging service can be completely turned off

 * by defining GSL_MESSAGING_OFF.  */

void gsl_message(const char * message, const char * file, int line,

                 unsigned int mask);

#ifndef GSL_MESSAGE_MASK

#define GSL_MESSAGE_MASK 0xffffffffu /* default all messages allowed */

#endif

GSL_VAR unsigned int gsl_message_mask ;

/* Provide some symolic masks for client ease of use. */

enum {

  GSL_MESSAGE_MASK_A = 1,

  GSL_MESSAGE_MASK_B = 2,

  GSL_MESSAGE_MASK_C = 4,

  GSL_MESSAGE_MASK_D = 8,

  GSL_MESSAGE_MASK_E = 16,

  GSL_MESSAGE_MASK_F = 32,

  GSL_MESSAGE_MASK_G = 64,

  GSL_MESSAGE_MASK_H = 128

} ;

#ifdef GSL_MESSAGING_OFF        /* throw away messages */ 

#define GSL_MESSAGE(message, mask) do { } while(0)

#else                           /* output all messages */

#define GSL_MESSAGE(message, mask) \

       do { \

       if (mask & GSL_MESSAGE_MASK) \

         gsl_message (message, __FILE__, __LINE__, mask) ; \

       } while (0)

#endif

__END_DECLS

#endif /* __GSL_MESSAGE_H__ */