99久久人人爽亚洲精品美女,精品综合久久久久久888蜜芽,精品久久久久中文字幕日本

ZEND公司的��品线

Tue, 05 Oct 2010 16:10:00 GMT

11/09/2009

大名鼎鼎�?a target="_blank" style="color: rgb(0, 68, 170); text-decoration: none; ">Zend公司在IT界的知名度是一路飙升啊�Q�她是php的商业公司，随着php在编�E�语�a�中越来越多的被��用，据本��Z��灵通的消息�Q�自9月以来，php已经��越C++排名�W�三�?/a>�Q�这真是一个振奋�h心的消息�Q�当初选择做php�Q�此时此刻，也让我感到��g��Q�尽��如此，你不得不承认�Q�php能拿到第三名的好成�W�Q�一定是有我的�A(ch��)献的~!!那么有没有一天，php能做到编�E�语�a�中的头把交椅呢？我想不会(x��)的，如果你在哪里看到�q�个排行榜，那它一定是不权威的�?/p>

OK�Q�言归正传，��Z��很多同学认�ؓ(f��)zend studio是官方网站的不正��认知（主要表现��是向我索取zend server,zend Guard的注册码�Q�，我就来说说这个zend公司她到底是个什么东西，或许我把标题�Ҏ(gu��)��?span style="text-decoration: underline; ">zend公司的那些事�?/span>》，大概更能�W�合中国人的阅读�?f��n)惯。顺便说一下，zend studio是公益性民间站�?/strong>�?/p>

�׃��zend公司的��品和php有着�l�对的关�p�，然而其每个产品之间竟然也有�q�千丝万�~�的联系�Q�这��是一个很值得�U�道的事情了�Q�甚臛_��金庸的武侠小说有异曲同工之妙。下面我们一一�i�叨�Q�排名不分先后，但zend studio排第一个）�?span id="more-833">

1、Zend Stduio

�q�是我认为zend公司唯一�q�有必要存在的真正原因，我厌烦了媒体一提到zend studio��q��本宣�U�的道比“一个屡获大奖的专业 PHP 集成开发环境，具备功能强大的专业编辑工具和调试工具……”�Q�虽然事实上��实是这么回事，zend studio��实是一个强大的php集成开发环境，我选择�Q�我喜欢�Q�但�q�里我想提醒下大�Ӟ��zend studio是商业��Y件�?/p>

2、Zend Debugger

��L��介绍一个商业公司的商业产品�Q�难免有打商业广告之嫌，虽然我根本就不是一个商人，所以接下来我就马上搬出zend debugger�Q�我前不久刚好写了一��?a style="color: rgb(0, 68, 170); text-decoration: none; ">zend debugger的终极安装教�E?/a>�Q�，zend debugger是zend公司为数不多的免费��品，体积不大�Q�安装方便，功能也很强大�Q�一般需要调试php�E�序的时候，装上它就够用了�?/p>

3、Zend Server

实际上我�q�没有搞清楚zend server的真正意图，据说针对php做了专门的优化，�q�且是商业��Y�Ӟ��但其不全是收费的�Q�只是部分组�Ӟ��我大�U�在3个月前试用过zend server�Q�记忆有些模�p�）�Q�内�|�的是apache服务器（当然你可以不选择内置�Q�，虽然奚w��成了Zend Optimizer、Zend Guard Loader、Zend Data Cache、Zend Debugger、Zend Framework�Q�但在我看来�q�和免费�?a style="color: rgb(0, 68, 170); text-decoration: none; ">xampp没有实质性区别。很多同学问�?#8220;安装了zend studio是否一定要安装zend server�Q?/em>”�Q�回�{�是“安装zend studio不一定要安装zend server�Q�因��Z��们之间没有必然的联系”。我惻I��问这个问题的同学�Q�大概看了很早的zend studio介绍�Q�那时候的zde�q�有分zend studio client和zend studio server�Q�然后同学将zend studio server和zend server搞�؜了�?span style="text-decoration: underline; ">你看�Q�这��日志的意义��显现出来了�?/span>

4、Zend Optimizer

�q�又是zend 公司的免费��品之一�Q�Zend Optimizer的最大作用是解密解析被zend Guard加密了的php源文�Ӟ��兼顾优化php性能的作用，因此�Q��?zh��n)�在部�|�服务器的时候将zend Optimizer��Z��安装上没有�Q何的坏处�Q�当�Ӟ��如果你购��C��一份Zend Guard加密�q�的php源码�Q�那你就必须安装她了�?/p>

5、Zend Guard

Zend Guard是一个非常有用的产品�Q�当然她也是一个商业��Y�Ӟ��如果你不打算��你的php代码开源，那么可以选择Zend Guard来保护你的研�I�成果，最新版的宝�?�p�，据说强度不是一般的大，能够在保护期内安全不被破解。值得一提的是，用Zend Guard加密�q�了的php源代码，在你的服务器环境中必��d��装Zend Optimizer�?#8220;正常�q�行”之（看！金庸的大师风范就彰显出来�?/em>�Q��?/p>

6、Zend Framework

