博客

You could use the macro function to add function header that could use by doxygen.

It is tested in Visual studio 2008.

    Sub FunctionHeader()
        Dim objEditPt As EditPoint
        Dim currentLine As Integer
        Dim endline As Integer
        Dim findString As String
        Dim findString2 As String
        Dim firstPosition As Integer
        Dim voidPosition As Integer
        Dim BoolPosition As Integer
        Dim PtrPosition As Integer
        Dim lastPosition As Integer

        objEditPt = DTE.ActiveDocument.Selection.ActivePoint.CreateEditPoint
        currentLine = objEditPt.Line
        objEditPt.EndOfDocument()
        endLine = objEditPt.Line

        If (endLine > currentLine + 50) Then
            endLine = currentLine + 50
        End If

        findString = objEditPt.GetLines(currentLine, endLine)

        ‘get params with “(” and “)”
        findString2 = “”
        Dim strList As New System.Collections.ArrayList

        Dim findVoid As Boolean = False
        Dim findBool As Boolean = False
        Dim findPtr As Boolean = False

        firstPosition = InStr(findString, “(“)
        voidPosition = InStr(findString, “void”)
        BoolPosition = InStr(findString, “BOOL “)
        PtrPosition = InStr(findString, “* “)
        If (firstPosition >= 1) Then
            If (voidPosition >= 1 And voidPosition < firstPosition) Then
                findVoid = True
            End If

            If (PtrPosition >= 1 And PtrPosition < firstPosition) Then
                findPtr = True
            End If

            If (BoolPosition >= 1 And BoolPosition < firstPosition) Then
                findBool = True
            End If

            lastPosition = InStr(firstPosition, findString, “)”)
            If (lastPosition >= firstPosition) Then
                findString2 = Mid(findString, firstPosition + 1, lastPosition – firstPosition – 1)
                strList.AddRange(findString2.Split(“,”c))
            End If
        End If

        DTE.ActiveDocument.Selection.NewLine()
        DTE.ActiveDocument.Selection.Text = “/**”
        DTE.ActiveDocument.Selection.NewLine()
        DTE.ActiveDocument.Selection.Text = “* ”
        DTE.ActiveDocument.Selection.NewLine()
        DTE.ActiveDocument.Selection.Text = “* ”
        DTE.ActiveDocument.Selection.NewLine()

        Dim listCount As Integer
        Dim newString As String

        listCount = strList.Count
        For Each stringElement In strList
            stringElement = Replace(stringElement, vbCr, “”)
            stringElement = Replace(stringElement, vbLf, “”)
            stringElement = Replace(stringElement, vbTab, ” “)
            stringElement = Trim(stringElement)
            If stringElement.Length <= 0 Then
                Continue For
            End If

            Dim bAsIn = “[in] ”
            If InStr(stringElement, “*”) Then
                bAsIn = “[out] ”
            End If

            newString = “* @param ” + bAsIn + stringElement + ” : ”
            DTE.ActiveDocument.Selection.Text = newString
            DTE.ActiveDocument.Selection.NewLine()
        Next

        DTE.ActiveDocument.Selection.Text = “* ”
        DTE.ActiveDocument.Selection.NewLine()

        If findVoid Then
            DTE.ActiveDocument.Selection.Text = “* @return void.”
            DTE.ActiveDocument.Selection.NewLine()
        ElseIf findBool Then
            DTE.ActiveDocument.Selection.Text = “* @return True success;”
            DTE.ActiveDocument.Selection.NewLine()
            DTE.ActiveDocument.Selection.Text = ”          False, failed;”
            DTE.ActiveDocument.Selection.NewLine()
        ElseIf findPtr Then
            DTE.ActiveDocument.Selection.Text = “* @return valid pointer; or NULL.”
            DTE.ActiveDocument.Selection.NewLine()
        Else
            DTE.ActiveDocument.Selection.Text = “* @return S_OK : the processing completed successfully;”
            DTE.ActiveDocument.Selection.NewLine()
            DTE.ActiveDocument.Selection.Text = “*         E_POINTER : a NULL pointer parameter was passed;”
            DTE.ActiveDocument.Selection.NewLine()
            DTE.ActiveDocument.Selection.Text = “*         E_FAIL : Some other failure occurred;”
            DTE.ActiveDocument.Selection.NewLine()
        End If

        DTE.ActiveDocument.Selection.Text = “* ”
        DTE.ActiveDocument.Selection.NewLine()
        DTE.ActiveDocument.Selection.Text = “*/”

    End Sub

