xref: /llvm-project/lldb/source/DataFormatters/FormatManager.cpp (revision ddac7611eefbf4015cb93a94d58396767adbef26) 
1 //===-- FormatManager.cpp -------------------------------------------*- C++ -*-===//
2 //
3 //                     The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 
10 #include "lldb/lldb-python.h"
11 
12 #include "lldb/DataFormatters/FormatManager.h"
13 
14 // C Includes
15 // C++ Includes
16 // Other libraries and framework includes
17 // Project includes
18 
19 #include "lldb/Core/Debugger.h"
20 #include "lldb/DataFormatters/CXXFormatterFunctions.h"
21 #include "lldb/Interpreter/ScriptInterpreterPython.h"
22 #include "lldb/Target/ExecutionContext.h"
23 #include "lldb/Target/Platform.h"
24 #include "llvm/ADT/STLExtras.h"
25 
26 using namespace lldb;
27 using namespace lldb_private;
28 
29 
30 struct FormatInfo
31 {
32     Format format;
33     const char format_char; // One or more format characters that can be used for this format.
34     const char *format_name;    // Long format name that can be used to specify the current format
35 };
36 
37 static FormatInfo
38 g_format_infos[] =
39 {
40     { eFormatDefault        , '\0'  , "default"             },
41     { eFormatBoolean        , 'B'   , "boolean"             },
42     { eFormatBinary         , 'b'   , "binary"              },
43     { eFormatBytes          , 'y'   , "bytes"               },
44     { eFormatBytesWithASCII , 'Y'   , "bytes with ASCII"    },
45     { eFormatChar           , 'c'   , "character"           },
46     { eFormatCharPrintable  , 'C'   , "printable character" },
47     { eFormatComplexFloat   , 'F'   , "complex float"       },
48     { eFormatCString        , 's'   , "c-string"            },
49     { eFormatDecimal        , 'd'   , "decimal"             },
50     { eFormatEnum           , 'E'   , "enumeration"         },
51     { eFormatHex            , 'x'   , "hex"                 },
52     { eFormatHexUppercase   , 'X'   , "uppercase hex"       },
53     { eFormatFloat          , 'f'   , "float"               },
54     { eFormatOctal          , 'o'   , "octal"               },
55     { eFormatOSType         , 'O'   , "OSType"              },
56     { eFormatUnicode16      , 'U'   , "unicode16"           },
57     { eFormatUnicode32      , '\0'  , "unicode32"           },
58     { eFormatUnsigned       , 'u'   , "unsigned decimal"    },
59     { eFormatPointer        , 'p'   , "pointer"             },
60     { eFormatVectorOfChar   , '\0'  , "char[]"              },
61     { eFormatVectorOfSInt8  , '\0'  , "int8_t[]"            },
62     { eFormatVectorOfUInt8  , '\0'  , "uint8_t[]"           },
63     { eFormatVectorOfSInt16 , '\0'  , "int16_t[]"           },
64     { eFormatVectorOfUInt16 , '\0'  , "uint16_t[]"          },
65     { eFormatVectorOfSInt32 , '\0'  , "int32_t[]"           },
66     { eFormatVectorOfUInt32 , '\0'  , "uint32_t[]"          },
67     { eFormatVectorOfSInt64 , '\0'  , "int64_t[]"           },
68     { eFormatVectorOfUInt64 , '\0'  , "uint64_t[]"          },
69     { eFormatVectorOfFloat32, '\0'  , "float32[]"           },
70     { eFormatVectorOfFloat64, '\0'  , "float64[]"           },
71     { eFormatVectorOfUInt128, '\0'  , "uint128_t[]"         },
72     { eFormatComplexInteger , 'I'   , "complex integer"     },
73     { eFormatCharArray      , 'a'   , "character array"     },
74     { eFormatAddressInfo    , 'A'   , "address"             },
75     { eFormatHexFloat       , '\0'  , "hex float"           },
76     { eFormatInstruction    , 'i'   , "instruction"         },
77     { eFormatVoid           , 'v'   , "void"                }
78 };
79 
80 static uint32_t g_num_format_infos = llvm::array_lengthof(g_format_infos);
81 
82 static bool
83 GetFormatFromFormatChar (char format_char, Format &format)
84 {
85     for (uint32_t i=0; i<g_num_format_infos; ++i)
86     {
87         if (g_format_infos[i].format_char == format_char)
88         {
89             format = g_format_infos[i].format;
90             return true;
91         }
92     }
93     format = eFormatInvalid;
94     return false;
95 }
96 
97 static bool
98 GetFormatFromFormatName (const char *format_name, bool partial_match_ok, Format &format)
99 {
100     uint32_t i;
101     for (i=0; i<g_num_format_infos; ++i)
102     {
103         if (strcasecmp (g_format_infos[i].format_name, format_name) == 0)
104         {
105             format = g_format_infos[i].format;
106             return true;
107         }
108     }
109 
110     if (partial_match_ok)
111     {
112         for (i=0; i<g_num_format_infos; ++i)
113         {
114             if (strcasestr (g_format_infos[i].format_name, format_name) == g_format_infos[i].format_name)
115             {
116                 format = g_format_infos[i].format;
117                 return true;
118             }
119         }
120     }
121     format = eFormatInvalid;
122     return false;
123 }
124 
125 bool
126 FormatManager::GetFormatFromCString (const char *format_cstr,
127                                      bool partial_match_ok,
128                                      lldb::Format &format)
129 {
130     bool success = false;
131     if (format_cstr && format_cstr[0])
132     {
133         if (format_cstr[1] == '\0')
134         {
135             success = GetFormatFromFormatChar (format_cstr[0], format);
136             if (success)
137                 return true;
138         }
139 
140         success = GetFormatFromFormatName (format_cstr, partial_match_ok, format);
141     }
142     if (!success)
143         format = eFormatInvalid;
144     return success;
145 }
146 
147 char
148 FormatManager::GetFormatAsFormatChar (lldb::Format format)
149 {
150     for (uint32_t i=0; i<g_num_format_infos; ++i)
151     {
152         if (g_format_infos[i].format == format)
153             return g_format_infos[i].format_char;
154     }
155     return '\0';
156 }
157 
158 const char *
159 FormatManager::GetFormatAsCString (Format format)
160 {
161     if (format >= eFormatDefault && format < kNumFormats)
162         return g_format_infos[format].format_name;
163     return NULL;
164 }
165 
166 void
167 FormatManager::GetPossibleMatches (ValueObject& valobj,
168                                    ClangASTType clang_type,
169                                    uint32_t reason,
170                                    lldb::DynamicValueType use_dynamic,
171                                    FormattersMatchVector& entries,
172                                    bool did_strip_ptr,
173                                    bool did_strip_ref,
174                                    bool did_strip_typedef,
175                                    bool root_level)
176 {
177     clang_type = clang_type.RemoveFastQualifiers();
178     ConstString type_name(clang_type.GetConstTypeName());
179     if (valobj.GetBitfieldBitSize() > 0)
180     {
181         StreamString sstring;
182         sstring.Printf("%s:%d",type_name.AsCString(),valobj.GetBitfieldBitSize());
183         ConstString bitfieldname = ConstString(sstring.GetData());
184         entries.push_back({bitfieldname,0,did_strip_ptr,did_strip_ref,did_strip_typedef});
185         reason |= lldb_private::eFormatterChoiceCriterionStrippedBitField;
186     }
187     entries.push_back({type_name,reason,did_strip_ptr,did_strip_ref,did_strip_typedef});
188 
189     ConstString display_type_name(clang_type.GetDisplayTypeName());
190     if (display_type_name != type_name)
191         entries.push_back({display_type_name,reason,did_strip_ptr,did_strip_ref,did_strip_typedef});
192 
193     for (bool is_rvalue_ref = true, j = true; j && clang_type.IsReferenceType(nullptr, &is_rvalue_ref); j = false)
194     {
195         ClangASTType non_ref_type = clang_type.GetNonReferenceType();
196         GetPossibleMatches(valobj,
197                            non_ref_type,
198                            reason | lldb_private::eFormatterChoiceCriterionStrippedPointerReference,
199                            use_dynamic,
200                            entries,
201                            did_strip_ptr,
202                            true,
203                            did_strip_typedef);
204         if (non_ref_type.IsTypedefType())
205         {
206             ClangASTType deffed_referenced_type = non_ref_type.GetTypedefedType();
207             deffed_referenced_type = is_rvalue_ref ? deffed_referenced_type.GetRValueReferenceType() : deffed_referenced_type.GetLValueReferenceType();
208             GetPossibleMatches(valobj,
209                                deffed_referenced_type,
210                                reason | lldb_private::eFormatterChoiceCriterionNavigatedTypedefs,
211                                use_dynamic,
212                                entries,
213                                did_strip_ptr,
214                                did_strip_ref,
215                                true); // this is not exactly the usual meaning of stripping typedefs
216         }
217     }
218 
219     if (clang_type.IsPointerType())
220     {
221         ClangASTType non_ptr_type = clang_type.GetPointeeType();
222         GetPossibleMatches(valobj,
223                            non_ptr_type,
224                            reason | lldb_private::eFormatterChoiceCriterionStrippedPointerReference,
225                            use_dynamic,
226                            entries,
227                            true,
228                            did_strip_ref,
229                            did_strip_typedef);
230         if (non_ptr_type.IsTypedefType())
231         {
232             ClangASTType deffed_pointed_type = non_ptr_type.GetTypedefedType().GetPointerType();
233             GetPossibleMatches(valobj,
234                                deffed_pointed_type,
235                                reason | lldb_private::eFormatterChoiceCriterionNavigatedTypedefs,
236                                use_dynamic,
237                                entries,
238                                did_strip_ptr,
239                                did_strip_ref,
240                                true); // this is not exactly the usual meaning of stripping typedefs
241         }
242     }
243     bool canBeObjCDynamic = clang_type.IsPossibleDynamicType (NULL,
244                                                               false, // no C
245                                                               true);  // yes ObjC
246 
247     if (canBeObjCDynamic)
248     {
249         if (use_dynamic != lldb::eNoDynamicValues)
250         {
251             do
252             {
253                 lldb::ProcessSP process_sp = valobj.GetProcessSP();
254                 ObjCLanguageRuntime* runtime = process_sp->GetObjCLanguageRuntime();
255                 if (runtime == nullptr)
256                     break;
257                 ObjCLanguageRuntime::ClassDescriptorSP objc_class_sp (runtime->GetClassDescriptor(valobj));
258                 if (!objc_class_sp)
259                     break;
260                 ConstString name (objc_class_sp->GetClassName());
261                 entries.push_back({name,reason | lldb_private::eFormatterChoiceCriterionDynamicObjCDiscovery,did_strip_ptr,did_strip_ref,did_strip_typedef});
262             } while (false);
263         }
264 
265         ClangASTType non_ptr_type = clang_type.GetPointeeType();
266         GetPossibleMatches(valobj,
267                            non_ptr_type,
268                            reason | lldb_private::eFormatterChoiceCriterionStrippedPointerReference,
269                            use_dynamic,
270                            entries,
271                            true,
272                            did_strip_ref,
273                            did_strip_typedef);
274     }
275 
276     // try to strip typedef chains
277     if (clang_type.IsTypedefType())
278     {
279         ClangASTType deffed_type = clang_type.GetTypedefedType();
280         GetPossibleMatches(valobj,
281                            deffed_type,
282                            reason | lldb_private::eFormatterChoiceCriterionNavigatedTypedefs,
283                            use_dynamic,
284                            entries,
285                            did_strip_ptr,
286                            did_strip_ref,
287                            true);
288     }
289 
290     if (root_level)
291     {
292         do {
293             if (!clang_type.IsValid())
294                 break;
295 
296             ClangASTType unqual_clang_ast_type = clang_type.GetFullyUnqualifiedType();
297             if (!unqual_clang_ast_type.IsValid())
298                 break;
299             if (unqual_clang_ast_type.GetOpaqueQualType() != clang_type.GetOpaqueQualType())
300                 GetPossibleMatches (valobj,
301                                     unqual_clang_ast_type,
302                                     reason,
303                                     use_dynamic,
304                                     entries,
305                                     did_strip_ptr,
306                                     did_strip_ref,
307                                     did_strip_typedef);
308         } while(false);
309 
310 
311         // if all else fails, go to static type
312         if (valobj.IsDynamic())
313         {
314             lldb::ValueObjectSP static_value_sp(valobj.GetStaticValue());
315             if (static_value_sp)
316                 GetPossibleMatches(*static_value_sp.get(),
317                                    static_value_sp->GetClangType(),
318                                    reason | lldb_private::eFormatterChoiceCriterionWentToStaticValue,
319                                    use_dynamic,
320                                    entries,
321                                    did_strip_ptr,
322                                    did_strip_ref,
323                                    did_strip_typedef,
324                                    true);
325         }
326     }
327 }
328 
329 lldb::TypeFormatImplSP
330 FormatManager::GetFormatForType (lldb::TypeNameSpecifierImplSP type_sp)
331 {
332     if (!type_sp)
333         return lldb::TypeFormatImplSP();
334     lldb::TypeFormatImplSP format_chosen_sp;
335     uint32_t num_categories = m_categories_map.GetCount();
336     lldb::TypeCategoryImplSP category_sp;
337     uint32_t prio_category = UINT32_MAX;
338     for (uint32_t category_id = 0;
339          category_id < num_categories;
340          category_id++)
341     {
342         category_sp = GetCategoryAtIndex(category_id);
343         if (category_sp->IsEnabled() == false)
344             continue;
345         lldb::TypeFormatImplSP format_current_sp = category_sp->GetFormatForType(type_sp);
346         if (format_current_sp && (format_chosen_sp.get() == NULL || (prio_category > category_sp->GetEnabledPosition())))
347         {
348             prio_category = category_sp->GetEnabledPosition();
349             format_chosen_sp = format_current_sp;
350         }
351     }
352     return format_chosen_sp;
353 }
354 
355 lldb::TypeSummaryImplSP
356 FormatManager::GetSummaryForType (lldb::TypeNameSpecifierImplSP type_sp)
357 {
358     if (!type_sp)
359         return lldb::TypeSummaryImplSP();
360     lldb::TypeSummaryImplSP summary_chosen_sp;
361     uint32_t num_categories = m_categories_map.GetCount();
362     lldb::TypeCategoryImplSP category_sp;
363     uint32_t prio_category = UINT32_MAX;
364     for (uint32_t category_id = 0;
365          category_id < num_categories;
366          category_id++)
367     {
368         category_sp = GetCategoryAtIndex(category_id);
369         if (category_sp->IsEnabled() == false)
370             continue;
371         lldb::TypeSummaryImplSP summary_current_sp = category_sp->GetSummaryForType(type_sp);
372         if (summary_current_sp && (summary_chosen_sp.get() == NULL || (prio_category > category_sp->GetEnabledPosition())))
373         {
374             prio_category = category_sp->GetEnabledPosition();
375             summary_chosen_sp = summary_current_sp;
376         }
377     }
378     return summary_chosen_sp;
379 }
380 
381 lldb::TypeFilterImplSP
382 FormatManager::GetFilterForType (lldb::TypeNameSpecifierImplSP type_sp)
383 {
384     if (!type_sp)
385         return lldb::TypeFilterImplSP();
386     lldb::TypeFilterImplSP filter_chosen_sp;
387     uint32_t num_categories = m_categories_map.GetCount();
388     lldb::TypeCategoryImplSP category_sp;
389     uint32_t prio_category = UINT32_MAX;
390     for (uint32_t category_id = 0;
391          category_id < num_categories;
392          category_id++)
393     {
394         category_sp = GetCategoryAtIndex(category_id);
395         if (category_sp->IsEnabled() == false)
396             continue;
397         lldb::TypeFilterImplSP filter_current_sp((TypeFilterImpl*)category_sp->GetFilterForType(type_sp).get());
398         if (filter_current_sp && (filter_chosen_sp.get() == NULL || (prio_category > category_sp->GetEnabledPosition())))
399         {
400             prio_category = category_sp->GetEnabledPosition();
401             filter_chosen_sp = filter_current_sp;
402         }
403     }
404     return filter_chosen_sp;
405 }
406 
407 #ifndef LLDB_DISABLE_PYTHON
408 lldb::ScriptedSyntheticChildrenSP
409 FormatManager::GetSyntheticForType (lldb::TypeNameSpecifierImplSP type_sp)
410 {
411     if (!type_sp)
412         return lldb::ScriptedSyntheticChildrenSP();
413     lldb::ScriptedSyntheticChildrenSP synth_chosen_sp;
414     uint32_t num_categories = m_categories_map.GetCount();
415     lldb::TypeCategoryImplSP category_sp;
416     uint32_t prio_category = UINT32_MAX;
417     for (uint32_t category_id = 0;
418          category_id < num_categories;
419          category_id++)
420     {
421         category_sp = GetCategoryAtIndex(category_id);
422         if (category_sp->IsEnabled() == false)
423             continue;
424         lldb::ScriptedSyntheticChildrenSP synth_current_sp((ScriptedSyntheticChildren*)category_sp->GetSyntheticForType(type_sp).get());
425         if (synth_current_sp && (synth_chosen_sp.get() == NULL || (prio_category > category_sp->GetEnabledPosition())))
426         {
427             prio_category = category_sp->GetEnabledPosition();
428             synth_chosen_sp = synth_current_sp;
429         }
430     }
431     return synth_chosen_sp;
432 }
433 #endif
434 
435 #ifndef LLDB_DISABLE_PYTHON
436 lldb::SyntheticChildrenSP
437 FormatManager::GetSyntheticChildrenForType (lldb::TypeNameSpecifierImplSP type_sp)
438 {
439     if (!type_sp)
440         return lldb::SyntheticChildrenSP();
441     lldb::TypeFilterImplSP filter_sp = GetFilterForType(type_sp);
442     lldb::ScriptedSyntheticChildrenSP synth_sp = GetSyntheticForType(type_sp);
443     if (filter_sp->GetRevision() > synth_sp->GetRevision())
444         return lldb::SyntheticChildrenSP(filter_sp.get());
445     else
446         return lldb::SyntheticChildrenSP(synth_sp.get());
447 }
448 #endif
449 
450 lldb::TypeValidatorImplSP
451 FormatManager::GetValidatorForType (lldb::TypeNameSpecifierImplSP type_sp)
452 {
453     if (!type_sp)
454         return lldb::TypeValidatorImplSP();
455     lldb::TypeValidatorImplSP validator_chosen_sp;
456     uint32_t num_categories = m_categories_map.GetCount();
457     lldb::TypeCategoryImplSP category_sp;
458     uint32_t prio_category = UINT32_MAX;
459     for (uint32_t category_id = 0;
460          category_id < num_categories;
461          category_id++)
462     {
463         category_sp = GetCategoryAtIndex(category_id);
464         if (category_sp->IsEnabled() == false)
465             continue;
466         lldb::TypeValidatorImplSP validator_current_sp(category_sp->GetValidatorForType(type_sp).get());
467         if (validator_current_sp && (validator_chosen_sp.get() == NULL || (prio_category > category_sp->GetEnabledPosition())))
468         {
469             prio_category = category_sp->GetEnabledPosition();
470             validator_chosen_sp = validator_current_sp;
471         }
472     }
473     return validator_chosen_sp;
474 }
475 
476 lldb::TypeCategoryImplSP
477 FormatManager::GetCategory (const ConstString& category_name,
478                          bool can_create)
479 {
480     if (!category_name)
481         return GetCategory(m_default_category_name);
482     lldb::TypeCategoryImplSP category;
483     if (m_categories_map.Get(category_name, category))
484         return category;
485 
486     if (!can_create)
487         return lldb::TypeCategoryImplSP();
488 
489     m_categories_map.Add(category_name,lldb::TypeCategoryImplSP(new TypeCategoryImpl(this, category_name)));
490     return GetCategory(category_name);
491 }
492 
493 lldb::Format
494 FormatManager::GetSingleItemFormat(lldb::Format vector_format)
495 {
496     switch(vector_format)
497     {
498         case eFormatVectorOfChar:
499             return eFormatCharArray;
500 
501         case eFormatVectorOfSInt8:
502         case eFormatVectorOfSInt16:
503         case eFormatVectorOfSInt32:
504         case eFormatVectorOfSInt64:
505             return eFormatDecimal;
506 
507         case eFormatVectorOfUInt8:
508         case eFormatVectorOfUInt16:
509         case eFormatVectorOfUInt32:
510         case eFormatVectorOfUInt64:
511         case eFormatVectorOfUInt128:
512             return eFormatHex;
513 
514         case eFormatVectorOfFloat32:
515         case eFormatVectorOfFloat64:
516             return eFormatFloat;
517 
518         default:
519             return lldb::eFormatInvalid;
520     }
521 }
522 
523 bool
524 FormatManager::ShouldPrintAsOneLiner (ValueObject& valobj)
525 {
526     // if settings say no oneline whatsoever
527     if (valobj.GetTargetSP().get() && valobj.GetTargetSP()->GetDebugger().GetAutoOneLineSummaries() == false)
528         return false; // then don't oneline
529 
530     // if this object has a summary, then ask the summary
531     if (valobj.GetSummaryFormat().get() != nullptr)
532         return valobj.GetSummaryFormat()->IsOneLiner();
533 
534     // no children, no party
535     if (valobj.GetNumChildren() == 0)
536         return false;
537 
538     size_t total_children_name_len = 0;
539 
540     for (size_t idx = 0;
541          idx < valobj.GetNumChildren();
542          idx++)
543     {
544         bool is_synth_val = false;
545         ValueObjectSP child_sp(valobj.GetChildAtIndex(idx, true));
546         // something is wrong here - bail out
547         if (!child_sp)
548             return false;
549         // if we decided to define synthetic children for a type, we probably care enough
550         // to show them, but avoid nesting children in children
551         if (child_sp->GetSyntheticChildren().get() != nullptr)
552         {
553             ValueObjectSP synth_sp(child_sp->GetSyntheticValue());
554             // wait.. wat? just get out of here..
555             if (!synth_sp)
556                 return false;
557             // but if we only have them to provide a value, keep going
558             if (synth_sp->MightHaveChildren() == false && synth_sp->DoesProvideSyntheticValue())
559                 is_synth_val = true;
560             else
561                 return false;
562         }
563 
564         total_children_name_len += child_sp->GetName().GetLength();
565 
566         // 50 itself is a "randomly" chosen number - the idea is that
567         // overly long structs should not get this treatment
568         // FIXME: maybe make this a user-tweakable setting?
569         if (total_children_name_len > 50)
570             return false;
571 
572         // if a summary is there..
573         if (child_sp->GetSummaryFormat())
574         {
575             // and it wants children, then bail out
576             if (child_sp->GetSummaryFormat()->DoesPrintChildren(child_sp.get()))
577                 return false;
578         }
579 
580         // if this child has children..
581         if (child_sp->GetNumChildren())
582         {
583             // ...and no summary...
584             // (if it had a summary and the summary wanted children, we would have bailed out anyway
585             //  so this only makes us bail out if this has no summary and we would then print children)
586             if (!child_sp->GetSummaryFormat() && !is_synth_val) // but again only do that if not a synthetic valued child
587                 return false; // then bail out
588         }
589     }
590     return true;
591 }
592 
593 ConstString
594 FormatManager::GetValidTypeName (const ConstString& type)
595 {
596     return ::GetValidTypeName_Impl(type);
597 }
598 
599 ConstString
600 GetTypeForCache (ValueObject& valobj,
601                  lldb::DynamicValueType use_dynamic)
602 {
603     if (use_dynamic == lldb::eNoDynamicValues)
604     {
605         if (valobj.IsDynamic())
606         {
607             if (valobj.GetStaticValue())
608                 return valobj.GetStaticValue()->GetQualifiedTypeName();
609             else
610                 return ConstString();
611         }
612         else
613             return valobj.GetQualifiedTypeName();
614     }
615     if (valobj.IsDynamic())
616         return valobj.GetQualifiedTypeName();
617     if (valobj.GetDynamicValue(use_dynamic))
618         return valobj.GetDynamicValue(use_dynamic)->GetQualifiedTypeName();
619     return ConstString();
620 }
621 
622 lldb::TypeFormatImplSP
623 FormatManager::GetHardcodedFormat (ValueObject& valobj,
624                                    lldb::DynamicValueType use_dynamic)
625 {
626     for (const auto& candidate: m_hardcoded_formats)
627     {
628         auto result = candidate(valobj,use_dynamic,*this);
629         if (result)
630             return result;
631     }
632     return nullptr;
633 }
634 
635 lldb::TypeFormatImplSP
636 FormatManager::GetFormat (ValueObject& valobj,
637                           lldb::DynamicValueType use_dynamic)
638 {
639     TypeFormatImplSP retval;
640     Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_TYPES));
641     ConstString valobj_type(GetTypeForCache(valobj, use_dynamic));
642     if (valobj_type)
643     {
644         if (log)
645             log->Printf("\n\n[FormatManager::GetFormat] Looking into cache for type %s", valobj_type.AsCString("<invalid>"));
646         if (m_format_cache.GetFormat(valobj_type,retval))
647         {
648             if (log)
649             {
650                 log->Printf("[FormatManager::GetFormat] Cache search success. Returning.");
651                 if (log->GetDebug())
652                     log->Printf("[FormatManager::GetFormat] Cache hits: %" PRIu64 " - Cache Misses: %" PRIu64, m_format_cache.GetCacheHits(), m_format_cache.GetCacheMisses());
653             }
654             return retval;
655         }
656         if (log)
657             log->Printf("[FormatManager::GetFormat] Cache search failed. Going normal route");
658     }
659     retval = m_categories_map.GetFormat(valobj, use_dynamic);
660     if (!retval)
661     {
662         if (log)
663             log->Printf("[FormatManager::GetFormat] Search failed. Giving hardcoded a chance.");
664         retval = GetHardcodedFormat(valobj, use_dynamic);
665     }
666     else if (valobj_type)
667     {
668         if (log)
669             log->Printf("[FormatManager::GetFormat] Caching %p for type %s",
670                         static_cast<void*>(retval.get()),
671                         valobj_type.AsCString("<invalid>"));
672         m_format_cache.SetFormat(valobj_type,retval);
673     }
674     if (log && log->GetDebug())
675         log->Printf("[FormatManager::GetFormat] Cache hits: %" PRIu64 " - Cache Misses: %" PRIu64, m_format_cache.GetCacheHits(), m_format_cache.GetCacheMisses());
676     return retval;
677 }
678 
679 lldb::TypeSummaryImplSP
680 FormatManager::GetHardcodedSummaryFormat (ValueObject& valobj,
681                                           lldb::DynamicValueType use_dynamic)
682 {
683     for (const auto& candidate: m_hardcoded_summaries)
684     {
685         auto result = candidate(valobj,use_dynamic,*this);
686         if (result)
687             return result;
688     }
689     return nullptr;
690 }
691 
692 lldb::TypeSummaryImplSP
693 FormatManager::GetSummaryFormat (ValueObject& valobj,
694                                  lldb::DynamicValueType use_dynamic)
695 {
696     TypeSummaryImplSP retval;
697     Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_TYPES));
698     ConstString valobj_type(GetTypeForCache(valobj, use_dynamic));
699     if (valobj_type)
700     {
701         if (log)
702             log->Printf("\n\n[FormatManager::GetSummaryFormat] Looking into cache for type %s", valobj_type.AsCString("<invalid>"));
703         if (m_format_cache.GetSummary(valobj_type,retval))
704         {
705             if (log)
706             {
707                 log->Printf("[FormatManager::GetSummaryFormat] Cache search success. Returning.");
708                 if (log->GetDebug())
709                     log->Printf("[FormatManager::GetSummaryFormat] Cache hits: %" PRIu64 " - Cache Misses: %" PRIu64, m_format_cache.GetCacheHits(), m_format_cache.GetCacheMisses());
710             }
711             return retval;
712         }
713         if (log)
714             log->Printf("[FormatManager::GetSummaryFormat] Cache search failed. Going normal route");
715     }
716     retval = m_categories_map.GetSummaryFormat(valobj, use_dynamic);
717     if (!retval)
718     {
719         if (log)
720             log->Printf("[FormatManager::GetSummaryFormat] Search failed. Giving hardcoded a chance.");
721         retval = GetHardcodedSummaryFormat(valobj, use_dynamic);
722     }
723     else if (valobj_type)
724     {
725         if (log)
726             log->Printf("[FormatManager::GetSummaryFormat] Caching %p for type %s",
727                         static_cast<void*>(retval.get()),
728                         valobj_type.AsCString("<invalid>"));
729         m_format_cache.SetSummary(valobj_type,retval);
730     }
731     if (log && log->GetDebug())
732         log->Printf("[FormatManager::GetSummaryFormat] Cache hits: %" PRIu64 " - Cache Misses: %" PRIu64, m_format_cache.GetCacheHits(), m_format_cache.GetCacheMisses());
733     return retval;
734 }
735 
736 #ifndef LLDB_DISABLE_PYTHON
737 lldb::SyntheticChildrenSP
738 FormatManager::GetHardcodedSyntheticChildren (ValueObject& valobj,
739                                               lldb::DynamicValueType use_dynamic)
740 {
741     for (const auto& candidate: m_hardcoded_synthetics)
742     {
743         auto result = candidate(valobj,use_dynamic,*this);
744         if (result)
745             return result;
746     }
747     return nullptr;
748 }
749 
750 lldb::SyntheticChildrenSP
751 FormatManager::GetSyntheticChildren (ValueObject& valobj,
752                                      lldb::DynamicValueType use_dynamic)
753 {
754     SyntheticChildrenSP retval;
755     Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_TYPES));
756     ConstString valobj_type(GetTypeForCache(valobj, use_dynamic));
757     if (valobj_type)
758     {
759         if (log)
760             log->Printf("\n\n[FormatManager::GetSyntheticChildren] Looking into cache for type %s", valobj_type.AsCString("<invalid>"));
761         if (m_format_cache.GetSynthetic(valobj_type,retval))
762         {
763             if (log)
764             {
765                 log->Printf("[FormatManager::GetSyntheticChildren] Cache search success. Returning.");
766                 if (log->GetDebug())
767                     log->Printf("[FormatManager::GetSyntheticChildren] Cache hits: %" PRIu64 " - Cache Misses: %" PRIu64, m_format_cache.GetCacheHits(), m_format_cache.GetCacheMisses());
768             }
769             return retval;
770         }
771         if (log)
772             log->Printf("[FormatManager::GetSyntheticChildren] Cache search failed. Going normal route");
773     }
774     retval = m_categories_map.GetSyntheticChildren(valobj, use_dynamic);
775     if (!retval)
776     {
777         if (log)
778             log->Printf("[FormatManager::GetSyntheticChildren] Search failed. Giving hardcoded a chance.");
779         retval = GetHardcodedSyntheticChildren(valobj, use_dynamic);
780     }
781     else if (valobj_type)
782     {
783         if (log)
784             log->Printf("[FormatManager::GetSyntheticChildren] Caching %p for type %s",
785                         static_cast<void*>(retval.get()),
786                         valobj_type.AsCString("<invalid>"));
787         m_format_cache.SetSynthetic(valobj_type,retval);
788     }
789     if (log && log->GetDebug())
790         log->Printf("[FormatManager::GetSyntheticChildren] Cache hits: %" PRIu64 " - Cache Misses: %" PRIu64, m_format_cache.GetCacheHits(), m_format_cache.GetCacheMisses());
791     return retval;
792 }
793 #endif
794 
795 lldb::TypeValidatorImplSP
796 FormatManager::GetValidator (ValueObject& valobj,
797                              lldb::DynamicValueType use_dynamic)
798 {
799     TypeValidatorImplSP retval;
800     Log *log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_TYPES));
801     ConstString valobj_type(GetTypeForCache(valobj, use_dynamic));
802     if (valobj_type)
803     {
804         if (log)
805             log->Printf("\n\n[FormatManager::GetValidator] Looking into cache for type %s", valobj_type.AsCString("<invalid>"));
806         if (m_format_cache.GetValidator(valobj_type,retval))
807         {
808             if (log)
809             {
810                 log->Printf("[FormatManager::GetValidator] Cache search success. Returning.");
811                 if (log->GetDebug())
812                     log->Printf("[FormatManager::GetValidator] Cache hits: %" PRIu64 " - Cache Misses: %" PRIu64, m_format_cache.GetCacheHits(), m_format_cache.GetCacheMisses());
813             }
814             return retval;
815         }
816         if (log)
817             log->Printf("[FormatManager::GetValidator] Cache search failed. Going normal route");
818     }
819     retval = m_categories_map.GetValidator(valobj, use_dynamic);
820     if (!retval)
821     {
822         if (log)
823             log->Printf("[FormatManager::GetValidator] Search failed. Giving hardcoded a chance.");
824         retval = GetHardcodedValidator(valobj, use_dynamic);
825     }
826     else if (valobj_type)
827     {
828         if (log)
829             log->Printf("[FormatManager::GetValidator] Caching %p for type %s",
830                         static_cast<void*>(retval.get()),
831                         valobj_type.AsCString("<invalid>"));
832         m_format_cache.SetValidator(valobj_type,retval);
833     }
834     if (log && log->GetDebug())
835         log->Printf("[FormatManager::GetValidator] Cache hits: %" PRIu64 " - Cache Misses: %" PRIu64, m_format_cache.GetCacheHits(), m_format_cache.GetCacheMisses());
836     return retval;
837 }
838 
839 lldb::TypeValidatorImplSP
840 FormatManager::GetHardcodedValidator (ValueObject& valobj,
841                                       lldb::DynamicValueType use_dynamic)
842 {
843     for (const auto& candidate: m_hardcoded_validators)
844     {
845         auto result = candidate(valobj,use_dynamic,*this);
846         if (result)
847             return result;
848     }
849     return nullptr;
850 }
851 
852 FormatManager::FormatManager() :
853     m_format_cache(),
854     m_named_summaries_map(this),
855     m_last_revision(0),
856     m_categories_map(this),
857     m_default_category_name(ConstString("default")),
858     m_system_category_name(ConstString("system")),
859     m_gnu_cpp_category_name(ConstString("gnu-libstdc++")),
860     m_libcxx_category_name(ConstString("libcxx")),
861     m_objc_category_name(ConstString("objc")),
862     m_corefoundation_category_name(ConstString("CoreFoundation")),
863     m_coregraphics_category_name(ConstString("CoreGraphics")),
864     m_coreservices_category_name(ConstString("CoreServices")),
865     m_vectortypes_category_name(ConstString("VectorTypes")),
866     m_appkit_category_name(ConstString("AppKit")),
867     m_hardcoded_formats(),
868     m_hardcoded_summaries(),
869     m_hardcoded_synthetics(),
870     m_hardcoded_validators()
871 
872 {
873     LoadSystemFormatters();
874     LoadLibStdcppFormatters();
875     LoadLibcxxFormatters();
876     LoadObjCFormatters();
877     LoadHardcodedFormatters();
878 
879     EnableCategory(m_objc_category_name,TypeCategoryMap::Last);
880     EnableCategory(m_corefoundation_category_name,TypeCategoryMap::Last);
881     EnableCategory(m_appkit_category_name,TypeCategoryMap::Last);
882     EnableCategory(m_coreservices_category_name,TypeCategoryMap::Last);
883     EnableCategory(m_coregraphics_category_name,TypeCategoryMap::Last);
884     EnableCategory(m_gnu_cpp_category_name,TypeCategoryMap::Last);
885     EnableCategory(m_libcxx_category_name,TypeCategoryMap::Last);
886     EnableCategory(m_vectortypes_category_name,TypeCategoryMap::Last);
887     EnableCategory(m_system_category_name,TypeCategoryMap::Last);
888 }
889 
890 static void
891 AddFormat (TypeCategoryImpl::SharedPointer category_sp,
892            lldb::Format format,
893            ConstString type_name,
894            TypeFormatImpl::Flags flags,
895            bool regex = false)
896 {
897     lldb::TypeFormatImplSP format_sp(new TypeFormatImpl_Format(format, flags));
898 
899     if (regex)
900         category_sp->GetRegexTypeFormatsContainer()->Add(RegularExpressionSP(new RegularExpression(type_name.AsCString())),format_sp);
901     else
902         category_sp->GetTypeFormatsContainer()->Add(type_name, format_sp);
903 }
904 
905 
906 static void
907 AddStringSummary(TypeCategoryImpl::SharedPointer category_sp,
908                  const char* string,
909                  ConstString type_name,
910                  TypeSummaryImpl::Flags flags,
911                  bool regex = false)
912 {
913     lldb::TypeSummaryImplSP summary_sp(new StringSummaryFormat(flags,
914                                                                string));
915 
916     if (regex)
917         category_sp->GetRegexTypeSummariesContainer()->Add(RegularExpressionSP(new RegularExpression(type_name.AsCString())),summary_sp);
918     else
919         category_sp->GetTypeSummariesContainer()->Add(type_name, summary_sp);
920 }
921 
922 #ifndef LLDB_DISABLE_PYTHON
923 static void
924 AddCXXSummary (TypeCategoryImpl::SharedPointer category_sp,
925                CXXFunctionSummaryFormat::Callback funct,
926                const char* description,
927                ConstString type_name,
928                TypeSummaryImpl::Flags flags,
929                bool regex = false)
930 {
931     lldb::TypeSummaryImplSP summary_sp(new CXXFunctionSummaryFormat(flags,funct,description));
932     if (regex)
933         category_sp->GetRegexTypeSummariesContainer()->Add(RegularExpressionSP(new RegularExpression(type_name.AsCString())),summary_sp);
934     else
935         category_sp->GetTypeSummariesContainer()->Add(type_name, summary_sp);
936 }
937 #endif
938 
939 #ifndef LLDB_DISABLE_PYTHON
940 static void AddCXXSynthetic  (TypeCategoryImpl::SharedPointer category_sp,
941                               CXXSyntheticChildren::CreateFrontEndCallback generator,
942                               const char* description,
943                               ConstString type_name,
944                               ScriptedSyntheticChildren::Flags flags,
945                               bool regex = false)
946 {
947     lldb::SyntheticChildrenSP synth_sp(new CXXSyntheticChildren(flags,description,generator));
948     if (regex)
949         category_sp->GetRegexTypeSyntheticsContainer()->Add(RegularExpressionSP(new RegularExpression(type_name.AsCString())), synth_sp);
950     else
951         category_sp->GetTypeSyntheticsContainer()->Add(type_name,synth_sp);
952 }
953 #endif
954 
955 #ifndef LLDB_DISABLE_PYTHON
956 static void AddFilter  (TypeCategoryImpl::SharedPointer category_sp,
957                         std::vector<std::string> children,
958                         const char* description,
959                         ConstString type_name,
960                         ScriptedSyntheticChildren::Flags flags,
961                         bool regex = false)
962 {
963     TypeFilterImplSP filter_sp(new TypeFilterImpl(flags));
964     for (auto child : children)
965         filter_sp->AddExpressionPath(child);
966     if (regex)
967         category_sp->GetRegexTypeFiltersContainer()->Add(RegularExpressionSP(new RegularExpression(type_name.AsCString())), filter_sp);
968     else
969         category_sp->GetTypeFiltersContainer()->Add(type_name,filter_sp);
970 }
971 #endif
972 
973 void
974 FormatManager::LoadLibStdcppFormatters()
975 {
976     TypeSummaryImpl::Flags stl_summary_flags;
977     stl_summary_flags.SetCascades(true)
978     .SetSkipPointers(false)
979     .SetSkipReferences(false)
980     .SetDontShowChildren(true)
981     .SetDontShowValue(true)
982     .SetShowMembersOneLiner(false)
983     .SetHideItemNames(false);
984 
985     lldb::TypeSummaryImplSP std_string_summary_sp(new StringSummaryFormat(stl_summary_flags,
986                                                                           "${var._M_dataplus._M_p}"));
987 
988     TypeCategoryImpl::SharedPointer gnu_category_sp = GetCategory(m_gnu_cpp_category_name);
989 
990     gnu_category_sp->GetTypeSummariesContainer()->Add(ConstString("std::string"),
991                                                 std_string_summary_sp);
992     gnu_category_sp->GetTypeSummariesContainer()->Add(ConstString("std::basic_string<char>"),
993                                                 std_string_summary_sp);
994     gnu_category_sp->GetTypeSummariesContainer()->Add(ConstString("std::basic_string<char,std::char_traits<char>,std::allocator<char> >"),
995                                                 std_string_summary_sp);
996     gnu_category_sp->GetTypeSummariesContainer()->Add(ConstString("std::basic_string<char, std::char_traits<char>, std::allocator<char> >"),
997                                                 std_string_summary_sp);
998 
999     // making sure we force-pick the summary for printing wstring (_M_p is a wchar_t*)
1000     lldb::TypeSummaryImplSP std_wstring_summary_sp(new StringSummaryFormat(stl_summary_flags,
1001                                                                            "${var._M_dataplus._M_p%S}"));
1002 
1003     gnu_category_sp->GetTypeSummariesContainer()->Add(ConstString("std::wstring"),
1004                                                 std_wstring_summary_sp);
1005     gnu_category_sp->GetTypeSummariesContainer()->Add(ConstString("std::basic_string<wchar_t>"),
1006                                                 std_wstring_summary_sp);
1007     gnu_category_sp->GetTypeSummariesContainer()->Add(ConstString("std::basic_string<wchar_t,std::char_traits<wchar_t>,std::allocator<wchar_t> >"),
1008                                                 std_wstring_summary_sp);
1009     gnu_category_sp->GetTypeSummariesContainer()->Add(ConstString("std::basic_string<wchar_t, std::char_traits<wchar_t>, std::allocator<wchar_t> >"),
1010                                                 std_wstring_summary_sp);
1011 
1012 
1013 #ifndef LLDB_DISABLE_PYTHON
1014 
1015     SyntheticChildren::Flags stl_synth_flags;
1016     stl_synth_flags.SetCascades(true).SetSkipPointers(false).SetSkipReferences(false);
1017 
1018     gnu_category_sp->GetRegexTypeSyntheticsContainer()->Add(RegularExpressionSP(new RegularExpression("^std::vector<.+>(( )?&)?$")),
1019                                                        SyntheticChildrenSP(new ScriptedSyntheticChildren(stl_synth_flags,
1020                                                                                                  "lldb.formatters.cpp.gnu_libstdcpp.StdVectorSynthProvider")));
1021     gnu_category_sp->GetRegexTypeSyntheticsContainer()->Add(RegularExpressionSP(new RegularExpression("^std::map<.+> >(( )?&)?$")),
1022                                                        SyntheticChildrenSP(new ScriptedSyntheticChildren(stl_synth_flags,
1023                                                                                                  "lldb.formatters.cpp.gnu_libstdcpp.StdMapSynthProvider")));
1024     gnu_category_sp->GetRegexTypeSyntheticsContainer()->Add(RegularExpressionSP(new RegularExpression("^std::list<.+>(( )?&)?$")),
1025                                                        SyntheticChildrenSP(new ScriptedSyntheticChildren(stl_synth_flags,
1026                                                                                                  "lldb.formatters.cpp.gnu_libstdcpp.StdListSynthProvider")));
1027 
1028     stl_summary_flags.SetDontShowChildren(false);stl_summary_flags.SetSkipPointers(true);
1029     gnu_category_sp->GetRegexTypeSummariesContainer()->Add(RegularExpressionSP(new RegularExpression("^std::vector<.+>(( )?&)?$")),
1030                                                      TypeSummaryImplSP(new StringSummaryFormat(stl_summary_flags,
1031                                                                                                "size=${svar%#}")));
1032     gnu_category_sp->GetRegexTypeSummariesContainer()->Add(RegularExpressionSP(new RegularExpression("^std::map<.+> >(( )?&)?$")),
1033                                                      TypeSummaryImplSP(new StringSummaryFormat(stl_summary_flags,
1034                                                                                                "size=${svar%#}")));
1035     gnu_category_sp->GetRegexTypeSummariesContainer()->Add(RegularExpressionSP(new RegularExpression("^std::list<.+>(( )?&)?$")),
1036                                                      TypeSummaryImplSP(new StringSummaryFormat(stl_summary_flags,
1037                                                                                                "size=${svar%#}")));
1038 
1039     AddCXXSynthetic(gnu_category_sp, lldb_private::formatters::LibStdcppVectorIteratorSyntheticFrontEndCreator, "std::vector iterator synthetic children", ConstString("^__gnu_cxx::__normal_iterator<.+>$"), stl_synth_flags, true);
1040 
1041     AddCXXSynthetic(gnu_category_sp, lldb_private::formatters::LibstdcppMapIteratorSyntheticFrontEndCreator, "std::map iterator synthetic children", ConstString("^std::_Rb_tree_iterator<.+>$"), stl_synth_flags, true);
1042 #endif
1043 }
1044 
1045 void
1046 FormatManager::LoadLibcxxFormatters()
1047 {
1048     TypeSummaryImpl::Flags stl_summary_flags;
1049     stl_summary_flags.SetCascades(true)
1050     .SetSkipPointers(false)
1051     .SetSkipReferences(false)
1052     .SetDontShowChildren(true)
1053     .SetDontShowValue(true)
1054     .SetShowMembersOneLiner(false)
1055     .SetHideItemNames(false);
1056 
1057 #ifndef LLDB_DISABLE_PYTHON
1058     //std::string code("     lldb.formatters.cpp.libcxx.stdstring_SummaryProvider(valobj,internal_dict)");
1059     //lldb::TypeSummaryImplSP std_string_summary_sp(new ScriptSummaryFormat(stl_summary_flags, "lldb.formatters.cpp.libcxx.stdstring_SummaryProvider",code.c_str()));
1060 
1061     lldb::TypeSummaryImplSP std_string_summary_sp(new CXXFunctionSummaryFormat(stl_summary_flags, lldb_private::formatters::LibcxxStringSummaryProvider, "std::string summary provider"));
1062     lldb::TypeSummaryImplSP std_wstring_summary_sp(new CXXFunctionSummaryFormat(stl_summary_flags, lldb_private::formatters::LibcxxWStringSummaryProvider, "std::wstring summary provider"));
1063 
1064     TypeCategoryImpl::SharedPointer libcxx_category_sp = GetCategory(m_libcxx_category_name);
1065 
1066     libcxx_category_sp->GetTypeSummariesContainer()->Add(ConstString("std::__1::string"),
1067                                                    std_string_summary_sp);
1068     libcxx_category_sp->GetTypeSummariesContainer()->Add(ConstString("std::__1::basic_string<char, std::__1::char_traits<char>, std::__1::allocator<char> >"),
1069                                                    std_string_summary_sp);
1070 
1071     libcxx_category_sp->GetTypeSummariesContainer()->Add(ConstString("std::__1::wstring"),
1072                                                    std_wstring_summary_sp);
1073     libcxx_category_sp->GetTypeSummariesContainer()->Add(ConstString("std::__1::basic_string<wchar_t, std::__1::char_traits<wchar_t>, std::__1::allocator<wchar_t> >"),
1074                                                    std_wstring_summary_sp);
1075 
1076     SyntheticChildren::Flags stl_synth_flags;
1077     stl_synth_flags.SetCascades(true).SetSkipPointers(false).SetSkipReferences(false);
1078 
1079     AddCXXSynthetic(libcxx_category_sp, lldb_private::formatters::LibcxxStdVectorSyntheticFrontEndCreator, "libc++ std::vector synthetic children", ConstString("^std::__1::vector<.+>(( )?&)?$"), stl_synth_flags, true);
1080     AddCXXSynthetic(libcxx_category_sp, lldb_private::formatters::LibcxxStdListSyntheticFrontEndCreator, "libc++ std::list synthetic children", ConstString("^std::__1::list<.+>(( )?&)?$"), stl_synth_flags, true);
1081     AddCXXSynthetic(libcxx_category_sp, lldb_private::formatters::LibcxxStdMapSyntheticFrontEndCreator, "libc++ std::map synthetic children", ConstString("^std::__1::map<.+> >(( )?&)?$"), stl_synth_flags, true);
1082     AddCXXSynthetic(libcxx_category_sp, lldb_private::formatters::LibcxxVectorBoolSyntheticFrontEndCreator, "libc++ std::vector<bool> synthetic children", ConstString("std::__1::vector<std::__1::allocator<bool> >"), stl_synth_flags);
1083     AddCXXSynthetic(libcxx_category_sp, lldb_private::formatters::LibcxxVectorBoolSyntheticFrontEndCreator, "libc++ std::vector<bool> synthetic children", ConstString("std::__1::vector<bool, std::__1::allocator<bool> >"), stl_synth_flags);
1084     AddCXXSynthetic(libcxx_category_sp, lldb_private::formatters::LibcxxStdMapSyntheticFrontEndCreator, "libc++ std::set synthetic children", ConstString("^std::__1::set<.+> >(( )?&)?$"), stl_synth_flags, true);
1085     AddCXXSynthetic(libcxx_category_sp, lldb_private::formatters::LibcxxStdMapSyntheticFrontEndCreator, "libc++ std::multiset synthetic children", ConstString("^std::__1::multiset<.+> >(( )?&)?$"), stl_synth_flags, true);
1086     AddCXXSynthetic(libcxx_category_sp, lldb_private::formatters::LibcxxStdMapSyntheticFrontEndCreator, "libc++ std::multimap synthetic children", ConstString("^std::__1::multimap<.+> >(( )?&)?$"), stl_synth_flags, true);
1087     AddCXXSynthetic(libcxx_category_sp, lldb_private::formatters::LibcxxStdUnorderedMapSyntheticFrontEndCreator, "libc++ std::unordered containers synthetic children", ConstString("^(std::__1::)unordered_(multi)?(map|set)<.+> >$"), stl_synth_flags, true);
1088 
1089     libcxx_category_sp->GetRegexTypeSyntheticsContainer()->Add(RegularExpressionSP(new RegularExpression("^(std::__1::)deque<.+>(( )?&)?$")),
1090                                                           SyntheticChildrenSP(new ScriptedSyntheticChildren(stl_synth_flags,
1091                                                                                                     "lldb.formatters.cpp.libcxx.stddeque_SynthProvider")));
1092 
1093     AddCXXSynthetic(libcxx_category_sp, lldb_private::formatters::LibcxxSharedPtrSyntheticFrontEndCreator, "shared_ptr synthetic children", ConstString("^(std::__1::)shared_ptr<.+>(( )?&)?$"), stl_synth_flags, true);
1094     AddCXXSynthetic(libcxx_category_sp, lldb_private::formatters::LibcxxSharedPtrSyntheticFrontEndCreator, "weak_ptr synthetic children", ConstString("^(std::__1::)weak_ptr<.+>(( )?&)?$"), stl_synth_flags, true);
1095 
1096     stl_summary_flags.SetDontShowChildren(false);stl_summary_flags.SetSkipPointers(false);
1097     AddCXXSynthetic(libcxx_category_sp, lldb_private::formatters::LibcxxVectorBoolSyntheticFrontEndCreator, "libc++ std::vector<bool> synthetic children", ConstString("std::__1::vector<bool, std::__1::allocator<bool> >"), stl_synth_flags);
1098 
1099     AddCXXSummary(libcxx_category_sp, lldb_private::formatters::LibcxxContainerSummaryProvider, "libc++ std::vector summary provider", ConstString("^std::__1::vector<.+>(( )?&)?$"), stl_summary_flags, true);
1100     AddCXXSummary(libcxx_category_sp, lldb_private::formatters::LibcxxContainerSummaryProvider, "libc++ std::list summary provider", ConstString("^std::__1::list<.+>(( )?&)?$"), stl_summary_flags, true);
1101     AddCXXSummary(libcxx_category_sp, lldb_private::formatters::LibcxxContainerSummaryProvider, "libc++ std::map summary provider", ConstString("^std::__1::map<.+>(( )?&)?$"), stl_summary_flags, true);
1102     AddCXXSummary(libcxx_category_sp, lldb_private::formatters::LibcxxContainerSummaryProvider, "libc++ std::deque summary provider", ConstString("^std::__1::deque<.+>(( )?&)?$"), stl_summary_flags, true);
1103     AddCXXSummary(libcxx_category_sp, lldb_private::formatters::LibcxxContainerSummaryProvider, "libc++ std::vector<bool> summary provider", ConstString("std::__1::vector<std::__1::allocator<bool> >"), stl_summary_flags);
1104     AddCXXSummary(libcxx_category_sp, lldb_private::formatters::LibcxxContainerSummaryProvider, "libc++ std::vector<bool> summary provider", ConstString("std::__1::vector<bool, std::__1::allocator<bool> >"), stl_summary_flags);
1105     AddCXXSummary(libcxx_category_sp, lldb_private::formatters::LibcxxContainerSummaryProvider, "libc++ std::set summary provider", ConstString("^std::__1::set<.+>(( )?&)?$"), stl_summary_flags, true);
1106     AddCXXSummary(libcxx_category_sp, lldb_private::formatters::LibcxxContainerSummaryProvider, "libc++ std::multiset summary provider", ConstString("^std::__1::multiset<.+>(( )?&)?$"), stl_summary_flags, true);
1107     AddCXXSummary(libcxx_category_sp, lldb_private::formatters::LibcxxContainerSummaryProvider, "libc++ std::multimap summary provider", ConstString("^std::__1::multimap<.+>(( )?&)?$"), stl_summary_flags, true);
1108     AddCXXSummary(libcxx_category_sp, lldb_private::formatters::LibcxxContainerSummaryProvider, "libc++ std::unordered containers summary provider", ConstString("^(std::__1::)unordered_(multi)?(map|set)<.+> >$"), stl_summary_flags, true);
1109 
1110     stl_summary_flags.SetSkipPointers(true);
1111 
1112     AddCXXSummary(libcxx_category_sp, lldb_private::formatters::LibcxxSmartPointerSummaryProvider, "libc++ std::shared_ptr summary provider", ConstString("^std::__1::shared_ptr<.+>(( )?&)?$"), stl_summary_flags, true);
1113     AddCXXSummary(libcxx_category_sp, lldb_private::formatters::LibcxxSmartPointerSummaryProvider, "libc++ std::weak_ptr summary provider", ConstString("^std::__1::weak_ptr<.+>(( )?&)?$"), stl_summary_flags, true);
1114 
1115     AddCXXSynthetic(libcxx_category_sp, lldb_private::formatters::LibCxxVectorIteratorSyntheticFrontEndCreator, "std::vector iterator synthetic children", ConstString("^std::__1::__wrap_iter<.+>$"), stl_synth_flags, true);
1116 
1117     AddCXXSummary(libcxx_category_sp, lldb_private::formatters::LibcxxContainerSummaryProvider, "libc++ std::vector<bool> summary provider", ConstString("std::__1::vector<bool, std::__1::allocator<bool> >"), stl_summary_flags);
1118     AddCXXSynthetic(libcxx_category_sp, lldb_private::formatters::LibCxxMapIteratorSyntheticFrontEndCreator, "std::map iterator synthetic children", ConstString("^std::__1::__map_iterator<.+>$"), stl_synth_flags, true);
1119 
1120     AddFilter(libcxx_category_sp, {"__a_"}, "libc++ std::atomic filter", ConstString("^std::__1::atomic<.*>$"), stl_synth_flags, true);
1121 #endif
1122 }
1123 
1124 void
1125 FormatManager::LoadSystemFormatters()
1126 {
1127 
1128     TypeSummaryImpl::Flags string_flags;
1129     string_flags.SetCascades(true)
1130     .SetSkipPointers(true)
1131     .SetSkipReferences(false)
1132     .SetDontShowChildren(true)
1133     .SetDontShowValue(false)
1134     .SetShowMembersOneLiner(false)
1135     .SetHideItemNames(false);
1136 
1137     lldb::TypeSummaryImplSP string_format(new StringSummaryFormat(string_flags, "${var%s}"));
1138 
1139 
1140     lldb::TypeSummaryImplSP string_array_format(new StringSummaryFormat(TypeSummaryImpl::Flags().SetCascades(false)
1141                                                                         .SetSkipPointers(true)
1142                                                                         .SetSkipReferences(false)
1143                                                                         .SetDontShowChildren(true)
1144                                                                         .SetDontShowValue(true)
1145                                                                         .SetShowMembersOneLiner(false)
1146                                                                         .SetHideItemNames(false),
1147                                                                         "${var%s}"));
1148 
1149     lldb::RegularExpressionSP any_size_char_arr(new RegularExpression("char \\[[0-9]+\\]"));
1150 
1151     TypeCategoryImpl::SharedPointer sys_category_sp = GetCategory(m_system_category_name);
1152 
1153     sys_category_sp->GetTypeSummariesContainer()->Add(ConstString("char *"), string_format);
1154     sys_category_sp->GetTypeSummariesContainer()->Add(ConstString("unsigned char *"), string_format);
1155     sys_category_sp->GetRegexTypeSummariesContainer()->Add(any_size_char_arr, string_array_format);
1156 
1157     lldb::TypeSummaryImplSP ostype_summary(new StringSummaryFormat(TypeSummaryImpl::Flags().SetCascades(false)
1158                                                                    .SetSkipPointers(true)
1159                                                                    .SetSkipReferences(true)
1160                                                                    .SetDontShowChildren(true)
1161                                                                    .SetDontShowValue(false)
1162                                                                    .SetShowMembersOneLiner(false)
1163                                                                    .SetHideItemNames(false),
1164                                                                    "${var%O}"));
1165 
1166     sys_category_sp->GetTypeSummariesContainer()->Add(ConstString("OSType"), ostype_summary);
1167 
1168 #ifndef LLDB_DISABLE_PYTHON
1169     // FIXME because of a bug in the FormattersContainer we need to add a summary for both X* and const X* (<rdar://problem/12717717>)
1170     AddCXXSummary(sys_category_sp, lldb_private::formatters::Char16StringSummaryProvider, "char16_t * summary provider", ConstString("char16_t *"), string_flags);
1171 
1172     AddCXXSummary(sys_category_sp, lldb_private::formatters::Char32StringSummaryProvider, "char32_t * summary provider", ConstString("char32_t *"), string_flags);
1173 
1174     AddCXXSummary(sys_category_sp, lldb_private::formatters::WCharStringSummaryProvider, "wchar_t * summary provider", ConstString("wchar_t *"), string_flags);
1175 
1176     AddCXXSummary(sys_category_sp, lldb_private::formatters::Char16StringSummaryProvider, "unichar * summary provider", ConstString("unichar *"), string_flags);
1177 
1178     TypeSummaryImpl::Flags widechar_flags;
1179     widechar_flags.SetDontShowValue(true)
1180     .SetSkipPointers(true)
1181     .SetSkipReferences(false)
1182     .SetCascades(true)
1183     .SetDontShowChildren(true)
1184     .SetHideItemNames(true)
1185     .SetShowMembersOneLiner(false);
1186 
1187     AddCXXSummary(sys_category_sp, lldb_private::formatters::Char16SummaryProvider, "char16_t summary provider", ConstString("char16_t"), widechar_flags);
1188     AddCXXSummary(sys_category_sp, lldb_private::formatters::Char32SummaryProvider, "char32_t summary provider", ConstString("char32_t"), widechar_flags);
1189     AddCXXSummary(sys_category_sp, lldb_private::formatters::WCharSummaryProvider, "wchar_t summary provider", ConstString("wchar_t"), widechar_flags);
1190 
1191     AddCXXSummary(sys_category_sp, lldb_private::formatters::Char16SummaryProvider, "unichar summary provider", ConstString("unichar"), widechar_flags);
1192 
1193     TypeFormatImpl::Flags fourchar_flags;
1194     fourchar_flags.SetCascades(true).SetSkipPointers(true).SetSkipReferences(true);
1195 
1196     AddFormat(sys_category_sp, lldb::eFormatOSType, ConstString("FourCharCode"), fourchar_flags);
1197 
1198 #endif
1199 }
1200 
1201 void
1202 FormatManager::LoadObjCFormatters()
1203 {
1204     TypeSummaryImpl::Flags objc_flags;
1205     objc_flags.SetCascades(false)
1206     .SetSkipPointers(true)
1207     .SetSkipReferences(true)
1208     .SetDontShowChildren(true)
1209     .SetDontShowValue(true)
1210     .SetShowMembersOneLiner(false)
1211     .SetHideItemNames(false);
1212 
1213     TypeCategoryImpl::SharedPointer objc_category_sp = GetCategory(m_objc_category_name);
1214 
1215     lldb::TypeSummaryImplSP ObjC_BOOL_summary(new CXXFunctionSummaryFormat(objc_flags, lldb_private::formatters::ObjCBOOLSummaryProvider,""));
1216     objc_category_sp->GetTypeSummariesContainer()->Add(ConstString("BOOL"),
1217                                                  ObjC_BOOL_summary);
1218     objc_category_sp->GetTypeSummariesContainer()->Add(ConstString("BOOL &"),
1219                                                  ObjC_BOOL_summary);
1220     objc_category_sp->GetTypeSummariesContainer()->Add(ConstString("BOOL *"),
1221                                                  ObjC_BOOL_summary);
1222 
1223 #ifndef LLDB_DISABLE_PYTHON
1224     // we need to skip pointers here since we are special casing a SEL* when retrieving its value
1225     objc_flags.SetSkipPointers(true);
1226     AddCXXSummary(objc_category_sp, lldb_private::formatters::ObjCSELSummaryProvider<false>, "SEL summary provider", ConstString("SEL"), objc_flags);
1227     AddCXXSummary(objc_category_sp, lldb_private::formatters::ObjCSELSummaryProvider<false>, "SEL summary provider", ConstString("struct objc_selector"), objc_flags);
1228     AddCXXSummary(objc_category_sp, lldb_private::formatters::ObjCSELSummaryProvider<false>, "SEL summary provider", ConstString("objc_selector"), objc_flags);
1229     AddCXXSummary(objc_category_sp, lldb_private::formatters::ObjCSELSummaryProvider<true>, "SEL summary provider", ConstString("objc_selector *"), objc_flags);
1230     AddCXXSummary(objc_category_sp, lldb_private::formatters::ObjCSELSummaryProvider<true>, "SEL summary provider", ConstString("SEL *"), objc_flags);
1231 
1232     AddCXXSummary(objc_category_sp, lldb_private::formatters::ObjCClassSummaryProvider, "Class summary provider", ConstString("Class"), objc_flags);
1233 
1234     SyntheticChildren::Flags class_synth_flags;
1235     class_synth_flags.SetCascades(true).SetSkipPointers(false).SetSkipReferences(false);
1236 
1237     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::ObjCClassSyntheticFrontEndCreator, "Class synthetic children", ConstString("Class"), class_synth_flags);
1238 #endif // LLDB_DISABLE_PYTHON
1239 
1240     objc_flags.SetSkipPointers(false);
1241     objc_flags.SetCascades(true);
1242     objc_flags.SetSkipReferences(false);
1243 
1244     AddStringSummary (objc_category_sp,
1245                       "${var.__FuncPtr%A}",
1246                       ConstString("__block_literal_generic"),
1247                       objc_flags);
1248 
1249     TypeCategoryImpl::SharedPointer corefoundation_category_sp = GetCategory(m_corefoundation_category_name);
1250 
1251     AddStringSummary(corefoundation_category_sp,
1252                      "${var.years} years, ${var.months} months, ${var.days} days, ${var.hours} hours, ${var.minutes} minutes ${var.seconds} seconds",
1253                      ConstString("CFGregorianUnits"),
1254                      objc_flags);
1255     AddStringSummary(corefoundation_category_sp,
1256                      "location=${var.location} length=${var.length}",
1257                      ConstString("CFRange"),
1258                      objc_flags);
1259     AddStringSummary(corefoundation_category_sp,
1260                      "(x=${var.x}, y=${var.y})",
1261                      ConstString("NSPoint"),
1262                      objc_flags);
1263     AddStringSummary(corefoundation_category_sp,
1264                      "location=${var.location}, length=${var.length}",
1265                      ConstString("NSRange"),
1266                      objc_flags);
1267     AddStringSummary(corefoundation_category_sp,
1268                      "${var.origin}, ${var.size}",
1269                      ConstString("NSRect"),
1270                      objc_flags);
1271     AddStringSummary(corefoundation_category_sp,
1272                      "(${var.origin}, ${var.size}), ...",
1273                      ConstString("NSRectArray"),
1274                      objc_flags);
1275     AddStringSummary(objc_category_sp,
1276                      "(width=${var.width}, height=${var.height})",
1277                      ConstString("NSSize"),
1278                      objc_flags);
1279 
1280     TypeCategoryImpl::SharedPointer coregraphics_category_sp = GetCategory(m_coregraphics_category_name);
1281 
1282     AddStringSummary(coregraphics_category_sp,
1283                      "(width=${var.width}, height=${var.height})",
1284                      ConstString("CGSize"),
1285                      objc_flags);
1286     AddStringSummary(coregraphics_category_sp,
1287                      "(x=${var.x}, y=${var.y})",
1288                      ConstString("CGPoint"),
1289                      objc_flags);
1290     AddStringSummary(coregraphics_category_sp,
1291                      "origin=${var.origin} size=${var.size}",
1292                      ConstString("CGRect"),
1293                      objc_flags);
1294 
1295     TypeCategoryImpl::SharedPointer coreservices_category_sp = GetCategory(m_coreservices_category_name);
1296 
1297     AddStringSummary(coreservices_category_sp,
1298                      "red=${var.red} green=${var.green} blue=${var.blue}",
1299                      ConstString("RGBColor"),
1300                      objc_flags);
1301     AddStringSummary(coreservices_category_sp,
1302                      "(t=${var.top}, l=${var.left}, b=${var.bottom}, r=${var.right})",
1303                      ConstString("Rect"),
1304                      objc_flags);
1305     AddStringSummary(coreservices_category_sp,
1306                      "(v=${var.v}, h=${var.h})",
1307                      ConstString("Point"),
1308                      objc_flags);
1309     AddStringSummary(coreservices_category_sp,
1310                      "${var.month}/${var.day}/${var.year}  ${var.hour} :${var.minute} :${var.second} dayOfWeek:${var.dayOfWeek}",
1311                      ConstString("DateTimeRect *"),
1312                      objc_flags);
1313     AddStringSummary(coreservices_category_sp,
1314                      "${var.ld.month}/${var.ld.day}/${var.ld.year} ${var.ld.hour} :${var.ld.minute} :${var.ld.second} dayOfWeek:${var.ld.dayOfWeek}",
1315                      ConstString("LongDateRect"),
1316                      objc_flags);
1317     AddStringSummary(coreservices_category_sp,
1318                      "(x=${var.x}, y=${var.y})",
1319                      ConstString("HIPoint"),
1320                      objc_flags);
1321     AddStringSummary(coreservices_category_sp,
1322                      "origin=${var.origin} size=${var.size}",
1323                      ConstString("HIRect"),
1324                      objc_flags);
1325 
1326     TypeCategoryImpl::SharedPointer appkit_category_sp = GetCategory(m_appkit_category_name);
1327 
1328     TypeSummaryImpl::Flags appkit_flags;
1329     appkit_flags.SetCascades(true)
1330     .SetSkipPointers(false)
1331     .SetSkipReferences(false)
1332     .SetDontShowChildren(true)
1333     .SetDontShowValue(false)
1334     .SetShowMembersOneLiner(false)
1335     .SetHideItemNames(false);
1336 
1337     appkit_flags.SetDontShowChildren(false);
1338 
1339 
1340 #ifndef LLDB_DISABLE_PYTHON
1341     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSArraySummaryProvider, "NSArray summary provider", ConstString("NSArray"), appkit_flags);
1342     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSArraySummaryProvider, "NSArray summary provider", ConstString("NSMutableArray"), appkit_flags);
1343     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSArraySummaryProvider, "NSArray summary provider", ConstString("__NSArrayI"), appkit_flags);
1344     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSArraySummaryProvider, "NSArray summary provider", ConstString("__NSArrayM"), appkit_flags);
1345     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSArraySummaryProvider, "NSArray summary provider", ConstString("__NSCFArray"), appkit_flags);
1346     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSArraySummaryProvider, "NSArray summary provider", ConstString("CFArrayRef"), appkit_flags);
1347     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSArraySummaryProvider, "NSArray summary provider", ConstString("CFMutableArrayRef"), appkit_flags);
1348 
1349     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSDictionarySummaryProvider<false>, "NSDictionary summary provider", ConstString("NSDictionary"), appkit_flags);
1350     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSDictionarySummaryProvider<false>, "NSDictionary summary provider", ConstString("NSMutableDictionary"), appkit_flags);
1351     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSDictionarySummaryProvider<false>, "NSDictionary summary provider", ConstString("__NSCFDictionary"), appkit_flags);
1352     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSDictionarySummaryProvider<false>, "NSDictionary summary provider", ConstString("__NSDictionaryI"), appkit_flags);
1353     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSDictionarySummaryProvider<false>, "NSDictionary summary provider", ConstString("__NSDictionaryM"), appkit_flags);
1354     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSDictionarySummaryProvider<true>, "NSDictionary summary provider", ConstString("CFDictionaryRef"), appkit_flags);
1355     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSDictionarySummaryProvider<true>, "NSDictionary summary provider", ConstString("CFMutableDictionaryRef"), appkit_flags);
1356 
1357     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSSetSummaryProvider<false>, "NSSet summary", ConstString("NSSet"), appkit_flags);
1358     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSSetSummaryProvider<false>, "NSMutableSet summary", ConstString("NSMutableSet"), appkit_flags);
1359     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSSetSummaryProvider<true>, "CFSetRef summary", ConstString("CFSetRef"), appkit_flags);
1360     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSSetSummaryProvider<true>, "CFMutableSetRef summary", ConstString("CFMutableSetRef"), appkit_flags);
1361     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSSetSummaryProvider<false>, "__NSCFSet summary", ConstString("__NSCFSet"), appkit_flags);
1362     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSSetSummaryProvider<false>, "__NSSetI summary", ConstString("__NSSetI"), appkit_flags);
1363     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSSetSummaryProvider<false>, "__NSSetM summary", ConstString("__NSSetM"), appkit_flags);
1364     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSSetSummaryProvider<false>, "NSCountedSet summary", ConstString("NSCountedSet"), appkit_flags);
1365     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSSetSummaryProvider<false>, "NSMutableSet summary", ConstString("NSMutableSet"), appkit_flags);
1366     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSSetSummaryProvider<false>, "NSOrderedSet summary", ConstString("NSOrderedSet"), appkit_flags);
1367     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSSetSummaryProvider<false>, "__NSOrderedSetI summary", ConstString("__NSOrderedSetI"), appkit_flags);
1368     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSSetSummaryProvider<false>, "__NSOrderedSetM summary", ConstString("__NSOrderedSetM"), appkit_flags);
1369 
1370     // AddSummary(appkit_category_sp, "${var.key%@} -> ${var.value%@}", ConstString("$_lldb_typegen_nspair"), appkit_flags);
1371 
1372     appkit_flags.SetDontShowChildren(true);
1373 
1374     AddCXXSynthetic(appkit_category_sp, lldb_private::formatters::NSArraySyntheticFrontEndCreator, "NSArray synthetic children", ConstString("__NSArrayM"), ScriptedSyntheticChildren::Flags());
1375     AddCXXSynthetic(appkit_category_sp, lldb_private::formatters::NSArraySyntheticFrontEndCreator, "NSArray synthetic children", ConstString("__NSArrayI"), ScriptedSyntheticChildren::Flags());
1376     AddCXXSynthetic(appkit_category_sp, lldb_private::formatters::NSArraySyntheticFrontEndCreator, "NSArray synthetic children", ConstString("NSArray"), ScriptedSyntheticChildren::Flags());
1377     AddCXXSynthetic(appkit_category_sp, lldb_private::formatters::NSArraySyntheticFrontEndCreator, "NSArray synthetic children", ConstString("NSMutableArray"), ScriptedSyntheticChildren::Flags());
1378     AddCXXSynthetic(corefoundation_category_sp, lldb_private::formatters::NSArraySyntheticFrontEndCreator, "NSArray synthetic children", ConstString("__NSCFArray"), ScriptedSyntheticChildren::Flags());
1379     AddCXXSynthetic(corefoundation_category_sp, lldb_private::formatters::NSArraySyntheticFrontEndCreator, "NSArray synthetic children", ConstString("CFMutableArrayRef"), ScriptedSyntheticChildren::Flags());
1380     AddCXXSynthetic(corefoundation_category_sp, lldb_private::formatters::NSArraySyntheticFrontEndCreator, "NSArray synthetic children", ConstString("CFArrayRef"), ScriptedSyntheticChildren::Flags());
1381 
1382     AddCXXSynthetic(appkit_category_sp, lldb_private::formatters::NSDictionarySyntheticFrontEndCreator, "NSDictionary synthetic children", ConstString("__NSDictionaryM"), ScriptedSyntheticChildren::Flags());
1383     AddCXXSynthetic(appkit_category_sp, lldb_private::formatters::NSDictionarySyntheticFrontEndCreator, "NSDictionary synthetic children", ConstString("__NSDictionaryI"), ScriptedSyntheticChildren::Flags());
1384     AddCXXSynthetic(appkit_category_sp, lldb_private::formatters::NSDictionarySyntheticFrontEndCreator, "NSDictionary synthetic children", ConstString("__NSCFDictionary"), ScriptedSyntheticChildren::Flags());
1385     AddCXXSynthetic(appkit_category_sp, lldb_private::formatters::NSDictionarySyntheticFrontEndCreator, "NSDictionary synthetic children", ConstString("NSDictionary"), ScriptedSyntheticChildren::Flags());
1386     AddCXXSynthetic(appkit_category_sp, lldb_private::formatters::NSDictionarySyntheticFrontEndCreator, "NSDictionary synthetic children", ConstString("NSMutableDictionary"), ScriptedSyntheticChildren::Flags());
1387     AddCXXSynthetic(corefoundation_category_sp, lldb_private::formatters::NSDictionarySyntheticFrontEndCreator, "NSDictionary synthetic children", ConstString("CFDictionaryRef"), ScriptedSyntheticChildren::Flags());
1388     AddCXXSynthetic(corefoundation_category_sp, lldb_private::formatters::NSDictionarySyntheticFrontEndCreator, "NSDictionary synthetic children", ConstString("CFMutableDictionaryRef"), ScriptedSyntheticChildren::Flags());
1389 
1390     AddCXXSynthetic(appkit_category_sp, lldb_private::formatters::NSSetSyntheticFrontEndCreator, "NSSet synthetic children", ConstString("NSSet"), ScriptedSyntheticChildren::Flags());
1391     AddCXXSynthetic(appkit_category_sp, lldb_private::formatters::NSSetSyntheticFrontEndCreator, "__NSSetI synthetic children", ConstString("__NSSetI"), ScriptedSyntheticChildren::Flags());
1392     AddCXXSynthetic(appkit_category_sp, lldb_private::formatters::NSSetSyntheticFrontEndCreator, "__NSSetM synthetic children", ConstString("__NSSetM"), ScriptedSyntheticChildren::Flags());
1393     AddCXXSynthetic(appkit_category_sp, lldb_private::formatters::NSSetSyntheticFrontEndCreator, "NSMutableSet synthetic children", ConstString("NSMutableSet"), ScriptedSyntheticChildren::Flags());
1394     AddCXXSynthetic(appkit_category_sp, lldb_private::formatters::NSSetSyntheticFrontEndCreator, "NSOrderedSet synthetic children", ConstString("NSOrderedSet"), ScriptedSyntheticChildren::Flags());
1395     AddCXXSynthetic(appkit_category_sp, lldb_private::formatters::NSSetSyntheticFrontEndCreator, "__NSOrderedSetI synthetic children", ConstString("__NSOrderedSetI"), ScriptedSyntheticChildren::Flags());
1396     AddCXXSynthetic(appkit_category_sp, lldb_private::formatters::NSSetSyntheticFrontEndCreator, "__NSOrderedSetM synthetic children", ConstString("__NSOrderedSetM"), ScriptedSyntheticChildren::Flags());
1397 
1398     AddCXXSummary(corefoundation_category_sp,lldb_private::formatters::CFBagSummaryProvider, "CFBag summary provider", ConstString("CFBagRef"), appkit_flags);
1399     AddCXXSummary(corefoundation_category_sp,lldb_private::formatters::CFBagSummaryProvider, "CFBag summary provider", ConstString("__CFBag"), appkit_flags);
1400     AddCXXSummary(corefoundation_category_sp,lldb_private::formatters::CFBagSummaryProvider, "CFBag summary provider", ConstString("const struct __CFBag"), appkit_flags);
1401     AddCXXSummary(corefoundation_category_sp,lldb_private::formatters::CFBagSummaryProvider, "CFBag summary provider", ConstString("CFMutableBagRef"), appkit_flags);
1402 
1403     AddCXXSummary(corefoundation_category_sp,lldb_private::formatters::CFBinaryHeapSummaryProvider, "CFBinaryHeap summary provider", ConstString("CFBinaryHeapRef"), appkit_flags);
1404     AddCXXSummary(corefoundation_category_sp,lldb_private::formatters::CFBinaryHeapSummaryProvider, "CFBinaryHeap summary provider", ConstString("__CFBinaryHeap"), appkit_flags);
1405 
1406     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSStringSummaryProvider, "NSString summary provider", ConstString("NSString"), appkit_flags);
1407     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSStringSummaryProvider, "NSString summary provider", ConstString("CFStringRef"), appkit_flags);
1408     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSStringSummaryProvider, "NSString summary provider", ConstString("__CFString"), appkit_flags);
1409     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSStringSummaryProvider, "NSString summary provider", ConstString("CFMutableStringRef"), appkit_flags);
1410     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSStringSummaryProvider, "NSString summary provider", ConstString("NSMutableString"), appkit_flags);
1411     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSStringSummaryProvider, "NSString summary provider", ConstString("__NSCFConstantString"), appkit_flags);
1412     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSStringSummaryProvider, "NSString summary provider", ConstString("__NSCFString"), appkit_flags);
1413     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSStringSummaryProvider, "NSString summary provider", ConstString("NSCFConstantString"), appkit_flags);
1414     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSStringSummaryProvider, "NSString summary provider", ConstString("NSCFString"), appkit_flags);
1415     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSStringSummaryProvider, "NSString summary provider", ConstString("NSPathStore2"), appkit_flags);
1416 
1417     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSAttributedStringSummaryProvider, "NSAttributedString summary provider", ConstString("NSAttributedString"), appkit_flags);
1418     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSMutableAttributedStringSummaryProvider, "NSMutableAttributedString summary provider", ConstString("NSMutableAttributedString"), appkit_flags);
1419     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSMutableAttributedStringSummaryProvider, "NSMutableAttributedString summary provider", ConstString("NSConcreteMutableAttributedString"), appkit_flags);
1420 
1421     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSBundleSummaryProvider, "NSBundle summary provider", ConstString("NSBundle"), appkit_flags);
1422 
1423     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSDataSummaryProvider<false>, "NSData summary provider", ConstString("NSData"), appkit_flags);
1424     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSDataSummaryProvider<false>, "NSData summary provider", ConstString("NSConcreteData"), appkit_flags);
1425     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSDataSummaryProvider<false>, "NSData summary provider", ConstString("NSConcreteMutableData"), appkit_flags);
1426     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSDataSummaryProvider<false>, "NSData summary provider", ConstString("NSMutableData"), appkit_flags);
1427     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSDataSummaryProvider<false>, "NSData summary provider", ConstString("__NSCFData"), appkit_flags);
1428     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSDataSummaryProvider<true>, "NSData summary provider", ConstString("CFDataRef"), appkit_flags);
1429     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSDataSummaryProvider<true>, "NSData summary provider", ConstString("CFMutableDataRef"), appkit_flags);
1430 
1431     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSMachPortSummaryProvider, "NSMachPort summary provider", ConstString("NSMachPort"), appkit_flags);
1432 
1433     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSNotificationSummaryProvider, "NSNotification summary provider", ConstString("NSNotification"), appkit_flags);
1434     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSNotificationSummaryProvider, "NSNotification summary provider", ConstString("NSConcreteNotification"), appkit_flags);
1435 
1436     AddStringSummary(appkit_category_sp, "domain: ${var._domain} - code: ${var._code}", ConstString("NSError"), appkit_flags);
1437     AddStringSummary(appkit_category_sp,"name:${var.name%S} reason:${var.reason%S}",ConstString("NSException"),appkit_flags);
1438 
1439     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSNumberSummaryProvider, "NSNumber summary provider", ConstString("NSNumber"), appkit_flags);
1440     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSNumberSummaryProvider, "CFNumberRef summary provider", ConstString("CFNumberRef"), appkit_flags);
1441     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSNumberSummaryProvider, "NSNumber summary provider", ConstString("__NSCFBoolean"), appkit_flags);
1442     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSNumberSummaryProvider, "NSNumber summary provider", ConstString("__NSCFNumber"), appkit_flags);
1443     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSNumberSummaryProvider, "NSNumber summary provider", ConstString("NSCFBoolean"), appkit_flags);
1444     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSNumberSummaryProvider, "NSNumber summary provider", ConstString("NSCFNumber"), appkit_flags);
1445 
1446     AddCXXSummary(appkit_category_sp, lldb_private::formatters::RuntimeSpecificDescriptionSummaryProvider, "NSDecimalNumber summary provider", ConstString("NSDecimalNumber"), appkit_flags);
1447     AddCXXSummary(appkit_category_sp, lldb_private::formatters::RuntimeSpecificDescriptionSummaryProvider, "NSHost summary provider", ConstString("NSHost"), appkit_flags);
1448     AddCXXSummary(appkit_category_sp, lldb_private::formatters::RuntimeSpecificDescriptionSummaryProvider, "NSTask summary provider", ConstString("NSTask"), appkit_flags);
1449     AddCXXSummary(appkit_category_sp, lldb_private::formatters::RuntimeSpecificDescriptionSummaryProvider, "NSValue summary provider", ConstString("NSValue"), appkit_flags);
1450 
1451     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSURLSummaryProvider, "NSURL summary provider", ConstString("NSURL"), appkit_flags);
1452     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSURLSummaryProvider, "NSURL summary provider", ConstString("CFURLRef"), appkit_flags);
1453 
1454     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSDateSummaryProvider, "NSDate summary provider", ConstString("NSDate"), appkit_flags);
1455     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSDateSummaryProvider, "NSDate summary provider", ConstString("__NSDate"), appkit_flags);
1456     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSDateSummaryProvider, "NSDate summary provider", ConstString("__NSTaggedDate"), appkit_flags);
1457     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSDateSummaryProvider, "NSDate summary provider", ConstString("NSCalendarDate"), appkit_flags);
1458 
1459     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSTimeZoneSummaryProvider, "NSTimeZone summary provider", ConstString("NSTimeZone"), appkit_flags);
1460     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::NSTimeZoneSummaryProvider, "NSTimeZone summary provider", ConstString("CFTimeZoneRef"), appkit_flags);
1461     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSTimeZoneSummaryProvider, "NSTimeZone summary provider", ConstString("__NSTimeZone"), appkit_flags);
1462 
1463     // CFAbsoluteTime is actually a double rather than a pointer to an object
1464     // we do not care about the numeric value, since it is probably meaningless to users
1465     appkit_flags.SetDontShowValue(true);
1466     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::CFAbsoluteTimeSummaryProvider, "CFAbsoluteTime summary provider", ConstString("CFAbsoluteTime"), appkit_flags);
1467     appkit_flags.SetDontShowValue(false);
1468 
1469     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSIndexSetSummaryProvider, "NSIndexSet summary provider", ConstString("NSIndexSet"), appkit_flags);
1470     AddCXXSummary(appkit_category_sp, lldb_private::formatters::NSIndexSetSummaryProvider, "NSIndexSet summary provider", ConstString("NSMutableIndexSet"), appkit_flags);
1471 
1472     AddStringSummary(corefoundation_category_sp,
1473                      "@\"${var.month%d}/${var.day%d}/${var.year%d} ${var.hour%d}:${var.minute%d}:${var.second}\"",
1474                      ConstString("CFGregorianDate"),
1475                      appkit_flags);
1476 
1477     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::CFBitVectorSummaryProvider, "CFBitVector summary provider", ConstString("CFBitVectorRef"), appkit_flags);
1478     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::CFBitVectorSummaryProvider, "CFBitVector summary provider", ConstString("CFMutableBitVectorRef"), appkit_flags);
1479     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::CFBitVectorSummaryProvider, "CFBitVector summary provider", ConstString("__CFBitVector"), appkit_flags);
1480     AddCXXSummary(corefoundation_category_sp, lldb_private::formatters::CFBitVectorSummaryProvider, "CFBitVector summary provider", ConstString("__CFMutableBitVector"), appkit_flags);
1481 #endif // LLDB_DISABLE_PYTHON
1482 
1483     TypeCategoryImpl::SharedPointer vectors_category_sp = GetCategory(m_vectortypes_category_name);
1484 
1485     TypeSummaryImpl::Flags vector_flags;
1486     vector_flags.SetCascades(true)
1487     .SetSkipPointers(true)
1488     .SetSkipReferences(false)
1489     .SetDontShowChildren(true)
1490     .SetDontShowValue(false)
1491     .SetShowMembersOneLiner(true)
1492     .SetHideItemNames(true);
1493 
1494     AddStringSummary(vectors_category_sp,
1495                      "${var.uint128}",
1496                      ConstString("builtin_type_vec128"),
1497                      objc_flags);
1498 
1499     AddStringSummary(vectors_category_sp,
1500                      "",
1501                      ConstString("float [4]"),
1502                      vector_flags);
1503     AddStringSummary(vectors_category_sp,
1504                      "",
1505                      ConstString("int32_t [4]"),
1506                      vector_flags);
1507     AddStringSummary(vectors_category_sp,
1508                      "",
1509                      ConstString("int16_t [8]"),
1510                      vector_flags);
1511     AddStringSummary(vectors_category_sp,
1512                      "",
1513                      ConstString("vDouble"),
1514                      vector_flags);
1515     AddStringSummary(vectors_category_sp,
1516                      "",
1517                      ConstString("vFloat"),
1518                      vector_flags);
1519     AddStringSummary(vectors_category_sp,
1520                      "",
1521                      ConstString("vSInt8"),
1522                      vector_flags);
1523     AddStringSummary(vectors_category_sp,
1524                      "",
1525                      ConstString("vSInt16"),
1526                      vector_flags);
1527     AddStringSummary(vectors_category_sp,
1528                      "",
1529                      ConstString("vSInt32"),
1530                      vector_flags);
1531     AddStringSummary(vectors_category_sp,
1532                      "",
1533                      ConstString("vUInt16"),
1534                      vector_flags);
1535     AddStringSummary(vectors_category_sp,
1536                      "",
1537                      ConstString("vUInt8"),
1538                      vector_flags);
1539     AddStringSummary(vectors_category_sp,
1540                      "",
1541                      ConstString("vUInt16"),
1542                      vector_flags);
1543     AddStringSummary(vectors_category_sp,
1544                      "",
1545                      ConstString("vUInt32"),
1546                      vector_flags);
1547     AddStringSummary(vectors_category_sp,
1548                      "",
1549                      ConstString("vBool32"),
1550                      vector_flags);
1551 }
1552 
1553 void
1554 FormatManager::LoadHardcodedFormatters()
1555 {
1556     {
1557         // insert code to load formats here
1558     }
1559     {
1560         // insert code to load summaries here
1561     }
1562     {
1563         // insert code to load synthetics here
1564     }
1565     {
1566         // insert code to load validators here
1567     }
1568 }
1569