<rdar://problem/10062621>
New public API for handling formatters: creating, deleting, modifying categories, and formatters, and managing type/formatter association.
This provides SB classes for each of the main object types involved in providing formatter support:
 SBTypeCategory
 SBTypeFilter
 SBTypeFormat
 SBTypeSummary
 SBTypeSynthetic
plus, an SBTypeNameSpecifier class that is used on the public API layer to abstract the notion that formatters can be applied to plain type-names as well as to regular expressions
For naming consistency, this patch also renames a lot of formatters-related classes.
Plus, the changes in how flags are handled that started with summaries is now extended to other classes as well. A new enum (lldb::eTypeOption) is meant to support this on the public side.
The patch also adds several new calls to the formatter infrastructure that are used to implement by-index accessing and several other design changes required to accommodate the new API layer.
An architectural change is introduced in that backing objects for formatters now become writable. On the public API layer, CoW is implemented to prevent unwanted propagation of changes.
Lastly, there are some modifications in how the "default" category is constructed and managed in relation to other categories.

llvm-svn: 150558
diff --git a/lldb/source/Core/DataVisualization.cpp b/lldb/source/Core/DataVisualization.cpp
index ce587dc..c5f0088c 100644
--- a/lldb/source/Core/DataVisualization.cpp
+++ b/lldb/source/Core/DataVisualization.cpp
@@ -38,16 +38,24 @@
     return GetFormatManager().GetCurrentRevision();
 }
 
-lldb::ValueFormatSP
+lldb::TypeFormatImplSP
 DataVisualization::ValueFormats::GetFormat (ValueObject& valobj, lldb::DynamicValueType use_dynamic)
 {
-    lldb::ValueFormatSP entry;
+    lldb::TypeFormatImplSP entry;
     GetFormatManager().GetValueNavigator().Get(valobj, entry, use_dynamic);
     return entry;
 }
 
+lldb::TypeFormatImplSP
+DataVisualization::ValueFormats::GetFormat (const ConstString &type)
+{
+    lldb::TypeFormatImplSP entry;
+    GetFormatManager().GetValueNavigator().Get(type, entry);
+    return entry;
+}
+
 void
-DataVisualization::ValueFormats::Add (const ConstString &type, const lldb::ValueFormatSP &entry)
+DataVisualization::ValueFormats::Add (const ConstString &type, const lldb::TypeFormatImplSP &entry)
 {
     GetFormatManager().GetValueNavigator().Add(FormatManager::GetValidTypeName(type),entry);
 }
@@ -65,7 +73,7 @@
 }
 
 void
-DataVisualization::ValueFormats::LoopThrough (ValueFormat::ValueCallback callback, void* callback_baton)
+DataVisualization::ValueFormats::LoopThrough (TypeFormatImpl::ValueCallback callback, void* callback_baton)
 {
     GetFormatManager().GetValueNavigator().LoopThrough(callback, callback_baton);
 }
@@ -76,7 +84,19 @@
     return GetFormatManager().GetValueNavigator().GetCount();
 }
 
-lldb::SummaryFormatSP
+lldb::TypeNameSpecifierImplSP
+DataVisualization::ValueFormats::GetTypeNameSpecifierForFormatAtIndex (uint32_t index)
+{
+    return GetFormatManager().GetValueNavigator().GetTypeNameSpecifierAtIndex(index);
+}
+
+lldb::TypeFormatImplSP
+DataVisualization::ValueFormats::GetFormatAtIndex (uint32_t index)
+{
+    return GetFormatManager().GetValueNavigator().GetAtIndex(index);
+}
+
+lldb::TypeSummaryImplSP
 DataVisualization::GetSummaryFormat (ValueObject& valobj,
                                      lldb::DynamicValueType use_dynamic)
 {
@@ -92,10 +112,10 @@
 
 bool
 DataVisualization::AnyMatches (ConstString type_name,
-                               FormatCategory::FormatCategoryItems items,
+                               TypeCategoryImpl::FormatCategoryItems items,
                                bool only_enabled,
                                const char** matching_category,
-                               FormatCategory::FormatCategoryItems* matching_type)
+                               TypeCategoryImpl::FormatCategoryItems* matching_type)
 {
     return GetFormatManager().AnyMatches(type_name,
                                          items,
@@ -105,10 +125,11 @@
 }
 
 bool
-DataVisualization::Categories::GetCategory (const ConstString &category, lldb::FormatCategorySP &entry)
+DataVisualization::Categories::GetCategory (const ConstString &category, lldb::TypeCategoryImplSP &entry,
+                                            bool allow_create)
 {
-    entry = GetFormatManager().GetCategory(category);
-    return true;
+    entry = GetFormatManager().GetCategory(category, allow_create);
+    return (entry.get() != NULL);
 }
 
 void
@@ -131,27 +152,43 @@
 }
 
 void
