Add GrowableObjectArray::ToUserCString().

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 3946 matching lines @@
   // function.
   bool IsCallable(Function* function, Context* context) const;
 
   // Evaluate the given expression as if it appeared in an instance
   // method of this instance and return the resulting value, or an
   // error object if evaluating the expression fails.
   RawObject* Evaluate(const String& expr) const;
 
   // Returns a string representation of this instance in a form
   // that is suitable for an end user.
-  virtual const char* ToUserCString(intptr_t maxLen = 40) const;
+  //
+  // max_len is advisory, and the returned string may exceed this max
+  // length.
+  virtual const char* ToUserCString(intptr_t max_len = 40,
+                                    intptr_t nesting = 0) const;
 
   static intptr_t InstanceSize() {
     return RoundedAllocationSize(sizeof(RawInstance));
   }
 
   static RawInstance* New(const Class& cls, Heap::Space space = Heap::kNew);
 
  private:
   RawObject** FieldAddrAtOffset(intptr_t offset) const {
     ASSERT(IsValidFieldOffset(offset));
@@ skipping 914 matching lines @@
   // and morphs the string object into an external string object.
   // The remaining unused part of the original string object is marked as
   // an Array object or a regular Object so that it can be traversed during
   // garbage collection.
   RawString* MakeExternal(void* array,
                           intptr_t length,
                           void* peer,
                           Dart_PeerFinalizer cback) const;
 
   // Produces a quoted, escaped, (possibly) truncated string.
-  const char* ToUserCString(intptr_t maxLen = 40) const;
+  const char* ToUserCString(intptr_t max_len = 40,
+                            intptr_t nesting = 0) const;
 
   // Creates a new String object from a C string that is assumed to contain
   // UTF-8 encoded characters and '\0' is considered a termination character.
   // TODO(7123) - Rename this to FromCString(....).
   static RawString* New(const char* cstr, Heap::Space space = Heap::kNew);
 
   // Creates a new String object from an array of UTF-8 encoded characters.
   static RawString* FromUTF8(const uint8_t* utf8_array,
                              intptr_t array_len,
                              Heap::Space space = Heap::kNew);
@@ skipping 105 matching lines @@
   }
 
   template<typename HandleType, typename ElementType, typename CallbackType>
   static void ReadFromImpl(SnapshotReader* reader,
                            String* str_obj,
                            intptr_t len,
                            intptr_t tags,
                            CallbackType new_symbol,
                            Snapshot::Kind kind);
 
-  intptr_t EscapedString(char* buffer, int maxLen) const;
+  intptr_t EscapedString(char* buffer, int max_len) const;
   intptr_t EscapedStringLen(intptr_t tooLong) const;
 
   FINAL_HEAP_OBJECT_IMPLEMENTATION(String, Instance);
 
   friend class Class;
   friend class Symbols;
   friend class OneByteString;
   friend class TwoByteString;
   friend class ExternalOneByteString;
   friend class ExternalTwoByteString;
@@ skipping 581 matching lines @@
     StorePointer(&raw_ptr()->type_arguments_, value.raw());
   }
 
   virtual bool Equals(const Instance& other) const;
 
   virtual RawInstance* CheckAndCanonicalize(const char** error_str) const {
     UNREACHABLE();
     return Instance::null();
   }
 
+  // Produces a readable representation of this array, e.g. '[1,2,3]',
+  // subject to length limits.
+  const char* ToUserCString(intptr_t max_len = 40,
+                            intptr_t nesting = 0) const;
+
   static intptr_t type_arguments_offset() {
     return OFFSET_OF(RawGrowableObjectArray, type_arguments_);
   }
 
   static intptr_t length_offset() {
     return OFFSET_OF(RawGrowableObjectArray, length_);
   }
   static intptr_t data_offset() {
     return OFFSET_OF(RawGrowableObjectArray, data_);
   }
@@ skipping 807 matching lines @@
 
 
 RawObject* MegamorphicCache::GetTargetFunction(const Array& array,
                                                intptr_t index) {
   return array.At((index * kEntryLength) + kTargetFunctionIndex);
 }
 
 }  // namespace dart
 
 #endif  // VM_OBJECT_H_