Support JSON encoding of data for about:tracking information

base/location.h

 // Copyright (c) 2011 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 BASE_LOCATION_H_
 #define BASE_LOCATION_H_
 
 #include <string>
 
 #include "base/base_export.h"
+#include "base/values.h"
 
 #ifndef NDEBUG
 #ifndef TRACK_ALL_TASK_OBJECTS
 #define TRACK_ALL_TASK_OBJECTS
 #endif   // TRACK_ALL_TASK_OBJECTS
 #endif  // NDEBUG
 
 namespace tracked_objects {
 
 // Location provides basic info where of an object was constructed, or was
@@ skipping 25 matching lines @@
     return function_name_ < other.function_name_;
   }
 
   const char* function_name()   const { return function_name_; }
   const char* file_name()       const { return file_name_; }
   int line_number()             const { return line_number_; }
   const void* program_counter() const { return program_counter_; }
 
   std::string ToString() const;
 
+  // Translate the some of the state in this instance into a human readable
+  // string with HTML characters in the function names escaped, and append that
+  // string to |output|.  Inclusion of the file_name_ and function_name_ are
+  // optional, and controlled by the boolean arguments.
   void Write(bool display_filename, bool display_function_name,
              std::string* output) const;
 
   // Write function_name_ in HTML with '<' and '>' properly encoded.
   void WriteFunctionName(std::string* output) const;
 
+  // Construct a Value* representation.  The caller assumes ownership of the
+  // memory in the returned instance.
+  base::DictionaryValue* ToValue() const;
+
  private:
   const char* function_name_;
   const char* file_name_;
   int line_number_;
   const void* program_counter_;
 };
 
 BASE_EXPORT const void* GetProgramCounter();
 
 // Define a macro to record the current source location.
 #define FROM_HERE tracked_objects::Location(                                   \
     __FUNCTION__,                                                              \
     __FILE__,                                                                  \
     __LINE__,                                                                  \
     tracked_objects::GetProgramCounter())                                      \
 
 }  // namespace tracked_objects
 
 #endif  // BASE_LOCATION_H_