// Copyright {Jagger Software Limited} 2003

#ifndef CONTAINER_STRAND_VIEW_INCLUDED
#define CONTAINER_STRAND_VIEW_INCLUDED

#include <iosfwd>
#include <stddef.h>
#include <string>

namespace container
{
    template<typename iterator>
    struct range_view;

    template<typename iterator>
    class strand_view // <<concrete>>
    {
    public: // 'tors
 
        explicit strand_view(const range_view<iterator> &);
                 strand_view(iterator, iterator);

        // compiler generated copy c'tor ok
        // compiler generated d'tor ok

    public: // assignment

        // compiler generated copy assignment ok

    public: // capacity

        bool empty() const;
        size_t size() const;

    public: // conversion

        ::std::string as_string() const;

    public: // iteration

        iterator begin() const;
        iterator end() const;

    public: // end element access
    
        char front() const;
        char  back() const;
        
    public: // subscripting

        char operator[](size_t) const;        

    private: // validation

        void range_check(size_t) const;

    private: // instance state
       
        iterator from, until;

    };
}

namespace container // strand_view
{
    // convenience

    template<typename iterator>
    strand_view<iterator> make_strand_view(iterator, iterator);

    template<typename iterator>
    strand_view<iterator> make_strand_view(const range_view<iterator> &);

    // streaming
    
    template<typename iterator>
    ::std::ostream & operator<<(::std::ostream &, const strand_view<iterator> &);
    
    // equality
    
    template<typename lhs_iterator, typename rhs_iterator>
    bool operator==(const strand_view<lhs_iterator> &, const strand_view<rhs_iterator> &);
    
    template<typename iterator>
    bool operator==(const strand_view<iterator> &, const ::std::string &);
    
    template<typename iterator>
    bool operator==(const ::std::string &, const strand_view<iterator> &);
    
    template<typename iterator>
    bool operator==(const strand_view<iterator> &, const char *);
    
    template<typename iterator>
    bool operator==(const char *, const strand_view<iterator> &);
    
    // inequality
    
    template<typename lhs_iterator, typename rhs_iterator>
    bool operator!=(const strand_view<lhs_iterator> &, const strand_view<rhs_iterator> &);
    
    template<typename iterator>
    bool operator!=(const strand_view<iterator> &, const ::std::string &);
    
    template<typename iterator>
    bool operator!=(const ::std::string &, const strand_view<iterator> &);
    
    template<typename iterator>
    bool operator!=(const strand_view<iterator> &, const char *);
    
    template<typename iterator>
    bool operator!=(const char *, const strand_view<iterator> &);
}
    
#include "container/strand_view-template.hpp"

#endif