---

tools.h

/*
 * tools.h - error handling and filename tools.
 *
 * code inspired by the books:
 *
 * The Unix Programming Environment
 * Brian W. Kernighan and Rob Pike.
 * Prentice Hall, Inc., 1984.
 * ISBN 0-13-937681-X (paperback), 0-13-937699-2 (hardback).
 *
 * The Practice of Programming.
 * Brian W. Kernighan and Rob Pike.
 * Addison-Wesley, Reading, Massachusetts, 1999.
 * ISBN 0-201-61586-X.
 *
 * $Revision: 1.0 $
 * $Date: 2003-03-27 11:52:18+01 $
 * $Source: \\\\fwneld\\msdos\\RCS\\K\\bf\\prj\\rulbus-dll\\editenv\\envio\\tools.h,v $
 * %Author: Martin J. Moene, Leiden University %
 *
 * Compiler        : Borland-C++ 5.5.1, GCC 3.2
 * Operating system: 32-bit Windows, Unix
 * Hardware system : PC, other
 *
 * This software is released into the public domain.
 * You are free to use it in any way you like.
 *
 * This software is provided "as is" with no expressed
 * or implied warranty.  I accept no liability for any
 * damage or loss of business that this software may cause.
 */

#ifndef __TOOLS_H
#define __TOOLS_H

#if defined( __BORLANDC__ )
#   include   <stdio>           // for FILE
#   include  <string>           // for class string
#elif defined( __MINGW32__ ) || defined( __GNUC__ )
#   include  <cstdio>           // for FILE
#   include  <string>           // for class string
#else
#error Unhandled compiler-specific include file selection.
#endif

using namespace std;

enum            // program return codes
{
   E_OK,        
   E_OPT,       
   E_PS,        
   E_INT,       
   E_ITL        
};

enum            // message levels
{
   MSG_L0,      
   MSG_L1,      
   MSG_L2       
};

enum            // debug levels
{
   DBG_L0,      
   DBG_L1,      
   DBG_L2       
};

/*
 * prototypes:
 */

const char *getprogname();
void        setprogname( const char *name );

int         getmsglevel(            );
void        setmsglevel( int  level );
FILE *      getmsgfile (            );
void        setmsgfile ( FILE *file );

int         getdbglevel(            );
void        setdbglevel( int  level );
FILE *      getdbgfile (            );
void        setdbgfile ( FILE *file );

const char *dirname    ( const char *pathname );
const char *basename   ( const char *pathname );
const char *extname    ( const char *pathname );

int         exist      ( const char *filename );

int         error      ( int status, const char *format ...);
int         message    ( int level , const char *format ...);
int         debug      ( int level , const char *format ...);

string      prompt     ( const char *ps );
int         pick       ( int isInteractive, const char *arg, const char *set = "yY" );
int         ttyin      ( );

#endif  // __TOOLS_H

/* @} \endimplementation */

/*
 * end of file
 */

---