mirror of
https://github.com/pocoproject/poco.git
synced 2025-10-19 12:42:30 +02:00
108 lines
4.7 KiB
C++
108 lines
4.7 KiB
C++
//
|
|
// Utility.h
|
|
//
|
|
// $Id: //poco/1.4/CppParser/include/Poco/CppParser/Utility.h#1 $
|
|
//
|
|
// Library: CppParser
|
|
// Package: CppParser
|
|
// Module: Utility
|
|
//
|
|
// Definition of the Utility class.
|
|
//
|
|
// Copyright (c) 2006, Applied Informatics Software Engineering GmbH.
|
|
// and Contributors.
|
|
//
|
|
// Permission is hereby granted, free of charge, to any person or organization
|
|
// obtaining a copy of the software and accompanying documentation covered by
|
|
// this license (the "Software") to use, reproduce, display, distribute,
|
|
// execute, and transmit the Software, and to prepare derivative works of the
|
|
// Software, and to permit third-parties to whom the Software is furnished to
|
|
// do so, all subject to the following:
|
|
//
|
|
// The copyright notices in the Software and this entire statement, including
|
|
// the above license grant, this restriction and the following disclaimer,
|
|
// must be included in all copies of the Software, in whole or in part, and
|
|
// all derivative works of the Software, unless such copies or derivative
|
|
// works are solely in the form of machine-executable object code generated by
|
|
// a source language processor.
|
|
//
|
|
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
// FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
|
|
// SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
|
|
// FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
|
|
// ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
|
|
// DEALINGS IN THE SOFTWARE.
|
|
//
|
|
|
|
|
|
#ifndef CppParser_Utility_INCLUDED
|
|
#define CppParser_Utility_INCLUDED
|
|
|
|
|
|
#include "Poco/CppParser/CppParser.h"
|
|
#include "Poco/CppParser/NameSpace.h"
|
|
#include <vector>
|
|
#include <set>
|
|
|
|
|
|
namespace Poco {
|
|
namespace CppParser {
|
|
|
|
|
|
class CppParser_API Utility
|
|
/// Various helpers for parsing and analyzing C++ header files.
|
|
{
|
|
public:
|
|
class CppParser_API FwdDeclBlock
|
|
{
|
|
public:
|
|
std::string beginNameSpaceDecl; // contains either $(NS)_BEGIN or the namespace x { decl
|
|
std::string endNameSpaceDecl; // contains either $(NS)_END or the closing brackets }
|
|
std::vector<std::string> classDecls; // contains strings of the form "class X;"
|
|
};
|
|
|
|
static void parse(const std::string& file, NameSpace::SymbolTable& st, const std::string& exec, const std::string& options, const std::string& path);
|
|
/// Preprocesses and parses the file. The resulting symboltable has base class references already fixed,
|
|
|
|
static void parseDir(const std::vector <std::string>& includePattern, const std::vector <std::string>& excludePattern, NameSpace::SymbolTable& st, const std::string& exec, const std::string& options, const std::string& path);
|
|
/// Preprocesses and parses all files specified by the include pattern (e.g.: p:/poco/Foundation/include/*/*.h) minus the ones defined in the exclude pattern
|
|
|
|
static void fixup(NameSpace::SymbolTable& st);
|
|
/// Fixes all base pointers in the symbol table
|
|
|
|
static void detectPrefixAndIncludes(const std::string& origHFile, std::vector<std::string>& lines, std::string& prefix);
|
|
/// This method is poco coding style specific! It looks for a $(PREFIX)_BEGIN and extracts from it a prefix, also include files and fwd declarations are extracted from the h file.
|
|
|
|
static void removeFile(const std::string& preprocessedfile);
|
|
/// Tries to remove the file. If it fails, the error is silently ignored.
|
|
|
|
protected:
|
|
static std::string preprocessFile(const std::string& file, const std::string& exec, const std::string& options, const std::string& path);
|
|
/// Preprocess the include file with name file. Parameter exec must contain the name of the preprocessor binary (e.g.: "cl" for Visual Studio).
|
|
/// Parameter options contains the flag for the preprocessor, and parameter path sets the environment PATH settings during preprocessing.
|
|
/// Returns the name of the created file or throws an exception.
|
|
|
|
static void parseOnly(const std::string& file, NameSpace::SymbolTable& st, const std::string& preprocessedFile, bool removePreprocessedFile = true);
|
|
/// Parses the file, throws an exception if anything goes wrong.
|
|
|
|
static void buildFileList(std::set<std::string>& files, const std::vector<std::string>& includePattern, const std::vector<std::string>& excludePattern);
|
|
/// Searches all files that match the defined patterns and inserts them into files.
|
|
private:
|
|
Utility();
|
|
~Utility();
|
|
Utility(const Utility&);
|
|
Utility& operator=(const Utility&);
|
|
|
|
};
|
|
|
|
|
|
std::string CppParser_API replace(const std::string& input, const std::string& oldToken, const std::string& newToken);
|
|
/// Replaces in character input all oldTokens with the newToken
|
|
|
|
|
|
} } // namespace Poco::CppParser
|
|
|
|
|
|
#endif // CppParser_Utility_INCLUDED
|