/***********************************************************************
* Copyright (C) 2006 by René Bählkow                                   *
*                                                                      *
* 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.            *
***********************************************************************/

#ifndef PLOW_STRING_PARSER_H
#define PLOW_STRING_PARSER_H

#include <string>
#include <vector>

using namespace std;

/**
 * @brief splits a string into tokens
 */
class StringParser
{
  public:
    /**
     * creates a new StringParser
     *
     * @param str the string
     * @param delim the delimiter
     */
    StringParser(const char *str, const char delim = ' ');

    /**
     * @returns a vector containing the tokens
     */
    vector<string *> getTokens();

    /**
     * @returns a char ** like argv of the tokens,
     *          but it is 0 terminated so we know where it ends
     *          (e.g. for use in execvp)
     */
    char **getArgv();

    /**
     * @returns the number of tokens
     */
    uint   getSize();

    /**
     * destroys the StringParser
     */
    ~StringParser();

  private:
    bool mb_remove;
    char **m_argv;
    vector<string *> m_tokens;
};

#endif
