stringy.h

Go to the documentation of this file.

/*
*               stringy.h
*
*               Copyright 2008 - 2016 Brenton Ross
*
*               This file is part of VICI.
*
*       VICI 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 3 of the License, or
*       (at your option) any later version.
*
*       VICI 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 VICI. If not, see <http://www.gnu.org/licenses/>.
*       
*/

#ifndef CFI_STRINGY_H
#define CFI_STRINGY_H

#include <string>
#include <vector>

typedef const std::string & csr;

namespace VICI
{

// convenience functions


void trim( std::string &s);


int split( csr text, std::vector< std::string > & result );


std::string expandMacros( csr s );


std::string clean( csr s );


class Path : public std::string
{
private:
        // std::string mPath;  // the actual value
        std::string::size_type lastSlash() const;
        static bool spacePolicy;

        // removes surplus /'s
        void normalise();

public:
        explicit Path();


        explicit Path( csr path );


        Path &append( csr name );


        Path &appendExt( csr ext );


        Path &up();

        bool absolute() const;

        std::string base() const;

        std::string dir() const;

        std::string ext() const;

        std::string name() const;

        std::string noExt() const;


        void split( std::vector< std::string > &dirs ) const;

        bool operator == ( const Path &x ) const;

        // bool operator == ( const std::string &x ) const;

        // bool operator == ( const char *x ) const;

        bool isChildOf( const Path &p ) const;

        Path & operator = ( const char * );

        Path & operator = ( const std::string & );

        operator const char * () const;
        // operator const std::string & () const;

        // const std::string & toString() const;

        bool defined() const;

        static bool check( const std::string &path );

        static void setSpacePolicy( bool allowSpaces = false );
};


} // namespace VICI



#endif /* STRINGY_H_ */