CheckObjCInstMethSignature.cpp revision 07189521a15d9c088216b943649cb9fe231cbb57 
1//=- CheckObjCInstMethodRetTy.cpp - Check ObjC method signatures -*- 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 CheckObjCInstMethSignature, a flow-insenstive check
11//  that determines if an Objective-C class interface incorrectly redefines
12//  the method signature in a subclass.
13//
14//===----------------------------------------------------------------------===//
15
16#include "ClangSACheckers.h"
17#include "clang/StaticAnalyzer/Core/Checker.h"
18#include "clang/StaticAnalyzer/Core/BugReporter/PathDiagnostic.h"
19#include "clang/StaticAnalyzer/Core/BugReporter/BugReporter.h"
20#include "clang/AST/DeclObjC.h"
21#include "clang/AST/Type.h"
22#include "clang/AST/ASTContext.h"
23
24#include "llvm/ADT/DenseMap.h"
25#include "llvm/Support/raw_ostream.h"
26
27using namespace clang;
28using namespace ento;
29
30static bool AreTypesCompatible(QualType Derived, QualType Ancestor,
31                               ASTContext &C) {
32
33  // Right now don't compare the compatibility of pointers.  That involves
34  // looking at subtyping relationships.  FIXME: Future patch.
35  if (Derived->isAnyPointerType() &&  Ancestor->isAnyPointerType())
36    return true;
37
38  return C.typesAreCompatible(Derived, Ancestor);
39}
40
41static void CompareReturnTypes(const ObjCMethodDecl *MethDerived,
42                               const ObjCMethodDecl *MethAncestor,
43                               BugReporter &BR, ASTContext &Ctx,
44                               const ObjCImplementationDecl *ID) {
45
46  QualType ResDerived  = MethDerived->getResultType();
47  QualType ResAncestor = MethAncestor->getResultType();
48
49  if (!AreTypesCompatible(ResDerived, ResAncestor, Ctx)) {
50    std::string sbuf;
51    llvm::raw_string_ostream os(sbuf);
52
53    os << "The Objective-C class '"
54       << *MethDerived->getClassInterface()
55       << "', which is derived from class '"
56       << *MethAncestor->getClassInterface()
57       << "', defines the instance method '"
58       << MethDerived->getSelector().getAsString()
59       << "' whose return type is '"
60       << ResDerived.getAsString()
61       << "'.  A method with the same name (same selector) is also defined in "
62          "class '"
63       << *MethAncestor->getClassInterface()
64       << "' and has a return type of '"
65       << ResAncestor.getAsString()
66       << "'.  These two types are incompatible, and may result in undefined "
67          "behavior for clients of these classes.";
68
69    PathDiagnosticLocation MethDLoc =
70      PathDiagnosticLocation::createBegin(MethDerived,
71                                          BR.getSourceManager());
72
73    BR.EmitBasicReport(MethDerived,
74                       "Incompatible instance method return type",
75                       os.str(), MethDLoc);
76  }
77}
78
79static void CheckObjCInstMethSignature(const ObjCImplementationDecl *ID,
80                                       BugReporter& BR) {
81
82  const ObjCInterfaceDecl *D = ID->getClassInterface();
83  const ObjCInterfaceDecl *C = D->getSuperClass();
84
85  if (!C)
86    return;
87
88  ASTContext &Ctx = BR.getContext();
89
90  // Build a DenseMap of the methods for quick querying.
91  typedef llvm::DenseMap<Selector,ObjCMethodDecl*> MapTy;
92  MapTy IMeths;
93  unsigned NumMethods = 0;
94
95  for (ObjCImplementationDecl::instmeth_iterator I=ID->instmeth_begin(),
96       E=ID->instmeth_end(); I!=E; ++I) {
97
98    ObjCMethodDecl *M = *I;
99    IMeths[M->getSelector()] = M;
100    ++NumMethods;
101  }
102
103  // Now recurse the class hierarchy chain looking for methods with the
104  // same signatures.
105  while (C && NumMethods) {
106    for (ObjCInterfaceDecl::instmeth_iterator I=C->instmeth_begin(),
107         E=C->instmeth_end(); I!=E; ++I) {
108
109      ObjCMethodDecl *M = *I;
110      Selector S = M->getSelector();
111
112      MapTy::iterator MI = IMeths.find(S);
113
114      if (MI == IMeths.end() || MI->second == 0)
115        continue;
116
117      --NumMethods;
118      ObjCMethodDecl *MethDerived = MI->second;
119      MI->second = 0;
120
121      CompareReturnTypes(MethDerived, M, BR, Ctx, ID);
122    }
123
124    C = C->getSuperClass();
125  }
126}
127
128//===----------------------------------------------------------------------===//
129// ObjCMethSigsChecker
130//===----------------------------------------------------------------------===//
131
132namespace {
133class ObjCMethSigsChecker : public Checker<
134                                      check::ASTDecl<ObjCImplementationDecl> > {
135public:
136  void checkASTDecl(const ObjCImplementationDecl *D, AnalysisManager& mgr,
137                    BugReporter &BR) const {
138    CheckObjCInstMethSignature(D, BR);
139  }
140};
141}
142
143void ento::registerObjCMethSigsChecker(CheckerManager &mgr) {
144  mgr.registerChecker<ObjCMethSigsChecker>();
145}
146