new trunk (base for 1.5)

windows build only

CppParser/include/Poco/CppParser/Utility.h

@@ -0,0 +1,107 @@
+//
+// Utility.h
+//
+// $Id: //poco/1.3/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