-DataVisualization::Categories::Clear (ConstString &category)
+DataVisualization::Categories::Clear (const ConstString &category)
 {
     GetFormatManager().GetCategory(category)->Clear(eFormatCategoryItemSummary | eFormatCategoryItemRegexSummary);
 }
 
 void
-DataVisualization::Categories::Enable (ConstString& category)
+DataVisualization::Categories::Enable (const ConstString& category,
+                                       CategoryMap::Position pos)
 {
-    if (GetFormatManager().GetCategory(category)->IsEnabled() == false)
-        GetFormatManager().EnableCategory(category);
-    else
-    {
+    if (GetFormatManager().GetCategory(category)->IsEnabled())
         GetFormatManager().DisableCategory(category);
-        GetFormatManager().EnableCategory(category);
+    GetFormatManager().EnableCategory(category, pos);
+}
+
+void
+DataVisualization::Categories::Disable (const ConstString& category)
+{
+    if (GetFormatManager().GetCategory(category)->IsEnabled() == true)
+        GetFormatManager().DisableCategory(category);
+}
+
+void
+DataVisualization::Categories::Enable (const lldb::TypeCategoryImplSP& category,
+                                       CategoryMap::Position pos)
+{
+    if (category.get())
+    {
+        if (category->IsEnabled())
+            GetFormatManager().DisableCategory(category);
+        GetFormatManager().EnableCategory(category, pos);
     }
 }
 
 void
-DataVisualization::Categories::Disable (ConstString& category)
+DataVisualization::Categories::Disable (const lldb::TypeCategoryImplSP& category)
 {
-    if (GetFormatManager().GetCategory(category)->IsEnabled() == true)
+    if (category.get() && category->IsEnabled() == true)
         GetFormatManager().DisableCategory(category);
 }
 
@@ -167,14 +204,20 @@
     return GetFormatManager().GetCategoriesCount();
 }
 
+lldb::TypeCategoryImplSP
+DataVisualization::Categories::GetCategoryAtIndex (uint32_t index)
+{
+    return GetFormatManager().GetCategoryAtIndex(index);
+}
+
 bool
-DataVisualization::NamedSummaryFormats::GetSummaryFormat (const ConstString &type, lldb::SummaryFormatSP &entry)
+DataVisualization::NamedSummaryFormats::GetSummaryFormat (const ConstString &type, lldb::TypeSummaryImplSP &entry)
 {
     return GetFormatManager().GetNamedSummaryNavigator().Get(type,entry);
 }
 
 void
-DataVisualization::NamedSummaryFormats::Add (const ConstString &type, const lldb::SummaryFormatSP &entry)
+DataVisualization::NamedSummaryFormats::Add (const ConstString &type, const lldb::TypeSummaryImplSP &entry)
 {
     GetFormatManager().GetNamedSummaryNavigator().Add(FormatManager::GetValidTypeName(type),entry);
 }
@@ -192,7 +235,7 @@
 }
 
 void
-DataVisualization::NamedSummaryFormats::LoopThrough (SummaryFormat::SummaryCallback callback, void* callback_baton)
+DataVisualization::NamedSummaryFormats::LoopThrough (TypeSummaryImpl::SummaryCallback callback, void* callback_baton)
 {
     GetFormatManager().GetNamedSummaryNavigator().LoopThrough(callback, callback_baton);
 }