clang  9.0.0svn
Public Types | Public Member Functions | List of all members
clang::DirectoryLookup Class Reference

DirectoryLookup - This class represents one entry in the search list that specifies the search order for directories in #include directives. More...

#include "clang/Lex/DirectoryLookup.h"

Collaboration diagram for clang::DirectoryLookup:
Collaboration graph
[legend]

Public Types

enum  LookupType_t { LT_NormalDir, LT_Framework, LT_HeaderMap }
 

Public Member Functions

 DirectoryLookup (const DirectoryEntry *dir, SrcMgr::CharacteristicKind DT, bool isFramework)
 DirectoryLookup ctor - Note that this ctor does not take ownership of 'dir'. More...
 
 DirectoryLookup (const HeaderMap *map, SrcMgr::CharacteristicKind DT, bool isIndexHeaderMap)
 DirectoryLookup ctor - Note that this ctor does not take ownership of 'map'. More...
 
LookupType_t getLookupType () const
 getLookupType - Return the kind of directory lookup that this is: either a normal directory, a framework path, or a HeaderMap. More...
 
StringRef getName () const
 getName - Return the directory or filename corresponding to this lookup object. More...
 
const DirectoryEntrygetDir () const
 getDir - Return the directory that this entry refers to. More...
 
const DirectoryEntrygetFrameworkDir () const
 getFrameworkDir - Return the directory that this framework refers to. More...
 
const HeaderMapgetHeaderMap () const
 getHeaderMap - Return the directory that this entry refers to. More...
 
bool isNormalDir () const
 isNormalDir - Return true if this is a normal directory, not a header map. More...
 
bool isFramework () const
 isFramework - True if this is a framework directory. More...
 
bool isHeaderMap () const
 isHeaderMap - Return true if this is a header map, not a normal directory. More...
 
bool haveSearchedAllModuleMaps () const
 Determine whether we have already searched this entire directory for module maps. More...
 
void setSearchedAllModuleMaps (bool SAMM)
 Specify whether we have already searched all of the subdirectories for module maps. More...
 
SrcMgr::CharacteristicKind getDirCharacteristic () const
 DirCharacteristic - The type of directory this is, one of the DirType enum values. More...
 
bool isSystemHeaderDirectory () const
 Whether this describes a system header directory. More...
 
bool isIndexHeaderMap () const
 Whether this header map is building a framework or not. More...
 
const FileEntryLookupFile (StringRef &Filename, HeaderSearch &HS, SourceLocation IncludeLoc, SmallVectorImpl< char > *SearchPath, SmallVectorImpl< char > *RelativePath, Module *RequestingModule, ModuleMap::KnownHeader *SuggestedModule, bool &InUserSpecifiedSystemFramework, bool &IsFrameworkFound, bool &HasBeenMapped, SmallVectorImpl< char > &MappedName) const
 LookupFile - Lookup the specified file in this search path, returning it if it exists or returning null if not. More...
 

Detailed Description

DirectoryLookup - This class represents one entry in the search list that specifies the search order for directories in #include directives.

It represents either a directory, a framework, or a headermap.

Definition at line 31 of file DirectoryLookup.h.

Member Enumeration Documentation

◆ LookupType_t

Enumerator
LT_NormalDir 
LT_Framework 
LT_HeaderMap 

Definition at line 33 of file DirectoryLookup.h.

Constructor & Destructor Documentation

◆ DirectoryLookup() [1/2]

clang::DirectoryLookup::DirectoryLookup ( const DirectoryEntry dir,
SrcMgr::CharacteristicKind  DT,
bool  isFramework 
)
inline

DirectoryLookup ctor - Note that this ctor does not take ownership of 'dir'.

Definition at line 67 of file DirectoryLookup.h.

◆ DirectoryLookup() [2/2]

clang::DirectoryLookup::DirectoryLookup ( const HeaderMap map,
SrcMgr::CharacteristicKind  DT,
bool  isIndexHeaderMap 
)
inline

DirectoryLookup ctor - Note that this ctor does not take ownership of 'map'.

Definition at line 77 of file DirectoryLookup.h.

Member Function Documentation

◆ getDir()

const DirectoryEntry* clang::DirectoryLookup::getDir ( ) const
inline

getDir - Return the directory that this entry refers to.

Definition at line 94 of file DirectoryLookup.h.

References isNormalDir().

Referenced by clang::HeaderSearch::loadTopLevelSystemModules().

◆ getDirCharacteristic()

SrcMgr::CharacteristicKind clang::DirectoryLookup::getDirCharacteristic ( ) const
inline

DirCharacteristic - The type of directory this is, one of the DirType enum values.

Definition at line 132 of file DirectoryLookup.h.

Referenced by isSystemHeaderDirectory(), and clang::HeaderSearch::LookupFile().

◆ getFrameworkDir()

const DirectoryEntry* clang::DirectoryLookup::getFrameworkDir ( ) const
inline

getFrameworkDir - Return the directory that this framework refers to.

Definition at line 100 of file DirectoryLookup.h.

References isFramework().

◆ getHeaderMap()

const HeaderMap* clang::DirectoryLookup::getHeaderMap ( ) const
inline

getHeaderMap - Return the directory that this entry refers to.

Definition at line 106 of file DirectoryLookup.h.

References isHeaderMap().

