ArFileParser.h

/*
MobileRobots Advanced Robotics Interface for Applications (ARIA)
Copyright (C) 2004, 2005 ActivMedia Robotics LLC
Copyright (C) 2006, 2007 MobileRobots Inc.

     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 
MobileRobots for information about a commercial version of ARIA at 
robots@mobilerobots.com or 
MobileRobots Inc, 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:
  AREXPORT ArFileParser(const char *baseDirectory = "./");
  AREXPORT ~ArFileParser(void);
  AREXPORT bool addHandler(const char *keyword, 
               ArRetFunctor1<bool, ArArgumentBuilder *> *functor);
  AREXPORT bool addHandlerWithError(const char *keyword, 
               ArRetFunctor3<bool, ArArgumentBuilder *, 
                    char *, size_t> *functor);
  AREXPORT bool remHandler(const char *keyword, bool logIfCannotFind = true);
  AREXPORT bool remHandler(ArRetFunctor1<bool, ArArgumentBuilder *> *functor);
  AREXPORT 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
  AREXPORT ArRetFunctor1<bool, ArArgumentBuilder *> *getHandler(const char *keyword);
  */
  
  AREXPORT bool parseFile(const char *fileName, bool continueOnErrors = true,
              bool noFileNotFoundMessage = false,
              char *errorBuffer = NULL, size_t errorBufferLen = 0);


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

  AREXPORT const char *getBaseDirectory(void) const;
  AREXPORT void setBaseDirectory(const char *baseDirectory);
  AREXPORT bool parseLine(char *line, char *errorBuffer = NULL, 
              size_t errorBufferLen = 0);
  AREXPORT 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

---