ArFileParser.h

/*
ActivMedia Robotics Interface for Applications (ARIA)
Copyright (C) 2004,2005 ActivMedia Robotics, LLC


     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 2 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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

If you wish to redistribute ARIA under different terms, contact 
ActivMedia Robotics for information about a commercial version of ARIA at 
robots@activmedia.com or 
ActivMedia Robotics, 19 Columbia Drive, Amherst, NH 03031; 800-639-9481

*/

#ifndef ARFILEPARSER_H
#define ARFILEPARSER_H

#include "ariaTypedefs.h"
#include "ArArgumentParser.h"
#include "ArFunctor.h"
#include "ariaUtil.h"


class ArFileParser
{
public:
  ArFileParser(const char *baseDirectory = "./");
  ~ArFileParser(void);
  bool addHandler(const char *keyword, 
                           ArRetFunctor1<bool, ArArgumentBuilder *> *functor);
  bool addHandlerWithError(const char *keyword, 
                           ArRetFunctor3<bool, ArArgumentBuilder *, 
                                    char *, size_t> *functor);
  bool remHandler(const char *keyword, bool logIfCannotFind = true);
  bool remHandler(ArRetFunctor1<bool, ArArgumentBuilder *> *functor);
  bool remHandler(
          ArRetFunctor3<bool, ArArgumentBuilder *, char *, size_t> *functor);
  /* this shouldn't be needed and would be inelegant with the new scheme, 
     if someone needs it let us know and I'll update it somehow
  ArRetFunctor1<bool, ArArgumentBuilder *> *getHandler(const char *keyword);
  */
  
  bool parseFile(const char *fileName, bool continueOnErrors = true,
                          bool noFileNotFoundMessage = false,
                          char *errorBuffer = NULL, size_t errorBufferLen = 0);


  bool parseFile(FILE *file, char *buffer, int bufferLength, 
                          bool continueOnErrors = true, 
                          char *errorBuffer = NULL, size_t errorBufferLen = 0);

  const char *getBaseDirectory(void) const;
  void setBaseDirectory(const char *baseDirectory);
  bool parseLine(char *line, char *errorBuffer = NULL, 
                          size_t errorBufferLen = 0);
  void resetCounters(void);
protected:
  class HandlerCBType
  {
    public:
    HandlerCBType(
            ArRetFunctor3<bool, ArArgumentBuilder *, char *, size_t> *functor)
    {
      myCallbackWithError = functor;
      myCallback = NULL;
    }
    HandlerCBType(ArRetFunctor1<bool, ArArgumentBuilder *> *functor)
    {
      myCallbackWithError = NULL;
      myCallback = functor;
    }
    ~HandlerCBType() {}
    bool call(ArArgumentBuilder *arg, char *errorBuffer, 
              size_t errorBufferLen) 
    { 
      if (myCallbackWithError != NULL) 
        return myCallbackWithError->invokeR(arg, errorBuffer, errorBufferLen);
      else if (myCallback != NULL) 
        return myCallback->invokeR(arg); 
      // if we get here there's a problem
      ArLog::log(ArLog::Terse, "ArFileParser: Horrible problem with process callbacks");
      return false;
    }
    bool haveFunctor(
            ArRetFunctor3<bool, ArArgumentBuilder *, char *, size_t> *functor)
    { 
      if (myCallbackWithError == functor) 
        return true; 
      else 
        return false; 
    }
    bool haveFunctor(ArRetFunctor1<bool, ArArgumentBuilder *> *functor)
    { 
      if (myCallback == functor) 
        return true; 
      else 
        return false; 
    }
    const char *getName(void) 
    { 
      if (myCallbackWithError != NULL)
        return myCallbackWithError->getName();
      else if (myCallback != NULL)
        return myCallback->getName();
      // if we get here there's a problem
      ArLog::log(ArLog::Terse, "ArFileParser: Horrible problem with process callback names");
      return NULL;
    }
    protected:
    ArRetFunctor3<bool, ArArgumentBuilder *, char *, size_t> *myCallbackWithError;
    ArRetFunctor1<bool, ArArgumentBuilder *> *myCallback;
  };
  int myLineNumber;
  std::string myBaseDir;
  std::map<std::string, HandlerCBType *, ArStrCaseCmpOp> myMap;
  // handles that NULL case
  HandlerCBType *myRemainderHandler;
};

#endif // ARFILEPARSER_H

---