OLD | NEW |
1 /* | 1 // Copyright 2017 The Chromium Authors. All rights reserved. |
2 * Copyright (C) 2013 Google Inc. All rights reserved. | 2 // Use of this source code is governed by a BSD-style license that can be |
3 * | 3 // found in the LICENSE file. |
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 | 4 |
31 #ifndef ArrayBufferBuilder_h | 5 #include "platform/wtf/typed_arrays/ArrayBufferBuilder.h" |
32 #define ArrayBufferBuilder_h | |
33 | 6 |
34 #include "wtf/Allocator.h" | 7 // The contents of this header was moved to platform/wtf as part of |
35 #include "wtf/Noncopyable.h" | 8 // WTF migration project. See the following post for details: |
36 #include "wtf/RefPtr.h" | 9 // https://groups.google.com/a/chromium.org/d/msg/blink-dev/tLdAZCTlcAA/bYXVT8gY
CAAJ |
37 #include "wtf/text/WTFString.h" | |
38 #include "wtf/typed_arrays/ArrayBuffer.h" | |
39 | |
40 namespace WTF { | |
41 | |
42 // A utility class to build an ArrayBuffer instance. Validity must be checked | |
43 // by isValid() before using an instance. | |
44 class WTF_EXPORT ArrayBufferBuilder final { | |
45 // Disallow copying since it's expensive and we don't want code to do it by | |
46 // accident. | |
47 WTF_MAKE_NONCOPYABLE(ArrayBufferBuilder); | |
48 USING_FAST_MALLOC(ArrayBufferBuilder); | |
49 | |
50 public: | |
51 // Creates an ArrayBufferBuilder using the default capacity. | |
52 ArrayBufferBuilder(); | |
53 | |
54 ArrayBufferBuilder(unsigned capacity) | |
55 : m_bytesUsed(0), m_variableCapacity(true) { | |
56 m_buffer = ArrayBuffer::create(capacity, 1); | |
57 } | |
58 | |
59 bool isValid() const { return m_buffer.get(); } | |
60 | |
61 // Appending empty data is not allowed. | |
62 unsigned append(const char* data, unsigned length); | |
63 | |
64 // Returns the accumulated data as an ArrayBuffer instance. If needed, | |
65 // creates a new ArrayBuffer instance and copies contents from the internal | |
66 // buffer to it. Otherwise, returns a PassRefPtr pointing to the internal | |
67 // buffer. | |
68 PassRefPtr<ArrayBuffer> toArrayBuffer(); | |
69 | |
70 // Converts the accumulated data into a String using the default encoding. | |
71 String toString(); | |
72 | |
73 // Number of bytes currently accumulated. | |
74 unsigned byteLength() const { return m_bytesUsed; } | |
75 | |
76 // Number of bytes allocated. | |
77 unsigned capacity() const { return m_buffer->byteLength(); } | |
78 | |
79 void shrinkToFit(); | |
80 | |
81 const void* data() const { return m_buffer->data(); } | |
82 | |
83 // If set to false, the capacity won't be expanded and when appended data | |
84 // overflows, the overflowed part will be dropped. | |
85 void setVariableCapacity(bool value) { m_variableCapacity = value; } | |
86 | |
87 private: | |
88 // Expands the size of m_buffer to size + m_bytesUsed bytes. Returns true | |
89 // iff successful. If reallocation is needed, copies only data in | |
90 // [0, m_bytesUsed) range. | |
91 bool expandCapacity(unsigned size); | |
92 | |
93 unsigned m_bytesUsed; | |
94 bool m_variableCapacity; | |
95 RefPtr<ArrayBuffer> m_buffer; | |
96 }; | |
97 | |
98 } // namespace WTF | |
99 | |
100 using WTF::ArrayBufferBuilder; | |
101 | |
102 #endif // ArrayBufferBuilder_h | |
OLD | NEW |