1/*
2 * Copyright (C) 2009 Google 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
31#ifndef WebData_h
32#define WebData_h
33
34#include "WebCommon.h"
35
36#if WEBKIT_IMPLEMENTATION
37namespace WebCore { class SharedBuffer; }
38namespace WTF { template <typename T> class PassRefPtr; }
39#endif
40
41namespace WebKit {
42
43class WebDataPrivate;
44
45// A container for raw bytes.  It is inexpensive to copy a WebData object.
46//
47// WARNING: It is not safe to pass a WebData across threads!!!
48//
49class WebData {
50public:
51    ~WebData() { reset(); }
52
53    WebData() : m_private(0) { }
54
55    WebData(const char* data, size_t size) : m_private(0)
56    {
57        assign(data, size);
58    }
59
60    template <int N>
61    WebData(const char (&data)[N]) : m_private(0)
62    {
63        assign(data, N - 1);
64    }
65
66    WebData(const WebData& d) : m_private(0) { assign(d); }
67
68    WebData& operator=(const WebData& d)
69    {
70        assign(d);
71        return *this;
72    }
73
74    WEBKIT_API void reset();
75    WEBKIT_API void assign(const WebData&);
76    WEBKIT_API void assign(const char* data, size_t size);
77
78    WEBKIT_API size_t size() const;
79    WEBKIT_API const char* data() const;
80
81    bool isEmpty() const { return !size(); }
82    bool isNull() const { return !m_private; }
83
84#if WEBKIT_IMPLEMENTATION
85    WebData(const WTF::PassRefPtr<WebCore::SharedBuffer>&);
86    WebData& operator=(const WTF::PassRefPtr<WebCore::SharedBuffer>&);
87    operator WTF::PassRefPtr<WebCore::SharedBuffer>() const;
88#else
89    template <class C>
90    WebData(const C& c) : m_private(0)
91    {
92        assign(c.data(), c.size());
93    }
94
95    template <class C>
96    WebData& operator=(const C& c)
97    {
98        assign(c.data(), c.size());
99        return *this;
100    }
101#endif
102
103private:
104    void assign(WebDataPrivate*);
105    WebDataPrivate* m_private;
106};
107
108} // namespace WebKit
109
110#endif
111