1// Copyright 2014 The Chromium Authors. All rights reserved.
2// Copyright (C) 2016 Apple Inc. All rights reserved.
3//
4// Redistribution and use in source and binary forms, with or without
5// modification, are permitted provided that the following conditions are
6// met:
7//
8// * Redistributions of source code must retain the above copyright
9// notice, this list of conditions and the following disclaimer.
10// * Redistributions in binary form must reproduce the above
11// copyright notice, this list of conditions and the following disclaimer
12// in the documentation and/or other materials provided with the
13// distribution.
14// * Neither the name of Google Inc. nor the names of its
15// contributors may be used to endorse or promote products derived from
16// this software without specific prior written permission.
17//
18// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
19// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
20// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
21// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
22// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
23// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
24// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
25// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
26// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
28// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29
30#pragma once
31
32#include "CSSParserToken.h"
33#include <wtf/Forward.h>
34
35namespace WebCore {
36
37// A CSSParserTokenRange is an iterator over a subrange of a vector of CSSParserTokens.
38// Accessing outside of the range will return an endless stream of EOF tokens.
39// This class refers to half-open intervals [first, last).
40class CSSParserTokenRange {
41public:
42 template<size_t inlineBuffer>
43 CSSParserTokenRange(const Vector<CSSParserToken, inlineBuffer>& vector)
44 : m_first(vector.begin())
45 , m_last(vector.end())
46 {
47 }
48
49 // This should be called on a range with tokens returned by that range.
50 CSSParserTokenRange makeSubRange(const CSSParserToken* first, const CSSParserToken* last) const;
51
52 bool atEnd() const { return m_first == m_last; }
53 const CSSParserToken* end() const { return m_last; }
54
55 const CSSParserToken& peek(unsigned offset = 0) const
56 {
57 if (m_first + offset >= m_last)
58 return eofToken();
59 return *(m_first + offset);
60 }
61
62 const CSSParserToken& consume()
63 {
64 if (m_first == m_last)
65 return eofToken();
66 return *m_first++;
67 }
68
69 const CSSParserToken& consumeIncludingWhitespace()
70 {
71 const CSSParserToken& result = consume();
72 consumeWhitespace();
73 return result;
74 }
75
76 // The returned range doesn't include the brackets
77 CSSParserTokenRange consumeBlock();
78 CSSParserTokenRange consumeBlockCheckingForEditability(StyleSheetContents*);
79
80 void consumeComponentValue();
81
82 void consumeWhitespace()
83 {
84 while (peek().type() == WhitespaceToken)
85 ++m_first;
86 }
87
88 String serialize() const;
89
90 const CSSParserToken* begin() const { return m_first; }
91
92 static CSSParserToken& eofToken();
93
94private:
95 CSSParserTokenRange(const CSSParserToken* first, const CSSParserToken* last)
96 : m_first(first)
97 , m_last(last)
98 { }
99
100 const CSSParserToken* m_first;
101 const CSSParserToken* m_last;
102};
103
104} // namespace WebCore
105