Extend assembler with ability to produce comments for the generated code.

runtime/vm/object.h

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 #ifndef VM_OBJECT_H_
 #define VM_OBJECT_H_
 
 #include "include/dart_api.h"
 #include "platform/assert.h"
 #include "platform/utils.h"
@@ skipping 2162 matching lines @@
   void set_pc_descriptors(const PcDescriptors& descriptors) const {
     StorePointer(&raw_ptr()->pc_descriptors_, descriptors.raw());
   }
 
   RawArray* stackmaps() const {
     return raw_ptr()->stackmaps_;
   }
   void set_stackmaps(const Array& maps) const;
   RawStackmap* GetStackmap(uword pc, Array* stackmaps, Stackmap* map) const;
 
+  class Comments : public ZoneAllocated {
+   public:
+    static Comments& New(intptr_t count);
+
+    intptr_t Length() const;
+
+    void SetPCOffsetAt(intptr_t idx, intptr_t pc_offset);
+    void SetCommentAt(intptr_t idx, const String& comment);
+
+    intptr_t PCOffsetAt(intptr_t idx) const;
+    const String& CommentAt(intptr_t idx) const;
+
+   private:
+    explicit Comments(const Array& comments);
+
+    // Layout of entries describing comments.
+    enum {
+      kPCOffsetEntry = 0,  // PC offset to a comment as a Smi.
+      kCommentEntry,  // Comment text as a String.
+      kNumberOfEntries
+    };
+
+    const Array& comments_;
+
+    friend class Code;
+
+    DISALLOW_COPY_AND_ASSIGN(Comments);
+  };
+
+
+  const Comments& comments() const;
+  void set_comments(const Comments& comments) const;
+
   RawLocalVarDescriptors* var_descriptors() const {
     return raw_ptr()->var_descriptors_;
   }
   void set_var_descriptors(const LocalVarDescriptors& value) const {
     StorePointer(&raw_ptr()->var_descriptors_, value.raw());
   }
 
   RawExceptionHandlers* exception_handlers() const {
     return raw_ptr()->exception_handlers_;
   }
@@ skipping 2723 matching lines @@
 }
 
 
 intptr_t Stackmap::SizeInBits() const {
   return (Smi::Value(raw_ptr()->bitmap_size_in_bytes_) * kBitsPerByte);
 }
 
 }  // namespace dart
 
 #endif  // VM_OBJECT_H_