467 lines
16 KiB
C++
467 lines
16 KiB
C++
|
//===--- TransUnbridgedCasts.cpp - Transformations to ARC mode ------------===//
|
||
|
//
|
||
|
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
|
||
|
// See https://llvm.org/LICENSE.txt for license information.
|
||
|
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
||
|
//
|
||
|
//===----------------------------------------------------------------------===//
|
||
|
//
|
||
|
// rewriteUnbridgedCasts:
|
||
|
//
|
||
|
// A cast of non-objc pointer to an objc one is checked. If the non-objc pointer
|
||
|
// is from a file-level variable, __bridge cast is used to convert it.
|
||
|
// For the result of a function call that we know is +1/+0,
|
||
|
// __bridge/CFBridgingRelease is used.
|
||
|
//
|
||
|
// NSString *str = (NSString *)kUTTypePlainText;
|
||
|
// str = b ? kUTTypeRTF : kUTTypePlainText;
|
||
|
// NSString *_uuidString = (NSString *)CFUUIDCreateString(kCFAllocatorDefault,
|
||
|
// _uuid);
|
||
|
// ---->
|
||
|
// NSString *str = (__bridge NSString *)kUTTypePlainText;
|
||
|
// str = (__bridge NSString *)(b ? kUTTypeRTF : kUTTypePlainText);
|
||
|
// NSString *_uuidString = (NSString *)
|
||
|
// CFBridgingRelease(CFUUIDCreateString(kCFAllocatorDefault, _uuid));
|
||
|
//
|
||
|
// For a C pointer to ObjC, for casting 'self', __bridge is used.
|
||
|
//
|
||
|
// CFStringRef str = (CFStringRef)self;
|
||
|
// ---->
|
||
|
// CFStringRef str = (__bridge CFStringRef)self;
|
||
|
//
|
||
|
// Uses of Block_copy/Block_release macros are rewritten:
|
||
|
//
|
||
|
// c = Block_copy(b);
|
||
|
// Block_release(c);
|
||
|
// ---->
|
||
|
// c = [b copy];
|
||
|
// <removed>
|
||
|
//
|
||
|
//===----------------------------------------------------------------------===//
|
||
|
|
||
|
#include "Transforms.h"
|
||
|
#include "Internals.h"
|
||
|
#include "clang/AST/ASTContext.h"
|
||
|
#include "clang/AST/Attr.h"
|
||
|
#include "clang/AST/ParentMap.h"
|
||
|
#include "clang/Analysis/DomainSpecific/CocoaConventions.h"
|
||
|
#include "clang/Basic/SourceManager.h"
|
||
|
#include "clang/Lex/Lexer.h"
|
||
|
#include "clang/Sema/SemaDiagnostic.h"
|
||
|
#include "llvm/ADT/SmallString.h"
|
||
|
|
||
|
using namespace clang;
|
||
|
using namespace arcmt;
|
||
|
using namespace trans;
|
||
|
|
||
|
namespace {
|
||
|
|
||
|
class UnbridgedCastRewriter : public RecursiveASTVisitor<UnbridgedCastRewriter>{
|
||
|
MigrationPass &Pass;
|
||
|
IdentifierInfo *SelfII;
|
||
|
std::unique_ptr<ParentMap> StmtMap;
|
||
|
Decl *ParentD;
|
||
|
Stmt *Body;
|
||
|
mutable std::unique_ptr<ExprSet> Removables;
|
||
|
|
||
|
public:
|
||
|
UnbridgedCastRewriter(MigrationPass &pass)
|
||
|
: Pass(pass), ParentD(nullptr), Body(nullptr) {
|
||
|
SelfII = &Pass.Ctx.Idents.get("self");
|
||
|
}
|
||
|
|
||
|
void transformBody(Stmt *body, Decl *ParentD) {
|
||
|
this->ParentD = ParentD;
|
||
|
Body = body;
|
||
|
StmtMap.reset(new ParentMap(body));
|
||
|
TraverseStmt(body);
|
||
|
}
|
||
|
|
||
|
bool TraverseBlockDecl(BlockDecl *D) {
|
||
|
// ParentMap does not enter into a BlockDecl to record its stmts, so use a
|
||
|
// new UnbridgedCastRewriter to handle the block.
|
||
|
UnbridgedCastRewriter(Pass).transformBody(D->getBody(), D);
|
||
|
return true;
|
||
|
}
|
||
|
|
||
|
bool VisitCastExpr(CastExpr *E) {
|
||
|
if (E->getCastKind() != CK_CPointerToObjCPointerCast &&
|
||
|
E->getCastKind() != CK_BitCast &&
|
||
|
E->getCastKind() != CK_AnyPointerToBlockPointerCast)
|
||
|
return true;
|
||
|
|
||
|
QualType castType = E->getType();
|
||
|
Expr *castExpr = E->getSubExpr();
|
||
|
QualType castExprType = castExpr->getType();
|
||
|
|
||
|
if (castType->isObjCRetainableType() == castExprType->isObjCRetainableType())
|
||
|
return true;
|
||
|
|
||
|
bool exprRetainable = castExprType->isObjCIndirectLifetimeType();
|
||
|
bool castRetainable = castType->isObjCIndirectLifetimeType();
|
||
|
if (exprRetainable == castRetainable) return true;
|
||
|
|
||
|
if (castExpr->isNullPointerConstant(Pass.Ctx,
|
||
|
Expr::NPC_ValueDependentIsNull))
|
||
|
return true;
|
||
|
|
||
|
SourceLocation loc = castExpr->getExprLoc();
|
||
|
if (loc.isValid() && Pass.Ctx.getSourceManager().isInSystemHeader(loc))
|
||
|
return true;
|
||
|
|
||
|
if (castType->isObjCRetainableType())
|
||
|
transformNonObjCToObjCCast(E);
|
||
|
else
|
||
|
transformObjCToNonObjCCast(E);
|
||
|
|
||
|
return true;
|
||
|
}
|
||
|
|
||
|
private:
|
||
|
void transformNonObjCToObjCCast(CastExpr *E) {
|
||
|
if (!E) return;
|
||
|
|
||
|
// Global vars are assumed that are cast as unretained.
|
||
|
if (isGlobalVar(E))
|
||
|
if (E->getSubExpr()->getType()->isPointerType()) {
|
||
|
castToObjCObject(E, /*retained=*/false);
|
||
|
return;
|
||
|
}
|
||
|
|
||
|
// If the cast is directly over the result of a Core Foundation function
|
||
|
// try to figure out whether it should be cast as retained or unretained.
|
||
|
Expr *inner = E->IgnoreParenCasts();
|
||
|
if (CallExpr *callE = dyn_cast<CallExpr>(inner)) {
|
||
|
if (FunctionDecl *FD = callE->getDirectCallee()) {
|
||
|
if (FD->hasAttr<CFReturnsRetainedAttr>()) {
|
||
|
castToObjCObject(E, /*retained=*/true);
|
||
|
return;
|
||
|
}
|
||
|
if (FD->hasAttr<CFReturnsNotRetainedAttr>()) {
|
||
|
castToObjCObject(E, /*retained=*/false);
|
||
|
return;
|
||
|
}
|
||
|
if (FD->isGlobal() &&
|
||
|
FD->getIdentifier() &&
|
||
|
ento::cocoa::isRefType(E->getSubExpr()->getType(), "CF",
|
||
|
FD->getIdentifier()->getName())) {
|
||
|
StringRef fname = FD->getIdentifier()->getName();
|
||
|
if (fname.endswith("Retain") ||
|
||
|
fname.find("Create") != StringRef::npos ||
|
||
|
fname.find("Copy") != StringRef::npos) {
|
||
|
// Do not migrate to couple of bridge transfer casts which
|
||
|
// cancel each other out. Leave it unchanged so error gets user
|
||
|
// attention instead.
|
||
|
if (FD->getName() == "CFRetain" &&
|
||
|
FD->getNumParams() == 1 &&
|
||
|
FD->getParent()->isTranslationUnit() &&
|
||
|
FD->isExternallyVisible()) {
|
||
|
Expr *Arg = callE->getArg(0);
|
||
|
if (const ImplicitCastExpr *ICE = dyn_cast<ImplicitCastExpr>(Arg)) {
|
||
|
const Expr *sub = ICE->getSubExpr();
|
||
|
QualType T = sub->getType();
|
||
|
if (T->isObjCObjectPointerType())
|
||
|
return;
|
||
|
}
|
||
|
}
|
||
|
castToObjCObject(E, /*retained=*/true);
|
||
|
return;
|
||
|
}
|
||
|
|
||
|
if (fname.find("Get") != StringRef::npos) {
|
||
|
castToObjCObject(E, /*retained=*/false);
|
||
|
return;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
|
||
|
// If returning an ivar or a member of an ivar from a +0 method, use
|
||
|
// a __bridge cast.
|
||
|
Expr *base = inner->IgnoreParenImpCasts();
|
||
|
while (isa<MemberExpr>(base))
|
||
|
base = cast<MemberExpr>(base)->getBase()->IgnoreParenImpCasts();
|
||
|
if (isa<ObjCIvarRefExpr>(base) &&
|
||
|
isa<ReturnStmt>(StmtMap->getParentIgnoreParenCasts(E))) {
|
||
|
if (ObjCMethodDecl *method = dyn_cast_or_null<ObjCMethodDecl>(ParentD)) {
|
||
|
if (!method->hasAttr<NSReturnsRetainedAttr>()) {
|
||
|
castToObjCObject(E, /*retained=*/false);
|
||
|
return;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
|
||
|
void castToObjCObject(CastExpr *E, bool retained) {
|
||
|
rewriteToBridgedCast(E, retained ? OBC_BridgeTransfer : OBC_Bridge);
|
||
|
}
|
||
|
|
||
|
void rewriteToBridgedCast(CastExpr *E, ObjCBridgeCastKind Kind) {
|
||
|
Transaction Trans(Pass.TA);
|
||
|
rewriteToBridgedCast(E, Kind, Trans);
|
||
|
}
|
||
|
|
||
|
void rewriteToBridgedCast(CastExpr *E, ObjCBridgeCastKind Kind,
|
||
|
Transaction &Trans) {
|
||
|
TransformActions &TA = Pass.TA;
|
||
|
|
||
|
// We will remove the compiler diagnostic.
|
||
|
if (!TA.hasDiagnostic(diag::err_arc_mismatched_cast,
|
||
|
diag::err_arc_cast_requires_bridge,
|
||
|
E->getBeginLoc())) {
|
||
|
Trans.abort();
|
||
|
return;
|
||
|
}
|
||
|
|
||
|
StringRef bridge;
|
||
|
switch(Kind) {
|
||
|
case OBC_Bridge:
|
||
|
bridge = "__bridge "; break;
|
||
|
case OBC_BridgeTransfer:
|
||
|
bridge = "__bridge_transfer "; break;
|
||
|
case OBC_BridgeRetained:
|
||
|
bridge = "__bridge_retained "; break;
|
||
|
}
|
||
|
|
||
|
TA.clearDiagnostic(diag::err_arc_mismatched_cast,
|
||
|
diag::err_arc_cast_requires_bridge, E->getBeginLoc());
|
||
|
if (Kind == OBC_Bridge || !Pass.CFBridgingFunctionsDefined()) {
|
||
|
if (CStyleCastExpr *CCE = dyn_cast<CStyleCastExpr>(E)) {
|
||
|
TA.insertAfterToken(CCE->getLParenLoc(), bridge);
|
||
|
} else {
|
||
|
SourceLocation insertLoc = E->getSubExpr()->getBeginLoc();
|
||
|
SmallString<128> newCast;
|
||
|
newCast += '(';
|
||
|
newCast += bridge;
|
||
|
newCast += E->getType().getAsString(Pass.Ctx.getPrintingPolicy());
|
||
|
newCast += ')';
|
||
|
|
||
|
if (isa<ParenExpr>(E->getSubExpr())) {
|
||
|
TA.insert(insertLoc, newCast.str());
|
||
|
} else {
|
||
|
newCast += '(';
|
||
|
TA.insert(insertLoc, newCast.str());
|
||
|
TA.insertAfterToken(E->getEndLoc(), ")");
|
||
|
}
|
||
|
}
|
||
|
} else {
|
||
|
assert(Kind == OBC_BridgeTransfer || Kind == OBC_BridgeRetained);
|
||
|
SmallString<32> BridgeCall;
|
||
|
|
||
|
Expr *WrapE = E->getSubExpr();
|
||
|
SourceLocation InsertLoc = WrapE->getBeginLoc();
|
||
|
|
||
|
SourceManager &SM = Pass.Ctx.getSourceManager();
|
||
|
char PrevChar = *SM.getCharacterData(InsertLoc.getLocWithOffset(-1));
|
||
|
if (Lexer::isIdentifierBodyChar(PrevChar, Pass.Ctx.getLangOpts()))
|
||
|
BridgeCall += ' ';
|
||
|
|
||
|
if (Kind == OBC_BridgeTransfer)
|
||
|
BridgeCall += "CFBridgingRelease";
|
||
|
else
|
||
|
BridgeCall += "CFBridgingRetain";
|
||
|
|
||
|
if (isa<ParenExpr>(WrapE)) {
|
||
|
TA.insert(InsertLoc, BridgeCall);
|
||
|
} else {
|
||
|
BridgeCall += '(';
|
||
|
TA.insert(InsertLoc, BridgeCall);
|
||
|
TA.insertAfterToken(WrapE->getEndLoc(), ")");
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
|
||
|
void rewriteCastForCFRetain(CastExpr *castE, CallExpr *callE) {
|
||
|
Transaction Trans(Pass.TA);
|
||
|
Pass.TA.replace(callE->getSourceRange(), callE->getArg(0)->getSourceRange());
|
||
|
rewriteToBridgedCast(castE, OBC_BridgeRetained, Trans);
|
||
|
}
|
||
|
|
||
|
void getBlockMacroRanges(CastExpr *E, SourceRange &Outer, SourceRange &Inner) {
|
||
|
SourceManager &SM = Pass.Ctx.getSourceManager();
|
||
|
SourceLocation Loc = E->getExprLoc();
|
||
|
assert(Loc.isMacroID());
|
||
|
CharSourceRange MacroRange = SM.getImmediateExpansionRange(Loc);
|
||
|
SourceRange SubRange = E->getSubExpr()->IgnoreParenImpCasts()->getSourceRange();
|
||
|
SourceLocation InnerBegin = SM.getImmediateMacroCallerLoc(SubRange.getBegin());
|
||
|
SourceLocation InnerEnd = SM.getImmediateMacroCallerLoc(SubRange.getEnd());
|
||
|
|
||
|
Outer = MacroRange.getAsRange();
|
||
|
Inner = SourceRange(InnerBegin, InnerEnd);
|
||
|
}
|
||
|
|
||
|
void rewriteBlockCopyMacro(CastExpr *E) {
|
||
|
SourceRange OuterRange, InnerRange;
|
||
|
getBlockMacroRanges(E, OuterRange, InnerRange);
|
||
|
|
||
|
Transaction Trans(Pass.TA);
|
||
|
Pass.TA.replace(OuterRange, InnerRange);
|
||
|
Pass.TA.insert(InnerRange.getBegin(), "[");
|
||
|
Pass.TA.insertAfterToken(InnerRange.getEnd(), " copy]");
|
||
|
Pass.TA.clearDiagnostic(diag::err_arc_mismatched_cast,
|
||
|
diag::err_arc_cast_requires_bridge,
|
||
|
OuterRange);
|
||
|
}
|
||
|
|
||
|
void removeBlockReleaseMacro(CastExpr *E) {
|
||
|
SourceRange OuterRange, InnerRange;
|
||
|
getBlockMacroRanges(E, OuterRange, InnerRange);
|
||
|
|
||
|
Transaction Trans(Pass.TA);
|
||
|
Pass.TA.clearDiagnostic(diag::err_arc_mismatched_cast,
|
||
|
diag::err_arc_cast_requires_bridge,
|
||
|
OuterRange);
|
||
|
if (!hasSideEffects(E, Pass.Ctx)) {
|
||
|
if (tryRemoving(cast<Expr>(StmtMap->getParentIgnoreParenCasts(E))))
|
||
|
return;
|
||
|
}
|
||
|
Pass.TA.replace(OuterRange, InnerRange);
|
||
|
}
|
||
|
|
||
|
bool tryRemoving(Expr *E) const {
|
||
|
if (!Removables) {
|
||
|
Removables.reset(new ExprSet);
|
||
|
collectRemovables(Body, *Removables);
|
||
|
}
|
||
|
|
||
|
if (Removables->count(E)) {
|
||
|
Pass.TA.removeStmt(E);
|
||
|
return true;
|
||
|
}
|
||
|
|
||
|
return false;
|
||
|
}
|
||
|
|
||
|
void transformObjCToNonObjCCast(CastExpr *E) {
|
||
|
SourceLocation CastLoc = E->getExprLoc();
|
||
|
if (CastLoc.isMacroID()) {
|
||
|
StringRef MacroName = Lexer::getImmediateMacroName(CastLoc,
|
||
|
Pass.Ctx.getSourceManager(),
|
||
|
Pass.Ctx.getLangOpts());
|
||
|
if (MacroName == "Block_copy") {
|
||
|
rewriteBlockCopyMacro(E);
|
||
|
return;
|
||
|
}
|
||
|
if (MacroName == "Block_release") {
|
||
|
removeBlockReleaseMacro(E);
|
||
|
return;
|
||
|
}
|
||
|
}
|
||
|
|
||
|
if (isSelf(E->getSubExpr()))
|
||
|
return rewriteToBridgedCast(E, OBC_Bridge);
|
||
|
|
||
|
CallExpr *callE;
|
||
|
if (isPassedToCFRetain(E, callE))
|
||
|
return rewriteCastForCFRetain(E, callE);
|
||
|
|
||
|
ObjCMethodFamily family = getFamilyOfMessage(E->getSubExpr());
|
||
|
if (family == OMF_retain)
|
||
|
return rewriteToBridgedCast(E, OBC_BridgeRetained);
|
||
|
|
||
|
if (family == OMF_autorelease || family == OMF_release) {
|
||
|
std::string err = "it is not safe to cast to '";
|
||
|
err += E->getType().getAsString(Pass.Ctx.getPrintingPolicy());
|
||
|
err += "' the result of '";
|
||
|
err += family == OMF_autorelease ? "autorelease" : "release";
|
||
|
err += "' message; a __bridge cast may result in a pointer to a "
|
||
|
"destroyed object and a __bridge_retained may leak the object";
|
||
|
Pass.TA.reportError(err, E->getBeginLoc(),
|
||
|
E->getSubExpr()->getSourceRange());
|
||
|
Stmt *parent = E;
|
||
|
do {
|
||
|
parent = StmtMap->getParentIgnoreParenImpCasts(parent);
|
||
|
} while (parent && isa<FullExpr>(parent));
|
||
|
|
||
|
if (ReturnStmt *retS = dyn_cast_or_null<ReturnStmt>(parent)) {
|
||
|
std::string note = "remove the cast and change return type of function "
|
||
|
"to '";
|
||
|
note += E->getSubExpr()->getType().getAsString(Pass.Ctx.getPrintingPolicy());
|
||
|
note += "' to have the object automatically autoreleased";
|
||
|
Pass.TA.reportNote(note, retS->getBeginLoc());
|
||
|
}
|
||
|
}
|
||
|
|
||
|
Expr *subExpr = E->getSubExpr();
|
||
|
|
||
|
// Look through pseudo-object expressions.
|
||
|
if (PseudoObjectExpr *pseudo = dyn_cast<PseudoObjectExpr>(subExpr)) {
|
||
|
subExpr = pseudo->getResultExpr();
|
||
|
assert(subExpr && "no result for pseudo-object of non-void type?");
|
||
|
}
|
||
|
|
||
|
if (ImplicitCastExpr *implCE = dyn_cast<ImplicitCastExpr>(subExpr)) {
|
||
|
if (implCE->getCastKind() == CK_ARCConsumeObject)
|
||
|
return rewriteToBridgedCast(E, OBC_BridgeRetained);
|
||
|
if (implCE->getCastKind() == CK_ARCReclaimReturnedObject)
|
||
|
return rewriteToBridgedCast(E, OBC_Bridge);
|
||
|
}
|
||
|
|
||
|
bool isConsumed = false;
|
||
|
if (isPassedToCParamWithKnownOwnership(E, isConsumed))
|
||
|
return rewriteToBridgedCast(E, isConsumed ? OBC_BridgeRetained
|
||
|
: OBC_Bridge);
|
||
|
}
|
||
|
|
||
|
static ObjCMethodFamily getFamilyOfMessage(Expr *E) {
|
||
|
E = E->IgnoreParenCasts();
|
||
|
if (ObjCMessageExpr *ME = dyn_cast<ObjCMessageExpr>(E))
|
||
|
return ME->getMethodFamily();
|
||
|
|
||
|
return OMF_None;
|
||
|
}
|
||
|
|
||
|
bool isPassedToCFRetain(Expr *E, CallExpr *&callE) const {
|
||
|
if ((callE = dyn_cast_or_null<CallExpr>(
|
||
|
StmtMap->getParentIgnoreParenImpCasts(E))))
|
||
|
if (FunctionDecl *
|
||
|
FD = dyn_cast_or_null<FunctionDecl>(callE->getCalleeDecl()))
|
||
|
if (FD->getName() == "CFRetain" && FD->getNumParams() == 1 &&
|
||
|
FD->getParent()->isTranslationUnit() &&
|
||
|
FD->isExternallyVisible())
|
||
|
return true;
|
||
|
|
||
|
return false;
|
||
|
}
|
||
|
|
||
|
bool isPassedToCParamWithKnownOwnership(Expr *E, bool &isConsumed) const {
|
||
|
if (CallExpr *callE = dyn_cast_or_null<CallExpr>(
|
||
|
StmtMap->getParentIgnoreParenImpCasts(E)))
|
||
|
if (FunctionDecl *
|
||
|
FD = dyn_cast_or_null<FunctionDecl>(callE->getCalleeDecl())) {
|
||
|
unsigned i = 0;
|
||
|
for (unsigned e = callE->getNumArgs(); i != e; ++i) {
|
||
|
Expr *arg = callE->getArg(i);
|
||
|
if (arg == E || arg->IgnoreParenImpCasts() == E)
|
||
|
break;
|
||
|
}
|
||
|
if (i < callE->getNumArgs() && i < FD->getNumParams()) {
|
||
|
ParmVarDecl *PD = FD->getParamDecl(i);
|
||
|
if (PD->hasAttr<CFConsumedAttr>()) {
|
||
|
isConsumed = true;
|
||
|
return true;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
|
||
|
return false;
|
||
|
}
|
||
|
|
||
|
bool isSelf(Expr *E) const {
|
||
|
E = E->IgnoreParenLValueCasts();
|
||
|
if (DeclRefExpr *DRE = dyn_cast<DeclRefExpr>(E))
|
||
|
if (ImplicitParamDecl *IPD = dyn_cast<ImplicitParamDecl>(DRE->getDecl()))
|
||
|
if (IPD->getIdentifier() == SelfII)
|
||
|
return true;
|
||
|
|
||
|
return false;
|
||
|
}
|
||
|
};
|
||
|
|
||
|
} // end anonymous namespace
|
||
|
|
||
|
void trans::rewriteUnbridgedCasts(MigrationPass &pass) {
|
||
|
BodyTransform<UnbridgedCastRewriter> trans(pass);
|
||
|
trans.TraverseDecl(pass.Ctx.getTranslationUnitDecl());
|
||
|
}
|