grive2/libgrive/src/xml/Node.hh

/*
	grive: an GPL program to sync a local directory with Google Drive
	Copyright (C) 2012  Wan Wai Ho

	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 version 2
	of the License.

	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.
*/

#pragma once

#include <iosfwd>
#include <string>
#include <vector>
#include <utility>

namespace gr { namespace xml {

class Node
{
public :
	class iterator ;
	typedef std::pair<Node::iterator, Node::iterator> Range ;

public :
	Node() ;
	Node( const Node& node ) ;
	~Node() ;

	static Node Element( const std::string& name ) ;
	static Node Text( const std::string& name ) ;
	
	Node& operator=( const Node& node ) ;
	
	Node AddElement( const std::string& name ) ;
	Node AddText( const std::string& text ) ;
	void AddNode( const Node& node ) ;
	void AddAttribute( const std::string& name, const std::string& val ) ;

	Node operator[]( const std::string& name ) const ;
	
	const std::string& Name() const ;
	std::string Value() const ;
	
	// read-only access to the reference counter. for checking.
	std::size_t RefCount() const ;
	
	enum Type { element, attr, text } ;
	Type GetType() const ;

	static bool IsCompatible( Type parent, Type child ) ;
	static std::ostream& PrintChar( std::ostream& os, char c ) ;
	static std::ostream& PrintString( std::ostream& os, const std::string& s ) ;

	iterator begin() const ;
	iterator end() const ;
	
	Range Attr() const ;
	
private :
	class	Impl ;
	typedef std::vector<Impl*>	ImplVec ;
	
public :
	class iterator
	{
	public :
		iterator() ;
		explicit iterator( std::vector< gr::xml::Node::Impl* >::iterator it ) ;
		
		typedef Node value_type ;
		typedef std::forward_iterator_tag	iterator_category ;
		typedef std::ptrdiff_t				difference_type;
		typedef Node*						pointer;
		typedef Node&						reference;

		value_type operator*() const ;
		iterator operator++() ;
		iterator operator++(int) ;
		
		bool operator==( const iterator& i ) const ;
		bool operator!=( const iterator& i ) const ;
	
	private :
		ImplVec::iterator	m_it ;
	} ;
	
private :
	explicit Node( Impl *impl ) ;

private :
	Impl *m_ptr ;
} ;

std::ostream& operator<<( std::ostream& os, const Node& node ) ;

} } // end of namespace