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