�q�又是zend 公司�q�年来的重要产品�Q�php界Framework的兴��P��无疑的简化开发，提高效率�Q�即“敏捷高效”四字斚w��Q�这个仅仅是�E�序员在开发工作上的描�q�ͼ�而php的运行效率性能上却�q��有质的飞跃。因此，本�h也不是非常崇��框�Ӟ��管国内的qeephp,thinkphp�{�著名框架发展的如火如荼�Q�框架的�q�捧者也是如潮水一般，有个��Z��然我行我素的“坐以待毙”�Q�他是——gently。然而Zend Framework�q��一无是处，�Ҏ(gu��)��一个伟大的框架产品�Q�发展稳健，现在的用��L(f��ng)��也是蛮庞大的�Q�中国�h比较�q�信官方�Q�当然也因�ؓ(f��)她确实不错）�?strong>Zend studio从宝�?�p�d��始，已经完美的支持zend Framework的开发、调试运行一条龙了�?/p>

7、Zend Core

直译�q�来�?em>zend核心�Q�乍听�v来，你一定觉得这是个了不��L(f��ng)��产品。实际上�Q�你的感觉是对的�Q�zend core是zend官方又一个�ؓ(f��)��C��多的优秀的免费��品，她的存在必要性是能够帮助大家快速的安装部��vphp�q�行环境�Q�简�U�而不��单，甚至�q�提供了一个web��理配置php.ini的功能，�q�是很优�U�的，更多有趣的功能等着大家��d��C��。它与zend studio也是有着千丝万缕的关�p�，比如我用zend studio开发了一个系�l�，借由zend core��p��很快的上�U�运行�?/p>

8、Zend Platform

更准��的说她是一整套的企业服务器解决�Ҏ(gu��)��Q�企业��应用从来都是和大型联�p�d��一��L(f��ng)��Q�因此，什么集��啊、阵列啊、控制中心啊、等�{�等�{�对zend platform来说全都不在话下�Q�她能够跟踪Php�q�行中的错误�Q�监控php�q�行的性能�Q�精��的扑և�瓉��Q�这是多么牛逼的产品啊。那么，需要多��钱呢？只要998�Q�全球限�?0套，赶紧拿�v�?sh��)话订购吧�?#8230;…抽风了一下，依我看，zend server正要逐步替代掉zend platform�Q�不止是做嫁衣，zend �q�要生��新娘�Q�因此，Zend Server风头正劲。Zend Platform与zend studio的关�p�d��是前者能够提供给后者非常强大的服务端支持，当然�q�个强大是zend debugger无法企及(qi��ng)的，当大多数时候，我们个�h开发者用不着�q�么强大�Q�官方可以下载到Zend Platform�?0天试用版�Q�就是说�Ҏ(gu��)��商业软�g�Q�，抱歉�Q�我也没有Zend Platform的注册码或者注册机。她与zend server的关�p�d��Q�就是Zend Server在嫁衣里面包了个新娘�?/p>

Zend公司是一个有潜力的公司，与各界的合作正纷�U�展开�Q�也��zend��走��远�?/p>

叫我老王�?/a> 2010-10-06 00:10 发表评论

VC++ ini文�g操作

Mon, 27 Sep 2010 10:14:00 GMT

原帖�Q?a >http://leapfish.blog.sohu.com/60685388.html
用Visual C++操作INI文�g
在我们写的程序当�?��L��一些配�|�信息需要保存下�?以便完成�E�序的功�?最��单的办法��是��这些信息写入INI文�g�?�E�序初始化时再读�?具体应用如下:
一.��信息写�?INI文�g�?
1.所用的WINAPI函数原型�?
BOOL WritePrivateProfileString(
LPCTSTR lpAppName,
LPCTSTR lpKeyName,
LPCTSTR lpString,
LPCTSTR lpFileName
);
其中各参数的意义:
　LPCTSTR lpAppName 是INI文�g中的一个字�D�名.
LPCTSTR lpKeyName 是lpAppName下的一个键�?通俗讲就是变量名.
　LPCTSTR lpString 是键�?也就是变量的�?不过必须为LPCTSTR型或CString型的.
　LPCTSTR lpFileName 是完整的INI文�g�?
2.具体使用�Ҏ(gu��)��:讄��有一名学�?需把他的姓名和�q�龄写入 c:\stud\student.ini 文�g�?
CString strName,strTemp;
int nAge;
strName="张三";
nAge=12;
::WritePrivateProfileString("StudentInfo","Name",strName,"c:\\stud\\student.ini");
此时c:\stud\student.ini文�g中的内容如下:
[StudentInfo]
Name=张三
3.要将学生的年龄保存下�?只需��整型的值变为字�W�型卛_��:
strTemp.Format("%d",nAge);
::WritePrivateProfileString("StudentInfo","Age",strTemp,"c:\\stud\\student.ini");
�?��信息从INI文�g中读入程序中的变�?
1.所用的WINAPI函数原型�?
DWORD GetPrivateProfileString(
LPCTSTR lpAppName,
LPCTSTR lpKeyName,
LPCTSTR lpDefault,
LPTSTR lpReturnedString,
DWORD nSize,
LPCTSTR lpFileName
);
其中各参数的意义:
前二个参��C�� WritePrivateProfileString中的意义一�?
lpDefault : 如果INI文�g中没有前两个参数指定的字�D�名或键�?则将此��D��l�变�?
　lpReturnedString : 接收INI文�g中的值的CString对象,即目的缓存器.
　nSize : 目的�~�存器的大小.
　lpFileName : 是完整的INI文�g�?
2.具体使用�Ҏ(gu��)��:现要��上一步中写入的学生的信息��d��E�序�?
CString strStudName;
int nStudAge;
GetPrivateProfileString("StudentInfo","Name","默认姓名",strStudName.GetBuffer(MAX_PATH),MAX_PATH,"c:\\stud\\student.ini");
　执行�?strStudName 的��gؓ(f��):"张三",若前两个参数有误,其��gؓ(f��):"默认姓名".
3.��d��整型��D��用另一个WINAPI函数:
UINT GetPrivateProfileInt(
LPCTSTR lpAppName,
LPCTSTR lpKeyName,
INT nDefault,
LPCTSTR lpFileName
);
�q�里的参数意义与上相�?使用�Ҏ(gu��)��如下:
nStudAge=GetPrivateProfileInt("StudentInfo","Age",10,"c:\\stud\\student.ini");
�?循环写入多个�?讄��有一�E�序,要将最�q��用的几个文�g名保存下�?具体�E�序如下:
1.写入:
CString strTemp,strTempA;
int i;
int nCount=6;
file://共有6个文件名需要保�?br style="line-height: 23px; ">for(i=0;i{
strTemp.Format("%d",i);
strTempA=文�g�?
//文�g名可以从数组,列表框等处取�?
::WritePrivateProfileString("UseFileName","FileName"+strTemp,strTempA,"c:\\usefile\\usefile.ini");
}
strTemp.Format("%d",nCount);
::WritePrivateProfileString("FileCount","Count",strTemp,"c:\\usefile\\usefile.ini");
//��文件��L��写入,以便��d��.
2.��d��:
nCount=::GetPrivateProfileInt("FileCount","Count",0,"c:\\usefile\\usefile.ini");
for(i=0;i{
strTemp.Format("%d",i);
strTemp="FileName"+strTemp;
::GetPrivateProfileString("CurrentIni",strTemp,"default.fil", strTempA.GetBuffer(MAX_PATH),MAX_PATH,"c:\\usefile\\usefile.ini");
//使用strTempA中的内容.
}
补充四点:
　1.INI文�g的�\径必��d��?文�g名前面的各��目录必须存在,否则写入不成�?该函数返�?FALSE �?
　2.文�g名的路径中必��Mؓ(f��) \\ ,因�ؓ(f��)在VC++�? \\ 才表�C�Z��?\ .
　3.也可��INI文�g攑֜��E�序所在目�?此时 lpFileName 参数�? ".\\student.ini".
//----------------------------------------------------------------------------------
/*
�c�d��Q�CIni
版本�Q�v2.0
加入高��操作的功�?br style="line-height: 23px; ">v1.0
梦小孩于2003�q�某�?br style="line-height: 23px; ">一般操作完�?/p>
�c�L��q�ͼ�(x��)
本类可以�?ini文�g�q�行操作
*/
文�g 1:
#pragma once
#include "afxTempl.h"
class CIni
{
private:
CString m_strFileName;
public:
CIni(CString strFileName):m_strFileName(strFileName)
{
}
public:
//一般性操作：(x��)
BOOL SetFileName(LPCTSTR lpFileName); //讄��文�g�?br style="line-height: 23px; ">CString GetFileName(void); //获得文�g�?br style="line-height: 23px; ">BOOL SetValue(LPCTSTR lpSection, LPCTSTR lpKey, LPCTSTR lpValue,bool bCreate=true); //讄��键��|��bCreate是指�D�名�?qi��ng)键名未存在�Ӟ��是否创徏�?br style="line-height: 23px; ">CString GetValue(LPCTSTR lpSection, LPCTSTR lpKey); //得到键�?
BOOL DelSection(LPCTSTR strSection); //删除�D�名
BOOL DelKey(LPCTSTR lpSection, LPCTSTR lpKey); //删除键名
public:
//高��操作�Q?br style="line-height: 23px; ">int GetSections(CStringArray& arrSection); //枚�D出全部的�D�名
int GetKeyValues(CStringArray& arrKey,CStringArray& arrValue,LPCTSTR lpSection); //枚�D��Z��D�内的全部键名及(qi��ng)�?/p>
BOOL DelAllSections();
};
文�g 2:
#include "StdAfx.h"
#include "ini.h"
#define MAX_ALLSECTIONS 2048 //全部的段�?br style="line-height: 23px; ">#define MAX_SECTION 260 //一个段名长�?br style="line-height: 23px; ">#define MAX_ALLKEYS 6000 //全部的键�?br style="line-height: 23px; ">#define MAX_KEY 260 //一个键名长�?/p>
BOOL CIni::SetFileName(LPCTSTR lpFileName)
{
CFile file;
CFileStatus status;
if(!file.GetStatus(lpFileName,status))
    return TRUE;
m_strFileName=lpFileName;
    return FALSE;
}
CString CIni::GetFileName(void)
{
return m_strFileName;
}
BOOL CIni::SetValue(LPCTSTR lpSection, LPCTSTR lpKey, LPCTSTR lpValue,bool bCreate)
{
TCHAR lpTemp[MAX_PATH] ={0};
//以下if语句表示如果讄��bCreate为false�Ӟ��当没有这个键名时则返回TRUE�Q�表�C�出错）
//!*&*none-value*&!* �q�是个垃圑֭��W�没有特别意义，�q�样乱写是防止凑巧相同�?br style="line-height: 23px; ">if (!bCreate)
{
GetPrivateProfileString(lpSection,lpKey,"!*&*none-value*&!*",lpTemp,MAX_PATH,m_strFileName);
if(strcmp(lpTemp,"!*&*none-value*&!*")==0)
return TRUE;
}
if(WritePrivateProfileString(lpSection,lpKey,lpValue,m_strFileName))
return FALSE;
else
return GetLastError();
}
CString CIni::GetValue(LPCTSTR lpSection, LPCTSTR lpKey)
{
DWORD dValue;
TCHAR lpValue[MAX_PATH] ={0};
dValue=GetPrivateProfileString(lpSection,lpKey,"",lpValue,MAX_PATH,m_strFileName);
return lpValue;
}
BOOL CIni::DelSection(LPCTSTR lpSection)
{
if(WritePrivateProfileString(lpSection,NULL,NULL,m_strFileName))
    return FALSE;
else
    return GetLastError();
}
BOOL CIni::DelKey(LPCTSTR lpSection, LPCTSTR lpKey)
{
if(WritePrivateProfileString(lpSection,lpKey,NULL,m_strFileName))
return FALSE;
else
return GetLastError();
}
int CIni::GetSections(CStringArray& arrSection)
{
/*
本函数基��Q?br style="line-height: 23px; ">GetPrivateProfileSectionNames - �?ini 文�g中获�?Section 的名�U?br style="line-height: 23px; ">如果 ini 中有两个 Section: [sec1] �?[sec2]�Q�则�q�回的是 'sec1',0,'sec2',0,0 �Q�当你不知道
ini 中有哪些 section 的时候可以用�q�个 api 来获取名�U?nbsp;
*/
int i;
int iPos=0;
int iMaxCount;
TCHAR chSectionNames[MAX_ALLSECTIONS]={0}; //�ȝ��提出来的字符�?br style="line-height: 23px; ">TCHAR chSection[MAX_SECTION]={0}; //存放一个段名�?br style="line-height: 23px; ">GetPrivateProfileSectionNames(chSectionNames,MAX_ALLSECTIONS,m_strFileName);
//以下循环�Q�截断到两个�q�箋�?
for(i=0;i{
if (chSectionNames[i]==0)
if (chSectionNames[i]==chSectionNames[i+1])
    break;
}
iMaxCount=i+1; //要多一�?号元素。即扑և�全部字符串的�l�束部分�?br style="line-height: 23px; ">arrSection.RemoveAll();//清空原数�l?/p>
for(i=0;i{
chSection[iPos++]=chSectionNames[i];
if(chSectionNames[i]==0)
{
arrSection.Add(chSection);
memset(chSection,0,MAX_SECTION);
iPos=0;
}
}
return (int)arrSection.GetSize();
}
int CIni::GetKeyValues(CStringArray& arrKey,CStringArray& arrValue, LPCTSTR lpSection)
{
/*
本函数基��Q?br style="line-height: 23px; ">GetPrivateProfileSection- �?ini 文�g中获得一个Section的全部键名及(qi��ng)值名
如果ini中有一个段�Q�其下有 "�D?=�?" "�D?=�?"�Q�则�q�回的是 '�D?=�?',0,'�D?=�?',0,0 �Q�当你不知道
获得一个段中的所有键�?qi��ng)值可以用�q�个�?nbsp;
*/
int i;
int iPos=0;
CString strKeyValue;
int iMaxCount;
TCHAR chKeyNames[MAX_ALLKEYS]={0}; //�ȝ��提出来的字符�?br style="line-height: 23px; ">TCHAR chKey[MAX_KEY]={0}; //提出来的一个键�?/p>
GetPrivateProfileSection(lpSection,chKeyNames,MAX_ALLKEYS,m_strFileName);
for(i=0;i{
if (chKeyNames[i]==0)
if (chKeyNames[i]==chKeyNames[i+1])
    break;
}
iMaxCount=i+1; //要多一�?号元素。即扑և�全部字符串的�l�束部分�?br style="line-height: 23px; ">arrKey.RemoveAll();//清空原数�l?br style="line-height: 23px; ">arrValue.RemoveAll();
for(i=0;i{
chKey[iPos++]=chKeyNames[i];
if(chKeyNames[i]==0)
{
strKeyValue=chKey;
arrKey.Add(strKeyValue.Left(strKeyValue.Find("=")));
arrValue.Add(strKeyValue.Mid(strKeyValue.Find("=")+1));
memset(chKey,0,MAX_KEY);
iPos=0;
}
}
return (int)arrKey.GetSize();
}
BOOL CIni::DelAllSections()
{
int nSection;
CStringArray arrSection;
nSection=GetSections(arrSection);
for(int i=0;i{
if(DelSection(arrSection[i]))
return GetLastError();
}
return FALSE;
}

使用�Ҏ(gu��)��Q?br style="line-height: 23px; ">CIni ini("c:\\a.ini");
int n;
/*获得�?br style="line-height: 23px; ">TRACE("%s",ini.GetValue("�D?","�?"));
*/
/*��d��?br style="line-height: 23px; ">ini.SetValue("自定义段","�?","�?);
ini.SetValue("自定义段2","�?","�?,false);
*/
/*枚�D全部�D�名
CStringArray arrSection;
n=ini.GetSections(arrSection);
for(int i=0;iTRACE("%s\n",arrSection[i]);
*/
/*枚�D全部键名�?qi��ng)�?br style="line-height: 23px; ">CStringArray arrKey,arrValue;
n=ini.GetKeyValues(arrKey,arrValue,"�D?");
for(int i=0;iTRACE("键：(x��)%s\n��|��(x��)%s\n",arrKey[i],arrValue[i]);
*/
/*删除键�?br style="line-height: 23px; ">ini.DelKey("�D?","�?");
*/
/*删除�D?br style="line-height: 23px; ">ini.DelSection("�D?");
*/
/*删除全部
ini.DelAllSections();
*/
操作配置文�gini
1.基础知识
    INI文�g�Q�Initialization file �Q�又�U�Cؓ(f��)初始化文�Ӟ��是用来保存应用程序设�|�和选项的一�U�特�D�的ASCII文�g�Q�以“.ini”作�ؓ(f��)文�g扩展名，也被�U�做配置文�g或概要文�Ӟ��Profile�Q�。除了各个应用程序可以拥有自��q��有的初始化文件外�Q�W(xu��)indows�pȝ��q�提供有一个系�l�的初始化文件Win.ini�Q��ƈ由此对当前的Windows�pȝ��q�行配置�Q�同时也可以在其内记录系�l�内其他应用�E�序在运行时的选项�?/p>
　　通常为应用程序所�U�有的初始化文�g比较?y��u)��，�q�样可以减少�E�序在初始化时所��d��的信息量�Q�从而提高程序的启动速度。而系�l�初始化文�gWin.ini�׃��除了记录有关�pȝ��的大量信息外�Q�还存储着许多其他应用软�g的初始化数据�Q�因此其通常比较庞大�Q�访问的数据量要�q�比�U�有的配�|�文件大得多。如没有必要�Q�一般不��对Win.ini文�g�q�行操作�Q�但如果待存取的信息涉及(qi��ng)到Windows�pȝ��环境或是其他应用�E�序�? ��必��d��Win.ini�q�行��d��讉K��Q��ƈ在访问的同时发送WM_WININICHANGE消息�l�所有的��层�H�口�Q�通知其他�q�程�pȝ��初始化文件已被更攏V�?/p>
　　配置文�g里的信息之所以能为系�l�和众多不同�c�d��的应用程序读取�ƈ识别�Q�是�׃��其内部对数据的存取采用了预先�U�定�?#8220;��?值对�Q�Entry-value pairs�Q?#8221;存储�l�构, �q�对待存取的数据分门别类地进行存储。下面是�pȝ��目录下Win.ini文�g的部分内容：(x��)
[windows]
load=
run=
NullPort=None
[Desktop]
WallpaperStyle=2
Pattern=(�?
   在此�Q�配�|�文件将信息分�ؓ(f��)若干“�?#8221;�Q�节标题攑֜��Ҏ(gu��)��号中�Q�如“[Desktop]”��是Desktop节，在每一个节中包含了一些与之相关的“��?#8221;�Q��ƈ通过�{�号对其�q�行赋倹{��一般�Ş式如下：(x��)
[SECTION]
ENTRY=VALUE
　　在初始化文�g中，VALUE值只能有两种数据�c�d��Q�数值和字符丌Ӏ�Windows分别��两种数据�c�d��提供了两套API函数对初始化文�g�q�行数据��d��Q�在写入初始化文件时则只支持对字�W�串的写入，数值等�c�d��必须先进行数据类型的转换�Q�然后才能写入到初始化文件。私有初始化文�g的访问　　对私有初始化文�g的数据存取是由GetPrivateProfileInt�Q�）、GetPrivateProfileString�Q�）和W(xu��)ritePrivateProfileString�Q�）�{�三个API函数来完成的。其函数说明如下�Q?/p>
UINT GetPrivateProfileInt(LPCTSTR lpAppName, // 节名地址
                          LPCTSTR lpKeyName, // ��名地址
                          INT nDefault,      // 在项名没有找到时�q�回的缺省�?br style="line-height: 23px; ">                          LPCTSTR lpFileName // 初始化文件名地址
);
DWORD GetPrivateProfileString(LPCTSTR lpAppName, // 节名地址
                              LPCTSTR lpKeyName, // ��名地址
                              LPCTSTR lpDefault, // �~�省字符�?br style="line-height: 23px; ">                              LPTSTR lpReturnedString, // 存放字符串的�~�冲区地址
                              DWORD nSize, // �~�冲区大��?br style="line-height: 23px; ">                              LPCTSTR lpFileName // 初始化文件名地址
);
BOOL WritePrivateProfileString(LPCTSTR lpAppName, // 节名地址
                               LPCTSTR lpKeyName, // ��名地址
                               LPCTSTR lpString, // 要写入的字符串地址
                               LPCTSTR lpFileName // 初始化文件名地址
);
    其中�Q�GetPrivateProfileInt�Q�）�q�回的是初始化文件lpFileName中lpAppName节内lpKeyName��的整数��|��如果没有扑ֈ�该项则返回缺省值nDefault。如果此��目存在�Q�但��g��为整敎ͼ�则返�?。如果某��目的��g��含有非数字字�W�则只返回第一个非数字前的字符�Q�例如对�?#8220;Value = 21century”则只�q�回数�?1。初始化文�g名lpFileName可以是全路径也可以只是文件名�Q�如果不指定具体路径�Q�W(xu��)indows�pȝ��在�pȝ��目录�Ҏ(gu��)��件进行寻找。GetPrivateProfileString�Q�）和W(xu��)ritePrivateProfileString�Q�）的用法基本与之类��|��只是处理对象的数据类型不同�?/p>
2 知识应用
　　�U�有初始化文件主要用来保存同应用�E�序当前状态相关的一些信息，当程序退出后�Q�这些信息由于已写入到初始化文�g而得以保留，当程序再�ơ运行时�Q�可以通过�Ҏ(gu��)��初始化文件各��Ҏ(gu��)��据的��d��而得知此应用�E�序在上�ơ运行期间的相关信息。下面这�D�代码即通过对私有初始化文�g的访问而对�E�序的运行次数和上一�ơ的�q�行日期�q�行记录�Q?/p>
CString sPath,sMsg,sTime,sDate;
char buffer[255];
// 获取当前应用�E�序全�\�?br style="line-height: 23px; ">GetModuleFileName(NULL, buffer, MAX_PATH);
sPath = CString(buffer);
sPath = sPath.Left(sPath.ReverseFind('\\'));
// 得到初始化文件的全�\�?br style="line-height: 23px; ">sPath += "\\Sample04.ini";
// 得到�E�序累计�q�行�ơ数
UINT Time = GetPrivateProfileInt("PROGRAM", "RUNTIME", 0, sPath);
// 得到上次�q�行日期
GetPrivateProfileString("DATE", "LAST", "2002-11-1", buffer, 1000, sPath);
// 昄��从初始化文�g获取到的文�g信息
sMsg.Format("本��Y件共�q�行�q?d��?上次�q�行日期�?s", Time, CString(buffer));
AfxMessageBox(sMsg);
// 累加�q�行�ơ数,�q�保存到初始化文�?br style="line-height: 23px; ">Time++;
sTime.Format("%d", Time);
WritePrivateProfileString("PROGRAM", "RUNTIME", sTime, sPath);
// 获取当前日期,�q�保存到初始化文�?br style="line-height: 23px; ">CTime tm = CTime::GetCurrentTime();
sDate.Format("%d-%d-%d", tm.GetYear(), tm.GetMonth(), tm.GetDay());
WritePrivateProfileString("DATE", "LAST", sDate, sPath);
在程序执行后�Q�初始化文�gSample04.ini的内容�ؓ(f��)�Q?br style="line-height: 23px; ">[DATE]
LAST =2002-11-12
[PROGRAM]
RUNTIME =1
　　�pȝ��目录下的Win.ini是一�U�特�D�的初始化文�Ӟ��主要为系�l�提供初始化服务�Q�在�pȝ��启动时将被系�l�所讉K��Q��ƈ�Ҏ(gu��)��其所保存的参数值对�pȝ��q�行配置。Windows专门提供了三个API函数GetProfileInt�Q�）、GetProfileString�Q�）和W(xu��)riteProfileString�Q�）对Win.ini�q�行��d��讉K��Q�其函数用法同访问私有初始化文�g的那几个函数非常�c�M��Q�只是不必再��L��定初始化文�g名。下面是�q�三个函数的原型声明�Q?/p>
UINT GetProfileInt(LPCTSTR lpAppName, // 节名地址
                   LPCTSTR lpKeyName, // ��名地址
                   INT nDefault // 在项名没有找到时�q�回的缺省�?br style="line-height: 23px; ">);
DWORD GetProfileString(LPCTSTR lpAppName, // 节名地址
                       LPCTSTR lpKeyName, // ��名地址
                       LPCTSTR lpDefault, // �~�省字符串地址
                       LPTSTR lpReturnedString, // 存放字符串的�~�存的地址
                       DWORD nSize // �~�存的大��?br style="line-height: 23px; ">);
BOOL WriteProfileString(LPCTSTR lpAppName, // 节名地址
                        LPCTSTR lpKeyName, // ��名地址
                        LPCTSTR lpString   // 要写入字�W�串的地址
);

　　只要对前面对�U�有初始化文件进行访问的代码�E�加改动卛_��程序的配置信息��d��到Win.ini中，改动后的代码如下�Q?/p>
CString sPath,sMsg,sTime,sDate;
// 得到�E�序累计�q�行�ơ数
UINT Time = GetProfileInt("PROGRAM", "RUNTIME", 0);
// 得到上次�q�行日期
GetProfileString("DATE", "LAST", "2002-11-1", buffer, 1000);
// 昄��从初始化文�g获取到的文�g信息
sMsg.Format("本��Y件共�q�行�q?d��?上次�q�行日期�?s", Time, CString(buffer));
AfxMessageBox(sMsg);
// 累加�q�行�ơ数,�q�保存到初始化文�?br style="line-height: 23px; ">Time++;
sTime.Format("%d", Time);
WriteProfileString("PROGRAM", "RUNTIME", sTime);
// 获取当前日期,�q�保存到初始化文�?br style="line-height: 23px; ">CTime tm = CTime::GetCurrentTime();
sDate.Format("%d-%d-%d", tm.GetYear(), tm.GetMonth(), tm.GetDay());
WriteProfileString("DATE", "LAST", sDate);
   �׃��Win.ini文�g是系�l�初始化文�g�Q�在�E�序没有�q�行前文件内不含“DATE”�?#8220;PROGRAM”�{�自定义的节以及(qi��ng)其下各项�Q�因此在�E�序�W�一�ơ执行后�Q�将由WriteProfileString�Q�）函数向Win.ini文�g末尾创徏相关节、项�Q��ƈ完成数据的写入�?br style="line-height: 23px; ">
分��n到搜狐微�?/a>

叫我老王�?/a> 2010-09-27 18:14 发表评论

Doxygen+Graphviz 帮助

Wed, 08 Sep 2010 07:45:00 GMT

Doxygen+Graphviz 帮助
2010-02-02 10:33
@class 声明一个类
@fn 声明一个函�?/div>
@brief ��要说�?/div>
/**
@file RenderMgr.h
@brief 渲染��理�c?br style="line-height: normal; ">@date 3/16/2006
@author lethean
*/
@param 声明一个参�?/div>
@note 注解
@par paragraph�Q�自定义一个段落标题，�c�M��html�?lt;p>
@code 代码�C�Z��Q�需要用@endcode��闭�Q�代码段中不需要加前置*�?/div>

/**
@brief ��d��bmp文�g
@remarks ��试一�?br style="line-height: normal; ">@param [in] dc 传入一个dc用于临时操作
@param [in] filename bmp文�g�?br style="line-height: normal; ">@note 屏幕dc只能在一处被使用�Q�请��保传入屏幕dc后其他地方不�?x��)操作该dc
@par 代码�C�Z��:
@code
   //使用
   CDC* dc = AfxGetMainWindow()->GetDC();
   Bitmap bmp( dc , "test.bmp");
   AfxGetMainWindow()->ReleaseDC( dc );
@endcode
*/
对于单行的前�|�注释可以用///�Q�或�?** blahblah */ 样式
///我是一个变�?/div>
int index;
对于单行的后�|�注释，需要加一�?<"�W�号
int count; ///< 我也�?/div>
/** 协议标识 */
enum ProtoId {
PROTOID_LOGIN, /**< 登陆协议*/
PROTOID_BROWSE, /**< ��览协议*/
};
@defgroup是用来定义新模块�?/div>
集中在某个头文�g中定义所有的模块�Q�然后在属于�q�个模块的类定义处��用@ingroup
EnginePrerequisite.h�?/div>
/**
@defgroup Render Render渲染模块
@defgroup Resource Resource��理模块
@defgroup Sound Sound声音模块
@defgroup Anim Anim动画模块
@defgroup Math Math数学库模�?br style="line-height: normal; ">@defgroup Script Script脚本模块
*/
RenderMgr.h�?/div>
/**
@class RenderMgr
@ingroup Render
*/
JavaDoc�c�d��Q?/span>
/**
* ... �E�序注释 ...
*/
Qt�c�d��Q?/span>
/*!
* ... �E�序注释...
*/
单行型式�Q?/span>
/// �q�是一个简�z�型的注�?/span>
//! �q�也是一个简�z�型的注�?/span>
�?/span>Doxygen的这几种基本注释�c�d��可以徏立��以徏立文档了�Q�如果需要更多复杂功能，Doxygen�q�可以提供高�U�格式如�l�（group�Q�和列表�?/span>
Doxygen的常用注释参敎ͼ�(x��)
@file
档案的批注说明�?/span>
@author
作者的信息
@brief
用于class �?/span>function的批注中�Q�后面�ؓ(f��)class �?/span>function的简易说明�?/span>
@param
格式�?/span>
@param arg_name 参数说明
主要用于函式说明中，后面接参数的名字�Q�然后再接关于该参数的说明�?/span>
@return
后面接函��C��回值的说明。用�?/span>function的批注中。说明该函数的传回倹{�?/span>
@retval
格式�?/span>
@retval value 传回��D��?/span>
主要用于函式说明中，说明特定传回值的意义。所以后面要先接一个传回倹{��然后在放该传回值的说明�?/span>
Doxygen的��用，如下�Q?/span>
E:\>xstring目录包含下列文�g�Q?/span>
Xstring.cpp
Xstring.h
其中xstring.h里对xstring�cȝ��StrToInt�Ҏ(gu��)��的注释如下：(x��)
       /**
       *
0. 序言
��Z��码写注释一直是大多数程序员有些困扰的事情。当前程序员都能接受��Z��E�序的可�l�护性、可��L��编码的同时写注释的说法�Q�但对哪些地方应该写注释�Q�注释如何写�Q�写多少�{�这些问题，很多�E�序员仍然没有答案。更头痛的是写文档，以及(qi��ng)�l�护文档的问题，开发�h员通常可以忍受�~�写或者改动代码时�~�写或者修改对应的注释�Q�但之后需要修正相应的文档却比较困难。如果能从注释直接�{化成文档�Q�对开发�h员无疑是一�U�福韟뀂而doxygen��p��把遵守某�U�格式的注释自动转化为对应的文档�?/p>
Doxygen是基于GPL的开源项目，是一个非�怼��U�的文档系�l�，当前支持在大多数unix�Q�包括linux�Q�，windows家族�Q�Mac�pȝ��上运行，完全支持C++, C, Java, IDL�Q�Corba和Microsoft 家族�Q�语�a��Q�部分支持PHP和C#语言�Q�输出格式包括HTML、latex、RTF、ps、PDF、压�~�的HTML和unix manpage。有很多开源项目（包括前两��文章介�l�的log4cpp和CppUnit�Q�都使用了doxygen文档�pȝ��。而国内的开发�h员却使用的不多，�q�里从开发�h员��用的角度介绍�q�个工具�Q��开发�h员用最��的代�h(hu��n)��快掌握�q�种技术，�q�结合这个工��h��讨如何撰写注释的问题。以下以linux下的C++语言��Z��q�行介绍�Q�以下讨论基于doxygen1.3.3�?/p>
1. doxygen使用步骤
�׃��只是工具的��用，�q�里不介�l�它的原理，直接从��用步骤开始。Doxygen的��用步骤非常简单。主要可以分为：(x��)
1�Q�第一�ơ��用需要安装doxygen的程�?br style="line-height: normal; ">2�Q�生成doxygen配置文�g
3�Q�编码时�Q�按照某�U�格式编写注�?br style="line-height: normal; ">4�Q�生成对应文�?br style="line-height: normal; ">doxygen的安装非常简单， linux下可以直接下载安装包�q�行卛_��Q�下载源代码�~�译安装也是比较通用的编译安装命令。请参考其安装文档完成安装�?/p>
Doxygen在生成文档时可以定义��目属性以�?qi��ng)文档生成过�E�中的很多选项�Q��用下面命令能够��生一个缺省的配置文�g�Q?br style="line-height: normal; ">doxygen -g [配置文�g名]
可以�Ҏ(gu��)��目的具体需求修攚w��|�文件中对应的项�Q�具体的修改�q�程在下面介�l�。修改过的配�|�文件可以作��Z��后项目的模板�?/p>
让doxygen自动产生文档�Q��^常的注释风格可不行，需要遵循doxygen自己的格式。具体如何写doxygen认识的注释在�W?节详�l�介�l��?/p>
OK�Q�代码编完了�Q�注释也按照格式写好了，最后的文档是如何的哪？非常��单，�q�行下面的命令，相应的文档就�?x��)��生在指定的目录中�?br style="line-height: normal; ">   doxygen [配置文�g名]
需要注意的是doxygen�q�不处理所有的注释�Q�doxygen重点��x��与程序结构有关的注释�Q�比如：(x��)文�g、类、结构、函数、变量、宏�{�注释，而忽略函数内变量、代码等的注释�?/p>
2. doxygen配置文�g
doxygen配置文�g的格式是也是通常的unix下配�|�文件的格式�Q�注�?#'开始；tag = value [,value2…]�Q�对于多值的情况可以使用 tag += value [,value2…]�?/p>
对doxygen的配�|�文件的修改分�ؓ(f��)两类�Q�一�U�就是输出选项�Q�控制如何解释源代码、如何输出；一�U�就是项目相关的信息�Q�比如项目名�U�、源代码目录、输出文档目录等。对于第一�U�设�|�好后，通常所有项目可以共用一份配�|�，而后一�U�是每个��目必须讄��的。下面选择重要的，有可能需要修改的选项�q�行解释说明�Q�其他选项在配�|�文仉��有详�l�解释�?/p>
TAG �~�省�?含义
PROJECT_NAME   ��目名称
PROJECT_NUMBER   可以理解为版本信�?br style="line-height: normal; ">OUTPUT_DIRECTORY   输出文�g到的目录�Q�相对目录（doxygen�q�行目录�Q�或者绝对目�?br style="line-height: normal; ">INPUT   代码文�g或者代码所在目录，使用�I�格分割
FILE_PATTERNS *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx *.hpp *.h++ *.idl *.odl 指定INPUT的目录中特定文�g�Q�如�Q?.cpp *.c *.h
RECURSIVE NO 是否递归INPUT中目录的子目�?br style="line-height: normal; ">EXCLUDE   在INPUT目录中需要忽略的子目�?br style="line-height: normal; ">EXCLUDE_PATTERNS   明确指定的在INPUT目录中需要忽略的文�g�Q�如�Q�FromOut*.cpp

OUTPUT_LANGUAGE English 生成文档的语�a��Q�当前支�?�?0�U�语�a��Q�国内用户可以设�|��ؓ(f��)Chinese
USE_WINDOWS_ENCODING YES�Q�win版本�Q?br style="line-height: normal; ">NO�Q�unix版本�Q?�~�码格式�Q�默认即可�?br style="line-height: normal; ">EXTRACT_ALL NO 为NO�Q�只解释有doxygen格式注释的代码；为YES�Q�解析所有代码，即��没有注释。类的私有成员和所有的静态项由EXTRACT_PRIVATE�?EXTRACT_STATIC控制
EXTRACT_PRIVATE NO 是否解析�cȝ��U�有成员
EXTRACT_STATIC NO 是否解析静态项
EXTRACT_LOCAL_CLASSES YES 是否解析源文�Ӟ��cpp文�g�Q�中定义的类
SOURCE_BROWSER NO 如果为YES�Q�源代码文�g�?x��)被包含在文档�?br style="line-height: normal; ">INLINE_SOURCES NO 如果为YES�Q�函数和�cȝ��实现代码被包含在文档�?br style="line-height: normal; ">ALPHABETICAL_INDEX NO 生成一个字母序的列表，有很多类、结构等��Ҏ(gu��)��设�ؓ(f��)YES
GENERATE_HTML YES 是否生成HTML格式文档
GENERATE_HTMLHELP NO 是否生成压羃HTML格式文档�Q?chm�Q?br style="line-height: normal; ">GENERATE_LATEX YES 是否乘�Rlatex格式的文�?br style="line-height: normal; ">GENERATE_RTF NO 是否生成RTF格式的文�?br style="line-height: normal; ">GENERATE_MAN NO 是否生成man格式文档
GENERATE_XML NO 是否生成XML格式文档

3. doxygen注释
3.1 注释风格
下面是工作量最大部分，安装doxygen格式写注释。通常代码可以附上一个注释块来对代码�q�行解释�Q�一个注释块�׃��行或者多行组成。通常一个注释块包括一个简要说明（brief�Q�和一个详�l�说明（detailed�Q�，�q�两部分都是可选的。可以有多种方式标识出doxygen可识别的注释块�?br style="line-height: normal; ">1�Q�JavaDoc�c�d��的多行注释�?br style="line-height: normal; ">/**
* ….text….
*/
2�Q�QT样式的多行注释�?br style="line-height: normal; ">/*!
….text….
*/
3�Q?/// …text….
4�Q?//! …text….
��要说明有多种方式标识�Q�这里推荐��用@brief命��o(h��)强制说明�Q�例如：(x��)
/**
* @brief [some brief description ]
*      [ brief description more. ]
*
* [some more detailed description…]
*/
以上�q�些注释格式用来对紧跟其后的代码�q�行注释。doxygen也允许把注释攑ֈ�代码后面�Q�具体格式是放一�?<'到注释开始部分。例如：(x��)
int var1 ; /**< ….text…. */
int var2; ///< ….text….
注释和代码完全分��，攑֜�其他地方也是允许的，但需要��用特�D�的命��o(h��)加上名称或者声明进行标识，比如�Q�class、struct、union、enum、fn、var、def、file、namespace、package、interface�Q�这些也��是doxygen��x��的注释类型）。这里不推荐使用�Q�徏议注释尽量放在代码前后。具体��用方式参见doxygen手册�?/p>
3.2 doxygen常用注释格式
通常的选择上面的一、两�U�注释风��|��遇到头文件中各种�c�d��定义�Q�关键变量、宏的定义，在其前或者后使用 @brief 定义其简要说明，�I�Z��行后�l�箋写其详细的注释即可�?/p>
对函数的注释�Q�是比较常常需要注释的部分。除了定义其��要说明以�?qi��ng)详�l�注释，�q�可以��用param命��o(h��)对其各个参数�q�行注释�Q��用return命��o(h��)对返回��D��行注释。常见的格式如下�Q?br style="line-height: normal; ">/**
*@brief func's brief comment.
*
* Some detailed comment.
*@param a [param a 's comment.]
*@param b [param b 's comment.]
*@exception std::out_of_range [exception's comment.]
*@return [return's comment.]
*/
int func1(int a, int b);
�q�行设计�Ӟ��通常有模块的概念�Q�一个模块可能有多个�c�L��者函数组成，完成某个特定功能的代码的集合。如何对�q�个概念�q�行注释�Q�doxygen提供了group的概念，生成的模块的注释�?x��)单独放在一个模块的��面中。��用下面的格式定义一个group�?br style="line-height: normal; ">/** [group_name] [brief group description ]
* detailed group description ]
* @{
*/
code
/** @} */
group中的代码可以有自��q��注释。单�U�定义一个模块，去除{ 和}命��o(h��)卛_��。�Q何其他代码项�Q�比如类、函数、甚��x��Ӟ��如果要加入到某个模块�Q�可以在其doxygen注释中��用ingroup命��o(h��)卛_��。Group之间使用ingroup命��o(h��)�Q�可以组成树(w��i)状关�p�R�?br style="line-height: normal; ">/** @file util.cpp
* @ingroup [group_name]
* @brief file's brief info.
*/
把多个代码项一��h��加到某个模块中可以��用addtogroup命��o(h��)�Q�格式和defgroup�怼��?/p>
对于某几个功能类似的代码��（比如�c�R��函数、变量）�{�，如果希望一��h��加注释，而又不想提升到模块的概念�Q�可以通过下面的方式：(x��)
//@{
/** Comments for all below code. */
code…
//@}
对这�U�组�q�行命名可以使用name命��o(h��)。此时中间代码可以有自己的注释。如�Q?br style="line-height: normal; ">/** @name group_name
* description for group.
*/
//@{
code…
//@}
3.3 doxygen常用注释命��o(h��)
doxygen通过注释命��o(h��)识别注释中需要特�D�处理的注释�Q�比如函数的参数、返回��D��行突出显�C�。上面也提到了一些注释命令（如：(x��)brief、param、return、以�?qi��ng)group相关的命令）�Q�下面对其他一些常用的注释命��o(h��)�q�行解释说明�?br style="line-height: normal; ">@exception {exception description} 对一个异常对象进行注释�?br style="line-height: normal; ">@warning {warning message } 一些需要注意的事情
@todo { things to be done } 对将要做的事情进行注�?br style="line-height: normal; ">@see {comment with reference to other items } 一�D�包含其他部分引用的注释�Q�中间包含对其他代码��的名称�Q�自动��生对其的引用链接�?br style="line-height: normal; ">@relates 通常用做把非成员函数的注释文档包含在�cȝ��说明文档中�?br style="line-height: normal; ">@since {text} 通常用来说明从什么版本、时间写此部分代码�?br style="line-height: normal; ">@deprecated
@pre { description of the precondition } 用来说明代码��的前提条�g�?br style="line-height: normal; ">@post { description of the postcondition } 用来说明代码��之后的使用条�g�?br style="line-height: normal; ">@code 在注释中开始说明一�D�代码，直到@endcode命��o(h��)�?br style="line-height: normal; ">@endcode 注释中代码段的结束�?/p>
到此为止�Q�常用的doxygen的注释格式讨论完毕，我们能够按照一定的格式撰写doxygen认识的注释，�q�能够��用doxygen方便快捷的生成对应的文档�Q�不�q�注释中应该写些什么，如何撰写有效的注释可能是困扰开发�h员的一个更深层�ơ的问题�?/p>
4. 注释的书�?br style="line-height: normal; ">注释应该怎么写，写多�q�是写少。过多的注释甚至�?x��)干扰对代码的阅诅R��写注释的一个�ȝ��原则��是注释应该��量用来表明作者的意图�Q�至��也应该是对一部分代码的�ȝ��Q�而不应该是对代码的重复或者解释。对代码的重复或者解释的代码�Q�看代码可能更容易理解。反映作者意囄��注释解释代码的目的，从解决问题的层次上进行注释，而代码�ȝ��性注释则是从问题的解�{�的层次上进行注释�?/p>
推荐的写注释的过�E�是首先使用注释勑֋��Z��码的主要框架�Q�然后根据注释撰写相应的代码。对各种主要的数据结构、输出的函数、多个函数公用的变量�q�行详细地注释。对代码中控制结构，单一目的的语句集�q�行注释。下面是一些写注释旉��要注意的要点�Q?br style="line-height: normal; ">   避免对单独语句进行注释；
   通过注释解释��Z��么这么做、或者要做什么，使代码的读者可以只阅读注释理解代码�Q?br style="line-height: normal; ">   对读者可能会(x��)有疑问的地方�q�行注释�Q?br style="line-height: normal; ">   �Ҏ(gu��)��据定义进行注释，而不是对其��用过�E�进行注释；
   对于难于理解的代码，�q�行改写�Q�而不要试��N��过注释加以说明�Q?br style="line-height: normal; ">   对关键的控制�l�构�q�行注释�Q?br style="line-height: normal; ">   �Ҏ(gu��)��据和函数的边界、��用前提等�q�行注释�Q?/p>
      虽然使用各种IDE或者Source Insight 可以方便地在windows下阅��d��分析C/C++代码�Q�但是一步步Go to Definetion 实在令�h痛苦。Doxygen能够生成函数调用关系图，所有的函数调用关系可以一目了�Ӟ��另外他还能统计文档中所有的�c�，成员变量�Q�成员函数等。�ȝ��来说�Q�Doxygen不但能从局部把握代码，�q�能从全局审视代码�Q�后者是一般IDE和Source Insight 不能做到的。所以，使用doxygen阅读分析代码可以辑ֈ�事半功倍的效果�?/p>
          doxygen的安装很��单，到官方网站下载doxygen的windows安装�E�序卛_��。除了安装doxygen外，�q�需要安装graphviz�Q�因为doxygen需要��用graphviz的dot.exe生成调用图。graphviz在它的官方网站上也可以下载到安装�E�序。不�q�我下蝲的安装程序在安装时老是报cab文�g错误。最后我下蝲了graphviz的release文�g�Q�即安装�E�序下面的zip压羃文�g�Q�下载完成后解压�~�即可�?/p>
         安装完doxygen后即可进行适当的配�|�，然后�q�行doxyfile生成文档。基本的配置前�h早有说明�Q�不再赘�q�。需要注意的是：(x��)
        1.要勾选Dot选项卡下面的HAVE_DOT、CALL_GRAPH 、CALLER_GRAPH 选项。�ƈ在DOT_PATH下面填入dot.exe的�\径，也就是graphviz安装目录下的bin文�g夏V�?/p>
        2.��N��Wizard->Project选项卡下面的Scan recursively�Q?/p>
        3.��N��Build选项卡下面的EXTRACT_ALL、EXTRACT_PRIVATE、EXTRACT_STATIC、EXTRACT_LOCAL_CLASSES、EXTRACT_LOCAL_METHODS选项
        4.如果�E�序里面有中文，��Project选项卡下的DOXYFILE_ENCODING和Input选项卡下面的INPUT_ENCODING改�ؓ(f��)GBK
       5.可以勾掉LATEX输出�Q�这栯��省编译时�?/p>
5. 参考资�?br style="line-height: normal; ">1. doxygen homepage
http://www.stack.nl/~dimitri/doxygen/
2. doxygen manual
http://www.stack.nl/~dimitri/doxygen/manual.html
3. Code Complete: A Practical Handbook of Software Construction. Redmond, Wa.: Microsoft Press, 880 pages, 1993. ISBN: 1-55615-484-4.

4. ��介doxygen
http://www.stack.nl/~dimitri/doxygen/doxygen_intro_cn.html

5. 10 Minutes to document your code
http://www.codeproject.com/tips/doxysetup.asp
6. 使用doxygen
http://www.csdn.net/Develop/article/16%5C16383.shtm

叫我老王�?/a> 2010-09-08 15:45 发表评论

Wed, 08 Sep 2010 07:15:00 GMT

DOXYGEN��明实用教�E?/a>
Posted on 2009-03-04 21:31 �zȝ��是�q�福阅读(507) 评论(0) �~�辑收藏所属分�c? Project Management
代码写多了难免需要做文档�Q�给自己�q�是�l�别人看都需要如此，�q�次XBOX360制作�Q�前期没怎么写注释，回头改Bug都要猜半天自己写的代码是什么意思。更别提别�h写的东西�Q?00行代码也没有一句注释，�q�好不是我维护，否则要疯掉了�?/p>
�׃��一天功夫尝试了一下Doxygen的��用，�q�好不难�Q�但是有些磕��绊�l�，它自��q��文档也说不清楚，�|�上搜出来的教程也只是给出样子，遇到的问题还是靠自己��试了几十次才搞定�?/p>
不管如何�Q�常用的东西都可以弄出来了。脓(chu��ng)在下面：(x��)
-----------------------------------------------------------------------------------
1.所有注释都可以使用///开�?C++风格)�?br>
2.�c�M��前必��d��?//描述�Q�否则会(x��)产生警告【Compound �c�d�� is not documented�?br> 描述中最好不要带有此�cȝ��c�d��Q�否则会(x��)产生两个链接(但指向同一个文�?影响��观�?br>
3.public和protected�?x��)自动生成，但是private要在Expert的Build选项里勾中EXTRACT_PRIVATE�Q�static成员也是如此�?br>
4.函数注释方式
   /// Constructor【函数描�q��?br>   /// @param [in] pos       The position of Camera in world coordinate         【参数描�q?�?br>   /// @param [in] lookat    The point Camera looks at in world coordinate   【参数描�q?�?br>   BaseCamera( const D3DXVECTOR3& pos, const D3DXVECTOR3& lookat );

5.变量注释方式
   D3DXVECTOR3 m_Position;   /*!< Camera position point in world coordinate */   �?br>   D3DXVECTOR3 m_Position;   ///< Camera position point in world coordinate
两种方式产生的结果不同。前者会(x��)单独产生一块Member Data Documentation注释�Q�后者会(x��)在Pubilc/Protected/Private Attributes变量描述后紧跟注释�?br>
6.@参数和\参数相同

7.产生描述��序和注释顺序相同，一般风��gؓ(f��)

   /// 函数描述
   /// @param    参数描述
   /// @return    �q�回值描�q?br>   /// @retval    �q�回�?    �q�回�?描述
   /// @retval    �q�回�?    �q�回�?描述
   /// @remarks    注意事项
   /// @note   注意事项�Q�功能同@remarks,昄��字样不同
   /// @par   自定义图块，后面可跟�C�Z��代码之类
   /// @code(必须使用@endcode�l�束)
   /// �C�Z��代码(无需�~�进)
   /// @endcode
   /// @see    其他参考项【��生指向参考的链接�?br>   函数代码声明

8.�Ҏ(gu��)��W�号
   /// -       产生一个黑色圆�?br>
9.定义在类体里面的enum
   /// Camera types
   enum CAMERA_TYPE
   {
       CAMERA_FIRST_VIEW,/*!< Camera that looks from the first view */
       CAMERA_MODEL_VIEW,///< Camera that looks from the third view
   };
   两种风格相同�?br>
以下开始的��w��是全局非类内定义，在文件最开�?我尝试是在include之前) 必须加上�?// \file 文�g名】，否则不会(x��)生成注释【没有File Member��c(di��n)��?br>
10. 定义在文仉��面的�?br>    #define CAMERA_TYPE_NUMBER     ///< The number of camera types.       �?br>   #define CAMERA_TYPE_NUMBER     /*!< The number of camera types. */
风格说明�?�?br>
11. 非类内enum定义�?0.       两种风格相同。见9�?br>12. 非类内typedef定义�?0.    风格说明�?�?/p>

叫我老王�?/a> 2010-09-08 15:15 发表评论

99久久人人爽亚洲精品美女,精品综合久久久久久888蜜芽,精品久久久久中文字幕日本

ZEND公司的��品线

11/09/2009

VC++ ini文�g操作

Doxygen+Graphviz 帮助

DOXYGEN���明实用教�E?/a>

DOXYGEN��明实用教�E?/a>