chemin.hpp

/*********************************************************************/
// webdar - a web server and interface program to libdar
// Copyright (C) 2013-2025 Denis Corbin
//
// This file is part of Webdar
//
//  Webdar 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.
//
//  Webdar 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 Webdar.  If not, see <http://www.gnu.org/licenses/>
//
//----
//  to contact the author: dar.linux@free.fr
/*********************************************************************/
 
#ifndef CHEMIN_HPP
#define CHEMIN_HPP
 
    // C system header files
#include "my_config.h"
extern "C"
{
 
}
 
    // C++ system header files
#include <string>
#include <deque>
 
    // webdar headers
#include "exceptions.hpp"
 
 
 
 
class chemin
{
public:
    chemin() { members.clear(); index = 0; };
    chemin(const std::string & path);
    chemin(const chemin & ref) = default;
    chemin(chemin && ref) noexcept = default;
    chemin & operator = (const chemin & ref) = default;
    chemin & operator = (chemin && ref) noexcept = default;
    ~chemin() = default;
 
 
 
 
 
 
    void clear() { members.clear(); index = 0; };
 
    bool operator == (const chemin & ref) const { return members == ref.members; };
    bool operator != (const chemin & ref) const { return !((*this) == ref); };
 
    bool is_the_beginning_of(const chemin & ref) const;
 
    void operator += (const chemin & ref);
 
    chemin operator + (const chemin & ref) const { chemin ret = *this; ret += ref; return ret; };
 
    void push_back(const std::string & x);
 
 
    std::string front() const { if(empty()) throw exception_range("cannot get front() from an empty chemin"); return members.front(); };
 
 
    std::string back() const { if(empty()) throw exception_range("cannot get back() from an empty chemin"); return members.back(); };
 
    void pop_front();
 
    void pop_back();
 
    unsigned int size() const { return members.size(); };
 
    bool empty() const { return members.empty(); };
 
 
    unsigned int get_index() const { return index; };
 
    void increase_index() const { if(index < size() - 1) ++(const_cast<chemin *>(this)->index); };
 
    void decrease_index() const { if(index > 0) --(const_cast<chemin *>(this)->index); };
 
    void set_index(unsigned int val) const;
 
    std::string display(bool relative = false) const;
 
    std::string namify() const;
 
    const std::string & operator[] (unsigned int x) const;
 
private:
    std::deque<std::string> members;
    unsigned int index;
};
 
 
#endif