DXR is a code search and navigation tool aimed at making sense of large projects. It supports full-text and regex searches as well as structural queries.

Implementation

Mercurial (b6d82b1a6b02)

VCS Links

Line Code
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
/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*-
 * vim: set ts=8 sts=2 et sw=2 tw=80:
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#ifndef vm_ReceiverGuard_h
#define vm_ReceiverGuard_h

#include "vm/Shape.h"

namespace js {

// [SMDOC] Receiver Guard
//
// A ReceiverGuard encapsulates the information about an object that needs to
// be tested to determine if it has the same 'structure' as another object.
// The guard includes the shape and/or group of the object, and which of these
// is tested, as well as the meaning here of 'structure', depends on the kind
// of object being tested:
//
// NativeObject: The structure of a native object is determined by its shape.
//   Two objects with the same shape have the same class, prototype, flags,
//   and all properties except those stored in dense elements.
//
// ProxyObject: The structure of a proxy object is determined by its shape.
//   Proxies with the same shape have the same class and prototype, but no
//   other commonality is guaranteed.
//
// TypedObject: The structure of a typed object is determined by its group.
//   All typed objects with the same group have the same class, prototype, and
//   own properties.
//
// In all cases, a ReceiverGuard has *either* a shape or a group active, and
// never both.
class HeapReceiverGuard;

class ReceiverGuard {
  ObjectGroup* group_;
  Shape* shape_;

  void MOZ_ALWAYS_INLINE assertInvariants() {
    // Only one of group_ or shape_ may be active at a time.
    MOZ_ASSERT_IF(group_ || shape_, !!group_ != !!shape_);
  }

 public:
  ReceiverGuard() : group_(nullptr), shape_(nullptr) {}

  inline MOZ_IMPLICIT ReceiverGuard(const HeapReceiverGuard& guard);

  explicit MOZ_ALWAYS_INLINE ReceiverGuard(JSObject* obj);
  MOZ_ALWAYS_INLINE ReceiverGuard(ObjectGroup* group, Shape* shape);

  bool operator==(const ReceiverGuard& other) const {
    return group_ == other.group_ && shape_ == other.shape_;
  }

  bool operator!=(const ReceiverGuard& other) const {
    return !(*this == other);
  }

  uintptr_t hash() const {
    return (uintptr_t(group_) >> 3) ^ (uintptr_t(shape_) >> 3);
  }

  void setShape(Shape* shape) {
    shape_ = shape;
    assertInvariants();
  }

  void setGroup(ObjectGroup* group) {
    group_ = group;
    assertInvariants();
  }

  Shape* getShape() const { return shape_; }
  ObjectGroup* getGroup() const { return group_; }
};

// Heap storage for ReceiverGuards.
//
// This is a storage only class -- all computation is actually
// done by converting this back to a RecieverGuard, hence why
// there are no accessors.
class HeapReceiverGuard {
  friend class ReceiverGuard;

  GCPtrObjectGroup group_;
  GCPtrShape shape_;

 public:
  explicit HeapReceiverGuard(const ReceiverGuard& guard)
      : group_(guard.getGroup()), shape_(guard.getShape()) {}

  void trace(JSTracer* trc);
};

inline ReceiverGuard::ReceiverGuard(const HeapReceiverGuard& guard)
    : group_(guard.group_), shape_(guard.shape_) {
  assertInvariants();
}

}  // namespace js

#endif /* vm_ReceiverGuard_h */