SubString.h

Go to the documentation of this file.

/*
 *   ORXONOX - the hottest 3D action shooter ever to exist
 *                    > www.orxonox.net <
 *
 *
 *   License notice:
 *
 *   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., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 *
 *   Author:
 *      Christian Meyer
 *   Co-authors:
 *      Benjamin Grauer
 *      Fabian 'x3n' Landau
 *

//  splitLine
//  STL string tokenizer
//
//  Created by Clemens Wacha.
//  Version 1.0
//  Copyright (c) 2005 Clemens Wacha. All rights reserved.

 *   Extended by Fabian 'x3n' Landau by the SL_PARENTHESES mode.
 */

#ifndef __SubString_H__
#define __SubString_H__

#include "UtilPrereqs.h"

#include <vector>
#include <string>

namespace orxonox
{
    class _UtilExport SubString
    {
        enum class SPLIT_LINE_STATE
        {
            NORMAL,            
            ESCAPE,            
            SAFEMODE,          
            SAFEESCAPE,        
            COMMENT,           
            PARENTHESES,       
            PARENTHESESESCAPE, 
        };

    public:
        SubString();
        SubString(const SubString& other) = default;
        SubString(SubString&& other) = default;
        SubString(const std::string& line,
                  const std::string& delimiters = SubString::WhiteSpaces,
                  const std::string& delimiterNeighbours = "",
                  bool bAllowEmptyEntries=false,
                  char escapeChar ='\\',
                  bool bRemoveEscapeChar = true,
                  char safemodeChar = '"',
                  bool bRemoveSafemodeChar = true,
                  char openparenthesisChar = '{',
                  char closeparenthesisChar = '}',
                  bool bRemoveParenthesisChars = true,
                  char commentChar = '\0');
        SubString(size_t argc, const char** argv);
        SubString(const SubString& other, size_t begin, size_t length = std::string::npos);
        ~SubString();

        // operate on the SubString
        SubString& operator=(const SubString& other);
        SubString& operator=(SubString&& other) = default;
        bool operator==(const SubString& other) const;
        bool compare(const SubString& other, size_t length = std::string::npos) const;
        SubString operator+(const SubString& other) const;
        SubString& operator+=(const SubString& other);
        inline SubString& append(const SubString& other) { return (*this += other); }

        // Split and Join the any String. ///////
        size_t split(const std::string& line,
                     const std::string& delimiters = SubString::WhiteSpaces,
                     const std::string& delimiterNeighbours = "",
                     bool bAllowEmptyEntries = false,
                     char escapeChar ='\\',
                     bool bRemoveEscapeChar = true,
                     char safemodeChar = '"',
                     bool bRemoveSafemodeChar = true,
                     char openparenthesisChar = '{',
                     char closeparenthesisChar = '}',
                     bool bRemoveParenthesisChars = true,
                     char commentChar = '\0');

        std::string join(const std::string& delimiter = " ") const;

        // retrieve a SubSet from the String
        SubString subSet(size_t begin, size_t length = std::string::npos) const;

        // retrieve Information from within
        inline bool empty() const { return this->tokens_.empty(); }
        inline size_t size() const { return this->tokens_.size(); }
        inline const std::string& operator[](size_t index) const { return this->tokens_[index]; }
        inline const std::string& getString(size_t index) const { return (*this)[index]; }
        inline const std::vector<std::string>& getAllStrings() const { return this->tokens_; }
        inline bool isInSafemode(size_t index) const { return this->bTokenInSafemode_[index]; }
        inline const std::string& front() const { return this->tokens_.front(); }
        inline const std::string& back() const { return this->tokens_.back(); }
        inline void pop_back() { this->tokens_.pop_back(); this->bTokenInSafemode_.pop_back(); }

        void debug() const;

    public:
        static const std::string WhiteSpaces;           
        static const std::string WhiteSpacesWithComma;  
        static const SubString   NullSubString;         

    private:
        // the almighty algorithm.
        static SPLIT_LINE_STATE splitLine(std::vector<std::string>& tokens,
                                          std::vector<bool>& bTokenInSafemode,
                                          const std::string& line,
                                          const std::string& delimiters = SubString::WhiteSpaces,
                                          const std::string& delimiterNeighbours = "",
                                          bool bAllowEmptyEntries = false,
                                          char escapeChar = '\\',
                                          bool bRemoveEscapeChar = true,
                                          char safemodeChar = '"',
                                          bool bRemoveSafemodeChar = true,
                                          char openparenthesisChar = '{',
                                          char closeparenthesisChar = '}',
                                          bool bRemoveParenthesisChars = true,
                                          char commentChar = '\0',
                                          SPLIT_LINE_STATE start_state = SPLIT_LINE_STATE::NORMAL);

        std::vector<std::string>  tokens_;              
        std::vector<bool>         bTokenInSafemode_;    
    };
}

#endif /* __SubString_H__ */