clang  3.9.0
Public Member Functions | Static Public Member Functions | Friends | List of all members
clang::Selector Class Reference

Smart pointer class that efficiently represents Objective-C method names. More...

#include <IdentifierTable.h>

Public Member Functions

 Selector ()
 The default ctor should only be used when creating data structures that will contain selectors. More...
 
 Selector (uintptr_t V)
 
bool operator== (Selector RHS) const
 operator==/!= - Indicate whether the specified selectors are identical. More...
 
bool operator!= (Selector RHS) const
 
void * getAsOpaquePtr () const
 
bool isNull () const
 Determine whether this is the empty selector. More...
 
bool isKeywordSelector () const
 
bool isUnarySelector () const
 
unsigned getNumArgs () const
 
IdentifierInfogetIdentifierInfoForSlot (unsigned argIndex) const
 Retrieve the identifier at a given position in the selector. More...
 
StringRef getNameForSlot (unsigned argIndex) const
 Retrieve the name at a given position in the selector. More...
 
std::string getAsString () const
 Derive the full selector name (e.g. More...
 
void print (llvm::raw_ostream &OS) const
 Prints the full selector name (e.g. "foo:bar:"). More...
 
ObjCMethodFamily getMethodFamily () const
 Derive the conventional family of this method. More...
 
ObjCStringFormatFamily getStringFormatFamily () const
 

Static Public Member Functions

static Selector getEmptyMarker ()
 
static Selector getTombstoneMarker ()
 
static ObjCInstanceTypeFamily getInstTypeMethodFamily (Selector sel)
 

Friends

class Diagnostic
 
class SelectorTable
 
class DeclarationName
 

Detailed Description

Smart pointer class that efficiently represents Objective-C method names.

This class will either point to an IdentifierInfo or a MultiKeywordSelector (which is private). This enables us to optimize selectors that take no arguments and selectors that take 1 argument, which accounts for 78% of all selectors in Cocoa.h.

Definition at line 628 of file IdentifierTable.h.

Constructor & Destructor Documentation

clang::Selector::Selector ( )
inline

The default ctor should only be used when creating data structures that will contain selectors.

Definition at line 675 of file IdentifierTable.h.

Referenced by getEmptyMarker(), and getTombstoneMarker().

clang::Selector::Selector ( uintptr_t  V)
inline

Definition at line 676 of file IdentifierTable.h.

Member Function Documentation

void* clang::Selector::getAsOpaquePtr ( ) const
inline
std::string Selector::getAsString ( ) const
static Selector clang::Selector::getEmptyMarker ( )
inlinestatic

Definition at line 743 of file IdentifierTable.h.

References Selector().

Referenced by llvm::DenseMapInfo< clang::Selector >::getEmptyKey().

IdentifierInfo * Selector::getIdentifierInfoForSlot ( unsigned  argIndex) const

Retrieve the identifier at a given position in the selector.

Note that the identifier pointer returned may be NULL. Clients that only care about the text of the identifier string, and not the specific, uniqued identifier pointer, should use getNameForSlot(), which returns an empty string when the identifier pointer would be NULL.

Parameters
argIndexThe index for which we want to retrieve the identifier. This index shall be less than getNumArgs() unless this is a keyword selector, in which case 0 is the only permissible value.
Returns
the uniqued identifier for this slot, or NULL if this slot has no corresponding identifier.

Definition at line 410 of file IdentifierTable.cpp.

References clang::MultiKeywordSelector::getIdentifierInfoForSlot().

Referenced by clang::ObjCMethodCall::argumentsMayEscape(), clang::serialization::ComputeHash(), clang::CodeCompletionResult::CreateCodeCompletionString(), GetAssumedMessageSendExprType(), getInstTypeMethodFamily(), getNameForSlot(), getOrderedName(), getStandardSelLoc(), clang::ASTImporter::Import(), isAcceptableObjCSelector(), and clang::CodeGen::CodeGenFunction::StartObjCMethod().

ObjCInstanceTypeFamily Selector::getInstTypeMethodFamily ( Selector  sel)
static
ObjCMethodFamily clang::Selector::getMethodFamily ( ) const
inline
StringRef Selector::getNameForSlot ( unsigned  argIndex) const

Retrieve the name at a given position in the selector.

Parameters
argIndexThe index for which we want to retrieve the name. This index shall be less than getNumArgs() unless this is a keyword selector, in which case 0 is the only permissible value.
Returns
the name for this slot, which may be the empty string if no name was supplied.

Definition at line 420 of file IdentifierTable.cpp.

References getIdentifierInfoForSlot(), and clang::IdentifierInfo::getName().

Referenced by AddSuperSendCompletion(), checkObjCPointerIntrospection(), clang::Sema::CodeCompleteObjCMethodDecl(), clang::Sema::CodeCompleteObjCSelector(), clang::DeclarationName::compare(), clang::CodeCompletionResult::CreateCodeCompletionString(), clang::Sema::DiagnoseAssignmentAsCondition(), findCapturingExpr(), getFreeWhenDoneArg(), hasDefaultGetterName(), hasDefaultSetterName(), isAcceptableMethodMismatch(), isKnownDeallocObjCMethodName(), isSetterLikeSelector(), isUnitTest(), and rewriteToObjCProperty().

unsigned Selector::getNumArgs ( ) const
ObjCStringFormatFamily clang::Selector::getStringFormatFamily ( ) const
inline

Definition at line 739 of file IdentifierTable.h.

Referenced by DiagnoseCStringFormatDirectiveInObjCAPI().

static Selector clang::Selector::getTombstoneMarker ( )
inlinestatic

Definition at line 746 of file IdentifierTable.h.

References Selector().

Referenced by llvm::DenseMapInfo< clang::Selector >::getTombstoneKey().

bool clang::Selector::isKeywordSelector ( ) const
inline

Definition at line 693 of file IdentifierTable.h.

bool clang::Selector::isNull ( ) const
inline
bool clang::Selector::isUnarySelector ( ) const
inline
bool clang::Selector::operator!= ( Selector  RHS) const
inline

Definition at line 682 of file IdentifierTable.h.

bool clang::Selector::operator== ( Selector  RHS) const
inline

operator==/!= - Indicate whether the specified selectors are identical.

Definition at line 679 of file IdentifierTable.h.

void Selector::print ( llvm::raw_ostream &  OS) const

Prints the full selector name (e.g. "foo:bar:").

Definition at line 458 of file IdentifierTable.cpp.

References getAsString().

Referenced by CompareReturnTypes(), clang::MangleContext::mangleObjCMethodNameWithoutSize(), and clang::DeclarationName::print().

Friends And Related Function Documentation

friend class DeclarationName
friend

Definition at line 671 of file IdentifierTable.h.

friend class Diagnostic
friend

Definition at line 629 of file IdentifierTable.h.

friend class SelectorTable
friend

Definition at line 670 of file IdentifierTable.h.


The documentation for this class was generated from the following files: