symbolresolver.cpp File Reference

#include <unordered_map>
#include <string>
#include <vector>
#include <algorithm>
#include <cassert>
#include "symbolresolver.h"
#include "util.h"
#include "doxygen.h"
#include "namespacedef.h"
#include "config.h"
#include "defargs.h"
#include "trace.h"

Include dependency graph for symbolresolver.cpp:

Go to the source code of this file.

Classes
struct	CacheStatistics
struct	CacheStatsWrapper
class	AccessStack
	Helper class representing the stack of items considered while resolving the scope. More...
struct	AccessStack::AccessElem
	Element in the stack. More...
struct	SymbolResolver::Private

Macros
#define	AUTO_TRACE(...)
#define	AUTO_TRACE_ADD(...)
#define	AUTO_TRACE_EXIT(...)

Typedefs
using	LookupCache = Cache<std::string,LookupInfo>
using	VisitedKeys = StringVector
using	VisitedNamespaceKeys = StringVector
using	VisitedNamespaces = std::unordered_map<std::string,const Definition *>

Functions
static void	mergeStatistics (CacheStatistics &stats, LookupCache &cache)
static size_t	getCacheSize ()
static LookupCache &	getTypeLookupCache ()
static LookupCache &	getSymbolLookupCache ()
static bool	isCodeSymbol (Definition::DefType defType)
static int	computeIdealCacheParam (size_t v)

Variables
static std::recursive_mutex	g_cacheTypedefMutex
static CacheStatistics	g_typeCacheStatistics
static CacheStatistics	g_symbolCacheStatistics
THREAD_LOCAL std::unordered_map< std::string, std::pair< QCString, const MemberDef * > >	g_substMap

Macro Definition Documentation

AUTO_TRACE

#define AUTO_TRACE

(

...

)

Value:

(void)0

Definition at line 34 of file symbolresolver.cpp.

AUTO_TRACE_ADD

#define AUTO_TRACE_ADD

(

...

)

Value:

(void)0

Definition at line 35 of file symbolresolver.cpp.

AUTO_TRACE_EXIT

#define AUTO_TRACE_EXIT

(

...

)

Value:

(void)0

Definition at line 36 of file symbolresolver.cpp.

Typedef Documentation

LookupCache

using LookupCache = Cache<std::string,LookupInfo>

Definition at line 53 of file symbolresolver.cpp.

VisitedKeys

using VisitedKeys = StringVector

Definition at line 163 of file symbolresolver.cpp.

VisitedNamespaceKeys

using VisitedNamespaceKeys = StringVector

Definition at line 164 of file symbolresolver.cpp.

VisitedNamespaces

using VisitedNamespaces = std::unordered_map<std::string,const Definition *>

Definition at line 165 of file symbolresolver.cpp.

Function Documentation

computeIdealCacheParam()

int computeIdealCacheParam ( size_t v )

static

Definition at line 1833 of file symbolresolver.cpp.

{
  //printf("computeIdealCacheParam(v=%u)\n",v);
 
  int r=0;
  while (v!=0)
  {
    v >>= 1;
    r++;
  }
  // r = log2(v)
 
  // convert to a valid cache size value
  return std::max(0,std::min(r-16,9));
}

Referenced by SymbolResolver::showCacheUsage().

getCacheSize()

size_t getCacheSize ( )

static

Definition at line 79 of file symbolresolver.cpp.

{
  int cacheSize = Config_getInt(LOOKUP_CACHE_SIZE);
  if (cacheSize<0) cacheSize=0;
  if (cacheSize>9) cacheSize=9;
  return 65536u << cacheSize;
}

References Config_getInt.

Referenced by getSymbolLookupCache(), and getTypeLookupCache().

getSymbolLookupCache()

LookupCache & getSymbolLookupCache ( )

static

Definition at line 93 of file symbolresolver.cpp.

{
  static THREAD_LOCAL CacheStatsWrapper wrapper(g_symbolCacheStatistics,getCacheSize());
  return wrapper.cache();
}

References g_symbolCacheStatistics, getCacheSize(), and THREAD_LOCAL.

Referenced by SymbolResolver::resolveSymbol(), and SymbolResolver::showCacheUsage().

getTypeLookupCache()

LookupCache & getTypeLookupCache ( )

static

Definition at line 87 of file symbolresolver.cpp.

{
  static THREAD_LOCAL CacheStatsWrapper wrapper(g_typeCacheStatistics, getCacheSize());
  return wrapper.cache();
}

References g_typeCacheStatistics, getCacheSize(), and THREAD_LOCAL.

Referenced by SymbolResolver::clearTypeLookupCache(), SymbolResolver::Private::followPath(), SymbolResolver::resolveClass(), and SymbolResolver::showCacheUsage().

isCodeSymbol()

bool isCodeSymbol ( Definition::DefType defType )

static

Definition at line 103 of file symbolresolver.cpp.

{
  return defType==Definition::TypeClass   || defType==Definition::TypeNamespace ||
         defType==Definition::TypeModule  || defType==Definition::TypeMember    ||
         defType==Definition::TypePackage || defType==Definition::TypeConcept;
}

References Definition::TypeClass, Definition::TypeConcept, Definition::TypeMember, Definition::TypeModule, Definition::TypeNamespace, and Definition::TypePackage.

Referenced by SymbolResolver::Private::getResolvedSymbolRec(), and SymbolResolver::Private::getResolvedTypeRec().

mergeStatistics()

void mergeStatistics ( CacheStatistics & stats, LookupCache & cache )

static

Definition at line 55 of file symbolresolver.cpp.

{
  std::lock_guard lock(stats.mutex);
  stats.size     = std::max(stats.size,     cache.size());
  stats.capacity = std::max(stats.capacity, cache.capacity());
  stats.hits     = std::max(stats.hits,     cache.hits());
  stats.misses   = std::max(stats.misses,   cache.misses());
}

References Cache< K, V >::capacity(), CacheStatistics::capacity, Cache< K, V >::hits(), CacheStatistics::hits, Cache< K, V >::misses(), CacheStatistics::misses, CacheStatistics::mutex, Cache< K, V >::size(), and CacheStatistics::size.

Referenced by SymbolResolver::showCacheUsage(), and CacheStatsWrapper::~CacheStatsWrapper().

Variable Documentation

g_cacheTypedefMutex

std::recursive_mutex g_cacheTypedefMutex

static

Definition at line 39 of file symbolresolver.cpp.

Referenced by SymbolResolver::Private::newResolveTypedef().

g_substMap

THREAD_LOCAL std::unordered_map<std::string, std::pair<QCString,const MemberDef *> > g_substMap

Definition at line 99 of file symbolresolver.cpp.

Referenced by SymbolResolver::Private::substTypedef().

g_symbolCacheStatistics

CacheStatistics g_symbolCacheStatistics

static

Definition at line 51 of file symbolresolver.cpp.

Referenced by getSymbolLookupCache(), and SymbolResolver::showCacheUsage().

g_typeCacheStatistics

CacheStatistics g_typeCacheStatistics

static

Definition at line 50 of file symbolresolver.cpp.

Referenced by getTypeLookupCache(), and SymbolResolver::showCacheUsage().