http://code.google.com/p/google-styleguide/ 这是google使用的一个C++代码风格规范，可以作为平常开发的参考。

作为风格参考，google还推出了一个cpplint.py的脚本，可以用作风格规范检查使用。可以在这里下载

http://google-styleguide.googlecode.com/svn/trunk/cpplint

在windows下的使用方法也非常简单，（安装python后）把cpplint.py放在项目目录下，然后进入命令行，敲打命令如下：

C:\temp\>cpplint.py –output=vs7 test1.cpp

可以通过cpplint.py –help来查看帮助。注意，命令行参数都是两个横线（–）。

在Tony bai的博客上看到他提起strlen的性能问题，这还真是比较有意思的一个话题。

我在前一阵专门用两周时间来对代码做优化，问题的起因是我们组有人提出来程序跑的慢，另外使用接口功能的外国同事也提起过几次。关于优化还专门做了一张ppt演示，有空节选一下分享出来。不过有意思的是，最后发现速度的最大瓶颈其实并不是在我们新加了多少功能，而是两方的客户端调用代码都写的太烂了，这种巧合都能碰到一起，太奇妙了。

印象中BSD的kernal开发人员delphij也曾经提到过strlen，开起google一搜果然如此。strlen这个函数貌似简单容易写，但是里面的花花肠还真不少呢。这也间接的说明了阅读学习经典代码的重要性。

编程中，经常会用到一些开源库或者项目，比如c++中经常用到的boost。

google的主要软件架构基于linux，c，c++，java，而且作为一个创新型的公司，他们也经常性的回馈社区一些优秀的代码。在不断的反馈修改中，代码质量得到了提高，用户得到优质服务，这也算是双赢的结果。而且google里面牛人多，写出来的代码质量相对比较高，有很大的学习价值。

周末无事，搜索code.google.com/p，找到一些有趣的google参与的项目，在这里简单分享一下。有一些开源项目没有列出来，主要因为平台是linux-only或者对项目本身不感兴趣。如果想找完全列表，可以在这里看到：
http://code.google.com/hosting/projects.html

另外也可以使用google这个label来搜索code.google.com/p，但是这样也许搜出来的并不一定是google开发的项目。

———————————-

http://code.google.com/p/omaha/

这是最新放出来的google update的代码，想做windows在线update功能的可以参考。(c++)

http://code.google.com/p/google-breakpad

http://code.google.com/p/google-glog/

breakpad，一个项目的开始需要做一些什么样的基础设施，crash dump和运行logging毫无疑问都是应该有的，这个项目就是负责在crash的时候收集信息，发出crash dump报告的。(c++)

glog就是用于项目中logging功能的，一般桌面程序不太需要logging，但是对于大规模长时间服务的系统来说，logging功能一定要有，而且要记录足够多的信息。(c++)

http://code.google.com/p/protobuf/

protocol buffer，可以用来在跨进程、跨机器，不同操作系统，不同编程语言之间进行数据交换。类似于微软的COM IDL或者XML，但是解析速度更快，需要传输字节数更少。(c++, java, python)

http://code.google.com/p/chromium/

google chrome浏览器项目，基于webkit，想自己开发个浏览器，学习这个吧。(c++)

http://code.google.com/p/google-perftools/

TCMalloc，heap检测，是一个google用于性能检测的工具。(c++)

http://code.google.com/p/jaikuengine/

jaiku是被google收购的微博客服务，类似twitter，但是google买下了以后没有什么动作。在将jaiku移植到appengine平台以后就做出了开源而且不再继续开发的决定，jaiku也就这样了。当然，幸福的还是我们这些程序员。（python）

http://code.google.com/p/googleappengine/

这个只是appengine在桌面进行测试运行的项目，相比google服务器上的appengine，肯定还是有着相当大的区别。不过我们也可以从中学到google对于python的使用，不是么？（python）

http://code.google.com/p/v8/

google chrome浏览器中的javascript引擎项目。可以单独用作解析javascript，号称速度非常快。(c++)

http://code.google.com/p/app-engine-site-creator/

使用appengine建立企业及个人网站的朋友，可以试试这个项目。（python）

http://code.google.com/p/googlemock/

http://code.google.com/p/googletest/

测试框架组合，mock怎么用实话说我也不清楚。

http://code.google.com/p/google-styleguide/

google c++编码规范，可以学习学习，网上有中文版的了。

http://code.google.com/p/google-email-uploader

outlook邮件上传到gmail，可以学学c#。