ConfigScanner.h

/*
 * ConfigScanner.h - lexical scanner for Rulbus configuration file.
 *
 * This file is part of the Rulbus Device Class Library (RDCL).
 *
 * Copyright (C) 2003-2004, Leiden University.
 * This library is free software, see below.
 *
 * $Revision: $
 * $Date: $
 * $Source: $
 * %Author: Martin J. Moene %
 *
 * Compiler        : Borland-C++ 5.6
 * Operating system: 32-bit Windows
 * Hardware system : PC
 *
 * This library 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 2 of the License, or
 * (at your option) any later version.
 *
 * The library 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 mngdriver; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */

/*
 * $Header: $
 *
 * $Log: $
 */

#ifndef __CONFIGSCANNER_H
#define __CONFIGSCANNER_H

#ifndef __COMMON_H
#include "Common.h"
#endif

#include <iosfwd>                               // for std::istream

namespace Rulbus
{
   DECLARE_CLASS( ConfigScanner );              
   DECLARE_CLASS( ConfigToken   );              

   class ConfigToken
   {
   public:
      enum TokenCode
      {
         #define op( a, b, c, d ) a = static_cast<TokenCode>( b ),
         #define id( a, b, c, d ) a = static_cast<TokenCode>( b ),
         #define kw( a, b, c, d ) a = static_cast<TokenCode>( b ),
         #include "ConfigToken.def"
         tcLAST,
      };

               ConfigToken() { ; }
      virtual ~ConfigToken() { ; }

      virtual  void get  ( std::istream *is ) = 0;

      virtual  void print() const = 0;

      bool        isBool () const;
      bool        isAsnop() const;
      bool        isCard () const;
      bool        isDelim() const;
      bool        isUnit () const;
      bool        isKind ( TokenCode t ) const;

      TokenCode     code () const;

      bool        toBool () const;
      Int          toInt () const;
      Real        toReal () const;
      String    toString () const;

      String    tokenString(              ) const;
      String    tokenString( TokenCode t  ) const;

   protected:
      TokenCode theTokenCode;                   
      Int       theIntValue;                    
      Real      theRealValue;                   
      String    theString;                      

   private:
      static    CharCptr  stringTable[];        
      static    TokenCode kindTable[];          
   };

   inline bool ConfigToken::isAsnop() const
   {
      return isKind( tcASN );
   }

   inline bool ConfigToken::isBool() const
   {
      return isKind( tcBOOL );
   }

   inline bool ConfigToken::isCard() const
   {
      return isKind( tcCARD );
   }

   inline bool ConfigToken::isDelim() const
   {
      return isKind( tcDELIM );
   }

   inline bool ConfigToken::isUnit () const
   {
      return isKind( tcUNIT );
   }

   inline ConfigToken::TokenCode ConfigToken::code () const
   {
      return theTokenCode;
   }

   inline bool ConfigToken::toBool() const
   {
      return tcTRUE == code() || tcYES == code();
   }

   inline Int ConfigToken::toInt() const
   {
      return theIntValue;
   }

   inline Real ConfigToken::toReal() const
   {
      return theRealValue;
   }

   inline String ConfigToken::toString() const
   {
      return theString;
   }

   class ConfigWordToken: public ConfigToken
   {
   public:
      void  get   (std::istream *is);
      void  print (                ) const;
   };

   class ConfigNumberToken: public ConfigToken
   {
   public:
      ConfigNumberToken() { theTokenCode = tcNUMBER; }

      void  get   ( std::istream *is );
      void  print (                  ) const;

   protected:
      Real  suffix(char chr);
   };

   class ConfigStringToken: public ConfigToken
   {
   public:
      ConfigStringToken() { theTokenCode = tcSTRING; }

      void  get   ( std::istream *is );
      void  print (                  ) const;
   };

   class ConfigSpecialToken: public ConfigToken
   {
   public:
      void  get   ( std::istream *is );
      void  print (                  ) const;
   };

   class ConfigEofToken: public ConfigToken
   {
   public:
      ConfigEofToken() { theTokenCode = tcEOF; }

   #pragma argsused
      void  get   ( std::istream *is )  { }
      void  print (                  ) const;
   };

   class ConfigErrorToken: public ConfigToken
   {
   public:
      ConfigErrorToken() { theTokenCode = tcERROR; }

      void  get   ( std::istream *is );
      void  print (                  ) const;
   };

   class ConfigScanner
   {
   public:
      virtual           ~ConfigScanner( );
//                     ConfigScanner( String aFilename );
                        ConfigScanner( std::istream& stream, String aFilename = "" );

      ConfigToken      *get();
      String            filename  () const;
      Int               linenumber() const;

   protected:
      void              skipWhitespace();

      bool              seechar( char& chr );

      ConfigWordToken   wordToken;         
      ConfigNumberToken numberToken;       
      ConfigStringToken stringToken;       
      ConfigSpecialToken specialToken;      
      ConfigEofToken    eofToken;          
      ConfigErrorToken  errorToken;        

   private:
      std::istream     *is;                
      String            theFilename;       
      Int               theLinenumber;     
   };

   inline String ConfigScanner::filename() const
   {
      return theFilename;
   }

   inline Int ConfigScanner::linenumber() const
   {
      return theLinenumber;
   }

} // namespace Rulbus

#endif  // __CONFIGSCANNER_H

/*
 * end of file
 */

---