cppparser.h

这是一个能够自动生成文档的程序

#ifndef __CPPPARSER_H__
#define __CPPPARSER_H__
#pragma once

#include <afxtempl.h>
#include "Pages.h"
#include "TokenReader.h"
#include "Identifiers.h"
#include "CPGlobals.h"

//C/C++代码解析器
class CCppParser
{
public:
	//构造函数
	CCppParser();
	//析构函数
	virtual ~CCppParser();

public:
	//解析一个文件的代码
	BOOL ParseFile(LPCTSTR iPathName);
	//解析一个代码页的代码
	BOOL ParsePage(CPage* ipPage);

private:
	//解析代码字符串
    BOOL ParseCode(char* ipCode);
	//预处理
	BOOL Preprocessor(CTokenList& ioList);

	//将源代码转换成记号序列
	void ReadTokenList(CTokenList& oList, LPCTSTR ipCode);
	//清除记号序列对象
	void ClearTokenList(CTokenList& iList);

	//解析预编译代码
	BOOL ParsePreprocessor(CTokenList& ioList, POSITION& ioPos);
	//解析#if
    void ParsePreprocessorIf(CTokenList& ioList, POSITION& ioPos);
	//解析#ifdef
	void ParsePreprocessorIfdef(CTokenList& ioList, POSITION& ioPos, BOOL iNot=FALSE);
	//解析#define
	void ParsePreprocessorDefine(CTokenList& ioList, POSITION& ioPos);
	//解析#undef
	void ParsePreprocessorUndefine(CTokenList& ioList, POSITION& ioPos);
	//解析#include
	void ParsePreprocessorInclude(CTokenList& ioList, POSITION& ioPos);


	//解析一个单词或以一个单开始的代码
	void ParseWord(CTokenList& ioList, POSITION& ioPos, POSITION& iCurrPos, LPCTSTR iWord);

	//解析namespace定义
	void ParseNameSpace(CTokenList& ioList, POSITION& ioPos);

	//解析模板声明
	void ParseTemplate(CTokenList& ioList, POSITION& ioPos);

	//解析全局函数或变量
    void ParseGlobalFuncOrVar(CTokenList& ioList, POSITION& ioPos);

	//清除所有内容
	void ClearContent();
	//设置忽略标记，为TRRE时跳过当前代码
	void SetSkip(BOOL iSkip=TRUE){mSkip = iSkip;};
	//重置忽略标记
	void ResetSkip() {mSkip = !mSkip;};
	//判断是否处于忽略标记
	BOOL IsSkip() const {return mSkip;};
	//设置忽略标记的层次: #ifdef ... #ifdef 
	void SetSkipCount(int iCount) {mSkipCount+=iCount;};
	//取得忽略标记的层次
	int GetSkipCount() const {return mSkipCount;};

	//忽略当前行的内容，即把ioPos移到指到下一行开始Token
	void GotoNextLine(CTokenList& ioList, POSITION& ioPos, CToken* ipCurrToken);

    //判断字符是否可作为单词的开始
	inline BOOL IsBeginOfWord(char ch);
	//判断字符是否可作为单词的一部分
	inline BOOL IsWordPart(char ch);
	//判断字符是否可作为数字的开始
	inline BOOL IsDigit(char ch);

private:

	//为TRUE时，跳过读到的内容，用于记录编译开关的状态
	BOOL   mSkip; 
	//当mSkip为TRUE时，记录内嵌的#if/#endif对的匹配情况
	int    mSkipCount; 

	UNIT_TEST(CCppParser);
};

#include "CppParser.inl"

#endif