CMake/Source/cmCacheManager.h

192 lines
6.6 KiB
C
Raw Normal View History

/*============================================================================
CMake - Cross Platform Makefile Generator
Copyright 2000-2009 Kitware, Inc., Insight Software Consortium
Distributed under the OSI-approved BSD License (the "License");
see accompanying file Copyright.txt for details.
This software is distributed WITHOUT ANY WARRANTY; without even the
implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the License for more information.
============================================================================*/
#ifndef cmCacheManager_h
#define cmCacheManager_h
#include "cmStandardIncludes.h"
#include "cmPropertyMap.h"
class cmMakefile;
class cmMarkAsAdvancedCommand;
class cmake;
/** \class cmCacheManager
* \brief Control class for cmake's cache
*
* Load and Save CMake cache files.
*
*/
class cmCacheManager
{
public:
cmCacheManager(cmake* cm);
2002-09-12 16:56:32 +04:00
class CacheIterator;
friend class cmCacheManager::CacheIterator;
2006-03-10 19:13:15 +03:00
enum CacheEntryType{ BOOL=0, PATH, FILEPATH, STRING, INTERNAL,STATIC,
UNINITIALIZED };
private:
2001-04-26 22:53:44 +04:00
struct CacheEntry
{
2006-03-15 19:02:08 +03:00
std::string Value;
CacheEntryType Type;
cmPropertyMap Properties;
const char* GetProperty(const char*) const;
void SetProperty(const char* property, const char* value);
void AppendProperty(const char* property, const char* value);
2006-03-15 19:02:08 +03:00
bool Initialized;
CacheEntry() : Value(""), Type(UNINITIALIZED), Initialized(false)
{}
};
public:
2002-08-21 19:57:12 +04:00
class CacheIterator
{
public:
2002-08-24 00:13:34 +04:00
void Begin();
bool Find(const char*);
bool IsAtEnd() const;
2002-08-24 00:13:34 +04:00
void Next();
const char *GetName() const {
2006-03-15 19:02:08 +03:00
return this->Position->first.c_str(); }
const char* GetProperty(const char*) const ;
bool GetPropertyAsBool(const char*) const ;
bool PropertyExists(const char*) const;
void SetProperty(const char* property, const char* value);
void AppendProperty(const char* property, const char* value);
void SetProperty(const char* property, bool value);
2006-03-15 19:02:08 +03:00
const char* GetValue() const { return this->GetEntry().Value.c_str(); }
bool GetValueAsBool() const;
void SetValue(const char*);
2006-03-15 19:02:08 +03:00
CacheEntryType GetType() const { return this->GetEntry().Type; }
void SetType(CacheEntryType ty) { this->GetEntry().Type = ty; }
2006-03-15 19:02:08 +03:00
bool Initialized() { return this->GetEntry().Initialized; }
cmCacheManager &Container;
std::map<cmStdString, CacheEntry>::iterator Position;
CacheIterator(cmCacheManager &cm) : Container(cm) {
2002-08-21 19:57:12 +04:00
this->Begin();
}
2006-03-15 19:02:08 +03:00
CacheIterator(cmCacheManager &cm, const char* key) : Container(cm)
{
if ( key )
{
this->Find(key);
}
}
private:
2006-03-15 19:02:08 +03:00
CacheEntry const& GetEntry() const { return this->Position->second; }
CacheEntry& GetEntry() { return this->Position->second; }
2002-08-21 19:57:12 +04:00
};
///! return an iterator to iterate through the cache map
cmCacheManager::CacheIterator NewIterator()
{
return CacheIterator(*this);
}
/**
* Types for the cache entries. These are useful as
* hints for a cache editor program. Path should bring
* up a file chooser, BOOL a check box, and STRING a
* text entry box, FILEPATH is a full path to a file which
* can be different than just a path input
*/
static CacheEntryType StringToType(const char*);
static const char* TypeToString(CacheEntryType);
static bool IsType(const char*);
2001-04-24 20:40:37 +04:00
///! Load a cache for given makefile. Loads from ouput home.
2002-08-24 00:13:34 +04:00
bool LoadCache(cmMakefile*);
///! Load a cache for given makefile. Loads from path/CMakeCache.txt.
2002-08-24 00:13:34 +04:00
bool LoadCache(const char* path);
bool LoadCache(const char* path, bool internal);
bool LoadCache(const char* path, bool internal,
std::set<cmStdString>& excludes,
std::set<cmStdString>& includes);
///! Save cache for given makefile. Saves to ouput home CMakeCache.txt.
2002-08-24 00:13:34 +04:00
bool SaveCache(cmMakefile*) ;
///! Save cache for given makefile. Saves to ouput path/CMakeCache.txt
2002-08-24 00:13:34 +04:00
bool SaveCache(const char* path) ;
2004-05-20 23:08:18 +04:00
///! Delete the cache given
bool DeleteCache(const char* path);
///! Print the cache to a stream
void PrintCache(std::ostream&) const;
///! Get the iterator for an entry with a given key.
cmCacheManager::CacheIterator GetCacheIterator(const char *key=0);
///! Remove an entry from the cache
2002-08-24 00:13:34 +04:00
void RemoveCacheEntry(const char* key);
2002-08-21 19:57:12 +04:00
///! Get the number of entries in the cache
2002-08-24 00:13:34 +04:00
int GetSize() {
2006-03-15 19:02:08 +03:00
return static_cast<int>(this->Cache.size()); }
///! Break up a line like VAR:type="value" into var, type and value
static bool ParseEntry(const char* entry,
std::string& var,
std::string& value,
CacheEntryType& type);
2002-09-04 23:46:25 +04:00
static bool ParseEntry(const char* entry,
std::string& var,
std::string& value);
2002-09-04 23:46:25 +04:00
///! Get a value from the cache given a key
const char* GetCacheValue(const char* key) const;
/** Get the version of CMake that wrote the cache. */
unsigned int GetCacheMajorVersion() { return this->CacheMajorVersion; }
unsigned int GetCacheMinorVersion() { return this->CacheMinorVersion; }
bool NeedCacheCompatibility(int major, int minor);
/** Define and document CACHE entry properties. */
static void DefineProperties(cmake *cm);
protected:
///! Add an entry into the cache
void AddCacheEntry(const char* key, const char* value,
const char* helpString, CacheEntryType type);
///! Get a cache entry object for a key
CacheEntry *GetCacheEntry(const char *key);
///! Clean out the CMakeFiles directory if no CMakeCache.txt
void CleanCMakeFiles(const char* path);
// Cache version info
unsigned int CacheMajorVersion;
unsigned int CacheMinorVersion;
private:
cmake* CMakeInstance;
typedef std::map<cmStdString, CacheEntry> CacheEntryMap;
static void OutputHelpString(std::ostream& fout,
2001-04-26 22:53:44 +04:00
const std::string& helpString);
static void OutputKey(std::ostream& fout, std::string const& key);
static void OutputValue(std::ostream& fout, std::string const& value);
static const char* PersistentProperties[];
bool ReadPropertyEntry(std::string const& key, CacheEntry& e);
void WritePropertyEntries(std::ostream& os, CacheIterator const& i);
2006-03-15 19:02:08 +03:00
CacheEntryMap Cache;
// Only cmake and cmMakefile should be able to add cache values
// the commands should never use the cmCacheManager directly
friend class cmMakefile; // allow access to add cache values
friend class cmake; // allow access to add cache values
friend class cmakewizard; // allow access to add cache values
friend class cmMarkAsAdvancedCommand; // allow access to add cache values
};
#endif