hcxselect.h

/*
 * hcxselect - A CSS selector engine for htmlcxx
 * Copyright (C) 2011 Jonas Gehring
 * All rights reserved.
 * 
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *     * Redistributions of source code must retain the above copyright
 *       notice, this list of conditions and the following disclaimer.
 *     * Redistributions in binary form must reproduce the above copyright
 *       notice, this list of conditions and the following disclaimer in the
 *       documentation and/or other materials provided with the distribution.
 *     * Neither the name of the copyright holders nor the
 *       names of its contributors may be used to endorse or promote products
 *       derived from this software without specific prior written permission.
 * 
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */


#ifndef HCXSELECT_H_
#define HCXSELECT_H_

#include <exception>
#include <string>
#include <set>

#include <htmlcxx/html/Node.h>
#include <htmlcxx/html/tree.h>

#define HCXSELECT_VERSION_STR "1.1"
#define HCXSELECT_VERSION_MAJOR 1
#define HCXSELECT_VERSION_MINOR 1
#define HCXSELECT_VERSION_RELEASE 0


namespace hcxselect
{

typedef tree_node_<htmlcxx::HTML::Node> Node;

struct NodeComp {
        bool operator()(Node *a, Node *b) const;
};

typedef std::set<Node *, NodeComp> NodeSet;


NodeSet select(const tree<htmlcxx::HTML::Node> &tree, const std::string &expr);

NodeSet select(const NodeSet &nodes, const std::string &expr);


class Selection : public NodeSet
{
public:
        Selection();
        Selection(const tree<htmlcxx::HTML::Node> &tree, const std::string &expr = std::string());
        Selection(const NodeSet &nodes, const std::string &expr = std::string());

        Selection select(const std::string &expr);
};

typedef Selection Selector;


class ParseException : std::exception
{
public:
        ParseException(int pos, const char *info = NULL)
                : m_pos(pos), m_info(info) { }

        const char *what() const throw() { return m_info; }

        int position() const throw() { return m_pos; }

private:
        int m_pos;
        const char *m_info;
};

} // namespace hcxselect

#endif // HCXSELECT_H_