xref: /llvm-project/lldb/source/Plugins/Language/CPlusPlus/CPlusPlusLanguage.cpp (revision e0d2733bf63f08989947f2a6a227d7301c6b11a3)
1 //===-- CPlusPlusLanguage.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 "CPlusPlusLanguage.h"
11 
12 // C Includes
13 #include <cctype>
14 #include <cstring>
15 
16 // C++ Includes
17 #include <functional>
18 #include <memory>
19 #include <mutex>
20 #include <set>
21 
22 // Other libraries and framework includes
23 #include "llvm/ADT/StringRef.h"
24 #include "llvm/Demangle/ItaniumDemangle.h"
25 
26 // Project includes
27 #include "lldb/Core/PluginManager.h"
28 #include "lldb/Core/UniqueCStringMap.h"
29 #include "lldb/DataFormatters/CXXFunctionPointer.h"
30 #include "lldb/DataFormatters/DataVisualization.h"
31 #include "lldb/DataFormatters/FormattersHelpers.h"
32 #include "lldb/DataFormatters/VectorType.h"
33 #include "lldb/Utility/ConstString.h"
34 #include "lldb/Utility/Log.h"
35 #include "lldb/Utility/RegularExpression.h"
36 
37 #include "BlockPointer.h"
38 #include "CPlusPlusNameParser.h"
39 #include "CxxStringTypes.h"
40 #include "LibCxx.h"
41 #include "LibCxxAtomic.h"
42 #include "LibCxxVariant.h"
43 #include "LibStdcpp.h"
44 #include "MSVCUndecoratedNameParser.h"
45 
46 using namespace lldb;
47 using namespace lldb_private;
48 using namespace lldb_private::formatters;
49 
50 void CPlusPlusLanguage::Initialize() {
51   PluginManager::RegisterPlugin(GetPluginNameStatic(), "C++ Language",
52                                 CreateInstance);
53 }
54 
55 void CPlusPlusLanguage::Terminate() {
56   PluginManager::UnregisterPlugin(CreateInstance);
57 }
58 
59 lldb_private::ConstString CPlusPlusLanguage::GetPluginNameStatic() {
60   static ConstString g_name("cplusplus");
61   return g_name;
62 }
63 
64 //------------------------------------------------------------------
65 // PluginInterface protocol
66 //------------------------------------------------------------------
67 
68 lldb_private::ConstString CPlusPlusLanguage::GetPluginName() {
69   return GetPluginNameStatic();
70 }
71 
72 uint32_t CPlusPlusLanguage::GetPluginVersion() { return 1; }
73 
74 //------------------------------------------------------------------
75 // Static Functions
76 //------------------------------------------------------------------
77 
78 Language *CPlusPlusLanguage::CreateInstance(lldb::LanguageType language) {
79   if (Language::LanguageIsCPlusPlus(language))
80     return new CPlusPlusLanguage();
81   return nullptr;
82 }
83 
84 void CPlusPlusLanguage::MethodName::Clear() {
85   m_full.Clear();
86   m_basename = llvm::StringRef();
87   m_context = llvm::StringRef();
88   m_arguments = llvm::StringRef();
89   m_qualifiers = llvm::StringRef();
90   m_parsed = false;
91   m_parse_error = false;
92 }
93 
94 static bool ReverseFindMatchingChars(const llvm::StringRef &s,
95                                      const llvm::StringRef &left_right_chars,
96                                      size_t &left_pos, size_t &right_pos,
97                                      size_t pos = llvm::StringRef::npos) {
98   assert(left_right_chars.size() == 2);
99   left_pos = llvm::StringRef::npos;
100   const char left_char = left_right_chars[0];
101   const char right_char = left_right_chars[1];
102   pos = s.find_last_of(left_right_chars, pos);
103   if (pos == llvm::StringRef::npos || s[pos] == left_char)
104     return false;
105   right_pos = pos;
106   uint32_t depth = 1;
107   while (pos > 0 && depth > 0) {
108     pos = s.find_last_of(left_right_chars, pos);
109     if (pos == llvm::StringRef::npos)
110       return false;
111     if (s[pos] == left_char) {
112       if (--depth == 0) {
113         left_pos = pos;
114         return left_pos < right_pos;
115       }
116     } else if (s[pos] == right_char) {
117       ++depth;
118     }
119   }
120   return false;
121 }
122 
123 static bool IsTrivialBasename(const llvm::StringRef &basename) {
124   // Check that the basename matches with the following regular expression
125   // "^~?([A-Za-z_][A-Za-z_0-9]*)$" We are using a hand written implementation
126   // because it is significantly more efficient then using the general purpose
127   // regular expression library.
128   size_t idx = 0;
129   if (basename.size() > 0 && basename[0] == '~')
130     idx = 1;
131 
132   if (basename.size() <= idx)
133     return false; // Empty string or "~"
134 
135   if (!std::isalpha(basename[idx]) && basename[idx] != '_')
136     return false; // First charater (after removing the possible '~'') isn't in
137                   // [A-Za-z_]
138 
139   // Read all characters matching [A-Za-z_0-9]
140   ++idx;
141   while (idx < basename.size()) {
142     if (!std::isalnum(basename[idx]) && basename[idx] != '_')
143       break;
144     ++idx;
145   }
146 
147   // We processed all characters. It is a vaild basename.
148   if (idx == basename.size())
149     return true;
150 
151   return false;
152 }
153 
154 bool CPlusPlusLanguage::MethodName::TrySimplifiedParse() {
155   // This method tries to parse simple method definitions which are presumably
156   // most comman in user programs. Definitions that can be parsed by this
157   // function don't have return types and templates in the name.
158   // A::B::C::fun(std::vector<T> &) const
159   size_t arg_start, arg_end;
160   llvm::StringRef full(m_full.GetCString());
161   llvm::StringRef parens("()", 2);
162   if (ReverseFindMatchingChars(full, parens, arg_start, arg_end)) {
163     m_arguments = full.substr(arg_start, arg_end - arg_start + 1);
164     if (arg_end + 1 < full.size())
165       m_qualifiers = full.substr(arg_end + 1).ltrim();
166 
167     if (arg_start == 0)
168       return false;
169     size_t basename_end = arg_start;
170     size_t context_start = 0;
171     size_t context_end = full.rfind(':', basename_end);
172     if (context_end == llvm::StringRef::npos)
173       m_basename = full.substr(0, basename_end);
174     else {
175       if (context_start < context_end)
176         m_context = full.substr(context_start, context_end - 1 - context_start);
177       const size_t basename_begin = context_end + 1;
178       m_basename = full.substr(basename_begin, basename_end - basename_begin);
179     }
180 
181     if (IsTrivialBasename(m_basename)) {
182       return true;
183     } else {
184       // The C++ basename doesn't match our regular expressions so this can't
185       // be a valid C++ method, clear everything out and indicate an error
186       m_context = llvm::StringRef();
187       m_basename = llvm::StringRef();
188       m_arguments = llvm::StringRef();
189       m_qualifiers = llvm::StringRef();
190       return false;
191     }
192   }
193   return false;
194 }
195 
196 void CPlusPlusLanguage::MethodName::Parse() {
197   if (!m_parsed && m_full) {
198     if (TrySimplifiedParse()) {
199       m_parse_error = false;
200     } else {
201       CPlusPlusNameParser parser(m_full.GetStringRef());
202       if (auto function = parser.ParseAsFunctionDefinition()) {
203         m_basename = function.getValue().name.basename;
204         m_context = function.getValue().name.context;
205         m_arguments = function.getValue().arguments;
206         m_qualifiers = function.getValue().qualifiers;
207         m_parse_error = false;
208       } else {
209         m_parse_error = true;
210       }
211     }
212     m_parsed = true;
213   }
214 }
215 
216 llvm::StringRef CPlusPlusLanguage::MethodName::GetBasename() {
217   if (!m_parsed)
218     Parse();
219   return m_basename;
220 }
221 
222 llvm::StringRef CPlusPlusLanguage::MethodName::GetContext() {
223   if (!m_parsed)
224     Parse();
225   return m_context;
226 }
227 
228 llvm::StringRef CPlusPlusLanguage::MethodName::GetArguments() {
229   if (!m_parsed)
230     Parse();
231   return m_arguments;
232 }
233 
234 llvm::StringRef CPlusPlusLanguage::MethodName::GetQualifiers() {
235   if (!m_parsed)
236     Parse();
237   return m_qualifiers;
238 }
239 
240 std::string CPlusPlusLanguage::MethodName::GetScopeQualifiedName() {
241   if (!m_parsed)
242     Parse();
243   if (m_context.empty())
244     return m_basename;
245 
246   std::string res;
247   res += m_context;
248   res += "::";
249   res += m_basename;
250   return res;
251 }
252 
253 bool CPlusPlusLanguage::IsCPPMangledName(const char *name) {
254   // FIXME!! we should really run through all the known C++ Language plugins
255   // and ask each one if this is a C++ mangled name
256 
257   if (name == nullptr)
258     return false;
259 
260   // MSVC style mangling
261   if (name[0] == '?')
262     return true;
263 
264   return (name[0] != '\0' && name[0] == '_' && name[1] == 'Z');
265 }
266 
267 bool CPlusPlusLanguage::ExtractContextAndIdentifier(
268     const char *name, llvm::StringRef &context, llvm::StringRef &identifier) {
269   if (MSVCUndecoratedNameParser::IsMSVCUndecoratedName(name))
270     return MSVCUndecoratedNameParser::ExtractContextAndIdentifier(name, context,
271                                                                   identifier);
272 
273   CPlusPlusNameParser parser(name);
274   if (auto full_name = parser.ParseAsFullName()) {
275     identifier = full_name.getValue().basename;
276     context = full_name.getValue().context;
277     return true;
278   }
279   return false;
280 }
281 
282 namespace {
283 class NodeAllocator {
284   llvm::BumpPtrAllocator Alloc;
285 
286 public:
287   void reset() { Alloc.Reset(); }
288 
289   template <typename T, typename... Args> T *makeNode(Args &&... args) {
290     return new (Alloc.Allocate(sizeof(T), alignof(T)))
291         T(std::forward<Args>(args)...);
292   }
293 
294   void *allocateNodeArray(size_t sz) {
295     return Alloc.Allocate(sizeof(llvm::itanium_demangle::Node *) * sz,
296                           alignof(llvm::itanium_demangle::Node *));
297   }
298 };
299 
300 /// Given a mangled function `Mangled`, replace all the primitive function type
301 /// arguments of `Search` with type `Replace`.
302 class TypeSubstitutor
303     : public llvm::itanium_demangle::AbstractManglingParser<TypeSubstitutor,
304                                                             NodeAllocator> {
305   /// Input character until which we have constructed the respective output
306   /// already
307   const char *Written;
308 
309   llvm::StringRef Search;
310   llvm::StringRef Replace;
311   llvm::SmallString<128> Result;
312 
313   /// Whether we have performed any substitutions.
314   bool Substituted;
315 
316   void reset(llvm::StringRef Mangled, llvm::StringRef Search,
317              llvm::StringRef Replace) {
318     AbstractManglingParser::reset(Mangled.begin(), Mangled.end());
319     Written = Mangled.begin();
320     this->Search = Search;
321     this->Replace = Replace;
322     Result.clear();
323     Substituted = false;
324   }
325 
326   void appendUnchangedInput() {
327     Result += llvm::StringRef(Written, First - Written);
328     Written = First;
329   }
330 
331 public:
332   TypeSubstitutor() : AbstractManglingParser(nullptr, nullptr) {}
333 
334   ConstString substitute(llvm::StringRef Mangled, llvm::StringRef From,
335                          llvm::StringRef To) {
336     Log *log = GetLogIfAllCategoriesSet(LIBLLDB_LOG_LANGUAGE);
337 
338     reset(Mangled, From, To);
339     if (parse() == nullptr) {
340       LLDB_LOG(log, "Failed to substitute mangling in {0}", Mangled);
341       return ConstString();
342     }
343     if (!Substituted)
344       return ConstString();
345 
346     // Append any trailing unmodified input.
347     appendUnchangedInput();
348     LLDB_LOG(log, "Substituted mangling {0} -> {1}", Mangled, Result);
349     return ConstString(Result);
350   }
351 
352   llvm::itanium_demangle::Node *parseType() {
353     if (llvm::StringRef(First, numLeft()).startswith(Search)) {
354       // We found a match. Append unmodified input up to this point.
355       appendUnchangedInput();
356 
357       // And then perform the replacement.
358       Result += Replace;
359       Written += Search.size();
360       Substituted = true;
361     }
362     return AbstractManglingParser::parseType();
363   }
364 };
365 }
366 
367 uint32_t CPlusPlusLanguage::FindAlternateFunctionManglings(
368     const ConstString mangled_name, std::set<ConstString> &alternates) {
369   const auto start_size = alternates.size();
370   /// Get a basic set of alternative manglings for the given symbol `name`, by
371   /// making a few basic possible substitutions on basic types, storage duration
372   /// and `const`ness for the given symbol. The output parameter `alternates`
373   /// is filled with a best-guess, non-exhaustive set of different manglings
374   /// for the given name.
375 
376   // Maybe we're looking for a const symbol but the debug info told us it was
377   // non-const...
378   if (!strncmp(mangled_name.GetCString(), "_ZN", 3) &&
379       strncmp(mangled_name.GetCString(), "_ZNK", 4)) {
380     std::string fixed_scratch("_ZNK");
381     fixed_scratch.append(mangled_name.GetCString() + 3);
382     alternates.insert(ConstString(fixed_scratch));
383   }
384 
385   // Maybe we're looking for a static symbol but we thought it was global...
386   if (!strncmp(mangled_name.GetCString(), "_Z", 2) &&
387       strncmp(mangled_name.GetCString(), "_ZL", 3)) {
388     std::string fixed_scratch("_ZL");
389     fixed_scratch.append(mangled_name.GetCString() + 2);
390     alternates.insert(ConstString(fixed_scratch));
391   }
392 
393   TypeSubstitutor TS;
394   // `char` is implementation defined as either `signed` or `unsigned`.  As a
395   // result a char parameter has 3 possible manglings: 'c'-char, 'a'-signed
396   // char, 'h'-unsigned char.  If we're looking for symbols with a signed char
397   // parameter, try finding matches which have the general case 'c'.
398   if (ConstString char_fixup =
399           TS.substitute(mangled_name.GetStringRef(), "a", "c"))
400     alternates.insert(char_fixup);
401 
402   // long long parameter mangling 'x', may actually just be a long 'l' argument
403   if (ConstString long_fixup =
404           TS.substitute(mangled_name.GetStringRef(), "x", "l"))
405     alternates.insert(long_fixup);
406 
407   // unsigned long long parameter mangling 'y', may actually just be unsigned
408   // long 'm' argument
409   if (ConstString ulong_fixup =
410           TS.substitute(mangled_name.GetStringRef(), "y", "m"))
411     alternates.insert(ulong_fixup);
412 
413   return alternates.size() - start_size;
414 }
415 
416 static void LoadLibCxxFormatters(lldb::TypeCategoryImplSP cpp_category_sp) {
417   if (!cpp_category_sp)
418     return;
419 
420   TypeSummaryImpl::Flags stl_summary_flags;
421   stl_summary_flags.SetCascades(true)
422       .SetSkipPointers(false)
423       .SetSkipReferences(false)
424       .SetDontShowChildren(true)
425       .SetDontShowValue(true)
426       .SetShowMembersOneLiner(false)
427       .SetHideItemNames(false);
428 
429 #ifndef LLDB_DISABLE_PYTHON
430   lldb::TypeSummaryImplSP std_string_summary_sp(new CXXFunctionSummaryFormat(
431       stl_summary_flags,
432       lldb_private::formatters::LibcxxStringSummaryProviderASCII,
433       "std::string summary provider"));
434   lldb::TypeSummaryImplSP std_stringu16_summary_sp(new CXXFunctionSummaryFormat(
435       stl_summary_flags,
436       lldb_private::formatters::LibcxxStringSummaryProviderUTF16,
437       "std::u16string summary provider"));
438   lldb::TypeSummaryImplSP std_stringu32_summary_sp(new CXXFunctionSummaryFormat(
439       stl_summary_flags,
440       lldb_private::formatters::LibcxxStringSummaryProviderUTF32,
441       "std::u32string summary provider"));
442   lldb::TypeSummaryImplSP std_wstring_summary_sp(new CXXFunctionSummaryFormat(
443       stl_summary_flags, lldb_private::formatters::LibcxxWStringSummaryProvider,
444       "std::wstring summary provider"));
445 
446   cpp_category_sp->GetTypeSummariesContainer()->Add(
447       ConstString("std::__1::string"), std_string_summary_sp);
448   cpp_category_sp->GetTypeSummariesContainer()->Add(
449       ConstString("std::__ndk1::string"), std_string_summary_sp);
450   cpp_category_sp->GetTypeSummariesContainer()->Add(
451       ConstString("std::__1::basic_string<char, std::__1::char_traits<char>, "
452                   "std::__1::allocator<char> >"),
453       std_string_summary_sp);
454   cpp_category_sp->GetTypeSummariesContainer()->Add(
455       ConstString(
456           "std::__1::basic_string<char16_t, std::__1::char_traits<char16_t>, "
457           "std::__1::allocator<char16_t> >"),
458       std_stringu16_summary_sp);
459   cpp_category_sp->GetTypeSummariesContainer()->Add(
460       ConstString(
461           "std::__1::basic_string<char32_t, std::__1::char_traits<char32_t>, "
462           "std::__1::allocator<char32_t> >"),
463       std_stringu32_summary_sp);
464   cpp_category_sp->GetTypeSummariesContainer()->Add(
465       ConstString("std::__ndk1::basic_string<char, "
466                   "std::__ndk1::char_traits<char>, "
467                   "std::__ndk1::allocator<char> >"),
468       std_string_summary_sp);
469 
470   cpp_category_sp->GetTypeSummariesContainer()->Add(
471       ConstString("std::__1::wstring"), std_wstring_summary_sp);
472   cpp_category_sp->GetTypeSummariesContainer()->Add(
473       ConstString("std::__ndk1::wstring"), std_wstring_summary_sp);
474   cpp_category_sp->GetTypeSummariesContainer()->Add(
475       ConstString("std::__1::basic_string<wchar_t, "
476                   "std::__1::char_traits<wchar_t>, "
477                   "std::__1::allocator<wchar_t> >"),
478       std_wstring_summary_sp);
479   cpp_category_sp->GetTypeSummariesContainer()->Add(
480       ConstString("std::__ndk1::basic_string<wchar_t, "
481                   "std::__ndk1::char_traits<wchar_t>, "
482                   "std::__ndk1::allocator<wchar_t> >"),
483       std_wstring_summary_sp);
484 
485   SyntheticChildren::Flags stl_synth_flags;
486   stl_synth_flags.SetCascades(true).SetSkipPointers(false).SetSkipReferences(
487       false);
488   SyntheticChildren::Flags stl_deref_flags = stl_synth_flags;
489   stl_deref_flags.SetFrontEndWantsDereference();
490 
491   AddCXXSynthetic(
492       cpp_category_sp,
493       lldb_private::formatters::LibcxxBitsetSyntheticFrontEndCreator,
494       "libc++ std::bitset synthetic children",
495       ConstString("^std::__(ndk)?1::bitset<.+>(( )?&)?$"), stl_deref_flags,
496       true);
497   AddCXXSynthetic(
498       cpp_category_sp,
499       lldb_private::formatters::LibcxxStdVectorSyntheticFrontEndCreator,
500       "libc++ std::vector synthetic children",
501       ConstString("^std::__(ndk)?1::vector<.+>(( )?&)?$"), stl_deref_flags,
502       true);
503   AddCXXSynthetic(
504       cpp_category_sp,
505       lldb_private::formatters::LibcxxStdForwardListSyntheticFrontEndCreator,
506       "libc++ std::forward_list synthetic children",
507       ConstString("^std::__(ndk)?1::forward_list<.+>(( )?&)?$"),
508       stl_synth_flags, true);
509   AddCXXSynthetic(
510       cpp_category_sp,
511       lldb_private::formatters::LibcxxStdListSyntheticFrontEndCreator,
512       "libc++ std::list synthetic children",
513       ConstString("^std::__(ndk)?1::list<.+>(( )?&)?$"), stl_synth_flags, true);
514   AddCXXSynthetic(
515       cpp_category_sp,
516       lldb_private::formatters::LibcxxStdMapSyntheticFrontEndCreator,
517       "libc++ std::map synthetic children",
518       ConstString("^std::__(ndk)?1::map<.+> >(( )?&)?$"), stl_synth_flags,
519       true);
520   AddCXXSynthetic(
521       cpp_category_sp,
522       lldb_private::formatters::LibcxxStdMapSyntheticFrontEndCreator,
523       "libc++ std::set synthetic children",
524       ConstString("^std::__(ndk)?1::set<.+> >(( )?&)?$"), stl_deref_flags,
525       true);
526   AddCXXSynthetic(
527       cpp_category_sp,
528       lldb_private::formatters::LibcxxStdMapSyntheticFrontEndCreator,
529       "libc++ std::multiset synthetic children",
530       ConstString("^std::__(ndk)?1::multiset<.+> >(( )?&)?$"), stl_deref_flags,
531       true);
532   AddCXXSynthetic(
533       cpp_category_sp,
534       lldb_private::formatters::LibcxxStdMapSyntheticFrontEndCreator,
535       "libc++ std::multimap synthetic children",
536       ConstString("^std::__(ndk)?1::multimap<.+> >(( )?&)?$"), stl_synth_flags,
537       true);
538   AddCXXSynthetic(
539       cpp_category_sp,
540       lldb_private::formatters::LibcxxStdUnorderedMapSyntheticFrontEndCreator,
541       "libc++ std::unordered containers synthetic children",
542       ConstString("^(std::__(ndk)?1::)unordered_(multi)?(map|set)<.+> >$"),
543       stl_synth_flags, true);
544   AddCXXSynthetic(
545       cpp_category_sp,
546       lldb_private::formatters::LibcxxInitializerListSyntheticFrontEndCreator,
547       "libc++ std::initializer_list synthetic children",
548       ConstString("^std::initializer_list<.+>(( )?&)?$"), stl_synth_flags,
549       true);
550   AddCXXSynthetic(cpp_category_sp, LibcxxQueueFrontEndCreator,
551                   "libc++ std::queue synthetic children",
552                   ConstString("^std::__(ndk)?1::queue<.+>(( )?&)?$"),
553                   stl_synth_flags, true);
554   AddCXXSynthetic(cpp_category_sp, LibcxxTupleFrontEndCreator,
555                   "libc++ std::tuple synthetic children",
556                   ConstString("^std::__(ndk)?1::tuple<.*>(( )?&)?$"), stl_synth_flags,
557                   true);
558   AddCXXSynthetic(cpp_category_sp, LibcxxOptionalFrontEndCreator,
559                   "libc++ std::optional synthetic children",
560                   ConstString("^std::__(ndk)?1::optional<.+>(( )?&)?$"),
561                   stl_synth_flags, true);
562   AddCXXSynthetic(cpp_category_sp, LibcxxVariantFrontEndCreator,
563                   "libc++ std::variant synthetic children",
564                   ConstString("^std::__(ndk)?1::variant<.+>(( )?&)?$"),
565                   stl_synth_flags, true);
566   AddCXXSynthetic(
567       cpp_category_sp,
568       lldb_private::formatters::LibcxxAtomicSyntheticFrontEndCreator,
569       "libc++ std::atomic synthetic children",
570       ConstString("^std::__(ndk)?1::atomic<.+>$"), stl_synth_flags, true);
571 
572   cpp_category_sp->GetRegexTypeSyntheticsContainer()->Add(
573       RegularExpressionSP(new RegularExpression(
574           llvm::StringRef("^(std::__(ndk)?1::)deque<.+>(( )?&)?$"))),
575       SyntheticChildrenSP(new ScriptedSyntheticChildren(
576           stl_synth_flags,
577           "lldb.formatters.cpp.libcxx.stddeque_SynthProvider")));
578 
579   AddCXXSynthetic(
580       cpp_category_sp,
581       lldb_private::formatters::LibcxxSharedPtrSyntheticFrontEndCreator,
582       "shared_ptr synthetic children",
583       ConstString("^(std::__(ndk)?1::)shared_ptr<.+>(( )?&)?$"),
584       stl_synth_flags, true);
585   AddCXXSynthetic(
586       cpp_category_sp,
587       lldb_private::formatters::LibcxxSharedPtrSyntheticFrontEndCreator,
588       "weak_ptr synthetic children",
589       ConstString("^(std::__(ndk)?1::)weak_ptr<.+>(( )?&)?$"), stl_synth_flags,
590       true);
591 
592   AddCXXSummary(
593       cpp_category_sp, lldb_private::formatters::LibcxxFunctionSummaryProvider,
594       "libc++ std::function summary provider",
595       ConstString("^std::__(ndk)?1::function<.+>$"), stl_summary_flags, true);
596 
597   stl_summary_flags.SetDontShowChildren(false);
598   stl_summary_flags.SetSkipPointers(false);
599   AddCXXSummary(cpp_category_sp,
600                 lldb_private::formatters::LibcxxContainerSummaryProvider,
601                 "libc++ std::bitset summary provider",
602                 ConstString("^std::__(ndk)?1::bitset<.+>(( )?&)?$"),
603                 stl_summary_flags, true);
604   AddCXXSummary(cpp_category_sp,
605                 lldb_private::formatters::LibcxxContainerSummaryProvider,
606                 "libc++ std::vector summary provider",
607                 ConstString("^std::__(ndk)?1::vector<.+>(( )?&)?$"),
608                 stl_summary_flags, true);
609   AddCXXSummary(cpp_category_sp,
610                 lldb_private::formatters::LibcxxContainerSummaryProvider,
611                 "libc++ std::list summary provider",
612                 ConstString("^std::__(ndk)?1::forward_list<.+>(( )?&)?$"),
613                 stl_summary_flags, true);
614   AddCXXSummary(cpp_category_sp,
615                 lldb_private::formatters::LibcxxContainerSummaryProvider,
616                 "libc++ std::list summary provider",
617                 ConstString("^std::__(ndk)?1::list<.+>(( )?&)?$"),
618                 stl_summary_flags, true);
619   AddCXXSummary(cpp_category_sp,
620                 lldb_private::formatters::LibcxxContainerSummaryProvider,
621                 "libc++ std::map summary provider",
622                 ConstString("^std::__(ndk)?1::map<.+>(( )?&)?$"),
623                 stl_summary_flags, true);
624   AddCXXSummary(cpp_category_sp,
625                 lldb_private::formatters::LibcxxContainerSummaryProvider,
626                 "libc++ std::deque summary provider",
627                 ConstString("^std::__(ndk)?1::deque<.+>(( )?&)?$"),
628                 stl_summary_flags, true);
629   AddCXXSummary(cpp_category_sp,
630                 lldb_private::formatters::LibcxxContainerSummaryProvider,
631                 "libc++ std::queue summary provider",
632                 ConstString("^std::__(ndk)?1::queue<.+>(( )?&)?$"),
633                 stl_summary_flags, true);
634   AddCXXSummary(cpp_category_sp,
635                 lldb_private::formatters::LibcxxContainerSummaryProvider,
636                 "libc++ std::set summary provider",
637                 ConstString("^std::__(ndk)?1::set<.+>(( )?&)?$"),
638                 stl_summary_flags, true);
639   AddCXXSummary(cpp_category_sp,
640                 lldb_private::formatters::LibcxxContainerSummaryProvider,
641                 "libc++ std::multiset summary provider",
642                 ConstString("^std::__(ndk)?1::multiset<.+>(( )?&)?$"),
643                 stl_summary_flags, true);
644   AddCXXSummary(cpp_category_sp,
645                 lldb_private::formatters::LibcxxContainerSummaryProvider,
646                 "libc++ std::multimap summary provider",
647                 ConstString("^std::__(ndk)?1::multimap<.+>(( )?&)?$"),
648                 stl_summary_flags, true);
649   AddCXXSummary(
650       cpp_category_sp, lldb_private::formatters::LibcxxContainerSummaryProvider,
651       "libc++ std::unordered containers summary provider",
652       ConstString("^(std::__(ndk)?1::)unordered_(multi)?(map|set)<.+> >$"),
653       stl_summary_flags, true);
654   AddCXXSummary(cpp_category_sp, LibcxxContainerSummaryProvider,
655                 "libc++ std::tuple summary provider",
656                 ConstString("^std::__(ndk)?1::tuple<.*>(( )?&)?$"), stl_summary_flags,
657                 true);
658   AddCXXSummary(
659       cpp_category_sp, lldb_private::formatters::LibCxxAtomicSummaryProvider,
660       "libc++ std::atomic summary provider",
661       ConstString("^std::__(ndk)?1::atomic<.+>$"), stl_summary_flags, true);
662   AddCXXSummary(cpp_category_sp,
663                 lldb_private::formatters::LibcxxOptionalSummaryProvider,
664                 "libc++ std::optional summary provider",
665                 ConstString("^std::__(ndk)?1::optional<.+>(( )?&)?$"),
666                 stl_summary_flags, true);
667   AddCXXSummary(cpp_category_sp,
668                 lldb_private::formatters::LibcxxVariantSummaryProvider,
669                 "libc++ std::variant summary provider",
670                 ConstString("^std::__(ndk)?1::variant<.+>(( )?&)?$"),
671                 stl_summary_flags, true);
672 
673   stl_summary_flags.SetSkipPointers(true);
674 
675   AddCXXSummary(cpp_category_sp,
676                 lldb_private::formatters::LibcxxSmartPointerSummaryProvider,
677                 "libc++ std::shared_ptr summary provider",
678                 ConstString("^std::__(ndk)?1::shared_ptr<.+>(( )?&)?$"),
679                 stl_summary_flags, true);
680   AddCXXSummary(cpp_category_sp,
681                 lldb_private::formatters::LibcxxSmartPointerSummaryProvider,
682                 "libc++ std::weak_ptr summary provider",
683                 ConstString("^std::__(ndk)?1::weak_ptr<.+>(( )?&)?$"),
684                 stl_summary_flags, true);
685 
686   AddCXXSynthetic(
687       cpp_category_sp,
688       lldb_private::formatters::LibCxxVectorIteratorSyntheticFrontEndCreator,
689       "std::vector iterator synthetic children",
690       ConstString("^std::__(ndk)?1::__wrap_iter<.+>$"), stl_synth_flags, true);
691 
692   AddCXXSynthetic(
693       cpp_category_sp,
694       lldb_private::formatters::LibCxxMapIteratorSyntheticFrontEndCreator,
695       "std::map iterator synthetic children",
696       ConstString("^std::__(ndk)?1::__map_iterator<.+>$"), stl_synth_flags,
697       true);
698 #endif
699 }
700 
701 static void LoadLibStdcppFormatters(lldb::TypeCategoryImplSP cpp_category_sp) {
702   if (!cpp_category_sp)
703     return;
704 
705   TypeSummaryImpl::Flags stl_summary_flags;
706   stl_summary_flags.SetCascades(true)
707       .SetSkipPointers(false)
708       .SetSkipReferences(false)
709       .SetDontShowChildren(true)
710       .SetDontShowValue(true)
711       .SetShowMembersOneLiner(false)
712       .SetHideItemNames(false);
713 
714   lldb::TypeSummaryImplSP std_string_summary_sp(
715       new StringSummaryFormat(stl_summary_flags, "${var._M_dataplus._M_p}"));
716 
717   lldb::TypeSummaryImplSP cxx11_string_summary_sp(new CXXFunctionSummaryFormat(
718       stl_summary_flags, LibStdcppStringSummaryProvider,
719       "libstdc++ c++11 std::string summary provider"));
720   lldb::TypeSummaryImplSP cxx11_wstring_summary_sp(new CXXFunctionSummaryFormat(
721       stl_summary_flags, LibStdcppWStringSummaryProvider,
722       "libstdc++ c++11 std::wstring summary provider"));
723 
724   cpp_category_sp->GetTypeSummariesContainer()->Add(ConstString("std::string"),
725                                                     std_string_summary_sp);
726   cpp_category_sp->GetTypeSummariesContainer()->Add(
727       ConstString("std::basic_string<char>"), std_string_summary_sp);
728   cpp_category_sp->GetTypeSummariesContainer()->Add(
729       ConstString("std::basic_string<char,std::char_traits<char>,std::"
730                   "allocator<char> >"),
731       std_string_summary_sp);
732   cpp_category_sp->GetTypeSummariesContainer()->Add(
733       ConstString("std::basic_string<char, std::char_traits<char>, "
734                   "std::allocator<char> >"),
735       std_string_summary_sp);
736 
737   cpp_category_sp->GetTypeSummariesContainer()->Add(
738       ConstString("std::__cxx11::string"), cxx11_string_summary_sp);
739   cpp_category_sp->GetTypeSummariesContainer()->Add(
740       ConstString("std::__cxx11::basic_string<char, std::char_traits<char>, "
741                   "std::allocator<char> >"),
742       cxx11_string_summary_sp);
743 
744   // making sure we force-pick the summary for printing wstring (_M_p is a
745   // wchar_t*)
746   lldb::TypeSummaryImplSP std_wstring_summary_sp(
747       new StringSummaryFormat(stl_summary_flags, "${var._M_dataplus._M_p%S}"));
748 
749   cpp_category_sp->GetTypeSummariesContainer()->Add(ConstString("std::wstring"),
750                                                     std_wstring_summary_sp);
751   cpp_category_sp->GetTypeSummariesContainer()->Add(
752       ConstString("std::basic_string<wchar_t>"), std_wstring_summary_sp);
753   cpp_category_sp->GetTypeSummariesContainer()->Add(
754       ConstString("std::basic_string<wchar_t,std::char_traits<wchar_t>,std::"
755                   "allocator<wchar_t> >"),
756       std_wstring_summary_sp);
757   cpp_category_sp->GetTypeSummariesContainer()->Add(
758       ConstString("std::basic_string<wchar_t, std::char_traits<wchar_t>, "
759                   "std::allocator<wchar_t> >"),
760       std_wstring_summary_sp);
761 
762   cpp_category_sp->GetTypeSummariesContainer()->Add(
763       ConstString("std::__cxx11::wstring"), cxx11_wstring_summary_sp);
764   cpp_category_sp->GetTypeSummariesContainer()->Add(
765       ConstString("std::__cxx11::basic_string<wchar_t, "
766                   "std::char_traits<wchar_t>, std::allocator<wchar_t> >"),
767       cxx11_wstring_summary_sp);
768 
769 #ifndef LLDB_DISABLE_PYTHON
770 
771   SyntheticChildren::Flags stl_synth_flags;
772   stl_synth_flags.SetCascades(true).SetSkipPointers(false).SetSkipReferences(
773       false);
774 
775   cpp_category_sp->GetRegexTypeSyntheticsContainer()->Add(
776       RegularExpressionSP(
777           new RegularExpression(llvm::StringRef("^std::vector<.+>(( )?&)?$"))),
778       SyntheticChildrenSP(new ScriptedSyntheticChildren(
779           stl_synth_flags,
780           "lldb.formatters.cpp.gnu_libstdcpp.StdVectorSynthProvider")));
781   cpp_category_sp->GetRegexTypeSyntheticsContainer()->Add(
782       RegularExpressionSP(
783           new RegularExpression(llvm::StringRef("^std::map<.+> >(( )?&)?$"))),
784       SyntheticChildrenSP(new ScriptedSyntheticChildren(
785           stl_synth_flags,
786           "lldb.formatters.cpp.gnu_libstdcpp.StdMapSynthProvider")));
787   cpp_category_sp->GetRegexTypeSyntheticsContainer()->Add(
788       RegularExpressionSP(new RegularExpression(
789           llvm::StringRef("^std::(__cxx11::)?list<.+>(( )?&)?$"))),
790       SyntheticChildrenSP(new ScriptedSyntheticChildren(
791           stl_synth_flags,
792           "lldb.formatters.cpp.gnu_libstdcpp.StdListSynthProvider")));
793   stl_summary_flags.SetDontShowChildren(false);
794   stl_summary_flags.SetSkipPointers(true);
795   cpp_category_sp->GetRegexTypeSummariesContainer()->Add(
796       RegularExpressionSP(
797           new RegularExpression(llvm::StringRef("^std::vector<.+>(( )?&)?$"))),
798       TypeSummaryImplSP(
799           new StringSummaryFormat(stl_summary_flags, "size=${svar%#}")));
800   cpp_category_sp->GetRegexTypeSummariesContainer()->Add(
801       RegularExpressionSP(
802           new RegularExpression(llvm::StringRef("^std::map<.+> >(( )?&)?$"))),
803       TypeSummaryImplSP(
804           new StringSummaryFormat(stl_summary_flags, "size=${svar%#}")));
805   cpp_category_sp->GetRegexTypeSummariesContainer()->Add(
806       RegularExpressionSP(new RegularExpression(
807           llvm::StringRef("^std::(__cxx11::)?list<.+>(( )?&)?$"))),
808       TypeSummaryImplSP(
809           new StringSummaryFormat(stl_summary_flags, "size=${svar%#}")));
810 
811   AddCXXSynthetic(
812       cpp_category_sp,
813       lldb_private::formatters::LibStdcppVectorIteratorSyntheticFrontEndCreator,
814       "std::vector iterator synthetic children",
815       ConstString("^__gnu_cxx::__normal_iterator<.+>$"), stl_synth_flags, true);
816 
817   AddCXXSynthetic(
818       cpp_category_sp,
819       lldb_private::formatters::LibstdcppMapIteratorSyntheticFrontEndCreator,
820       "std::map iterator synthetic children",
821       ConstString("^std::_Rb_tree_iterator<.+>$"), stl_synth_flags, true);
822 
823   AddCXXSynthetic(
824       cpp_category_sp,
825       lldb_private::formatters::LibStdcppUniquePtrSyntheticFrontEndCreator,
826       "std::unique_ptr synthetic children",
827       ConstString("^std::unique_ptr<.+>(( )?&)?$"), stl_synth_flags, true);
828   AddCXXSynthetic(
829       cpp_category_sp,
830       lldb_private::formatters::LibStdcppSharedPtrSyntheticFrontEndCreator,
831       "std::shared_ptr synthetic children",
832       ConstString("^std::shared_ptr<.+>(( )?&)?$"), stl_synth_flags, true);
833   AddCXXSynthetic(
834       cpp_category_sp,
835       lldb_private::formatters::LibStdcppSharedPtrSyntheticFrontEndCreator,
836       "std::weak_ptr synthetic children",
837       ConstString("^std::weak_ptr<.+>(( )?&)?$"), stl_synth_flags, true);
838   AddCXXSynthetic(
839       cpp_category_sp,
840       lldb_private::formatters::LibStdcppTupleSyntheticFrontEndCreator,
841       "std::tuple synthetic children", ConstString("^std::tuple<.+>(( )?&)?$"),
842       stl_synth_flags, true);
843 
844   AddCXXSummary(cpp_category_sp,
845                 lldb_private::formatters::LibStdcppUniquePointerSummaryProvider,
846                 "libstdc++ std::unique_ptr summary provider",
847                 ConstString("^std::unique_ptr<.+>(( )?&)?$"), stl_summary_flags,
848                 true);
849   AddCXXSummary(cpp_category_sp,
850                 lldb_private::formatters::LibStdcppSmartPointerSummaryProvider,
851                 "libstdc++ std::shared_ptr summary provider",
852                 ConstString("^std::shared_ptr<.+>(( )?&)?$"), stl_summary_flags,
853                 true);
854   AddCXXSummary(cpp_category_sp,
855                 lldb_private::formatters::LibStdcppSmartPointerSummaryProvider,
856                 "libstdc++ std::weak_ptr summary provider",
857                 ConstString("^std::weak_ptr<.+>(( )?&)?$"), stl_summary_flags,
858                 true);
859 #endif
860 }
861 
862 static void LoadSystemFormatters(lldb::TypeCategoryImplSP cpp_category_sp) {
863   if (!cpp_category_sp)
864     return;
865 
866   TypeSummaryImpl::Flags string_flags;
867   string_flags.SetCascades(true)
868       .SetSkipPointers(true)
869       .SetSkipReferences(false)
870       .SetDontShowChildren(true)
871       .SetDontShowValue(false)
872       .SetShowMembersOneLiner(false)
873       .SetHideItemNames(false);
874 
875   TypeSummaryImpl::Flags string_array_flags;
876   string_array_flags.SetCascades(true)
877       .SetSkipPointers(true)
878       .SetSkipReferences(false)
879       .SetDontShowChildren(true)
880       .SetDontShowValue(true)
881       .SetShowMembersOneLiner(false)
882       .SetHideItemNames(false);
883 
884 #ifndef LLDB_DISABLE_PYTHON
885   // FIXME because of a bug in the FormattersContainer we need to add a summary
886   // for both X* and const X* (<rdar://problem/12717717>)
887   AddCXXSummary(
888       cpp_category_sp, lldb_private::formatters::Char16StringSummaryProvider,
889       "char16_t * summary provider", ConstString("char16_t *"), string_flags);
890   AddCXXSummary(cpp_category_sp,
891                 lldb_private::formatters::Char16StringSummaryProvider,
892                 "char16_t [] summary provider",
893                 ConstString("char16_t \\[[0-9]+\\]"), string_array_flags, true);
894 
895   AddCXXSummary(
896       cpp_category_sp, lldb_private::formatters::Char32StringSummaryProvider,
897       "char32_t * summary provider", ConstString("char32_t *"), string_flags);
898   AddCXXSummary(cpp_category_sp,
899                 lldb_private::formatters::Char32StringSummaryProvider,
900                 "char32_t [] summary provider",
901                 ConstString("char32_t \\[[0-9]+\\]"), string_array_flags, true);
902 
903   AddCXXSummary(
904       cpp_category_sp, lldb_private::formatters::WCharStringSummaryProvider,
905       "wchar_t * summary provider", ConstString("wchar_t *"), string_flags);
906   AddCXXSummary(cpp_category_sp,
907                 lldb_private::formatters::WCharStringSummaryProvider,
908                 "wchar_t * summary provider",
909                 ConstString("wchar_t \\[[0-9]+\\]"), string_array_flags, true);
910 
911   AddCXXSummary(
912       cpp_category_sp, lldb_private::formatters::Char16StringSummaryProvider,
913       "unichar * summary provider", ConstString("unichar *"), string_flags);
914 
915   TypeSummaryImpl::Flags widechar_flags;
916   widechar_flags.SetDontShowValue(true)
917       .SetSkipPointers(true)
918       .SetSkipReferences(false)
919       .SetCascades(true)
920       .SetDontShowChildren(true)
921       .SetHideItemNames(true)
922       .SetShowMembersOneLiner(false);
923 
924   AddCXXSummary(
925       cpp_category_sp, lldb_private::formatters::Char16SummaryProvider,
926       "char16_t summary provider", ConstString("char16_t"), widechar_flags);
927   AddCXXSummary(
928       cpp_category_sp, lldb_private::formatters::Char32SummaryProvider,
929       "char32_t summary provider", ConstString("char32_t"), widechar_flags);
930   AddCXXSummary(cpp_category_sp, lldb_private::formatters::WCharSummaryProvider,
931                 "wchar_t summary provider", ConstString("wchar_t"),
932                 widechar_flags);
933 
934   AddCXXSummary(
935       cpp_category_sp, lldb_private::formatters::Char16SummaryProvider,
936       "unichar summary provider", ConstString("unichar"), widechar_flags);
937 #endif
938 }
939 
940 std::unique_ptr<Language::TypeScavenger> CPlusPlusLanguage::GetTypeScavenger() {
941   class CPlusPlusTypeScavenger : public Language::ImageListTypeScavenger {
942   public:
943     virtual CompilerType AdjustForInclusion(CompilerType &candidate) override {
944       LanguageType lang_type(candidate.GetMinimumLanguage());
945       if (!Language::LanguageIsC(lang_type) &&
946           !Language::LanguageIsCPlusPlus(lang_type))
947         return CompilerType();
948       if (candidate.IsTypedefType())
949         return candidate.GetTypedefedType();
950       return candidate;
951     }
952   };
953 
954   return std::unique_ptr<TypeScavenger>(new CPlusPlusTypeScavenger());
955 }
956 
957 lldb::TypeCategoryImplSP CPlusPlusLanguage::GetFormatters() {
958   static llvm::once_flag g_initialize;
959   static TypeCategoryImplSP g_category;
960 
961   llvm::call_once(g_initialize, [this]() -> void {
962     DataVisualization::Categories::GetCategory(GetPluginName(), g_category);
963     if (g_category) {
964       LoadLibCxxFormatters(g_category);
965       LoadLibStdcppFormatters(g_category);
966       LoadSystemFormatters(g_category);
967     }
968   });
969   return g_category;
970 }
971 
972 HardcodedFormatters::HardcodedSummaryFinder
973 CPlusPlusLanguage::GetHardcodedSummaries() {
974   static llvm::once_flag g_initialize;
975   static ConstString g_vectortypes("VectorTypes");
976   static HardcodedFormatters::HardcodedSummaryFinder g_formatters;
977 
978   llvm::call_once(g_initialize, []() -> void {
979     g_formatters.push_back(
980         [](lldb_private::ValueObject &valobj, lldb::DynamicValueType,
981            FormatManager &) -> TypeSummaryImpl::SharedPointer {
982           static CXXFunctionSummaryFormat::SharedPointer formatter_sp(
983               new CXXFunctionSummaryFormat(
984                   TypeSummaryImpl::Flags(),
985                   lldb_private::formatters::CXXFunctionPointerSummaryProvider,
986                   "Function pointer summary provider"));
987           if (valobj.GetCompilerType().IsFunctionPointerType()) {
988             return formatter_sp;
989           }
990           return nullptr;
991         });
992     g_formatters.push_back(
993         [](lldb_private::ValueObject &valobj, lldb::DynamicValueType,
994            FormatManager &fmt_mgr) -> TypeSummaryImpl::SharedPointer {
995           static CXXFunctionSummaryFormat::SharedPointer formatter_sp(
996               new CXXFunctionSummaryFormat(
997                   TypeSummaryImpl::Flags()
998                       .SetCascades(true)
999                       .SetDontShowChildren(true)
1000                       .SetHideItemNames(true)
1001                       .SetShowMembersOneLiner(true)
1002                       .SetSkipPointers(true)
1003                       .SetSkipReferences(false),
1004                   lldb_private::formatters::VectorTypeSummaryProvider,
1005                   "vector_type pointer summary provider"));
1006           if (valobj.GetCompilerType().IsVectorType(nullptr, nullptr)) {
1007             if (fmt_mgr.GetCategory(g_vectortypes)->IsEnabled())
1008               return formatter_sp;
1009           }
1010           return nullptr;
1011         });
1012     g_formatters.push_back(
1013         [](lldb_private::ValueObject &valobj, lldb::DynamicValueType,
1014            FormatManager &fmt_mgr) -> TypeSummaryImpl::SharedPointer {
1015           static CXXFunctionSummaryFormat::SharedPointer formatter_sp(
1016               new CXXFunctionSummaryFormat(
1017                   TypeSummaryImpl::Flags()
1018                       .SetCascades(true)
1019                       .SetDontShowChildren(true)
1020                       .SetHideItemNames(true)
1021                       .SetShowMembersOneLiner(true)
1022                       .SetSkipPointers(true)
1023                       .SetSkipReferences(false),
1024                   lldb_private::formatters::BlockPointerSummaryProvider,
1025                   "block pointer summary provider"));
1026           if (valobj.GetCompilerType().IsBlockPointerType(nullptr)) {
1027             return formatter_sp;
1028           }
1029           return nullptr;
1030         });
1031   });
1032 
1033   return g_formatters;
1034 }
1035 
1036 HardcodedFormatters::HardcodedSyntheticFinder
1037 CPlusPlusLanguage::GetHardcodedSynthetics() {
1038   static llvm::once_flag g_initialize;
1039   static ConstString g_vectortypes("VectorTypes");
1040   static HardcodedFormatters::HardcodedSyntheticFinder g_formatters;
1041 
1042   llvm::call_once(g_initialize, []() -> void {
1043     g_formatters.push_back([](lldb_private::ValueObject &valobj,
1044                               lldb::DynamicValueType,
1045                               FormatManager &
1046                                   fmt_mgr) -> SyntheticChildren::SharedPointer {
1047       static CXXSyntheticChildren::SharedPointer formatter_sp(
1048           new CXXSyntheticChildren(
1049               SyntheticChildren::Flags()
1050                   .SetCascades(true)
1051                   .SetSkipPointers(true)
1052                   .SetSkipReferences(true)
1053                   .SetNonCacheable(true),
1054               "vector_type synthetic children",
1055               lldb_private::formatters::VectorTypeSyntheticFrontEndCreator));
1056       if (valobj.GetCompilerType().IsVectorType(nullptr, nullptr)) {
1057         if (fmt_mgr.GetCategory(g_vectortypes)->IsEnabled())
1058           return formatter_sp;
1059       }
1060       return nullptr;
1061     });
1062     g_formatters.push_back([](lldb_private::ValueObject &valobj,
1063                               lldb::DynamicValueType,
1064                               FormatManager &
1065                                   fmt_mgr) -> SyntheticChildren::SharedPointer {
1066       static CXXSyntheticChildren::SharedPointer formatter_sp(
1067           new CXXSyntheticChildren(
1068               SyntheticChildren::Flags()
1069                   .SetCascades(true)
1070                   .SetSkipPointers(true)
1071                   .SetSkipReferences(true)
1072                   .SetNonCacheable(true),
1073               "block pointer synthetic children",
1074               lldb_private::formatters::BlockPointerSyntheticFrontEndCreator));
1075       if (valobj.GetCompilerType().IsBlockPointerType(nullptr)) {
1076         return formatter_sp;
1077       }
1078       return nullptr;
1079     });
1080 
1081   });
1082 
1083   return g_formatters;
1084 }
1085 
1086 bool CPlusPlusLanguage::IsSourceFile(llvm::StringRef file_path) const {
1087   const auto suffixes = {".cpp", ".cxx", ".c++", ".cc",  ".c",
1088                          ".h",   ".hh",  ".hpp", ".hxx", ".h++"};
1089   for (auto suffix : suffixes) {
1090     if (file_path.endswith_lower(suffix))
1091       return true;
1092   }
1093 
1094   // Check if we're in a STL path (where the files usually have no extension
1095   // that we could check for.
1096   return file_path.contains("/usr/include/c++/");
1097 }
1098