---

Path.h

/*****************************************************************************
 * Author:   Valient Gough <vgough@pobox.com>
 *
 *****************************************************************************
 * Copyright (c) 2001, Valient Gough
 *
 * This library is free software; you can distribute it and/or modify it under
 * the terms of the GNU Lesser General Public License (LGPL), as published by
 * the Free Software Foundation; either version 2.1 of the License, or (at your
 * option) any later version.
 *
 * This library 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 LGPL in the file COPYING for more
 * details.
 *
 */


#ifndef _Path_incl_
#define _Path_incl_

#include <rel/TypeStream.h>
#include <rel/StringIODevice.h>


namespace rel
{


    // TypeStream is not virtual, so we can't overwrite it's operation, but we
    // can add our own functions..
    class Path : public TypeStream
    {
    public:
        Path(const std::string &path, char separator = '/');
        Path(const char *path, char separator = '/');
        Path(const Path &src);
        Path();
        virtual ~Path();

        Path &operator = (const Path &src);

        // single path element
        bool append(const string &name);  
        // possibly multi-element
        bool append(const string &name, char separator); 
        bool append(const char *name, char separator = '/');

        // create new path from arguments.
        static OpaqueValue New(const TypeStream *);

        // empty path
        void clear();


        // These are public so that associated operators can call them..
        void Encode(TypeStream &) const;
        void Decode(const TypeStream &);
    private:

        StreamCoder fCoder;
        StringIODevice fBuffer;
    };

} // namespace rel
    
rel::TypeStream &operator << (rel::TypeStream &output, const rel::Path &src);

#endif

---