Move files in wtf/ to platform/wtf/ (Part 11).

third_party/WebKit/Source/wtf/typed_arrays/ArrayBuffer.h

-/*
- * Copyright (C) 2009 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 COMPUTER, 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 COMPUTER, 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.
- */
+// Copyright 2017 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
 
-#ifndef ArrayBuffer_h
-#define ArrayBuffer_h
+#include "platform/wtf/typed_arrays/ArrayBuffer.h"
 
-#include "wtf/Assertions.h"
-#include "wtf/HashSet.h"
-#include "wtf/PassRefPtr.h"
-#include "wtf/RefCounted.h"
-#include "wtf/WTFExport.h"
-#include "wtf/typed_arrays/ArrayBufferContents.h"
-
-namespace WTF {
-
-class ArrayBuffer;
-class ArrayBufferView;
-
-class WTF_EXPORT ArrayBuffer : public RefCounted<ArrayBuffer> {
- public:
-  static inline PassRefPtr<ArrayBuffer> create(unsigned numElements,
-                                               unsigned elementByteSize);
-  static inline PassRefPtr<ArrayBuffer> create(ArrayBuffer*);
-  static inline PassRefPtr<ArrayBuffer> create(const void* source,
-                                               unsigned byteLength);
-  static inline PassRefPtr<ArrayBuffer> create(ArrayBufferContents&);
-
-  static inline PassRefPtr<ArrayBuffer> createOrNull(unsigned numElements,
-                                                     unsigned elementByteSize);
-
-  // Only for use by DOMArrayBuffer::createUninitializedOrNull().
-  static inline PassRefPtr<ArrayBuffer> createUninitializedOrNull(
-      unsigned numElements,
-      unsigned elementByteSize);
-
-  static inline PassRefPtr<ArrayBuffer> createShared(unsigned numElements,
-                                                     unsigned elementByteSize);
-  static inline PassRefPtr<ArrayBuffer> createShared(const void* source,
-                                                     unsigned byteLength);
-
-  inline void* data();
-  inline const void* data() const;
-  inline void* dataShared();
-  inline const void* dataShared() const;
-  inline void* dataMaybeShared();
-  inline const void* dataMaybeShared() const;
-  inline unsigned byteLength() const;
-
-  // Creates a new ArrayBuffer object with copy of bytes in this object
-  // ranging from |begin| upto but not including |end|.
-  inline PassRefPtr<ArrayBuffer> slice(int begin, int end) const;
-  inline PassRefPtr<ArrayBuffer> slice(int begin) const;
-
-  void addView(ArrayBufferView*);
-  void removeView(ArrayBufferView*);
-
-  bool transfer(ArrayBufferContents&);
-  bool shareContentsWith(ArrayBufferContents&);
-  bool isNeutered() const { return m_isNeutered; }
-  bool isShared() const { return m_contents.isShared(); }
-
-  ~ArrayBuffer() {}
-
- protected:
-  inline explicit ArrayBuffer(ArrayBufferContents&);
-
- private:
-  static inline PassRefPtr<ArrayBuffer> create(
-      unsigned numElements,
-      unsigned elementByteSize,
-      ArrayBufferContents::InitializationPolicy);
-  static inline PassRefPtr<ArrayBuffer> createOrNull(
-      unsigned numElements,
-      unsigned elementByteSize,
-      ArrayBufferContents::InitializationPolicy);
-  static inline PassRefPtr<ArrayBuffer> createShared(
-      unsigned numElements,
-      unsigned elementByteSize,
-      ArrayBufferContents::InitializationPolicy);
-
-  inline PassRefPtr<ArrayBuffer> sliceImpl(unsigned begin, unsigned end) const;
-  inline unsigned clampIndex(int index) const;
-  static inline int clampValue(int x, int left, int right);
-
-  ArrayBufferContents m_contents;
-  ArrayBufferView* m_firstView;
-  bool m_isNeutered;
-};
-
-int ArrayBuffer::clampValue(int x, int left, int right) {
-  DCHECK_LE(left, right);
-  if (x < left)
-    x = left;
-  if (right < x)
-    x = right;
-  return x;
-}
-
-PassRefPtr<ArrayBuffer> ArrayBuffer::create(unsigned numElements,
-                                            unsigned elementByteSize) {
-  return create(numElements, elementByteSize,
-                ArrayBufferContents::ZeroInitialize);
-}
-
-PassRefPtr<ArrayBuffer> ArrayBuffer::create(ArrayBuffer* other) {
-  // TODO(binji): support creating a SharedArrayBuffer by copying another
-  // ArrayBuffer?
-  DCHECK(!other->isShared());
-  return ArrayBuffer::create(other->data(), other->byteLength());
-}
-
-PassRefPtr<ArrayBuffer> ArrayBuffer::create(const void* source,
-                                            unsigned byteLength) {
-  ArrayBufferContents contents(byteLength, 1, ArrayBufferContents::NotShared,
-                               ArrayBufferContents::DontInitialize);
-  if (UNLIKELY(!contents.data()))
-    OOM_CRASH();
-  RefPtr<ArrayBuffer> buffer = adoptRef(new ArrayBuffer(contents));
-  memcpy(buffer->data(), source, byteLength);
-  return buffer.release();
-}
-
-PassRefPtr<ArrayBuffer> ArrayBuffer::create(ArrayBufferContents& contents) {
-  RELEASE_ASSERT(contents.dataMaybeShared());
-  return adoptRef(new ArrayBuffer(contents));
-}
-
-PassRefPtr<ArrayBuffer> ArrayBuffer::createOrNull(unsigned numElements,
-                                                  unsigned elementByteSize) {
-  return createOrNull(numElements, elementByteSize,
-                      ArrayBufferContents::ZeroInitialize);
-}
-
-PassRefPtr<ArrayBuffer> ArrayBuffer::createUninitializedOrNull(
-    unsigned numElements,
-    unsigned elementByteSize) {
-  return createOrNull(numElements, elementByteSize,
-                      ArrayBufferContents::DontInitialize);
-}
-
-PassRefPtr<ArrayBuffer> ArrayBuffer::create(
-    unsigned numElements,
-    unsigned elementByteSize,
-    ArrayBufferContents::InitializationPolicy policy) {
-  ArrayBufferContents contents(numElements, elementByteSize,
-                               ArrayBufferContents::NotShared, policy);
-  RELEASE_ASSERT(contents.data());
-  return adoptRef(new ArrayBuffer(contents));
-}
-
-PassRefPtr<ArrayBuffer> ArrayBuffer::createOrNull(
-    unsigned numElements,
-    unsigned elementByteSize,
-    ArrayBufferContents::InitializationPolicy policy) {
-  ArrayBufferContents contents(numElements, elementByteSize,
-                               ArrayBufferContents::NotShared, policy);
-  if (!contents.data())
-    return nullptr;
-  return adoptRef(new ArrayBuffer(contents));
-}
-
-PassRefPtr<ArrayBuffer> ArrayBuffer::createShared(unsigned numElements,
-                                                  unsigned elementByteSize) {
-  return createShared(numElements, elementByteSize,
-                      ArrayBufferContents::ZeroInitialize);
-}
-
-PassRefPtr<ArrayBuffer> ArrayBuffer::createShared(const void* source,
-                                                  unsigned byteLength) {
-  ArrayBufferContents contents(byteLength, 1, ArrayBufferContents::Shared,
-                               ArrayBufferContents::DontInitialize);
-  RELEASE_ASSERT(contents.dataShared());
-  RefPtr<ArrayBuffer> buffer = adoptRef(new ArrayBuffer(contents));
-  memcpy(buffer->dataShared(), source, byteLength);
-  return buffer.release();
-}
-
-PassRefPtr<ArrayBuffer> ArrayBuffer::createShared(
-    unsigned numElements,
-    unsigned elementByteSize,
-    ArrayBufferContents::InitializationPolicy policy) {
-  ArrayBufferContents contents(numElements, elementByteSize,
-                               ArrayBufferContents::Shared, policy);
-  RELEASE_ASSERT(contents.dataShared());
-  return adoptRef(new ArrayBuffer(contents));
-}
-
-ArrayBuffer::ArrayBuffer(ArrayBufferContents& contents)
-    : m_firstView(0), m_isNeutered(false) {
-  if (contents.isShared())
-    contents.shareWith(m_contents);
-  else
-    contents.transfer(m_contents);
-}
-
-void* ArrayBuffer::data() {
-  return m_contents.data();
-}
-
-const void* ArrayBuffer::data() const {
-  return m_contents.data();
-}
-
-void* ArrayBuffer::dataShared() {
-  return m_contents.dataShared();
-}
-
-const void* ArrayBuffer::dataShared() const {
-  return m_contents.dataShared();
-}
-
-void* ArrayBuffer::dataMaybeShared() {
-  return m_contents.dataMaybeShared();
-}
-
-const void* ArrayBuffer::dataMaybeShared() const {
-  return m_contents.dataMaybeShared();
-}
-
-unsigned ArrayBuffer::byteLength() const {
-  return m_contents.sizeInBytes();
-}
-
-PassRefPtr<ArrayBuffer> ArrayBuffer::slice(int begin, int end) const {
-  return sliceImpl(clampIndex(begin), clampIndex(end));
-}
-
-PassRefPtr<ArrayBuffer> ArrayBuffer::slice(int begin) const {
-  return sliceImpl(clampIndex(begin), byteLength());
-}
-
-PassRefPtr<ArrayBuffer> ArrayBuffer::sliceImpl(unsigned begin,
-                                               unsigned end) const {
-  unsigned size = begin <= end ? end - begin : 0;
-  return ArrayBuffer::create(static_cast<const char*>(data()) + begin, size);
-}
-
-unsigned ArrayBuffer::clampIndex(int index) const {
-  unsigned currentLength = byteLength();
-  if (index < 0)
-    index = currentLength + index;
-  return clampValue(index, 0, currentLength);
-}
-
-}  // namespace WTF
-
-using WTF::ArrayBuffer;
-
-#endif  // ArrayBuffer_h
+// The contents of this header was moved to platform/wtf as part of
+// WTF migration project. See the following post for details:
+// https://groups.google.com/a/chromium.org/d/msg/blink-dev/tLdAZCTlcAA/bYXVT8gYCAAJ