pip/libs/main/code/picodeparser.h

/*! \file picodeparser.h
 * \ingroup Code
 * \~\brief
 * \~english C++ code parser
 * \~russian Разбор C++ кода
 */
/*
	PIP - Platform Independent Primitives
	C++ code parser
	Ivan Pelipenko peri4ko@yandex.ru

	This program is free software: you can redistribute it and/or modify
	it under the terms of the GNU Lesser General Public License as published by
	the Free Software Foundation, either version 3 of the License, or
	(at your option) any later version.

	This program is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of
	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
	GNU Lesser General Public License for more details.

	You should have received a copy of the GNU Lesser General Public License
	along with this program.  If not, see <http://www.gnu.org/licenses/>.
*/

#ifndef PICODEPARSER_H
#define PICODEPARSER_H

#include "pifile.h"
#include "pievaluator.h"

inline bool _isCChar(const PIChar & c) {return (c.isAlpha() || (c.toAscii() == '_'));}
inline bool _isCChar(const PIString & c) {if (c.isEmpty()) return false; return _isCChar(c[0]);}

class PIP_EXPORT PICodeParser {
public:
	PICodeParser();
	
	enum Visibility {Global, Public, Protected, Private};
	enum Attribute {
		NoAttributes = 0x0,
		Const = 0x01,
		Static = 0x02,
		Mutable = 0x04,
		Volatile = 0x08,
		Inline = 0x10,
		Virtual = 0x20,
		Extern = 0x40
	};
	
	typedef PIFlags<Attribute> Attributes;
	typedef PIPair<PIString, PIString> Define;
	typedef PIPair<PIString, PIString> Typedef;
	typedef PIMap<PIString, PIString> MetaMap;

	struct PIP_EXPORT Macro {
		Macro(const PIString & n = PIString(), const PIString & v = PIString(), const PIStringList & a = PIStringList()) {
			name = n;
			value = v;
			args = a;
		}
		PIString expand(PIString args_, bool * ok = 0) const;
		PIString name;
		PIString value;
		PIStringList args;
	};
	
	struct PIP_EXPORT Member {
		Member() {
			visibility = Global;
			size = 0;
			bits = -1;
			is_type_ptr = false;
			attributes = NoAttributes;
		}
		bool isBitfield() const {return bits > 0;}
		MetaMap meta;
		PIString type;
		PIString name;
		PIStringList arguments_full;
		PIStringList arguments_type;
		PIStringList dims;
		Visibility visibility;
		Attributes attributes;
		bool is_type_ptr;
		int size;
		int bits;
	};
	
	struct PIP_EXPORT Entity {
		Entity() {
			visibility = Global;
			has_name = true;
			size = 0;
			parent_scope = 0;
		}
		MetaMap meta;
		PIString type;
		PIString name;
		PIString file;
		Visibility visibility;
		int size;
		bool has_name;
		Entity * parent_scope;
		PIVector<Entity * > parents;
		PIVector<Entity * > children;
		PIVector<Member> functions;
		PIVector<Member> members;
		PIVector<Typedef> typedefs;
	};

	struct PIP_EXPORT EnumeratorInfo {
		EnumeratorInfo(const PIString & n = PIString(), int v = 0, const MetaMap & m = MetaMap()) {name = n; value = v; meta = m;}
		MetaMap meta;
		PIString name;
		int value;
	};

	struct PIP_EXPORT Enum {
		Enum(const PIString & n = PIString()) {
			name = n;
		}
		MetaMap meta;
		PIString name;
		PIVector<EnumeratorInfo> members;
	};
	
	void parseFile(const PIString & file, bool follow_includes = true);
	void parseFiles(const PIStringList & files, bool follow_includes = true);
	
	void includeDirectory(const PIString & dir) {includes << dir;}
	void addDefine(const PIString & def_name, const PIString & def_value) {custom_defines << Define(def_name, def_value);}
	bool isEnum(const PIString & name);
	Entity * findEntityByName(const PIString & en);
	PIStringList parsedFiles() const {return PIStringList(proc_files.toVector());}
	PIString mainFile() const {return main_file;}
	const PICodeParser::Entity * global() const {return &root_;}
	
	int macrosSubstitutionMaxIterations() const {return macros_iter;}
	void setMacrosSubstitutionMaxIterations(int value) {macros_iter = value;}
	
	PIVector<Define> defines, custom_defines;
	PIVector<Macro> macros;
	PIVector<Enum> enums;
	PIVector<Typedef> typedefs;
	PIVector<Entity * > entities;
	
private:
	void clear();
	bool parseFileInternal(const PIString & file, bool follow_includes);
	bool parseFileContent(PIString & fc, bool main);
	bool parseDirective(PIString d);
	Entity * parseClassDeclaration(const PIString & fc);
	void parseClass(Entity * parent, PIString & fc, bool is_namespace);
	MetaMap parseMeta(PIString & fc);
	bool parseEnum(Entity * parent, const PIString & name, PIString fc, const MetaMap & meta);
	Typedef parseTypedef(PIString fc);
	bool parseMember(Entity * parent, PIString & fc);
	int extractMemberBits(PIString & fc);
	void restoreTmpTemp(Member * e);
	void restoreTmpMeta(Member * e);
	MetaMap maybeMeta(PIString & fc);
	bool macroCondition(const PIString & mif, PIString mifcond);
	bool isDefineExists(const PIString & dn);
	double defineValue(const PIString & dn);
	void replaceMeta(PIString & dn);
	PIString procMacros(PIString fc);
	double procMacrosCond(PIString fc);
	bool isDeclaration(const PIString & fc, int start, int * end);
	bool isMainFile(const PIString & fc);
	void normalizeEntityNamespace(PIString & n);
	
	int macros_iter, anon_num;
	bool with_includes;
	PIEvaluator evaluator;
	PISet<PIString> proc_files;
	PIString cur_file, main_file;
	PIStringList includes;
	Entity root_;
	Visibility cur_def_vis;
	PIString cur_namespace;
	PIMap<PIString, PIString> tmp_temp;
	PIMap<PIString, MetaMap> tmp_meta;
	
};

#endif // PICODEPARSER_H