diff -r 000000000000 -r 4f2f89ce4247 WebCore/dom/NodeIterator.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/WebCore/dom/NodeIterator.h Fri Sep 17 09:02:29 2010 +0300 @@ -0,0 +1,82 @@ +/* + * Copyright (C) 1999 Lars Knoll (knoll@kde.org) + * Copyright (C) 2000 Frederik Holljen (frederik.holljen@hig.no) + * Copyright (C) 2001 Peter Kelly (pmk@post.com) + * Copyright (C) 2006 Samuel Weinig (sam.weinig@gmail.com) + * Copyright (C) 2004, 2008 Apple Inc. All rights reserved. + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Library General Public + * License as published by the Free Software Foundation; either + * version 2 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 GNU + * Library General Public License for more details. + * + * You should have received a copy of the GNU Library General Public License + * along with this library; see the file COPYING.LIB. If not, write to + * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, + * Boston, MA 02110-1301, USA. + * + */ + +#ifndef NodeIterator_h +#define NodeIterator_h + +#include "NodeFilter.h" +#include "Traversal.h" +#include +#include + +namespace WebCore { + + typedef int ExceptionCode; + + class NodeIterator : public RefCounted, public Traversal { + public: + static PassRefPtr create(PassRefPtr rootNode, unsigned whatToShow, PassRefPtr filter, bool expandEntityReferences) + { + return adoptRef(new NodeIterator(rootNode, whatToShow, filter, expandEntityReferences)); + } + ~NodeIterator(); + + PassRefPtr nextNode(ScriptState*, ExceptionCode&); + PassRefPtr previousNode(ScriptState*, ExceptionCode&); + void detach(); + + Node* referenceNode() const { return m_referenceNode.node.get(); } + bool pointerBeforeReferenceNode() const { return m_referenceNode.isPointerBeforeNode; } + + // This function is called before any node is removed from the document tree. + void nodeWillBeRemoved(Node*); + + // Do not call these functions. They are just scaffolding to support the Objective-C bindings. + // They operate in the main thread normal world, and they swallow JS exceptions. + PassRefPtr nextNode(ExceptionCode& ec) { return nextNode(scriptStateFromNode(mainThreadNormalWorld(), referenceNode()), ec); } + PassRefPtr previousNode(ExceptionCode& ec) { return previousNode(scriptStateFromNode(mainThreadNormalWorld(), referenceNode()), ec); } + + private: + NodeIterator(PassRefPtr, unsigned whatToShow, PassRefPtr, bool expandEntityReferences); + + struct NodePointer { + RefPtr node; + bool isPointerBeforeNode; + NodePointer(); + NodePointer(PassRefPtr, bool); + void clear(); + bool moveToNext(Node* root); + bool moveToPrevious(Node* root); + }; + + void updateForNodeRemoval(Node* nodeToBeRemoved, NodePointer&) const; + + NodePointer m_referenceNode; + NodePointer m_candidateNode; + bool m_detached; + }; + +} // namespace WebCore + +#endif // NodeIterator_h