◆ getLookupType()

LookupType_t clang::DirectoryLookup::getLookupType ( ) const
inline

getLookupType - Return the kind of directory lookup that this is: either a normal directory, a framework path, or a HeaderMap.

Definition at line 86 of file DirectoryLookup.h.

References getName().

Referenced by isFramework(), isHeaderMap(), and isNormalDir().

◆ getName()

StringRef DirectoryLookup::getName ( ) const

getName - Return the directory or filename corresponding to this lookup object.

Definition at line 298 of file HeaderSearch.cpp.

References clang::FileEntry::getDir(), clang::FileManager::getFile(), and clang::HeaderSearch::getFileMgr().

Referenced by getLookupType().

◆ haveSearchedAllModuleMaps()

bool clang::DirectoryLookup::haveSearchedAllModuleMaps ( ) const
inline

Determine whether we have already searched this entire directory for module maps.

Definition at line 122 of file DirectoryLookup.h.

Referenced by clang::HeaderSearch::loadTopLevelSystemModules().

◆ isFramework()

bool clang::DirectoryLookup::isFramework ( ) const
inline

isFramework - True if this is a framework directory.

Definition at line 115 of file DirectoryLookup.h.

References getLookupType(), and LT_Framework.

Referenced by getFrameworkDir(), and clang::HeaderSearch::loadTopLevelSystemModules().

◆ isHeaderMap()

bool clang::DirectoryLookup::isHeaderMap ( ) const
inline

isHeaderMap - Return true if this is a header map, not a normal directory.

Definition at line 118 of file DirectoryLookup.h.

References getLookupType(), and LT_HeaderMap.

Referenced by getHeaderMap(), and isIndexHeaderMap().

◆ isIndexHeaderMap()

bool clang::DirectoryLookup::isIndexHeaderMap ( ) const
inline

Whether this header map is building a framework or not.

Definition at line 142 of file DirectoryLookup.h.

References Filename, isHeaderMap(), and LookupFile().

Referenced by clang::HeaderSearch::LookupFile().

◆ isNormalDir()

bool clang::DirectoryLookup::isNormalDir ( ) const
inline

isNormalDir - Return true if this is a normal directory, not a header map.

Definition at line 111 of file DirectoryLookup.h.

References getLookupType(), and LT_NormalDir.

Referenced by getDir().

◆ isSystemHeaderDirectory()

bool clang::DirectoryLookup::isSystemHeaderDirectory ( ) const
inline

Whether this describes a system header directory.

Definition at line 137 of file DirectoryLookup.h.

References clang::SrcMgr::C_User, and getDirCharacteristic().

Referenced by clang::HeaderSearch::loadTopLevelSystemModules().

◆ LookupFile()

const FileEntry * DirectoryLookup::LookupFile ( StringRef &  Filename,
HeaderSearch HS,
SourceLocation  IncludeLoc,
SmallVectorImpl< char > *  SearchPath,
SmallVectorImpl< char > *  RelativePath,
Module RequestingModule,
ModuleMap::KnownHeader SuggestedModule,
bool InUserSpecifiedSystemFramework,
bool IsFrameworkFound,
bool HasBeenMapped,
SmallVectorImpl< char > &  MappedName 
) const

LookupFile - Lookup the specified file in this search path, returning it if it exists or returning null if not.

Parameters
FilenameThe file to look up relative to the search paths.
HSThe header search instance to search with.
IncludeLocthe source location of the #include or #import directive.
SearchPathIf not NULL, will be set to the search path relative to which the file was found.
RelativePathIf not NULL, will be set to the path relative to SearchPath at which the file was found. This only differs from the Filename for framework includes.
RequestingModuleThe module in which the lookup was performed.
SuggestedModuleIf non-null, and the file found is semantically part of a known module, this will be set to the module that should be imported instead of preprocessing/parsing the file found.
[out]InUserSpecifiedSystemFrameworkIf the file is found, set to true if the file is located in a framework that has been user-specified to be treated as a system framework.
[out]IsFrameworkFoundFor a framework directory set to true if specified '.framework' directory is found.
[out]MappedNameif this is a headermap which maps the filename to a framework include ("Foo.h" -> "Foo/Foo.h"), set the new name to this vector and point Filename to it.

Definition at line 328 of file HeaderSearch.cpp.

References clang::FileManager::getFile(), clang::HeaderSearch::getFileMgr(), clang::CodeGen::getName(), clang::HeaderMap::LookupFile(), clang::HeaderMapImpl::lookupFilename(), and clang::Result.

Referenced by isIndexHeaderMap().

◆ setSearchedAllModuleMaps()

void clang::DirectoryLookup::setSearchedAllModuleMaps ( bool  SAMM)
inline

Specify whether we have already searched all of the subdirectories for module maps.

Definition at line 126 of file DirectoryLookup.h.

Referenced by clang::HeaderSearch::loadTopLevelSystemModules().

Member Data Documentation

◆ Dir

const DirectoryEntry* clang::DirectoryLookup::Dir

Dir - This is the actual directory that we're referring to for a normal directory or a framework.

Definition at line 42 of file DirectoryLookup.h.

◆ Map

const HeaderMap* clang::DirectoryLookup::Map

Map - This is the HeaderMap if this is a headermap lookup.

Definition at line 46 of file DirectoryLookup.h.


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