1 //===-- ObjCLanguage.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 // C Includes
11 // C++ Includes
12 #include <mutex>
13 
14 // Other libraries and framework includes
15 // Project includes
16 #include "ObjCLanguage.h"
17 
18 #include "lldb/Core/ConstString.h"
19 #include "lldb/Core/PluginManager.h"
20 #include "lldb/Core/StreamString.h"
21 #include "lldb/Core/ValueObject.h"
22 #include "lldb/DataFormatters/DataVisualization.h"
23 #include "lldb/DataFormatters/FormattersHelpers.h"
24 #include "lldb/Symbol/CompilerType.h"
25 #include "lldb/Target/Target.h"
26 #include "lldb/Target/ObjCLanguageRuntime.h"
27 #include "lldb/Symbol/ClangASTContext.h"
28 
29 #include "CF.h"
30 #include "Cocoa.h"
31 #include "CoreMedia.h"
32 #include "NSDictionary.h"
33 #include "NSSet.h"
34 #include "NSString.h"
35 
36 using namespace lldb;
37 using namespace lldb_private;
38 using namespace lldb_private::formatters;
39 
40 void
41 ObjCLanguage::Initialize()
42 {
43     PluginManager::RegisterPlugin (GetPluginNameStatic(),
44                                    "Objective-C Language",
45                                    CreateInstance);
46 }
47 
48 void
49 ObjCLanguage::Terminate()
50 {
51     PluginManager::UnregisterPlugin (CreateInstance);
52 }
53 
54 lldb_private::ConstString
55 ObjCLanguage::GetPluginNameStatic()
56 {
57     static ConstString g_name("objc");
58     return g_name;
59 }
60 
61 //------------------------------------------------------------------
62 // PluginInterface protocol
63 //------------------------------------------------------------------
64 
65 lldb_private::ConstString
66 ObjCLanguage::GetPluginName()
67 {
68     return GetPluginNameStatic();
69 }
70 
71 uint32_t
72 ObjCLanguage::GetPluginVersion()
73 {
74     return 1;
75 }
76 
77 //------------------------------------------------------------------
78 // Static Functions
79 //------------------------------------------------------------------
80 
81 Language *
82 ObjCLanguage::CreateInstance (lldb::LanguageType language)
83 {
84     switch (language)
85     {
86         case lldb::eLanguageTypeObjC:
87             return new ObjCLanguage();
88         default:
89             return nullptr;
90     }
91 }
92 
93 void
94 ObjCLanguage::MethodName::Clear()
95 {
96     m_full.Clear();
97     m_class.Clear();
98     m_category.Clear();
99     m_selector.Clear();
100     m_type = eTypeUnspecified;
101     m_category_is_valid = false;
102 }
103 
104 bool
105 ObjCLanguage::MethodName::SetName (const char *name, bool strict)
106 {
107     Clear();
108     if (name && name[0])
109     {
110         // If "strict" is true. then the method must be specified with a
111         // '+' or '-' at the beginning. If "strict" is false, then the '+'
112         // or '-' can be omitted
113         bool valid_prefix = false;
114 
115         if (name[0] == '+' || name[0] == '-')
116         {
117             valid_prefix = name[1] == '[';
118             if (name[0] == '+')
119                 m_type = eTypeClassMethod;
120             else
121                 m_type = eTypeInstanceMethod;
122         }
123         else if (!strict)
124         {
125             // "strict" is false, the name just needs to start with '['
126             valid_prefix = name[0] == '[';
127         }
128 
129         if (valid_prefix)
130         {
131             int name_len = strlen (name);
132             // Objective C methods must have at least:
133             //      "-[" or "+[" prefix
134             //      One character for a class name
135             //      One character for the space between the class name
136             //      One character for the method name
137             //      "]" suffix
138             if (name_len >= (5 + (strict ? 1 : 0)) && name[name_len - 1] == ']')
139             {
140                 m_full.SetCStringWithLength(name, name_len);
141             }
142         }
143     }
144     return IsValid(strict);
145 }
146 
147 const ConstString &
148 ObjCLanguage::MethodName::GetClassName ()
149 {
150     if (!m_class)
151     {
152         if (IsValid(false))
153         {
154             const char *full = m_full.GetCString();
155             const char *class_start = (full[0] == '[' ? full + 1 : full + 2);
156             const char *paren_pos = strchr (class_start, '(');
157             if (paren_pos)
158             {
159                 m_class.SetCStringWithLength (class_start, paren_pos - class_start);
160             }
161             else
162             {
163                 // No '(' was found in the full name, we can definitively say
164                 // that our category was valid (and empty).
165                 m_category_is_valid = true;
166                 const char *space_pos = strchr (full, ' ');
167                 if (space_pos)
168                 {
169                     m_class.SetCStringWithLength (class_start, space_pos - class_start);
170                     if (!m_class_category)
171                     {
172                         // No category in name, so we can also fill in the m_class_category
173                         m_class_category = m_class;
174                     }
175                 }
176             }
177         }
178     }
179     return m_class;
180 }
181 
182 const ConstString &
183 ObjCLanguage::MethodName::GetClassNameWithCategory ()
184 {
185     if (!m_class_category)
186     {
187         if (IsValid(false))
188         {
189             const char *full = m_full.GetCString();
190             const char *class_start = (full[0] == '[' ? full + 1 : full + 2);
191             const char *space_pos = strchr (full, ' ');
192             if (space_pos)
193             {
194                 m_class_category.SetCStringWithLength (class_start, space_pos - class_start);
195                 // If m_class hasn't been filled in and the class with category doesn't
196                 // contain a '(', then we can also fill in the m_class
197                 if (!m_class && strchr(m_class_category.GetCString(), '(') == nullptr)
198                 {
199                     m_class = m_class_category;
200                     // No '(' was found in the full name, we can definitively say
201                     // that our category was valid (and empty).
202                     m_category_is_valid = true;
203 
204                 }
205             }
206         }
207     }
208     return m_class_category;
209 }
210 
211 const ConstString &
212 ObjCLanguage::MethodName::GetSelector ()
213 {
214     if (!m_selector)
215     {
216         if (IsValid(false))
217         {
218             const char *full = m_full.GetCString();
219             const char *space_pos = strchr (full, ' ');
220             if (space_pos)
221             {
222                 ++space_pos; // skip the space
223                 m_selector.SetCStringWithLength (space_pos, m_full.GetLength() - (space_pos - full) - 1);
224             }
225         }
226     }
227     return m_selector;
228 }
229 
230 const ConstString &
231 ObjCLanguage::MethodName::GetCategory ()
232 {
233     if (!m_category_is_valid && !m_category)
234     {
235         if (IsValid(false))
236         {
237             m_category_is_valid = true;
238             const char *full = m_full.GetCString();
239             const char *class_start = (full[0] == '[' ? full + 1 : full + 2);
240             const char *open_paren_pos = strchr (class_start, '(');
241             if (open_paren_pos)
242             {
243                 ++open_paren_pos; // Skip the open paren
244                 const char *close_paren_pos = strchr (open_paren_pos, ')');
245                 if (close_paren_pos)
246                     m_category.SetCStringWithLength (open_paren_pos, close_paren_pos - open_paren_pos);
247             }
248         }
249     }
250     return m_category;
251 }
252 
253 ConstString
254 ObjCLanguage::MethodName::GetFullNameWithoutCategory (bool empty_if_no_category)
255 {
256     if (IsValid(false))
257     {
258         if (HasCategory())
259         {
260             StreamString strm;
261             if (m_type == eTypeClassMethod)
262                 strm.PutChar('+');
263             else if (m_type == eTypeInstanceMethod)
264                 strm.PutChar('-');
265             strm.Printf("[%s %s]", GetClassName().GetCString(), GetSelector().GetCString());
266             return ConstString(strm.GetString().c_str());
267         }
268 
269         if (!empty_if_no_category)
270         {
271             // Just return the full name since it doesn't have a category
272             return GetFullName();
273         }
274     }
275     return ConstString();
276 }
277 
278 size_t
279 ObjCLanguage::MethodName::GetFullNames (std::vector<ConstString> &names, bool append)
280 {
281     if (!append)
282         names.clear();
283     if (IsValid(false))
284     {
285         StreamString strm;
286         const bool is_class_method = m_type == eTypeClassMethod;
287         const bool is_instance_method = m_type == eTypeInstanceMethod;
288         const ConstString &category = GetCategory();
289         if (is_class_method || is_instance_method)
290         {
291             names.push_back (m_full);
292             if (category)
293             {
294                 strm.Printf("%c[%s %s]",
295                             is_class_method ? '+' : '-',
296                             GetClassName().GetCString(),
297                             GetSelector().GetCString());
298                 names.push_back(ConstString(strm.GetString().c_str()));
299             }
300         }
301         else
302         {
303             const ConstString &class_name = GetClassName();
304             const ConstString &selector = GetSelector();
305             strm.Printf("+[%s %s]", class_name.GetCString(), selector.GetCString());
306             names.push_back(ConstString(strm.GetString().c_str()));
307             strm.Clear();
308             strm.Printf("-[%s %s]", class_name.GetCString(), selector.GetCString());
309             names.push_back(ConstString(strm.GetString().c_str()));
310             strm.Clear();
311             if (category)
312             {
313                 strm.Printf("+[%s(%s) %s]", class_name.GetCString(), category.GetCString(), selector.GetCString());
314                 names.push_back(ConstString(strm.GetString().c_str()));
315                 strm.Clear();
316                 strm.Printf("-[%s(%s) %s]", class_name.GetCString(), category.GetCString(), selector.GetCString());
317                 names.push_back(ConstString(strm.GetString().c_str()));
318             }
319         }
320     }
321     return names.size();
322 }
323 
324 static void
325 LoadObjCFormatters(TypeCategoryImplSP objc_category_sp)
326 {
327     if (!objc_category_sp)
328         return;
329 
330     TypeSummaryImpl::Flags objc_flags;
331     objc_flags.SetCascades(false)
332     .SetSkipPointers(true)
333     .SetSkipReferences(true)
334     .SetDontShowChildren(true)
335     .SetDontShowValue(true)
336     .SetShowMembersOneLiner(false)
337     .SetHideItemNames(false);
338 
339     lldb::TypeSummaryImplSP ObjC_BOOL_summary(new CXXFunctionSummaryFormat(objc_flags, lldb_private::formatters::ObjCBOOLSummaryProvider,""));
340     objc_category_sp->GetTypeSummariesContainer()->Add(ConstString("BOOL"),
341                                                        ObjC_BOOL_summary);
342     objc_category_sp->GetTypeSummariesContainer()->Add(ConstString("BOOL &"),
343                                                        ObjC_BOOL_summary);
344     objc_category_sp->GetTypeSummariesContainer()->Add(ConstString("BOOL *"),
345                                                        ObjC_BOOL_summary);
346 
347 #ifndef LLDB_DISABLE_PYTHON
348     // we need to skip pointers here since we are special casing a SEL* when retrieving its value
349     objc_flags.SetSkipPointers(true);
350     AddCXXSummary(objc_category_sp, lldb_private::formatters::ObjCSELSummaryProvider<false>, "SEL summary provider", ConstString("SEL"), objc_flags);
351     AddCXXSummary(objc_category_sp, lldb_private::formatters::ObjCSELSummaryProvider<false>, "SEL summary provider", ConstString("struct objc_selector"), objc_flags);
352     AddCXXSummary(objc_category_sp, lldb_private::formatters::ObjCSELSummaryProvider<false>, "SEL summary provider", ConstString("objc_selector"), objc_flags);
353     AddCXXSummary(objc_category_sp, lldb_private::formatters::ObjCSELSummaryProvider<true>, "SEL summary provider", ConstString("objc_selector *"), objc_flags);
354     AddCXXSummary(objc_category_sp, lldb_private::formatters::ObjCSELSummaryProvider<true>, "SEL summary provider", ConstString("SEL *"), objc_flags);
355 
356     AddCXXSummary(objc_category_sp, lldb_private::formatters::ObjCClassSummaryProvider, "Class summary provider", ConstString("Class"), objc_flags);
357 
358     SyntheticChildren::Flags class_synth_flags;
359     class_synth_flags.SetCascades(true).SetSkipPointers(false).SetSkipReferences(false);
360 
361     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::ObjCClassSyntheticFrontEndCreator, "Class synthetic children", ConstString("Class"), class_synth_flags);
362 #endif // LLDB_DISABLE_PYTHON
363 
364     objc_flags.SetSkipPointers(false);
365     objc_flags.SetCascades(true);
366     objc_flags.SetSkipReferences(false);
367 
368     AddStringSummary (objc_category_sp,
369                       "${var.__FuncPtr%A}",
370                       ConstString("__block_literal_generic"),
371                       objc_flags);
372 
373     AddStringSummary(objc_category_sp,
374                      "${var.years} years, ${var.months} months, ${var.days} days, ${var.hours} hours, ${var.minutes} minutes ${var.seconds} seconds",
375                      ConstString("CFGregorianUnits"),
376                      objc_flags);
377     AddStringSummary(objc_category_sp,
378                      "location=${var.location} length=${var.length}",
379                      ConstString("CFRange"),
380                      objc_flags);
381 
382     AddStringSummary(objc_category_sp,
383                      "location=${var.location}, length=${var.length}",
384                      ConstString("NSRange"),
385                      objc_flags);
386     AddStringSummary(objc_category_sp,
387                      "(${var.origin}, ${var.size}), ...",
388                      ConstString("NSRectArray"),
389                      objc_flags);
390 
391     AddOneLineSummary (objc_category_sp,
392                        ConstString("NSPoint"),
393                        objc_flags);
394     AddOneLineSummary (objc_category_sp,
395                        ConstString("NSSize"),
396                        objc_flags);
397     AddOneLineSummary (objc_category_sp,
398                        ConstString("NSRect"),
399                        objc_flags);
400 
401     AddOneLineSummary (objc_category_sp,
402                        ConstString("CGSize"),
403                        objc_flags);
404     AddOneLineSummary (objc_category_sp,
405                        ConstString("CGPoint"),
406                        objc_flags);
407     AddOneLineSummary (objc_category_sp,
408                        ConstString("CGRect"),
409                        objc_flags);
410 
411     AddStringSummary(objc_category_sp,
412                      "red=${var.red} green=${var.green} blue=${var.blue}",
413                      ConstString("RGBColor"),
414                      objc_flags);
415     AddStringSummary(objc_category_sp,
416                      "(t=${var.top}, l=${var.left}, b=${var.bottom}, r=${var.right})",
417                      ConstString("Rect"),
418                      objc_flags);
419     AddStringSummary(objc_category_sp,
420                      "{(v=${var.v}, h=${var.h})}",
421                      ConstString("Point"),
422                      objc_flags);
423     AddStringSummary(objc_category_sp,
424                      "${var.month}/${var.day}/${var.year}  ${var.hour} :${var.minute} :${var.second} dayOfWeek:${var.dayOfWeek}",
425                      ConstString("DateTimeRect *"),
426                      objc_flags);
427     AddStringSummary(objc_category_sp,
428                      "${var.ld.month}/${var.ld.day}/${var.ld.year} ${var.ld.hour} :${var.ld.minute} :${var.ld.second} dayOfWeek:${var.ld.dayOfWeek}",
429                      ConstString("LongDateRect"),
430                      objc_flags);
431     AddStringSummary(objc_category_sp,
432                      "(x=${var.x}, y=${var.y})",
433                      ConstString("HIPoint"),
434                      objc_flags);
435     AddStringSummary(objc_category_sp,
436                      "origin=${var.origin} size=${var.size}",
437                      ConstString("HIRect"),
438                      objc_flags);
439 
440     TypeSummaryImpl::Flags appkit_flags;
441     appkit_flags.SetCascades(true)
442     .SetSkipPointers(false)
443     .SetSkipReferences(false)
444     .SetDontShowChildren(true)
445     .SetDontShowValue(false)
446     .SetShowMembersOneLiner(false)
447     .SetHideItemNames(false);
448 
449     appkit_flags.SetDontShowChildren(false);
450 
451 #ifndef LLDB_DISABLE_PYTHON
452     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSArraySummaryProvider, "NSArray summary provider", ConstString("NSArray"), appkit_flags);
453     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSArraySummaryProvider, "NSArray summary provider", ConstString("NSMutableArray"), appkit_flags);
454     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSArraySummaryProvider, "NSArray summary provider", ConstString("__NSArrayI"), appkit_flags);
455     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSArraySummaryProvider, "NSArray summary provider", ConstString("__NSArray0"), appkit_flags);
456     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSArraySummaryProvider, "NSArray summary provider", ConstString("__NSSingleObjectArrayI"), appkit_flags);
457     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSArraySummaryProvider, "NSArray summary provider", ConstString("__NSArrayM"), appkit_flags);
458     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSArraySummaryProvider, "NSArray summary provider", ConstString("__NSCFArray"), appkit_flags);
459     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSArraySummaryProvider, "NSArray summary provider", ConstString("CFArrayRef"), appkit_flags);
460     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSArraySummaryProvider, "NSArray summary provider", ConstString("CFMutableArrayRef"), appkit_flags);
461 
462     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSDictionarySummaryProvider<false>, "NSDictionary summary provider", ConstString("NSDictionary"), appkit_flags);
463     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSDictionarySummaryProvider<false>, "NSDictionary summary provider", ConstString("NSMutableDictionary"), appkit_flags);
464     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSDictionarySummaryProvider<false>, "NSDictionary summary provider", ConstString("__NSCFDictionary"), appkit_flags);
465     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSDictionarySummaryProvider<false>, "NSDictionary summary provider", ConstString("__NSDictionaryI"), appkit_flags);
466     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSDictionarySummaryProvider<false>, "NSDictionary summary provider", ConstString("__NSSingleEntryDictionaryI"), appkit_flags);
467     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSDictionarySummaryProvider<false>, "NSDictionary summary provider", ConstString("__NSDictionaryM"), appkit_flags);
468     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSDictionarySummaryProvider<true>, "NSDictionary summary provider", ConstString("CFDictionaryRef"), appkit_flags);
469     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSDictionarySummaryProvider<true>, "NSDictionary summary provider", ConstString("CFMutableDictionaryRef"), appkit_flags);
470 
471     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSSetSummaryProvider<false>, "NSSet summary", ConstString("NSSet"), appkit_flags);
472     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSSetSummaryProvider<false>, "NSMutableSet summary", ConstString("NSMutableSet"), appkit_flags);
473     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSSetSummaryProvider<true>, "CFSetRef summary", ConstString("CFSetRef"), appkit_flags);
474     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSSetSummaryProvider<true>, "CFMutableSetRef summary", ConstString("CFMutableSetRef"), appkit_flags);
475     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSSetSummaryProvider<false>, "__NSCFSet summary", ConstString("__NSCFSet"), appkit_flags);
476     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSSetSummaryProvider<false>, "__NSSetI summary", ConstString("__NSSetI"), appkit_flags);
477     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSSetSummaryProvider<false>, "__NSSetM summary", ConstString("__NSSetM"), appkit_flags);
478     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSSetSummaryProvider<false>, "NSCountedSet summary", ConstString("NSCountedSet"), appkit_flags);
479     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSSetSummaryProvider<false>, "NSMutableSet summary", ConstString("NSMutableSet"), appkit_flags);
480     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSSetSummaryProvider<false>, "NSOrderedSet summary", ConstString("NSOrderedSet"), appkit_flags);
481     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSSetSummaryProvider<false>, "__NSOrderedSetI summary", ConstString("__NSOrderedSetI"), appkit_flags);
482     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSSetSummaryProvider<false>, "__NSOrderedSetM summary", ConstString("__NSOrderedSetM"), appkit_flags);
483 
484     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSError_SummaryProvider, "NSError summary provider", ConstString("NSError"), appkit_flags);
485     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSException_SummaryProvider, "NSException summary provider", ConstString("NSException"), appkit_flags);
486 
487     // AddSummary(appkit_category_sp, "${var.key%@} -> ${var.value%@}", ConstString("$_lldb_typegen_nspair"), appkit_flags);
488 
489     appkit_flags.SetDontShowChildren(true);
490 
491     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSArraySyntheticFrontEndCreator, "NSArray synthetic children", ConstString("__NSArrayM"), ScriptedSyntheticChildren::Flags());
492     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSArraySyntheticFrontEndCreator, "NSArray synthetic children", ConstString("__NSArrayI"), ScriptedSyntheticChildren::Flags());
493     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSArraySyntheticFrontEndCreator, "NSArray synthetic children", ConstString("__NSArray0"), ScriptedSyntheticChildren::Flags());
494     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSArraySyntheticFrontEndCreator, "NSArray synthetic children", ConstString("__NSSingleObjectArrayI"), ScriptedSyntheticChildren::Flags());
495     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSArraySyntheticFrontEndCreator, "NSArray synthetic children", ConstString("NSArray"), ScriptedSyntheticChildren::Flags());
496     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSArraySyntheticFrontEndCreator, "NSArray synthetic children", ConstString("NSMutableArray"), ScriptedSyntheticChildren::Flags());
497     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSArraySyntheticFrontEndCreator, "NSArray synthetic children", ConstString("__NSCFArray"), ScriptedSyntheticChildren::Flags());
498     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSArraySyntheticFrontEndCreator, "NSArray synthetic children", ConstString("CFMutableArrayRef"), ScriptedSyntheticChildren::Flags());
499     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSArraySyntheticFrontEndCreator, "NSArray synthetic children", ConstString("CFArrayRef"), ScriptedSyntheticChildren::Flags());
500 
501     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSDictionarySyntheticFrontEndCreator, "NSDictionary synthetic children", ConstString("__NSDictionaryM"), ScriptedSyntheticChildren::Flags());
502     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSDictionarySyntheticFrontEndCreator, "NSDictionary synthetic children", ConstString("__NSDictionaryI"), ScriptedSyntheticChildren::Flags());
503     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSDictionarySyntheticFrontEndCreator, "NSDictionary synthetic children", ConstString("__NSSingleEntryDictionaryI"), ScriptedSyntheticChildren::Flags());
504     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSDictionarySyntheticFrontEndCreator, "NSDictionary synthetic children", ConstString("__NSCFDictionary"), ScriptedSyntheticChildren::Flags());
505     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSDictionarySyntheticFrontEndCreator, "NSDictionary synthetic children", ConstString("NSDictionary"), ScriptedSyntheticChildren::Flags());
506     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSDictionarySyntheticFrontEndCreator, "NSDictionary synthetic children", ConstString("NSMutableDictionary"), ScriptedSyntheticChildren::Flags());
507     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSDictionarySyntheticFrontEndCreator, "NSDictionary synthetic children", ConstString("CFDictionaryRef"), ScriptedSyntheticChildren::Flags());
508     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSDictionarySyntheticFrontEndCreator, "NSDictionary synthetic children", ConstString("CFMutableDictionaryRef"), ScriptedSyntheticChildren::Flags());
509 
510     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSErrorSyntheticFrontEndCreator, "NSError synthetic children", ConstString("NSError"), ScriptedSyntheticChildren::Flags());
511     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSExceptionSyntheticFrontEndCreator, "NSException synthetic children", ConstString("NSException"), ScriptedSyntheticChildren::Flags());
512 
513     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSSetSyntheticFrontEndCreator, "NSSet synthetic children", ConstString("NSSet"), ScriptedSyntheticChildren::Flags());
514     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSSetSyntheticFrontEndCreator, "__NSSetI synthetic children", ConstString("__NSSetI"), ScriptedSyntheticChildren::Flags());
515     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSSetSyntheticFrontEndCreator, "__NSSetM synthetic children", ConstString("__NSSetM"), ScriptedSyntheticChildren::Flags());
516     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSSetSyntheticFrontEndCreator, "NSMutableSet synthetic children", ConstString("NSMutableSet"), ScriptedSyntheticChildren::Flags());
517     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSSetSyntheticFrontEndCreator, "NSOrderedSet synthetic children", ConstString("NSOrderedSet"), ScriptedSyntheticChildren::Flags());
518     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSSetSyntheticFrontEndCreator, "__NSOrderedSetI synthetic children", ConstString("__NSOrderedSetI"), ScriptedSyntheticChildren::Flags());
519     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSSetSyntheticFrontEndCreator, "__NSOrderedSetM synthetic children", ConstString("__NSOrderedSetM"), ScriptedSyntheticChildren::Flags());
520 
521     AddCXXSynthetic(objc_category_sp, lldb_private::formatters::NSIndexPathSyntheticFrontEndCreator, "NSIndexPath synthetic children", ConstString("NSIndexPath"), ScriptedSyntheticChildren::Flags());
522 
523     AddCXXSummary(objc_category_sp,lldb_private::formatters::CFBagSummaryProvider, "CFBag summary provider", ConstString("CFBagRef"), appkit_flags);
524     AddCXXSummary(objc_category_sp,lldb_private::formatters::CFBagSummaryProvider, "CFBag summary provider", ConstString("__CFBag"), appkit_flags);
525     AddCXXSummary(objc_category_sp,lldb_private::formatters::CFBagSummaryProvider, "CFBag summary provider", ConstString("const struct __CFBag"), appkit_flags);
526     AddCXXSummary(objc_category_sp,lldb_private::formatters::CFBagSummaryProvider, "CFBag summary provider", ConstString("CFMutableBagRef"), appkit_flags);
527 
528     AddCXXSummary(objc_category_sp,lldb_private::formatters::CFBinaryHeapSummaryProvider, "CFBinaryHeap summary provider", ConstString("CFBinaryHeapRef"), appkit_flags);
529     AddCXXSummary(objc_category_sp,lldb_private::formatters::CFBinaryHeapSummaryProvider, "CFBinaryHeap summary provider", ConstString("__CFBinaryHeap"), appkit_flags);
530 
531     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSStringSummaryProvider, "NSString summary provider", ConstString("NSString"), appkit_flags);
532     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSStringSummaryProvider, "NSString summary provider", ConstString("CFStringRef"), appkit_flags);
533     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSStringSummaryProvider, "NSString summary provider", ConstString("__CFString"), appkit_flags);
534     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSStringSummaryProvider, "NSString summary provider", ConstString("CFMutableStringRef"), appkit_flags);
535     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSStringSummaryProvider, "NSString summary provider", ConstString("NSMutableString"), appkit_flags);
536     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSStringSummaryProvider, "NSString summary provider", ConstString("__NSCFConstantString"), appkit_flags);
537     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSStringSummaryProvider, "NSString summary provider", ConstString("__NSCFString"), appkit_flags);
538     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSStringSummaryProvider, "NSString summary provider", ConstString("NSCFConstantString"), appkit_flags);
539     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSStringSummaryProvider, "NSString summary provider", ConstString("NSCFString"), appkit_flags);
540     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSStringSummaryProvider, "NSString summary provider", ConstString("NSPathStore2"), appkit_flags);
541 
542     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSAttributedStringSummaryProvider, "NSAttributedString summary provider", ConstString("NSAttributedString"), appkit_flags);
543     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSMutableAttributedStringSummaryProvider, "NSMutableAttributedString summary provider", ConstString("NSMutableAttributedString"), appkit_flags);
544     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSMutableAttributedStringSummaryProvider, "NSMutableAttributedString summary provider", ConstString("NSConcreteMutableAttributedString"), appkit_flags);
545 
546     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSBundleSummaryProvider, "NSBundle summary provider", ConstString("NSBundle"), appkit_flags);
547 
548     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSDataSummaryProvider<false>, "NSData summary provider", ConstString("NSData"), appkit_flags);
549     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSDataSummaryProvider<false>, "NSData summary provider", ConstString("NSConcreteData"), appkit_flags);
550     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSDataSummaryProvider<false>, "NSData summary provider", ConstString("NSConcreteMutableData"), appkit_flags);
551     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSDataSummaryProvider<false>, "NSData summary provider", ConstString("NSMutableData"), appkit_flags);
552     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSDataSummaryProvider<false>, "NSData summary provider", ConstString("__NSCFData"), appkit_flags);
553     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSDataSummaryProvider<true>, "NSData summary provider", ConstString("CFDataRef"), appkit_flags);
554     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSDataSummaryProvider<true>, "NSData summary provider", ConstString("CFMutableDataRef"), appkit_flags);
555 
556     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSMachPortSummaryProvider, "NSMachPort summary provider", ConstString("NSMachPort"), appkit_flags);
557 
558     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSNotificationSummaryProvider, "NSNotification summary provider", ConstString("NSNotification"), appkit_flags);
559     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSNotificationSummaryProvider, "NSNotification summary provider", ConstString("NSConcreteNotification"), appkit_flags);
560 
561     AddStringSummary(objc_category_sp, "domain: ${var._domain} - code: ${var._code}", ConstString("NSError"), appkit_flags);
562     AddStringSummary(objc_category_sp,"name:${var.name%S} reason:${var.reason%S}",ConstString("NSException"),appkit_flags);
563 
564     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSNumberSummaryProvider, "NSNumber summary provider", ConstString("NSNumber"), appkit_flags);
565     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSNumberSummaryProvider, "CFNumberRef summary provider", ConstString("CFNumberRef"), appkit_flags);
566     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSNumberSummaryProvider, "NSNumber summary provider", ConstString("__NSCFBoolean"), appkit_flags);
567     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSNumberSummaryProvider, "NSNumber summary provider", ConstString("__NSCFNumber"), appkit_flags);
568     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSNumberSummaryProvider, "NSNumber summary provider", ConstString("NSCFBoolean"), appkit_flags);
569     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSNumberSummaryProvider, "NSNumber summary provider", ConstString("NSCFNumber"), appkit_flags);
570 
571     AddCXXSummary(objc_category_sp, lldb_private::formatters::RuntimeSpecificDescriptionSummaryProvider, "NSDecimalNumber summary provider", ConstString("NSDecimalNumber"), appkit_flags);
572     AddCXXSummary(objc_category_sp, lldb_private::formatters::RuntimeSpecificDescriptionSummaryProvider, "NSHost summary provider", ConstString("NSHost"), appkit_flags);
573     AddCXXSummary(objc_category_sp, lldb_private::formatters::RuntimeSpecificDescriptionSummaryProvider, "NSTask summary provider", ConstString("NSTask"), appkit_flags);
574     AddCXXSummary(objc_category_sp, lldb_private::formatters::RuntimeSpecificDescriptionSummaryProvider, "NSValue summary provider", ConstString("NSValue"), appkit_flags);
575 
576     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSURLSummaryProvider, "NSURL summary provider", ConstString("NSURL"), appkit_flags);
577     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSURLSummaryProvider, "NSURL summary provider", ConstString("CFURLRef"), appkit_flags);
578 
579     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSDateSummaryProvider, "NSDate summary provider", ConstString("NSDate"), appkit_flags);
580     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSDateSummaryProvider, "NSDate summary provider", ConstString("__NSDate"), appkit_flags);
581     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSDateSummaryProvider, "NSDate summary provider", ConstString("__NSTaggedDate"), appkit_flags);
582     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSDateSummaryProvider, "NSDate summary provider", ConstString("NSCalendarDate"), appkit_flags);
583 
584     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSTimeZoneSummaryProvider, "NSTimeZone summary provider", ConstString("NSTimeZone"), appkit_flags);
585     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSTimeZoneSummaryProvider, "NSTimeZone summary provider", ConstString("CFTimeZoneRef"), appkit_flags);
586     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSTimeZoneSummaryProvider, "NSTimeZone summary provider", ConstString("__NSTimeZone"), appkit_flags);
587 
588     // CFAbsoluteTime is actually a double rather than a pointer to an object
589     // we do not care about the numeric value, since it is probably meaningless to users
590     appkit_flags.SetDontShowValue(true);
591     AddCXXSummary(objc_category_sp, lldb_private::formatters::CFAbsoluteTimeSummaryProvider, "CFAbsoluteTime summary provider", ConstString("CFAbsoluteTime"), appkit_flags);
592     appkit_flags.SetDontShowValue(false);
593 
594     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSIndexSetSummaryProvider, "NSIndexSet summary provider", ConstString("NSIndexSet"), appkit_flags);
595     AddCXXSummary(objc_category_sp, lldb_private::formatters::NSIndexSetSummaryProvider, "NSIndexSet summary provider", ConstString("NSMutableIndexSet"), appkit_flags);
596 
597     AddStringSummary(objc_category_sp,
598                      "@\"${var.month%d}/${var.day%d}/${var.year%d} ${var.hour%d}:${var.minute%d}:${var.second}\"",
599                      ConstString("CFGregorianDate"),
600                      appkit_flags);
601 
602     AddCXXSummary(objc_category_sp, lldb_private::formatters::CFBitVectorSummaryProvider, "CFBitVector summary provider", ConstString("CFBitVectorRef"), appkit_flags);
603     AddCXXSummary(objc_category_sp, lldb_private::formatters::CFBitVectorSummaryProvider, "CFBitVector summary provider", ConstString("CFMutableBitVectorRef"), appkit_flags);
604     AddCXXSummary(objc_category_sp, lldb_private::formatters::CFBitVectorSummaryProvider, "CFBitVector summary provider", ConstString("__CFBitVector"), appkit_flags);
605     AddCXXSummary(objc_category_sp, lldb_private::formatters::CFBitVectorSummaryProvider, "CFBitVector summary provider", ConstString("__CFMutableBitVector"), appkit_flags);
606 #endif // LLDB_DISABLE_PYTHON
607 }
608 
609 static void
610 LoadCoreMediaFormatters(TypeCategoryImplSP objc_category_sp)
611 {
612     if (!objc_category_sp)
613         return;
614 
615     TypeSummaryImpl::Flags cm_flags;
616     cm_flags.SetCascades(true)
617     .SetDontShowChildren(false)
618     .SetDontShowValue(false)
619     .SetHideItemNames(false)
620     .SetShowMembersOneLiner(false)
621     .SetSkipPointers(false)
622     .SetSkipReferences(false);
623 
624 #ifndef LLDB_DISABLE_PYTHON
625     AddCXXSummary(objc_category_sp, lldb_private::formatters::CMTimeSummaryProvider, "CMTime summary provider", ConstString("CMTime"), cm_flags);
626 #endif // LLDB_DISABLE_PYTHON
627 }
628 
629 lldb::TypeCategoryImplSP
630 ObjCLanguage::GetFormatters ()
631 {
632     static std::once_flag g_initialize;
633     static TypeCategoryImplSP g_category;
634 
635     std::call_once(g_initialize, [this] () -> void {
636         DataVisualization::Categories::GetCategory(GetPluginName(), g_category);
637         if (g_category)
638         {
639             LoadCoreMediaFormatters(g_category);
640             LoadObjCFormatters(g_category);
641         }
642     });
643     return g_category;
644 }
645 
646 std::vector<ConstString>
647 ObjCLanguage::GetPossibleFormattersMatches (ValueObject& valobj, lldb::DynamicValueType use_dynamic)
648 {
649     std::vector<ConstString> result;
650 
651     if (use_dynamic == lldb::eNoDynamicValues)
652         return result;
653 
654     CompilerType compiler_type(valobj.GetCompilerType());
655 
656     const bool check_cpp = false;
657     const bool check_objc = true;
658     bool canBeObjCDynamic = compiler_type.IsPossibleDynamicType(nullptr, check_cpp, check_objc);
659 
660     if (canBeObjCDynamic)
661     {
662         do {
663             lldb::ProcessSP process_sp = valobj.GetProcessSP();
664             if (!process_sp)
665                 break;
666             ObjCLanguageRuntime* runtime = process_sp->GetObjCLanguageRuntime();
667             if (runtime == nullptr)
668                 break;
669             ObjCLanguageRuntime::ClassDescriptorSP objc_class_sp (runtime->GetClassDescriptor(valobj));
670             if (!objc_class_sp)
671                 break;
672             if (ConstString name = objc_class_sp->GetClassName())
673                 result.push_back(name);
674         } while (false);
675     }
676 
677     return result;
678 }
679 
680 std::unique_ptr<Language::TypeScavenger>
681 ObjCLanguage::GetTypeScavenger ()
682 {
683     class ObjCTypeScavenger : public Language::TypeScavenger
684     {
685     private:
686         class ObjCScavengerResult : public Language::TypeScavenger::Result
687         {
688         public:
689             ObjCScavengerResult (CompilerType type) :
690                 Language::TypeScavenger::Result(),
691                 m_compiler_type(type)
692             {
693             }
694 
695             bool
696             IsValid () override
697             {
698                 return m_compiler_type.IsValid();
699             }
700 
701             bool
702             DumpToStream (Stream& stream,
703                           bool print_help_if_available) override
704             {
705                 if (IsValid())
706                 {
707                     m_compiler_type.DumpTypeDescription(&stream);
708                     stream.EOL();
709                     return true;
710                 }
711                 return false;
712             }
713 
714             ~ObjCScavengerResult() override = default;
715 
716         private:
717             CompilerType m_compiler_type;
718         };
719 
720     protected:
721         ObjCTypeScavenger() = default;
722 
723         ~ObjCTypeScavenger() override = default;
724 
725         bool
726         Find_Impl (ExecutionContextScope *exe_scope,
727                    const char *key,
728                    ResultSet &results) override
729         {
730             bool result = false;
731 
732             Target* target = exe_scope->CalculateTarget().get();
733             if (target)
734             {
735                 if (auto clang_modules_decl_vendor = target->GetClangModulesDeclVendor())
736                 {
737                     std::vector <clang::NamedDecl*> decls;
738                     ConstString key_cs(key);
739 
740                     if (clang_modules_decl_vendor->FindDecls(key_cs, false, UINT32_MAX, decls) > 0 &&
741                         !decls.empty())
742                     {
743                         CompilerType module_type = ClangASTContext::GetTypeForDecl(decls.front());
744                         result = true;
745                         std::unique_ptr<Language::TypeScavenger::Result> result(new ObjCScavengerResult(module_type));
746                         results.insert(std::move(result));
747                     }
748                 }
749             }
750 
751             if (!result)
752             {
753                 Process* process = exe_scope->CalculateProcess().get();
754                 if (process)
755                 {
756                     const bool create_on_demand = false;
757                     auto objc_runtime = process->GetObjCLanguageRuntime(create_on_demand);
758                     if (objc_runtime)
759                     {
760                         auto decl_vendor = objc_runtime->GetDeclVendor();
761                         if (decl_vendor)
762                         {
763                             std::vector<clang::NamedDecl *> decls;
764                             ConstString name(key);
765                             decl_vendor->FindDecls(name, true, UINT32_MAX, decls);
766                             for (auto decl : decls)
767                             {
768                                 if (decl)
769                                 {
770                                     if (CompilerType candidate = ClangASTContext::GetTypeForDecl(decl))
771                                     {
772                                         result = true;
773                                         std::unique_ptr<Language::TypeScavenger::Result> result(new ObjCScavengerResult(candidate));
774                                         results.insert(std::move(result));
775                                     }
776                                 }
777                             }
778                         }
779                     }
780                 }
781             }
782 
783             return result;
784         }
785 
786         friend class lldb_private::ObjCLanguage;
787     };
788 
789     return std::unique_ptr<TypeScavenger>(new ObjCTypeScavenger());
790 }
791 
792 bool
793 ObjCLanguage::GetFormatterPrefixSuffix (ValueObject& valobj, ConstString type_hint,
794                                         std::string& prefix, std::string& suffix)
795 {
796     static ConstString g_CFBag("CFBag");
797     static ConstString g_CFBinaryHeap("CFBinaryHeap");
798 
799     static ConstString g_NSNumberChar("NSNumber:char");
800     static ConstString g_NSNumberShort("NSNumber:short");
801     static ConstString g_NSNumberInt("NSNumber:int");
802     static ConstString g_NSNumberLong("NSNumber:long");
803     static ConstString g_NSNumberFloat("NSNumber:float");
804     static ConstString g_NSNumberDouble("NSNumber:double");
805 
806     static ConstString g_NSData("NSData");
807     static ConstString g_NSArray("NSArray");
808     static ConstString g_NSString("NSString");
809     static ConstString g_NSStringStar("NSString*");
810 
811     if (type_hint.IsEmpty())
812         return false;
813 
814     prefix.clear();
815     suffix.clear();
816 
817     if (type_hint == g_CFBag ||
818         type_hint == g_CFBinaryHeap)
819     {
820         prefix = "@";
821         return true;
822     }
823 
824     if (type_hint == g_NSNumberChar)
825     {
826         prefix = "(char)";
827         return true;
828     }
829     if (type_hint == g_NSNumberShort)
830     {
831         prefix = "(short)";
832         return true;
833     }
834     if (type_hint == g_NSNumberInt)
835     {
836         prefix = "(int)";
837         return true;
838     }
839     if (type_hint == g_NSNumberLong)
840     {
841         prefix = "(long)";
842         return true;
843     }
844     if (type_hint == g_NSNumberFloat)
845     {
846         prefix = "(float)";
847         return true;
848     }
849     if (type_hint == g_NSNumberDouble)
850     {
851         prefix = "(double)";
852         return true;
853     }
854 
855     if (type_hint == g_NSData ||
856         type_hint == g_NSArray)
857     {
858         prefix = "@\"";
859         suffix = "\"";
860         return true;
861     }
862 
863     if (type_hint == g_NSString ||
864         type_hint == g_NSStringStar)
865     {
866         prefix = "@";
867         return true;
868     }
869 
870     return false;
871 }
872 
873 bool
874 ObjCLanguage::IsNilReference (ValueObject& valobj)
875 {
876     const uint32_t mask = eTypeIsObjC | eTypeIsPointer;
877     bool isObjCpointer = (((valobj.GetCompilerType().GetTypeInfo(nullptr)) & mask) == mask);
878     if (!isObjCpointer)
879         return false;
880     bool canReadValue = true;
881     bool isZero = valobj.GetValueAsUnsigned(0,&canReadValue) == 0;
882     return canReadValue && isZero;
883 }
884