1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124
|
/*
* Copyright (C) 2013-2020 Apple Inc. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. 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.
*
* THIS SOFTWARE IS PROVIDED BY APPLE INC. ``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 APPLE INC. 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.
*/
#pragma once
#include <wtf/CheckedPtr.h>
#if ASSERT_ENABLED
#include "ElementIteratorAssertions.h"
#endif
namespace WebCore {
class ContainerNode;
class Node;
template <typename ElementType>
class ElementIterator {
public:
using iterator_category = std::forward_iterator_tag;
using value_type = ElementType;
using difference_type = ptrdiff_t;
using pointer = value_type*;
using reference = value_type&;
ElementIterator() = default;
inline ElementType& operator*() const;
inline ElementType* operator->() const;
constexpr operator bool() const { return m_current.get(); }
constexpr bool operator!() const { return !m_current; }
constexpr bool operator==(std::nullptr_t) const { return !m_current; }
constexpr bool operator==(const ElementIterator&) const;
inline ElementIterator& traverseNext();
inline ElementIterator& traversePrevious();
inline ElementIterator& traverseNextSibling();
inline ElementIterator& traversePreviousSibling();
inline ElementIterator& traverseNextSkippingChildren();
inline ElementIterator& traverseAncestor();
inline void dropAssertions();
protected:
ElementIterator(const ContainerNode* root, ElementType* current);
private:
CheckedPtr<const ContainerNode> m_root;
CheckedPtr<ElementType> m_current;
#if ASSERT_ENABLED
ElementIteratorAssertions m_assertions;
#endif
};
template <typename ElementType>
inline ElementType* findElementAncestorOfType(const Node&);
// ElementIterator
template <typename ElementType>
inline ElementIterator<ElementType>::ElementIterator(const ContainerNode* root, ElementType* current)
: m_root(root)
, m_current(current)
#if ASSERT_ENABLED
, m_assertions(current)
#endif
{
}
template<typename ElementType> constexpr bool ElementIterator<ElementType>::operator==(const ElementIterator& other) const
{
ASSERT(m_root == other.m_root || !m_current || !other.m_current);
return m_current == other.m_current;
}
template <typename ElementType>
inline ElementType& ElementIterator<ElementType>::operator*() const
{
ASSERT(m_current);
ASSERT(!m_assertions.domTreeHasMutated());
return *m_current;
}
template <typename ElementType>
inline ElementType* ElementIterator<ElementType>::operator->() const
{
ASSERT(m_current);
ASSERT(!m_assertions.domTreeHasMutated());
return m_current.get();
}
template <typename ElementType>
inline void ElementIterator<ElementType>::dropAssertions()
{
#if ASSERT_ENABLED
m_assertions.clear();
#endif
}
} // namespace WebCore
|