clang  8.0.0svn
LocalizationChecker.cpp
Go to the documentation of this file.
1 //=- LocalizationChecker.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 // This file defines a set of checks for localizability including:
11 // 1) A checker that warns about uses of non-localized NSStrings passed to
12 // UI methods expecting localized strings
13 // 2) A syntactic checker that warns against the bad practice of
14 // not including a comment in NSLocalizedString macros.
15 //
16 //===----------------------------------------------------------------------===//
17 
18 #include "ClangSACheckers.h"
19 #include "clang/AST/Attr.h"
20 #include "clang/AST/Decl.h"
21 #include "clang/AST/DeclObjC.h"
23 #include "clang/AST/StmtVisitor.h"
24 #include "clang/Lex/Lexer.h"
32 #include "llvm/Support/Unicode.h"
33 
34 using namespace clang;
35 using namespace ento;
36 
37 namespace {
38 struct LocalizedState {
39 private:
40  enum Kind { NonLocalized, Localized } K;
41  LocalizedState(Kind InK) : K(InK) {}
42 
43 public:
44  bool isLocalized() const { return K == Localized; }
45  bool isNonLocalized() const { return K == NonLocalized; }
46 
47  static LocalizedState getLocalized() { return LocalizedState(Localized); }
48  static LocalizedState getNonLocalized() {
49  return LocalizedState(NonLocalized);
50  }
51 
52  // Overload the == operator
53  bool operator==(const LocalizedState &X) const { return K == X.K; }
54 
55  // LLVMs equivalent of a hash function
56  void Profile(llvm::FoldingSetNodeID &ID) const { ID.AddInteger(K); }
57 };
58 
59 class NonLocalizedStringChecker
60  : public Checker<check::PreCall, check::PostCall, check::PreObjCMessage,
61  check::PostObjCMessage,
62  check::PostStmt<ObjCStringLiteral>> {
63 
64  mutable std::unique_ptr<BugType> BT;
65 
66  // Methods that require a localized string
67  mutable llvm::DenseMap<const IdentifierInfo *,
68  llvm::DenseMap<Selector, uint8_t>> UIMethods;
69  // Methods that return a localized string
70  mutable llvm::SmallSet<std::pair<const IdentifierInfo *, Selector>, 12> LSM;
71  // C Functions that return a localized string
72  mutable llvm::SmallSet<const IdentifierInfo *, 5> LSF;
73 
74  void initUIMethods(ASTContext &Ctx) const;
75  void initLocStringsMethods(ASTContext &Ctx) const;
76 
77  bool hasNonLocalizedState(SVal S, CheckerContext &C) const;
78  bool hasLocalizedState(SVal S, CheckerContext &C) const;
79  void setNonLocalizedState(SVal S, CheckerContext &C) const;
80  void setLocalizedState(SVal S, CheckerContext &C) const;
81 
82  bool isAnnotatedAsReturningLocalized(const Decl *D) const;
83  bool isAnnotatedAsTakingLocalized(const Decl *D) const;
84  void reportLocalizationError(SVal S, const CallEvent &M, CheckerContext &C,
85  int argumentNumber = 0) const;
86 
87  int getLocalizedArgumentForSelector(const IdentifierInfo *Receiver,
88  Selector S) const;
89 
90 public:
91  NonLocalizedStringChecker();
92 
93  // When this parameter is set to true, the checker assumes all
94  // methods that return NSStrings are unlocalized. Thus, more false
95  // positives will be reported.
96  DefaultBool IsAggressive;
97 
98  void checkPreObjCMessage(const ObjCMethodCall &msg, CheckerContext &C) const;
99  void checkPostObjCMessage(const ObjCMethodCall &msg, CheckerContext &C) const;
100  void checkPostStmt(const ObjCStringLiteral *SL, CheckerContext &C) const;
101  void checkPreCall(const CallEvent &Call, CheckerContext &C) const;
102  void checkPostCall(const CallEvent &Call, CheckerContext &C) const;
103 };
104 
105 } // end anonymous namespace
106 
107 REGISTER_MAP_WITH_PROGRAMSTATE(LocalizedMemMap, const MemRegion *,
108  LocalizedState)
109 
110 NonLocalizedStringChecker::NonLocalizedStringChecker() {
111  BT.reset(new BugType(this, "Unlocalizable string",
112  "Localizability Issue (Apple)"));
113 }
114 
115 namespace {
116 class NonLocalizedStringBRVisitor final : public BugReporterVisitor {
117 
118  const MemRegion *NonLocalizedString;
119  bool Satisfied;
120 
121 public:
122  NonLocalizedStringBRVisitor(const MemRegion *NonLocalizedString)
123  : NonLocalizedString(NonLocalizedString), Satisfied(false) {
124  assert(NonLocalizedString);
125  }
126 
127  std::shared_ptr<PathDiagnosticPiece> VisitNode(const ExplodedNode *Succ,
128  BugReporterContext &BRC,
129  BugReport &BR) override;
130 
131  void Profile(llvm::FoldingSetNodeID &ID) const override {
132  ID.Add(NonLocalizedString);
133  }
134 };
135 } // End anonymous namespace.
136 
137 #define NEW_RECEIVER(receiver) \
138  llvm::DenseMap<Selector, uint8_t> &receiver##M = \
139  UIMethods.insert({&Ctx.Idents.get(#receiver), \
140  llvm::DenseMap<Selector, uint8_t>()}) \
141  .first->second;
142 #define ADD_NULLARY_METHOD(receiver, method, argument) \
143  receiver##M.insert( \
144  {Ctx.Selectors.getNullarySelector(&Ctx.Idents.get(#method)), argument});
145 #define ADD_UNARY_METHOD(receiver, method, argument) \
146  receiver##M.insert( \
147  {Ctx.Selectors.getUnarySelector(&Ctx.Idents.get(#method)), argument});
148 #define ADD_METHOD(receiver, method_list, count, argument) \
149  receiver##M.insert({Ctx.Selectors.getSelector(count, method_list), argument});
150 
151 /// Initializes a list of methods that require a localized string
152 /// Format: {"ClassName", {{"selectorName:", LocStringArg#}, ...}, ...}
153 void NonLocalizedStringChecker::initUIMethods(ASTContext &Ctx) const {
154  if (!UIMethods.empty())
155  return;
156 
157  // UI Methods
158  NEW_RECEIVER(UISearchDisplayController)
159  ADD_UNARY_METHOD(UISearchDisplayController, setSearchResultsTitle, 0)
160 
161  NEW_RECEIVER(UITabBarItem)
162  IdentifierInfo *initWithTitleUITabBarItemTag[] = {
163  &Ctx.Idents.get("initWithTitle"), &Ctx.Idents.get("image"),
164  &Ctx.Idents.get("tag")};
165  ADD_METHOD(UITabBarItem, initWithTitleUITabBarItemTag, 3, 0)
166  IdentifierInfo *initWithTitleUITabBarItemImage[] = {
167  &Ctx.Idents.get("initWithTitle"), &Ctx.Idents.get("image"),
168  &Ctx.Idents.get("selectedImage")};
169  ADD_METHOD(UITabBarItem, initWithTitleUITabBarItemImage, 3, 0)
170 
171  NEW_RECEIVER(NSDockTile)
172  ADD_UNARY_METHOD(NSDockTile, setBadgeLabel, 0)
173 
174  NEW_RECEIVER(NSStatusItem)
175  ADD_UNARY_METHOD(NSStatusItem, setTitle, 0)
176  ADD_UNARY_METHOD(NSStatusItem, setToolTip, 0)
177 
178  NEW_RECEIVER(UITableViewRowAction)
179  IdentifierInfo *rowActionWithStyleUITableViewRowAction[] = {
180  &Ctx.Idents.get("rowActionWithStyle"), &Ctx.Idents.get("title"),
181  &Ctx.Idents.get("handler")};
182  ADD_METHOD(UITableViewRowAction, rowActionWithStyleUITableViewRowAction, 3, 1)
183  ADD_UNARY_METHOD(UITableViewRowAction, setTitle, 0)
184 
185  NEW_RECEIVER(NSBox)
186  ADD_UNARY_METHOD(NSBox, setTitle, 0)
187 
188  NEW_RECEIVER(NSButton)
189  ADD_UNARY_METHOD(NSButton, setTitle, 0)
190  ADD_UNARY_METHOD(NSButton, setAlternateTitle, 0)
191  IdentifierInfo *radioButtonWithTitleNSButton[] = {
192  &Ctx.Idents.get("radioButtonWithTitle"), &Ctx.Idents.get("target"),
193  &Ctx.Idents.get("action")};
194  ADD_METHOD(NSButton, radioButtonWithTitleNSButton, 3, 0)
195  IdentifierInfo *buttonWithTitleNSButtonImage[] = {
196  &Ctx.Idents.get("buttonWithTitle"), &Ctx.Idents.get("image"),
197  &Ctx.Idents.get("target"), &Ctx.Idents.get("action")};
198  ADD_METHOD(NSButton, buttonWithTitleNSButtonImage, 4, 0)
199  IdentifierInfo *checkboxWithTitleNSButton[] = {
200  &Ctx.Idents.get("checkboxWithTitle"), &Ctx.Idents.get("target"),
201  &Ctx.Idents.get("action")};
202  ADD_METHOD(NSButton, checkboxWithTitleNSButton, 3, 0)
203  IdentifierInfo *buttonWithTitleNSButtonTarget[] = {
204  &Ctx.Idents.get("buttonWithTitle"), &Ctx.Idents.get("target"),
205  &Ctx.Idents.get("action")};
206  ADD_METHOD(NSButton, buttonWithTitleNSButtonTarget, 3, 0)
207 
208  NEW_RECEIVER(NSSavePanel)
209  ADD_UNARY_METHOD(NSSavePanel, setPrompt, 0)
210  ADD_UNARY_METHOD(NSSavePanel, setTitle, 0)
211  ADD_UNARY_METHOD(NSSavePanel, setNameFieldLabel, 0)
212  ADD_UNARY_METHOD(NSSavePanel, setNameFieldStringValue, 0)
213  ADD_UNARY_METHOD(NSSavePanel, setMessage, 0)
214 
215  NEW_RECEIVER(UIPrintInfo)
216  ADD_UNARY_METHOD(UIPrintInfo, setJobName, 0)
217 
218  NEW_RECEIVER(NSTabViewItem)
219  ADD_UNARY_METHOD(NSTabViewItem, setLabel, 0)
220  ADD_UNARY_METHOD(NSTabViewItem, setToolTip, 0)
221 
222  NEW_RECEIVER(NSBrowser)
223  IdentifierInfo *setTitleNSBrowser[] = {&Ctx.Idents.get("setTitle"),
224  &Ctx.Idents.get("ofColumn")};
225  ADD_METHOD(NSBrowser, setTitleNSBrowser, 2, 0)
226 
227  NEW_RECEIVER(UIAccessibilityElement)
228  ADD_UNARY_METHOD(UIAccessibilityElement, setAccessibilityLabel, 0)
229  ADD_UNARY_METHOD(UIAccessibilityElement, setAccessibilityHint, 0)
230  ADD_UNARY_METHOD(UIAccessibilityElement, setAccessibilityValue, 0)
231 
232  NEW_RECEIVER(UIAlertAction)
233  IdentifierInfo *actionWithTitleUIAlertAction[] = {
234  &Ctx.Idents.get("actionWithTitle"), &Ctx.Idents.get("style"),
235  &Ctx.Idents.get("handler")};
236  ADD_METHOD(UIAlertAction, actionWithTitleUIAlertAction, 3, 0)
237 
238  NEW_RECEIVER(NSPopUpButton)
239  ADD_UNARY_METHOD(NSPopUpButton, addItemWithTitle, 0)
240  IdentifierInfo *insertItemWithTitleNSPopUpButton[] = {
241  &Ctx.Idents.get("insertItemWithTitle"), &Ctx.Idents.get("atIndex")};
242  ADD_METHOD(NSPopUpButton, insertItemWithTitleNSPopUpButton, 2, 0)
243  ADD_UNARY_METHOD(NSPopUpButton, removeItemWithTitle, 0)
244  ADD_UNARY_METHOD(NSPopUpButton, selectItemWithTitle, 0)
245  ADD_UNARY_METHOD(NSPopUpButton, setTitle, 0)
246 
247  NEW_RECEIVER(NSTableViewRowAction)
248  IdentifierInfo *rowActionWithStyleNSTableViewRowAction[] = {
249  &Ctx.Idents.get("rowActionWithStyle"), &Ctx.Idents.get("title"),
250  &Ctx.Idents.get("handler")};
251  ADD_METHOD(NSTableViewRowAction, rowActionWithStyleNSTableViewRowAction, 3, 1)
252  ADD_UNARY_METHOD(NSTableViewRowAction, setTitle, 0)
253 
254  NEW_RECEIVER(NSImage)
255  ADD_UNARY_METHOD(NSImage, setAccessibilityDescription, 0)
256 
257  NEW_RECEIVER(NSUserActivity)
258  ADD_UNARY_METHOD(NSUserActivity, setTitle, 0)
259 
260  NEW_RECEIVER(NSPathControlItem)
261  ADD_UNARY_METHOD(NSPathControlItem, setTitle, 0)
262 
263  NEW_RECEIVER(NSCell)
264  ADD_UNARY_METHOD(NSCell, initTextCell, 0)
265  ADD_UNARY_METHOD(NSCell, setTitle, 0)
266  ADD_UNARY_METHOD(NSCell, setStringValue, 0)
267 
268  NEW_RECEIVER(NSPathControl)
269  ADD_UNARY_METHOD(NSPathControl, setPlaceholderString, 0)
270 
271  NEW_RECEIVER(UIAccessibility)
272  ADD_UNARY_METHOD(UIAccessibility, setAccessibilityLabel, 0)
273  ADD_UNARY_METHOD(UIAccessibility, setAccessibilityHint, 0)
274  ADD_UNARY_METHOD(UIAccessibility, setAccessibilityValue, 0)
275 
276  NEW_RECEIVER(NSTableColumn)
277  ADD_UNARY_METHOD(NSTableColumn, setTitle, 0)
278  ADD_UNARY_METHOD(NSTableColumn, setHeaderToolTip, 0)
279 
280  NEW_RECEIVER(NSSegmentedControl)
281  IdentifierInfo *setLabelNSSegmentedControl[] = {
282  &Ctx.Idents.get("setLabel"), &Ctx.Idents.get("forSegment")};
283  ADD_METHOD(NSSegmentedControl, setLabelNSSegmentedControl, 2, 0)
284  IdentifierInfo *setToolTipNSSegmentedControl[] = {
285  &Ctx.Idents.get("setToolTip"), &Ctx.Idents.get("forSegment")};
286  ADD_METHOD(NSSegmentedControl, setToolTipNSSegmentedControl, 2, 0)
287 
288  NEW_RECEIVER(NSButtonCell)
289  ADD_UNARY_METHOD(NSButtonCell, setTitle, 0)
290  ADD_UNARY_METHOD(NSButtonCell, setAlternateTitle, 0)
291 
292  NEW_RECEIVER(NSDatePickerCell)
293  ADD_UNARY_METHOD(NSDatePickerCell, initTextCell, 0)
294 
295  NEW_RECEIVER(NSSliderCell)
296  ADD_UNARY_METHOD(NSSliderCell, setTitle, 0)
297 
298  NEW_RECEIVER(NSControl)
299  ADD_UNARY_METHOD(NSControl, setStringValue, 0)
300 
301  NEW_RECEIVER(NSAccessibility)
302  ADD_UNARY_METHOD(NSAccessibility, setAccessibilityValueDescription, 0)
303  ADD_UNARY_METHOD(NSAccessibility, setAccessibilityLabel, 0)
304  ADD_UNARY_METHOD(NSAccessibility, setAccessibilityTitle, 0)
305  ADD_UNARY_METHOD(NSAccessibility, setAccessibilityPlaceholderValue, 0)
306  ADD_UNARY_METHOD(NSAccessibility, setAccessibilityHelp, 0)
307 
308  NEW_RECEIVER(NSMatrix)
309  IdentifierInfo *setToolTipNSMatrix[] = {&Ctx.Idents.get("setToolTip"),
310  &Ctx.Idents.get("forCell")};
311  ADD_METHOD(NSMatrix, setToolTipNSMatrix, 2, 0)
312 
313  NEW_RECEIVER(NSPrintPanel)
314  ADD_UNARY_METHOD(NSPrintPanel, setDefaultButtonTitle, 0)
315 
316  NEW_RECEIVER(UILocalNotification)
317  ADD_UNARY_METHOD(UILocalNotification, setAlertBody, 0)
318  ADD_UNARY_METHOD(UILocalNotification, setAlertAction, 0)
319  ADD_UNARY_METHOD(UILocalNotification, setAlertTitle, 0)
320 
321  NEW_RECEIVER(NSSlider)
322  ADD_UNARY_METHOD(NSSlider, setTitle, 0)
323 
324  NEW_RECEIVER(UIMenuItem)
325  IdentifierInfo *initWithTitleUIMenuItem[] = {&Ctx.Idents.get("initWithTitle"),
326  &Ctx.Idents.get("action")};
327  ADD_METHOD(UIMenuItem, initWithTitleUIMenuItem, 2, 0)
328  ADD_UNARY_METHOD(UIMenuItem, setTitle, 0)
329 
330  NEW_RECEIVER(UIAlertController)
331  IdentifierInfo *alertControllerWithTitleUIAlertController[] = {
332  &Ctx.Idents.get("alertControllerWithTitle"), &Ctx.Idents.get("message"),
333  &Ctx.Idents.get("preferredStyle")};
334  ADD_METHOD(UIAlertController, alertControllerWithTitleUIAlertController, 3, 1)
335  ADD_UNARY_METHOD(UIAlertController, setTitle, 0)
336  ADD_UNARY_METHOD(UIAlertController, setMessage, 0)
337 
338  NEW_RECEIVER(UIApplicationShortcutItem)
339  IdentifierInfo *initWithTypeUIApplicationShortcutItemIcon[] = {
340  &Ctx.Idents.get("initWithType"), &Ctx.Idents.get("localizedTitle"),
341  &Ctx.Idents.get("localizedSubtitle"), &Ctx.Idents.get("icon"),
342  &Ctx.Idents.get("userInfo")};
343  ADD_METHOD(UIApplicationShortcutItem,
344  initWithTypeUIApplicationShortcutItemIcon, 5, 1)
345  IdentifierInfo *initWithTypeUIApplicationShortcutItem[] = {
346  &Ctx.Idents.get("initWithType"), &Ctx.Idents.get("localizedTitle")};
347  ADD_METHOD(UIApplicationShortcutItem, initWithTypeUIApplicationShortcutItem,
348  2, 1)
349 
350  NEW_RECEIVER(UIActionSheet)
351  IdentifierInfo *initWithTitleUIActionSheet[] = {
352  &Ctx.Idents.get("initWithTitle"), &Ctx.Idents.get("delegate"),
353  &Ctx.Idents.get("cancelButtonTitle"),
354  &Ctx.Idents.get("destructiveButtonTitle"),
355  &Ctx.Idents.get("otherButtonTitles")};
356  ADD_METHOD(UIActionSheet, initWithTitleUIActionSheet, 5, 0)
357  ADD_UNARY_METHOD(UIActionSheet, addButtonWithTitle, 0)
358  ADD_UNARY_METHOD(UIActionSheet, setTitle, 0)
359 
360  NEW_RECEIVER(UIAccessibilityCustomAction)
361  IdentifierInfo *initWithNameUIAccessibilityCustomAction[] = {
362  &Ctx.Idents.get("initWithName"), &Ctx.Idents.get("target"),
363  &Ctx.Idents.get("selector")};
364  ADD_METHOD(UIAccessibilityCustomAction,
365  initWithNameUIAccessibilityCustomAction, 3, 0)
366  ADD_UNARY_METHOD(UIAccessibilityCustomAction, setName, 0)
367 
368  NEW_RECEIVER(UISearchBar)
369  ADD_UNARY_METHOD(UISearchBar, setText, 0)
370  ADD_UNARY_METHOD(UISearchBar, setPrompt, 0)
371  ADD_UNARY_METHOD(UISearchBar, setPlaceholder, 0)
372 
373  NEW_RECEIVER(UIBarItem)
374  ADD_UNARY_METHOD(UIBarItem, setTitle, 0)
375 
376  NEW_RECEIVER(UITextView)
377  ADD_UNARY_METHOD(UITextView, setText, 0)
378 
379  NEW_RECEIVER(NSView)
380  ADD_UNARY_METHOD(NSView, setToolTip, 0)
381 
382  NEW_RECEIVER(NSTextField)
383  ADD_UNARY_METHOD(NSTextField, setPlaceholderString, 0)
384  ADD_UNARY_METHOD(NSTextField, textFieldWithString, 0)
385  ADD_UNARY_METHOD(NSTextField, wrappingLabelWithString, 0)
386  ADD_UNARY_METHOD(NSTextField, labelWithString, 0)
387 
388  NEW_RECEIVER(NSAttributedString)
389  ADD_UNARY_METHOD(NSAttributedString, initWithString, 0)
390  IdentifierInfo *initWithStringNSAttributedString[] = {
391  &Ctx.Idents.get("initWithString"), &Ctx.Idents.get("attributes")};
392  ADD_METHOD(NSAttributedString, initWithStringNSAttributedString, 2, 0)
393 
394  NEW_RECEIVER(NSText)
395  ADD_UNARY_METHOD(NSText, setString, 0)
396 
397  NEW_RECEIVER(UIKeyCommand)
398  IdentifierInfo *keyCommandWithInputUIKeyCommand[] = {
399  &Ctx.Idents.get("keyCommandWithInput"), &Ctx.Idents.get("modifierFlags"),
400  &Ctx.Idents.get("action"), &Ctx.Idents.get("discoverabilityTitle")};
401  ADD_METHOD(UIKeyCommand, keyCommandWithInputUIKeyCommand, 4, 3)
402  ADD_UNARY_METHOD(UIKeyCommand, setDiscoverabilityTitle, 0)
403 
404  NEW_RECEIVER(UILabel)
405  ADD_UNARY_METHOD(UILabel, setText, 0)
406 
407  NEW_RECEIVER(NSAlert)
408  IdentifierInfo *alertWithMessageTextNSAlert[] = {
409  &Ctx.Idents.get("alertWithMessageText"), &Ctx.Idents.get("defaultButton"),
410  &Ctx.Idents.get("alternateButton"), &Ctx.Idents.get("otherButton"),
411  &Ctx.Idents.get("informativeTextWithFormat")};
412  ADD_METHOD(NSAlert, alertWithMessageTextNSAlert, 5, 0)
413  ADD_UNARY_METHOD(NSAlert, addButtonWithTitle, 0)
414  ADD_UNARY_METHOD(NSAlert, setMessageText, 0)
415  ADD_UNARY_METHOD(NSAlert, setInformativeText, 0)
416  ADD_UNARY_METHOD(NSAlert, setHelpAnchor, 0)
417 
418  NEW_RECEIVER(UIMutableApplicationShortcutItem)
419  ADD_UNARY_METHOD(UIMutableApplicationShortcutItem, setLocalizedTitle, 0)
420  ADD_UNARY_METHOD(UIMutableApplicationShortcutItem, setLocalizedSubtitle, 0)
421 
422  NEW_RECEIVER(UIButton)
423  IdentifierInfo *setTitleUIButton[] = {&Ctx.Idents.get("setTitle"),
424  &Ctx.Idents.get("forState")};
425  ADD_METHOD(UIButton, setTitleUIButton, 2, 0)
426 
427  NEW_RECEIVER(NSWindow)
428  ADD_UNARY_METHOD(NSWindow, setTitle, 0)
429  IdentifierInfo *minFrameWidthWithTitleNSWindow[] = {
430  &Ctx.Idents.get("minFrameWidthWithTitle"), &Ctx.Idents.get("styleMask")};
431  ADD_METHOD(NSWindow, minFrameWidthWithTitleNSWindow, 2, 0)
432  ADD_UNARY_METHOD(NSWindow, setMiniwindowTitle, 0)
433 
434  NEW_RECEIVER(NSPathCell)
435  ADD_UNARY_METHOD(NSPathCell, setPlaceholderString, 0)
436 
437  NEW_RECEIVER(UIDocumentMenuViewController)
438  IdentifierInfo *addOptionWithTitleUIDocumentMenuViewController[] = {
439  &Ctx.Idents.get("addOptionWithTitle"), &Ctx.Idents.get("image"),
440  &Ctx.Idents.get("order"), &Ctx.Idents.get("handler")};
441  ADD_METHOD(UIDocumentMenuViewController,
442  addOptionWithTitleUIDocumentMenuViewController, 4, 0)
443 
444  NEW_RECEIVER(UINavigationItem)
445  ADD_UNARY_METHOD(UINavigationItem, initWithTitle, 0)
446  ADD_UNARY_METHOD(UINavigationItem, setTitle, 0)
447  ADD_UNARY_METHOD(UINavigationItem, setPrompt, 0)
448 
449  NEW_RECEIVER(UIAlertView)
450  IdentifierInfo *initWithTitleUIAlertView[] = {
451  &Ctx.Idents.get("initWithTitle"), &Ctx.Idents.get("message"),
452  &Ctx.Idents.get("delegate"), &Ctx.Idents.get("cancelButtonTitle"),
453  &Ctx.Idents.get("otherButtonTitles")};
454  ADD_METHOD(UIAlertView, initWithTitleUIAlertView, 5, 0)
455  ADD_UNARY_METHOD(UIAlertView, addButtonWithTitle, 0)
456  ADD_UNARY_METHOD(UIAlertView, setTitle, 0)
457  ADD_UNARY_METHOD(UIAlertView, setMessage, 0)
458 
459  NEW_RECEIVER(NSFormCell)
460  ADD_UNARY_METHOD(NSFormCell, initTextCell, 0)
461  ADD_UNARY_METHOD(NSFormCell, setTitle, 0)
462  ADD_UNARY_METHOD(NSFormCell, setPlaceholderString, 0)
463 
464  NEW_RECEIVER(NSUserNotification)
465  ADD_UNARY_METHOD(NSUserNotification, setTitle, 0)
466  ADD_UNARY_METHOD(NSUserNotification, setSubtitle, 0)
467  ADD_UNARY_METHOD(NSUserNotification, setInformativeText, 0)
468  ADD_UNARY_METHOD(NSUserNotification, setActionButtonTitle, 0)
469  ADD_UNARY_METHOD(NSUserNotification, setOtherButtonTitle, 0)
470  ADD_UNARY_METHOD(NSUserNotification, setResponsePlaceholder, 0)
471 
472  NEW_RECEIVER(NSToolbarItem)
473  ADD_UNARY_METHOD(NSToolbarItem, setLabel, 0)
474  ADD_UNARY_METHOD(NSToolbarItem, setPaletteLabel, 0)
475  ADD_UNARY_METHOD(NSToolbarItem, setToolTip, 0)
476 
477  NEW_RECEIVER(NSProgress)
478  ADD_UNARY_METHOD(NSProgress, setLocalizedDescription, 0)
479  ADD_UNARY_METHOD(NSProgress, setLocalizedAdditionalDescription, 0)
480 
481  NEW_RECEIVER(NSSegmentedCell)
482  IdentifierInfo *setLabelNSSegmentedCell[] = {&Ctx.Idents.get("setLabel"),
483  &Ctx.Idents.get("forSegment")};
484  ADD_METHOD(NSSegmentedCell, setLabelNSSegmentedCell, 2, 0)
485  IdentifierInfo *setToolTipNSSegmentedCell[] = {&Ctx.Idents.get("setToolTip"),
486  &Ctx.Idents.get("forSegment")};
487  ADD_METHOD(NSSegmentedCell, setToolTipNSSegmentedCell, 2, 0)
488 
489  NEW_RECEIVER(NSUndoManager)
490  ADD_UNARY_METHOD(NSUndoManager, setActionName, 0)
491  ADD_UNARY_METHOD(NSUndoManager, undoMenuTitleForUndoActionName, 0)
492  ADD_UNARY_METHOD(NSUndoManager, redoMenuTitleForUndoActionName, 0)
493 
494  NEW_RECEIVER(NSMenuItem)
495  IdentifierInfo *initWithTitleNSMenuItem[] = {
496  &Ctx.Idents.get("initWithTitle"), &Ctx.Idents.get("action"),
497  &Ctx.Idents.get("keyEquivalent")};
498  ADD_METHOD(NSMenuItem, initWithTitleNSMenuItem, 3, 0)
499  ADD_UNARY_METHOD(NSMenuItem, setTitle, 0)
500  ADD_UNARY_METHOD(NSMenuItem, setToolTip, 0)
501 
502  NEW_RECEIVER(NSPopUpButtonCell)
503  IdentifierInfo *initTextCellNSPopUpButtonCell[] = {
504  &Ctx.Idents.get("initTextCell"), &Ctx.Idents.get("pullsDown")};
505  ADD_METHOD(NSPopUpButtonCell, initTextCellNSPopUpButtonCell, 2, 0)
506  ADD_UNARY_METHOD(NSPopUpButtonCell, addItemWithTitle, 0)
507  IdentifierInfo *insertItemWithTitleNSPopUpButtonCell[] = {
508  &Ctx.Idents.get("insertItemWithTitle"), &Ctx.Idents.get("atIndex")};
509  ADD_METHOD(NSPopUpButtonCell, insertItemWithTitleNSPopUpButtonCell, 2, 0)
510  ADD_UNARY_METHOD(NSPopUpButtonCell, removeItemWithTitle, 0)
511  ADD_UNARY_METHOD(NSPopUpButtonCell, selectItemWithTitle, 0)
512  ADD_UNARY_METHOD(NSPopUpButtonCell, setTitle, 0)
513 
514  NEW_RECEIVER(NSViewController)
515  ADD_UNARY_METHOD(NSViewController, setTitle, 0)
516 
517  NEW_RECEIVER(NSMenu)
518  ADD_UNARY_METHOD(NSMenu, initWithTitle, 0)
519  IdentifierInfo *insertItemWithTitleNSMenu[] = {
520  &Ctx.Idents.get("insertItemWithTitle"), &Ctx.Idents.get("action"),
521  &Ctx.Idents.get("keyEquivalent"), &Ctx.Idents.get("atIndex")};
522  ADD_METHOD(NSMenu, insertItemWithTitleNSMenu, 4, 0)
523  IdentifierInfo *addItemWithTitleNSMenu[] = {
524  &Ctx.Idents.get("addItemWithTitle"), &Ctx.Idents.get("action"),
525  &Ctx.Idents.get("keyEquivalent")};
526  ADD_METHOD(NSMenu, addItemWithTitleNSMenu, 3, 0)
527  ADD_UNARY_METHOD(NSMenu, setTitle, 0)
528 
529  NEW_RECEIVER(UIMutableUserNotificationAction)
530  ADD_UNARY_METHOD(UIMutableUserNotificationAction, setTitle, 0)
531 
532  NEW_RECEIVER(NSForm)
533  ADD_UNARY_METHOD(NSForm, addEntry, 0)
534  IdentifierInfo *insertEntryNSForm[] = {&Ctx.Idents.get("insertEntry"),
535  &Ctx.Idents.get("atIndex")};
536  ADD_METHOD(NSForm, insertEntryNSForm, 2, 0)
537 
538  NEW_RECEIVER(NSTextFieldCell)
539  ADD_UNARY_METHOD(NSTextFieldCell, setPlaceholderString, 0)
540 
541  NEW_RECEIVER(NSUserNotificationAction)
542  IdentifierInfo *actionWithIdentifierNSUserNotificationAction[] = {
543  &Ctx.Idents.get("actionWithIdentifier"), &Ctx.Idents.get("title")};
544  ADD_METHOD(NSUserNotificationAction,
545  actionWithIdentifierNSUserNotificationAction, 2, 1)
546 
547  NEW_RECEIVER(UITextField)
548  ADD_UNARY_METHOD(UITextField, setText, 0)
549  ADD_UNARY_METHOD(UITextField, setPlaceholder, 0)
550 
551  NEW_RECEIVER(UIBarButtonItem)
552  IdentifierInfo *initWithTitleUIBarButtonItem[] = {
553  &Ctx.Idents.get("initWithTitle"), &Ctx.Idents.get("style"),
554  &Ctx.Idents.get("target"), &Ctx.Idents.get("action")};
555  ADD_METHOD(UIBarButtonItem, initWithTitleUIBarButtonItem, 4, 0)
556 
557  NEW_RECEIVER(UIViewController)
558  ADD_UNARY_METHOD(UIViewController, setTitle, 0)
559 
560  NEW_RECEIVER(UISegmentedControl)
561  IdentifierInfo *insertSegmentWithTitleUISegmentedControl[] = {
562  &Ctx.Idents.get("insertSegmentWithTitle"), &Ctx.Idents.get("atIndex"),
563  &Ctx.Idents.get("animated")};
564  ADD_METHOD(UISegmentedControl, insertSegmentWithTitleUISegmentedControl, 3, 0)
565  IdentifierInfo *setTitleUISegmentedControl[] = {
566  &Ctx.Idents.get("setTitle"), &Ctx.Idents.get("forSegmentAtIndex")};
567  ADD_METHOD(UISegmentedControl, setTitleUISegmentedControl, 2, 0)
568 
569  NEW_RECEIVER(NSAccessibilityCustomRotorItemResult)
571  *initWithItemLoadingTokenNSAccessibilityCustomRotorItemResult[] = {
572  &Ctx.Idents.get("initWithItemLoadingToken"),
573  &Ctx.Idents.get("customLabel")};
574  ADD_METHOD(NSAccessibilityCustomRotorItemResult,
575  initWithItemLoadingTokenNSAccessibilityCustomRotorItemResult, 2, 1)
576  ADD_UNARY_METHOD(NSAccessibilityCustomRotorItemResult, setCustomLabel, 0)
577 
578  NEW_RECEIVER(UIContextualAction)
579  IdentifierInfo *contextualActionWithStyleUIContextualAction[] = {
580  &Ctx.Idents.get("contextualActionWithStyle"), &Ctx.Idents.get("title"),
581  &Ctx.Idents.get("handler")};
582  ADD_METHOD(UIContextualAction, contextualActionWithStyleUIContextualAction, 3,
583  1)
584  ADD_UNARY_METHOD(UIContextualAction, setTitle, 0)
585 
586  NEW_RECEIVER(NSAccessibilityCustomRotor)
587  IdentifierInfo *initWithLabelNSAccessibilityCustomRotor[] = {
588  &Ctx.Idents.get("initWithLabel"), &Ctx.Idents.get("itemSearchDelegate")};
589  ADD_METHOD(NSAccessibilityCustomRotor,
590  initWithLabelNSAccessibilityCustomRotor, 2, 0)
591  ADD_UNARY_METHOD(NSAccessibilityCustomRotor, setLabel, 0)
592 
593  NEW_RECEIVER(NSWindowTab)
594  ADD_UNARY_METHOD(NSWindowTab, setTitle, 0)
595  ADD_UNARY_METHOD(NSWindowTab, setToolTip, 0)
596 
597  NEW_RECEIVER(NSAccessibilityCustomAction)
598  IdentifierInfo *initWithNameNSAccessibilityCustomAction[] = {
599  &Ctx.Idents.get("initWithName"), &Ctx.Idents.get("handler")};
600  ADD_METHOD(NSAccessibilityCustomAction,
601  initWithNameNSAccessibilityCustomAction, 2, 0)
602  IdentifierInfo *initWithNameTargetNSAccessibilityCustomAction[] = {
603  &Ctx.Idents.get("initWithName"), &Ctx.Idents.get("target"),
604  &Ctx.Idents.get("selector")};
605  ADD_METHOD(NSAccessibilityCustomAction,
606  initWithNameTargetNSAccessibilityCustomAction, 3, 0)
607  ADD_UNARY_METHOD(NSAccessibilityCustomAction, setName, 0)
608 }
609 
610 #define LSF_INSERT(function_name) LSF.insert(&Ctx.Idents.get(function_name));
611 #define LSM_INSERT_NULLARY(receiver, method_name) \
612  LSM.insert({&Ctx.Idents.get(receiver), Ctx.Selectors.getNullarySelector( \
613  &Ctx.Idents.get(method_name))});
614 #define LSM_INSERT_UNARY(receiver, method_name) \
615  LSM.insert({&Ctx.Idents.get(receiver), \
616  Ctx.Selectors.getUnarySelector(&Ctx.Idents.get(method_name))});
617 #define LSM_INSERT_SELECTOR(receiver, method_list, arguments) \
618  LSM.insert({&Ctx.Idents.get(receiver), \
619  Ctx.Selectors.getSelector(arguments, method_list)});
620 
621 /// Initializes a list of methods and C functions that return a localized string
622 void NonLocalizedStringChecker::initLocStringsMethods(ASTContext &Ctx) const {
623  if (!LSM.empty())
624  return;
625 
626  IdentifierInfo *LocalizedStringMacro[] = {
627  &Ctx.Idents.get("localizedStringForKey"), &Ctx.Idents.get("value"),
628  &Ctx.Idents.get("table")};
629  LSM_INSERT_SELECTOR("NSBundle", LocalizedStringMacro, 3)
630  LSM_INSERT_UNARY("NSDateFormatter", "stringFromDate")
631  IdentifierInfo *LocalizedStringFromDate[] = {
632  &Ctx.Idents.get("localizedStringFromDate"), &Ctx.Idents.get("dateStyle"),
633  &Ctx.Idents.get("timeStyle")};
634  LSM_INSERT_SELECTOR("NSDateFormatter", LocalizedStringFromDate, 3)
635  LSM_INSERT_UNARY("NSNumberFormatter", "stringFromNumber")
636  LSM_INSERT_NULLARY("UITextField", "text")
637  LSM_INSERT_NULLARY("UITextView", "text")
638  LSM_INSERT_NULLARY("UILabel", "text")
639 
640  LSF_INSERT("CFDateFormatterCreateStringWithDate");
641  LSF_INSERT("CFDateFormatterCreateStringWithAbsoluteTime");
642  LSF_INSERT("CFNumberFormatterCreateStringWithNumber");
643 }
644 
645 /// Checks to see if the method / function declaration includes
646 /// __attribute__((annotate("returns_localized_nsstring")))
647 bool NonLocalizedStringChecker::isAnnotatedAsReturningLocalized(
648  const Decl *D) const {
649  if (!D)
650  return false;
651  return std::any_of(
652  D->specific_attr_begin<AnnotateAttr>(),
653  D->specific_attr_end<AnnotateAttr>(), [](const AnnotateAttr *Ann) {
654  return Ann->getAnnotation() == "returns_localized_nsstring";
655  });
656 }
657 
658 /// Checks to see if the method / function declaration includes
659 /// __attribute__((annotate("takes_localized_nsstring")))
660 bool NonLocalizedStringChecker::isAnnotatedAsTakingLocalized(
661  const Decl *D) const {
662  if (!D)
663  return false;
664  return std::any_of(
665  D->specific_attr_begin<AnnotateAttr>(),
666  D->specific_attr_end<AnnotateAttr>(), [](const AnnotateAttr *Ann) {
667  return Ann->getAnnotation() == "takes_localized_nsstring";
668  });
669 }
670 
671 /// Returns true if the given SVal is marked as Localized in the program state
672 bool NonLocalizedStringChecker::hasLocalizedState(SVal S,
673  CheckerContext &C) const {
674  const MemRegion *mt = S.getAsRegion();
675  if (mt) {
676  const LocalizedState *LS = C.getState()->get<LocalizedMemMap>(mt);
677  if (LS && LS->isLocalized())
678  return true;
679  }
680  return false;
681 }
682 
683 /// Returns true if the given SVal is marked as NonLocalized in the program
684 /// state
685 bool NonLocalizedStringChecker::hasNonLocalizedState(SVal S,
686  CheckerContext &C) const {
687  const MemRegion *mt = S.getAsRegion();
688  if (mt) {
689  const LocalizedState *LS = C.getState()->get<LocalizedMemMap>(mt);
690  if (LS && LS->isNonLocalized())
691  return true;
692  }
693  return false;
694 }
695 
696 /// Marks the given SVal as Localized in the program state
697 void NonLocalizedStringChecker::setLocalizedState(const SVal S,
698  CheckerContext &C) const {
699  const MemRegion *mt = S.getAsRegion();
700  if (mt) {
702  C.getState()->set<LocalizedMemMap>(mt, LocalizedState::getLocalized());
703  C.addTransition(State);
704  }
705 }
706 
707 /// Marks the given SVal as NonLocalized in the program state
708 void NonLocalizedStringChecker::setNonLocalizedState(const SVal S,
709  CheckerContext &C) const {
710  const MemRegion *mt = S.getAsRegion();
711  if (mt) {
712  ProgramStateRef State = C.getState()->set<LocalizedMemMap>(
713  mt, LocalizedState::getNonLocalized());
714  C.addTransition(State);
715  }
716 }
717 
718 
719 static bool isDebuggingName(std::string name) {
720  return StringRef(name).lower().find("debug") != StringRef::npos;
721 }
722 
723 /// Returns true when, heuristically, the analyzer may be analyzing debugging
724 /// code. We use this to suppress localization diagnostics in un-localized user
725 /// interfaces that are only used for debugging and are therefore not user
726 /// facing.
727 static bool isDebuggingContext(CheckerContext &C) {
728  const Decl *D = C.getCurrentAnalysisDeclContext()->getDecl();
729  if (!D)
730  return false;
731 
732  if (auto *ND = dyn_cast<NamedDecl>(D)) {
733  if (isDebuggingName(ND->getNameAsString()))
734  return true;
735  }
736 
737  const DeclContext *DC = D->getDeclContext();
738 
739  if (auto *CD = dyn_cast<ObjCContainerDecl>(DC)) {
740  if (isDebuggingName(CD->getNameAsString()))
741  return true;
742  }
743 
744  return false;
745 }
746 
747 
748 /// Reports a localization error for the passed in method call and SVal
749 void NonLocalizedStringChecker::reportLocalizationError(
750  SVal S, const CallEvent &M, CheckerContext &C, int argumentNumber) const {
751 
752  // Don't warn about localization errors in classes and methods that
753  // may be debug code.
754  if (isDebuggingContext(C))
755  return;
756 
757  ExplodedNode *ErrNode = C.getPredecessor();
758  static CheckerProgramPointTag Tag("NonLocalizedStringChecker",
759  "UnlocalizedString");
760  ErrNode = C.addTransition(C.getState(), C.getPredecessor(), &Tag);
761 
762  if (!ErrNode)
763  return;
764 
765  // Generate the bug report.
766  std::unique_ptr<BugReport> R(new BugReport(
767  *BT, "User-facing text should use localized string macro", ErrNode));
768  if (argumentNumber) {
769  R->addRange(M.getArgExpr(argumentNumber - 1)->getSourceRange());
770  } else {
771  R->addRange(M.getSourceRange());
772  }
773  R->markInteresting(S);
774 
775  const MemRegion *StringRegion = S.getAsRegion();
776  if (StringRegion)
777  R->addVisitor(llvm::make_unique<NonLocalizedStringBRVisitor>(StringRegion));
778 
779  C.emitReport(std::move(R));
780 }
781 
782 /// Returns the argument number requiring localized string if it exists
783 /// otherwise, returns -1
784 int NonLocalizedStringChecker::getLocalizedArgumentForSelector(
785  const IdentifierInfo *Receiver, Selector S) const {
786  auto method = UIMethods.find(Receiver);
787 
788  if (method == UIMethods.end())
789  return -1;
790 
791  auto argumentIterator = method->getSecond().find(S);
792 
793  if (argumentIterator == method->getSecond().end())
794  return -1;
795 
796  int argumentNumber = argumentIterator->getSecond();
797  return argumentNumber;
798 }
799 
800 /// Check if the string being passed in has NonLocalized state
801 void NonLocalizedStringChecker::checkPreObjCMessage(const ObjCMethodCall &msg,
802  CheckerContext &C) const {
803  initUIMethods(C.getASTContext());
804 
805  const ObjCInterfaceDecl *OD = msg.getReceiverInterface();
806  if (!OD)
807  return;
808  const IdentifierInfo *odInfo = OD->getIdentifier();
809 
810  Selector S = msg.getSelector();
811 
812  std::string SelectorString = S.getAsString();
813  StringRef SelectorName = SelectorString;
814  assert(!SelectorName.empty());
815 
816  if (odInfo->isStr("NSString")) {
817  // Handle the case where the receiver is an NSString
818  // These special NSString methods draw to the screen
819 
820  if (!(SelectorName.startswith("drawAtPoint") ||
821  SelectorName.startswith("drawInRect") ||
822  SelectorName.startswith("drawWithRect")))
823  return;
824 
825  SVal svTitle = msg.getReceiverSVal();
826 
827  bool isNonLocalized = hasNonLocalizedState(svTitle, C);
828 
829  if (isNonLocalized) {
830  reportLocalizationError(svTitle, msg, C);
831  }
832  }
833 
834  int argumentNumber = getLocalizedArgumentForSelector(odInfo, S);
835  // Go up each hierarchy of superclasses and their protocols
836  while (argumentNumber < 0 && OD->getSuperClass() != nullptr) {
837  for (const auto *P : OD->all_referenced_protocols()) {
838  argumentNumber = getLocalizedArgumentForSelector(P->getIdentifier(), S);
839  if (argumentNumber >= 0)
840  break;
841  }
842  if (argumentNumber < 0) {
843  OD = OD->getSuperClass();
844  argumentNumber = getLocalizedArgumentForSelector(OD->getIdentifier(), S);
845  }
846  }
847 
848  if (argumentNumber < 0) { // There was no match in UIMethods
849  if (const Decl *D = msg.getDecl()) {
850  if (const ObjCMethodDecl *OMD = dyn_cast_or_null<ObjCMethodDecl>(D)) {
851  auto formals = OMD->parameters();
852  for (unsigned i = 0, ei = formals.size(); i != ei; ++i) {
853  if (isAnnotatedAsTakingLocalized(formals[i])) {
854  argumentNumber = i;
855  break;
856  }
857  }
858  }
859  }
860  }
861 
862  if (argumentNumber < 0) // Still no match
863  return;
864 
865  SVal svTitle = msg.getArgSVal(argumentNumber);
866 
867  if (const ObjCStringRegion *SR =
868  dyn_cast_or_null<ObjCStringRegion>(svTitle.getAsRegion())) {
869  StringRef stringValue =
870  SR->getObjCStringLiteral()->getString()->getString();
871  if ((stringValue.trim().size() == 0 && stringValue.size() > 0) ||
872  stringValue.empty())
873  return;
874  if (!IsAggressive && llvm::sys::unicode::columnWidthUTF8(stringValue) < 2)
875  return;
876  }
877 
878  bool isNonLocalized = hasNonLocalizedState(svTitle, C);
879 
880  if (isNonLocalized) {
881  reportLocalizationError(svTitle, msg, C, argumentNumber + 1);
882  }
883 }
884 
885 void NonLocalizedStringChecker::checkPreCall(const CallEvent &Call,
886  CheckerContext &C) const {
887  const Decl *D = Call.getDecl();
888  if (D && isa<FunctionDecl>(D)) {
889  const FunctionDecl *FD = dyn_cast<FunctionDecl>(D);
890  auto formals = FD->parameters();
891  for (unsigned i = 0,
892  ei = std::min(unsigned(formals.size()), Call.getNumArgs());
893  i != ei; ++i) {
894  if (isAnnotatedAsTakingLocalized(formals[i])) {
895  auto actual = Call.getArgSVal(i);
896  if (hasNonLocalizedState(actual, C)) {
897  reportLocalizationError(actual, Call, C, i + 1);
898  }
899  }
900  }
901  }
902 }
903 
904 static inline bool isNSStringType(QualType T, ASTContext &Ctx) {
905 
907  if (!PT)
908  return false;
909 
911  if (!Cls)
912  return false;
913 
914  IdentifierInfo *ClsName = Cls->getIdentifier();
915 
916  // FIXME: Should we walk the chain of classes?
917  return ClsName == &Ctx.Idents.get("NSString") ||
918  ClsName == &Ctx.Idents.get("NSMutableString");
919 }
920 
921 /// Marks a string being returned by any call as localized
922 /// if it is in LocStringFunctions (LSF) or the function is annotated.
923 /// Otherwise, we mark it as NonLocalized (Aggressive) or
924 /// NonLocalized only if it is not backed by a SymRegion (Non-Aggressive),
925 /// basically leaving only string literals as NonLocalized.
926 void NonLocalizedStringChecker::checkPostCall(const CallEvent &Call,
927  CheckerContext &C) const {
928  initLocStringsMethods(C.getASTContext());
929 
930  if (!Call.getOriginExpr())
931  return;
932 
933  // Anything that takes in a localized NSString as an argument
934  // and returns an NSString will be assumed to be returning a
935  // localized NSString. (Counter: Incorrectly combining two LocalizedStrings)
936  const QualType RT = Call.getResultType();
937  if (isNSStringType(RT, C.getASTContext())) {
938  for (unsigned i = 0; i < Call.getNumArgs(); ++i) {
939  SVal argValue = Call.getArgSVal(i);
940  if (hasLocalizedState(argValue, C)) {
941  SVal sv = Call.getReturnValue();
942  setLocalizedState(sv, C);
943  return;
944  }
945  }
946  }
947 
948  const Decl *D = Call.getDecl();
949  if (!D)
950  return;
951 
952  const IdentifierInfo *Identifier = Call.getCalleeIdentifier();
953 
954  SVal sv = Call.getReturnValue();
955  if (isAnnotatedAsReturningLocalized(D) || LSF.count(Identifier) != 0) {
956  setLocalizedState(sv, C);
957  } else if (isNSStringType(RT, C.getASTContext()) &&
958  !hasLocalizedState(sv, C)) {
959  if (IsAggressive) {
960  setNonLocalizedState(sv, C);
961  } else {
962  const SymbolicRegion *SymReg =
963  dyn_cast_or_null<SymbolicRegion>(sv.getAsRegion());
964  if (!SymReg)
965  setNonLocalizedState(sv, C);
966  }
967  }
968 }
969 
970 /// Marks a string being returned by an ObjC method as localized
971 /// if it is in LocStringMethods or the method is annotated
972 void NonLocalizedStringChecker::checkPostObjCMessage(const ObjCMethodCall &msg,
973  CheckerContext &C) const {
974  initLocStringsMethods(C.getASTContext());
975 
976  if (!msg.isInstanceMessage())
977  return;
978 
979  const ObjCInterfaceDecl *OD = msg.getReceiverInterface();
980  if (!OD)
981  return;
982  const IdentifierInfo *odInfo = OD->getIdentifier();
983 
984  Selector S = msg.getSelector();
985  std::string SelectorName = S.getAsString();
986 
987  std::pair<const IdentifierInfo *, Selector> MethodDescription = {odInfo, S};
988 
989  if (LSM.count(MethodDescription) ||
990  isAnnotatedAsReturningLocalized(msg.getDecl())) {
991  SVal sv = msg.getReturnValue();
992  setLocalizedState(sv, C);
993  }
994 }
995 
996 /// Marks all empty string literals as localized
997 void NonLocalizedStringChecker::checkPostStmt(const ObjCStringLiteral *SL,
998  CheckerContext &C) const {
999  SVal sv = C.getSVal(SL);
1000  setNonLocalizedState(sv, C);
1001 }
1002 
1003 std::shared_ptr<PathDiagnosticPiece>
1004 NonLocalizedStringBRVisitor::VisitNode(const ExplodedNode *Succ,
1005  BugReporterContext &BRC, BugReport &BR) {
1006  if (Satisfied)
1007  return nullptr;
1008 
1009  Optional<StmtPoint> Point = Succ->getLocation().getAs<StmtPoint>();
1010  if (!Point.hasValue())
1011  return nullptr;
1012 
1013  auto *LiteralExpr = dyn_cast<ObjCStringLiteral>(Point->getStmt());
1014  if (!LiteralExpr)
1015  return nullptr;
1016 
1017  SVal LiteralSVal = Succ->getSVal(LiteralExpr);
1018  if (LiteralSVal.getAsRegion() != NonLocalizedString)
1019  return nullptr;
1020 
1021  Satisfied = true;
1022 
1023  PathDiagnosticLocation L =
1024  PathDiagnosticLocation::create(*Point, BRC.getSourceManager());
1025 
1026  if (!L.isValid() || !L.asLocation().isValid())
1027  return nullptr;
1028 
1029  auto Piece = std::make_shared<PathDiagnosticEventPiece>(
1030  L, "Non-localized string literal here");
1031  Piece->addRange(LiteralExpr->getSourceRange());
1032 
1033  return std::move(Piece);
1034 }
1035 
1036 namespace {
1037 class EmptyLocalizationContextChecker
1038  : public Checker<check::ASTDecl<ObjCImplementationDecl>> {
1039 
1040  // A helper class, which walks the AST
1041  class MethodCrawler : public ConstStmtVisitor<MethodCrawler> {
1042  const ObjCMethodDecl *MD;
1043  BugReporter &BR;
1044  AnalysisManager &Mgr;
1045  const CheckerBase *Checker;
1047 
1048  public:
1049  MethodCrawler(const ObjCMethodDecl *InMD, BugReporter &InBR,
1050  const CheckerBase *Checker, AnalysisManager &InMgr,
1051  AnalysisDeclContext *InDCtx)
1052  : MD(InMD), BR(InBR), Mgr(InMgr), Checker(Checker), DCtx(InDCtx) {}
1053 
1054  void VisitStmt(const Stmt *S) { VisitChildren(S); }
1055 
1056  void VisitObjCMessageExpr(const ObjCMessageExpr *ME);
1057 
1058  void reportEmptyContextError(const ObjCMessageExpr *M) const;
1059 
1060  void VisitChildren(const Stmt *S) {
1061  for (const Stmt *Child : S->children()) {
1062  if (Child)
1063  this->Visit(Child);
1064  }
1065  }
1066  };
1067 
1068 public:
1069  void checkASTDecl(const ObjCImplementationDecl *D, AnalysisManager &Mgr,
1070  BugReporter &BR) const;
1071 };
1072 } // end anonymous namespace
1073 
1074 void EmptyLocalizationContextChecker::checkASTDecl(
1075  const ObjCImplementationDecl *D, AnalysisManager &Mgr,
1076  BugReporter &BR) const {
1077 
1078  for (const ObjCMethodDecl *M : D->methods()) {
1079  AnalysisDeclContext *DCtx = Mgr.getAnalysisDeclContext(M);
1080 
1081  const Stmt *Body = M->getBody();
1082  assert(Body);
1083 
1084  MethodCrawler MC(M->getCanonicalDecl(), BR, this, Mgr, DCtx);
1085  MC.VisitStmt(Body);
1086  }
1087 }
1088 
1089 /// This check attempts to match these macros, assuming they are defined as
1090 /// follows:
1091 ///
1092 /// #define NSLocalizedString(key, comment) \
1093 /// [[NSBundle mainBundle] localizedStringForKey:(key) value:@"" table:nil]
1094 /// #define NSLocalizedStringFromTable(key, tbl, comment) \
1095 /// [[NSBundle mainBundle] localizedStringForKey:(key) value:@"" table:(tbl)]
1096 /// #define NSLocalizedStringFromTableInBundle(key, tbl, bundle, comment) \
1097 /// [bundle localizedStringForKey:(key) value:@"" table:(tbl)]
1098 /// #define NSLocalizedStringWithDefaultValue(key, tbl, bundle, val, comment)
1099 ///
1100 /// We cannot use the path sensitive check because the macro argument we are
1101 /// checking for (comment) is not used and thus not present in the AST,
1102 /// so we use Lexer on the original macro call and retrieve the value of
1103 /// the comment. If it's empty or nil, we raise a warning.
1104 void EmptyLocalizationContextChecker::MethodCrawler::VisitObjCMessageExpr(
1105  const ObjCMessageExpr *ME) {
1106 
1107  // FIXME: We may be able to use PPCallbacks to check for empty context
1108  // comments as part of preprocessing and avoid this re-lexing hack.
1109  const ObjCInterfaceDecl *OD = ME->getReceiverInterface();
1110  if (!OD)
1111  return;
1112 
1113  const IdentifierInfo *odInfo = OD->getIdentifier();
1114 
1115  if (!(odInfo->isStr("NSBundle") &&
1116  ME->getSelector().getAsString() ==
1117  "localizedStringForKey:value:table:")) {
1118  return;
1119  }
1120 
1121  SourceRange R = ME->getSourceRange();
1122  if (!R.getBegin().isMacroID())
1123  return;
1124 
1125  // getImmediateMacroCallerLoc gets the location of the immediate macro
1126  // caller, one level up the stack toward the initial macro typed into the
1127  // source, so SL should point to the NSLocalizedString macro.
1128  SourceLocation SL =
1129  Mgr.getSourceManager().getImmediateMacroCallerLoc(R.getBegin());
1130  std::pair<FileID, unsigned> SLInfo =
1131  Mgr.getSourceManager().getDecomposedLoc(SL);
1132 
1133  SrcMgr::SLocEntry SE = Mgr.getSourceManager().getSLocEntry(SLInfo.first);
1134 
1135  // If NSLocalizedString macro is wrapped in another macro, we need to
1136  // unwrap the expansion until we get to the NSLocalizedStringMacro.
1137  while (SE.isExpansion()) {
1138  SL = SE.getExpansion().getSpellingLoc();
1139  SLInfo = Mgr.getSourceManager().getDecomposedLoc(SL);
1140  SE = Mgr.getSourceManager().getSLocEntry(SLInfo.first);
1141  }
1142 
1143  bool Invalid = false;
1144  llvm::MemoryBuffer *BF =
1145  Mgr.getSourceManager().getBuffer(SLInfo.first, SL, &Invalid);
1146  if (Invalid)
1147  return;
1148 
1149  Lexer TheLexer(SL, LangOptions(), BF->getBufferStart(),
1150  BF->getBufferStart() + SLInfo.second, BF->getBufferEnd());
1151 
1152  Token I;
1153  Token Result; // This will hold the token just before the last ')'
1154  int p_count = 0; // This is for parenthesis matching
1155  while (!TheLexer.LexFromRawLexer(I)) {
1156  if (I.getKind() == tok::l_paren)
1157  ++p_count;
1158  if (I.getKind() == tok::r_paren) {
1159  if (p_count == 1)
1160  break;
1161  --p_count;
1162  }
1163  Result = I;
1164  }
1165 
1166  if (isAnyIdentifier(Result.getKind())) {
1167  if (Result.getRawIdentifier().equals("nil")) {
1168  reportEmptyContextError(ME);
1169  return;
1170  }
1171  }
1172 
1173  if (!isStringLiteral(Result.getKind()))
1174  return;
1175 
1176  StringRef Comment =
1177  StringRef(Result.getLiteralData(), Result.getLength()).trim('"');
1178 
1179  if ((Comment.trim().size() == 0 && Comment.size() > 0) || // Is Whitespace
1180  Comment.empty()) {
1181  reportEmptyContextError(ME);
1182  }
1183 }
1184 
1185 void EmptyLocalizationContextChecker::MethodCrawler::reportEmptyContextError(
1186  const ObjCMessageExpr *ME) const {
1187  // Generate the bug report.
1188  BR.EmitBasicReport(MD, Checker, "Context Missing",
1189  "Localizability Issue (Apple)",
1190  "Localized string macro should include a non-empty "
1191  "comment for translators",
1192  PathDiagnosticLocation(ME, BR.getSourceManager(), DCtx));
1193 }
1194 
1195 namespace {
1196 class PluralMisuseChecker : public Checker<check::ASTCodeBody> {
1197 
1198  // A helper class, which walks the AST
1199  class MethodCrawler : public RecursiveASTVisitor<MethodCrawler> {
1200  BugReporter &BR;
1201  const CheckerBase *Checker;
1202  AnalysisDeclContext *AC;
1203 
1204  // This functions like a stack. We push on any IfStmt or
1205  // ConditionalOperator that matches the condition
1206  // and pop it off when we leave that statement
1207  llvm::SmallVector<const clang::Stmt *, 8> MatchingStatements;
1208  // This is true when we are the direct-child of a
1209  // matching statement
1210  bool InMatchingStatement = false;
1211 
1212  public:
1213  explicit MethodCrawler(BugReporter &InBR, const CheckerBase *Checker,
1214  AnalysisDeclContext *InAC)
1215  : BR(InBR), Checker(Checker), AC(InAC) {}
1216 
1217  bool VisitIfStmt(const IfStmt *I);
1218  bool EndVisitIfStmt(IfStmt *I);
1219  bool TraverseIfStmt(IfStmt *x);
1220  bool VisitConditionalOperator(const ConditionalOperator *C);
1221  bool TraverseConditionalOperator(ConditionalOperator *C);
1222  bool VisitCallExpr(const CallExpr *CE);
1223  bool VisitObjCMessageExpr(const ObjCMessageExpr *ME);
1224 
1225  private:
1226  void reportPluralMisuseError(const Stmt *S) const;
1227  bool isCheckingPlurality(const Expr *E) const;
1228  };
1229 
1230 public:
1231  void checkASTCodeBody(const Decl *D, AnalysisManager &Mgr,
1232  BugReporter &BR) const {
1233  MethodCrawler Visitor(BR, this, Mgr.getAnalysisDeclContext(D));
1234  Visitor.TraverseDecl(const_cast<Decl *>(D));
1235  }
1236 };
1237 } // end anonymous namespace
1238 
1239 // Checks the condition of the IfStmt and returns true if one
1240 // of the following heuristics are met:
1241 // 1) The conidtion is a variable with "singular" or "plural" in the name
1242 // 2) The condition is a binary operator with 1 or 2 on the right-hand side
1243 bool PluralMisuseChecker::MethodCrawler::isCheckingPlurality(
1244  const Expr *Condition) const {
1245  const BinaryOperator *BO = nullptr;
1246  // Accounts for when a VarDecl represents a BinaryOperator
1247  if (const DeclRefExpr *DRE = dyn_cast<DeclRefExpr>(Condition)) {
1248  if (const VarDecl *VD = dyn_cast<VarDecl>(DRE->getDecl())) {
1249  const Expr *InitExpr = VD->getInit();
1250  if (InitExpr) {
1251  if (const BinaryOperator *B =
1252  dyn_cast<BinaryOperator>(InitExpr->IgnoreParenImpCasts())) {
1253  BO = B;
1254  }
1255  }
1256  if (VD->getName().lower().find("plural") != StringRef::npos ||
1257  VD->getName().lower().find("singular") != StringRef::npos) {
1258  return true;
1259  }
1260  }
1261  } else if (const BinaryOperator *B = dyn_cast<BinaryOperator>(Condition)) {
1262  BO = B;
1263  }
1264 
1265  if (BO == nullptr)
1266  return false;
1267 
1268  if (IntegerLiteral *IL = dyn_cast_or_null<IntegerLiteral>(
1269  BO->getRHS()->IgnoreParenImpCasts())) {
1270  llvm::APInt Value = IL->getValue();
1271  if (Value == 1 || Value == 2) {
1272  return true;
1273  }
1274  }
1275  return false;
1276 }
1277 
1278 // A CallExpr with "LOC" in its identifier that takes in a string literal
1279 // has been shown to almost always be a function that returns a localized
1280 // string. Raise a diagnostic when this is in a statement that matches
1281 // the condition.
1282 bool PluralMisuseChecker::MethodCrawler::VisitCallExpr(const CallExpr *CE) {
1283  if (InMatchingStatement) {
1284  if (const FunctionDecl *FD = CE->getDirectCallee()) {
1285  std::string NormalizedName =
1286  StringRef(FD->getNameInfo().getAsString()).lower();
1287  if (NormalizedName.find("loc") != std::string::npos) {
1288  for (const Expr *Arg : CE->arguments()) {
1289  if (isa<ObjCStringLiteral>(Arg))
1290  reportPluralMisuseError(CE);
1291  }
1292  }
1293  }
1294  }
1295  return true;
1296 }
1297 
1298 // The other case is for NSLocalizedString which also returns
1299 // a localized string. It's a macro for the ObjCMessageExpr
1300 // [NSBundle localizedStringForKey:value:table:] Raise a
1301 // diagnostic when this is in a statement that matches
1302 // the condition.
1303 bool PluralMisuseChecker::MethodCrawler::VisitObjCMessageExpr(
1304  const ObjCMessageExpr *ME) {
1305  const ObjCInterfaceDecl *OD = ME->getReceiverInterface();
1306  if (!OD)
1307  return true;
1308 
1309  const IdentifierInfo *odInfo = OD->getIdentifier();
1310 
1311  if (odInfo->isStr("NSBundle") &&
1312  ME->getSelector().getAsString() == "localizedStringForKey:value:table:") {
1313  if (InMatchingStatement) {
1314  reportPluralMisuseError(ME);
1315  }
1316  }
1317  return true;
1318 }
1319 
1320 /// Override TraverseIfStmt so we know when we are done traversing an IfStmt
1321 bool PluralMisuseChecker::MethodCrawler::TraverseIfStmt(IfStmt *I) {
1323  return EndVisitIfStmt(I);
1324 }
1325 
1326 // EndVisit callbacks are not provided by the RecursiveASTVisitor
1327 // so we override TraverseIfStmt and make a call to EndVisitIfStmt
1328 // after traversing the IfStmt
1329 bool PluralMisuseChecker::MethodCrawler::EndVisitIfStmt(IfStmt *I) {
1330  MatchingStatements.pop_back();
1331  if (!MatchingStatements.empty()) {
1332  if (MatchingStatements.back() != nullptr) {
1333  InMatchingStatement = true;
1334  return true;
1335  }
1336  }
1337  InMatchingStatement = false;
1338  return true;
1339 }
1340 
1341 bool PluralMisuseChecker::MethodCrawler::VisitIfStmt(const IfStmt *I) {
1342  const Expr *Condition = I->getCond()->IgnoreParenImpCasts();
1343  if (isCheckingPlurality(Condition)) {
1344  MatchingStatements.push_back(I);
1345  InMatchingStatement = true;
1346  } else {
1347  MatchingStatements.push_back(nullptr);
1348  InMatchingStatement = false;
1349  }
1350 
1351  return true;
1352 }
1353 
1354 // Preliminary support for conditional operators.
1355 bool PluralMisuseChecker::MethodCrawler::TraverseConditionalOperator(
1356  ConditionalOperator *C) {
1358  MatchingStatements.pop_back();
1359  if (!MatchingStatements.empty()) {
1360  if (MatchingStatements.back() != nullptr)
1361  InMatchingStatement = true;
1362  else
1363  InMatchingStatement = false;
1364  } else {
1365  InMatchingStatement = false;
1366  }
1367  return true;
1368 }
1369 
1370 bool PluralMisuseChecker::MethodCrawler::VisitConditionalOperator(
1371  const ConditionalOperator *C) {
1372  const Expr *Condition = C->getCond()->IgnoreParenImpCasts();
1373  if (isCheckingPlurality(Condition)) {
1374  MatchingStatements.push_back(C);
1375  InMatchingStatement = true;
1376  } else {
1377  MatchingStatements.push_back(nullptr);
1378  InMatchingStatement = false;
1379  }
1380  return true;
1381 }
1382 
1383 void PluralMisuseChecker::MethodCrawler::reportPluralMisuseError(
1384  const Stmt *S) const {
1385  // Generate the bug report.
1386  BR.EmitBasicReport(AC->getDecl(), Checker, "Plural Misuse",
1387  "Localizability Issue (Apple)",
1388  "Plural cases are not supported across all languages. "
1389  "Use a .stringsdict file instead",
1390  PathDiagnosticLocation(S, BR.getSourceManager(), AC));
1391 }
1392 
1393 //===----------------------------------------------------------------------===//
1394 // Checker registration.
1395 //===----------------------------------------------------------------------===//
1396 
1397 void ento::registerNonLocalizedStringChecker(CheckerManager &mgr) {
1398  NonLocalizedStringChecker *checker =
1399  mgr.registerChecker<NonLocalizedStringChecker>();
1400  checker->IsAggressive =
1401  mgr.getAnalyzerOptions().getCheckerBooleanOption("AggressiveReport",
1402  false, checker);
1403 }
1404 
1405 void ento::registerEmptyLocalizationContextChecker(CheckerManager &mgr) {
1406  mgr.registerChecker<EmptyLocalizationContextChecker>();
1407 }
1408 
1409 void ento::registerPluralMisuseChecker(CheckerManager &mgr) {
1410  mgr.registerChecker<PluralMisuseChecker>();
1411 }
SVal getReceiverSVal() const
Returns the value of the receiver at the time of this call.
Definition: CallEvent.cpp:960
#define NEW_RECEIVER(receiver)
Represents a function declaration or definition.
Definition: Decl.h:1739
StringRef Identifier
Definition: Format.cpp:1636
Lexer - This provides a simple interface that turns a text buffer into a stream of tokens...
Definition: Lexer.h:77
Smart pointer class that efficiently represents Objective-C method names.
This is a discriminated union of FileInfo and ExpansionInfo.
A (possibly-)qualified type.
Definition: Type.h:642
Selector getSelector() const
Definition: ExprObjC.cpp:312
SourceLocation getSpellingLoc() const
bool operator==(CanQual< T > x, CanQual< U > y)
ConstStmtVisitor - This class implements a simple visitor for Stmt subclasses.
Definition: StmtVisitor.h:193
specific_attr_iterator< T > specific_attr_begin() const
Definition: DeclBase.h:518
Stmt - This represents one statement.
Definition: Stmt.h:66
#define ADD_METHOD(receiver, method_list, count, argument)
IfStmt - This represents an if/then/else.
Definition: Stmt.h:1467
ObjCInterfaceDecl * getReceiverInterface() const
Retrieve the Objective-C interface to which this message is being directed, if known.
Definition: ExprObjC.cpp:333
Decl - This represents one declaration (or definition), e.g.
Definition: DeclBase.h:87
IntrusiveRefCntPtr< const ProgramState > ProgramStateRef
StringRef P
REGISTER_MAP_WITH_PROGRAMSTATE(LocalizedMemMap, const MemRegion *, LocalizedState) NonLocalizedStringChecker
static bool isDebuggingName(std::string name)
static bool isDebuggingContext(CheckerContext &C)
Returns true when, heuristically, the analyzer may be analyzing debugging code.
Represents a variable declaration or definition.
Definition: Decl.h:812
const T * getAs() const
Member-template getAs<specific type>&#39;.
Definition: Type.h:6716
bool isStringLiteral(TokenKind K)
Return true if this is a C or C++ string-literal (or C++11 user-defined-string-literal) token...
Definition: TokenKinds.h:78
ObjCMethodDecl - Represents an instance or class method declaration.
Definition: DeclObjC.h:139
tok::TokenKind getKind() const
Definition: Token.h:90
IdentifierInfo * getIdentifier() const
Get the identifier that names this declaration, if there is one.
Definition: Decl.h:269
One of these records is kept for each identifier that is lexed.
bool isStr(const char(&Str)[StrLen]) const
Return true if this is the identifier for the specified string.
Holds long-lived AST nodes (such as types and decls) that can be referred to throughout the semantic ...
Definition: ASTContext.h:154
LineState State
AnalysisDeclContext contains the context data for the function or method under analysis.
method_range methods() const
Definition: DeclObjC.h:1029
const ObjCInterfaceDecl * getReceiverInterface() const
Get the interface for the receiver.
Definition: CallEvent.h:1034
Token - This structure provides full information about a lexed token.
Definition: Token.h:35
specific_attr_iterator< T > specific_attr_end() const
Definition: DeclBase.h:523
Keeps track of the various options that can be enabled, which controls the dialect of C or C++ that i...
Definition: LangOptions.h:50
IdentifierTable & Idents
Definition: ASTContext.h:565
ArrayRef< ParmVarDecl * > parameters() const
Definition: Decl.h:2263
Represents any expression that calls an Objective-C method.
Definition: CallEvent.h:970
child_range children()
Definition: Stmt.cpp:237
A builtin binary operation expression such as "x + y" or "x <= y".
Definition: Expr.h:3233
ObjCStringLiteral, used for Objective-C string literals i.e.
Definition: ExprObjC.h:51
static PathDiagnosticLocation create(const Decl *D, const SourceManager &SM)
Create a location corresponding to the given declaration.
A class that does preorder or postorder depth-first traversal on the entire Clang AST and visits each...
Represents an ObjC class declaration.
Definition: DeclObjC.h:1164
ObjCInterfaceDecl * getInterface() const
Gets the interface declaration for this object type, if the base type really is an interface...
Definition: Type.h:5759
ConditionalOperator - The ?: ternary operator.
Definition: Expr.h:3528
#define LSM_INSERT_NULLARY(receiver, method_name)
Expr * getCond() const
Definition: Expr.h:3562
This represents one expression.
Definition: Expr.h:106
DeclContext * getDeclContext()
Definition: DeclBase.h:427
llvm::PointerUnion< const LocationContext *, AnalysisDeclContext * > LocationOrAnalysisDeclContext
An expression that sends a message to the given Objective-C object or class.
Definition: ExprObjC.h:904
Expr * getCond()
Definition: Stmt.h:1542
const ExpansionInfo & getExpansion() const
#define ADD_UNARY_METHOD(receiver, method, argument)
std::string getAsString() const
Derive the full selector name (e.g.
Kind
static bool isNSStringType(QualType T, ASTContext &Ctx)
Encodes a location in the source.
IdentifierInfo & get(StringRef Name)
Return the identifier token info for the specified named identifier.
#define LSF_INSERT(function_name)
arg_range arguments()
Definition: Expr.h:2513
const ObjCMethodDecl * getDecl() const override
Definition: CallEvent.h:998
Selector getSelector() const
Definition: CallEvent.h:1018
Dataflow Directional Tag Classes.
DeclContext - This is used only as base class of specific decl types that can act as declaration cont...
Definition: DeclBase.h:1262
FunctionDecl * getDirectCallee()
If the callee is a FunctionDecl, return it. Otherwise return 0.
Definition: Expr.cpp:1283
const ObjCObjectType * getObjectType() const
Gets the type pointed to by this ObjC pointer.
Definition: Type.h:5821
unsigned getLength() const
Definition: Token.h:127
Expr * IgnoreParenImpCasts() LLVM_READONLY
IgnoreParenImpCasts - Ignore parentheses and implicit casts.
Definition: Expr.cpp:2652
Represents a pointer to an Objective C object.
Definition: Type.h:5780
bool isInstanceMessage() const
Definition: CallEvent.h:1010
const char * getLiteralData() const
getLiteralData - For a literal token (numeric constant, string, etc), this returns a pointer to the s...
Definition: Token.h:215
ObjCImplementationDecl - Represents a class definition - this is where method definitions are specifi...
Definition: DeclObjC.h:2544
X
Add a minimal nested name specifier fixit hint to allow lookup of a tag name from an outer enclosing ...
Definition: SemaDecl.cpp:13956
#define LSM_INSERT_UNARY(receiver, method_name)
StringRef getRawIdentifier() const
getRawIdentifier - For a raw identifier token (i.e., an identifier lexed in raw mode), returns a reference to the text substring in the buffer if known.
Definition: Token.h:203
SourceRange getSourceRange() const LLVM_READONLY
SourceLocation tokens are not useful in isolation - they are low level value objects created/interpre...
Definition: Stmt.cpp:276
CallExpr - Represents a function call (C99 6.5.2.2, C++ [expr.call]).
Definition: Expr.h:2407
A reference to a declared variable, function, enum, etc.
Definition: Expr.h:1042
Expr * getRHS() const
Definition: Expr.h:3275
__DEVICE__ int min(int __a, int __b)
#define LSM_INSERT_SELECTOR(receiver, method_list, arguments)
A trivial tuple used to represent a source range.
SourceLocation getBegin() const
bool isAnyIdentifier(TokenKind K)
Return true if this is a raw identifier or an identifier kind.
Definition: TokenKinds.h:72