《一个码农的自我修养》一书花了相当多的篇幅来阐述代码注释的重要性，可见注释真的很重要！好吧，其实没这本书～

不过，应该没人能质疑注释的重要性，因为没多少人愿意接手和维护一堆纯粹的逻辑符号，虽然个人项目另当别论，但不是每个人的记忆力都能突破天际地记得“原来我曾经写过这样的代码”。所以，我个人对那些写了一堆代码没一句注释的伪牛人是嗤之以鼻的。但写这篇文章的自己可能也是相当的小题大做，其实注释只要是简明清楚，都应该来者不拒，而没必要太注重形式。一个团队还是保持某一种统一的风格比较好，在大框架下的求同存异，每个人也都应该保留适合自己的空间。

本文旨在罗列一些笔者遇到的注释，仅仅只是闲谈。每个人都有适合自己的风格，无所谓好坏。

无论是C风格的注释，还是后来C++增加的单行注释，我们都再熟悉不过了：

/* Basic Comment */
// Basic Comment

但个人而言，单行注释我更多地是用在调试上，我几乎不用单行注释来写注释。单行注释常常被用在画框上，但个人感觉太粗，影响视觉。而且真正的注释和调试代码最好在视觉上分开，所以我几乎不用，以至于到后来看到自己顺手写的单行注释会非常别扭，出于一种强迫下重新改回C语言的那种风格。

///////////////////////////////////////
//
//
// This is a comment hat
//
//
///////////////////////////////////////
function swordair(){}

///////////////////////////////////////
// This is a comment hat
function swordair(){}

所以本文中的单行注释，只是一笔路过。更重要的原因是，CSS里无法使用——虽然很多人提出在CSS里支持单行注释，但直到现在也没有结果。原因很简单，因为CSS里经常出现 http:// 这样的字符串，解释器需要做额外区分。而且即使浏览器支持了，当前的众多CSS格式化工具和压缩器也都需要改进算法，所以CSS的单行注释还是遥遥无期的事情。所以，即使从统一性角度看，似乎也应该选择最为古老的注释方式 /**/

除了最为常见的单行 /× comment ×/ 以外，下面这种多行的块形注释也是比较常见，特别是在Java里。这种注释方式对于函数，类，以及文档都非常有效，因为它提供了足够多的信息量：

/*
 * Group comment block.
 * Ideal for multi-line explanations and documentation.
 */

另一种较为常见的注释类似于一个大标题，非常醒目，类似于HTML里 h1 的效果：

/*------------------------------------*\
   COMMENT CONTENTS
\*------------------------------------*/
function swordair(){}

当然，如果觉得这样的标题太大，也完全可以用小一些的标题，甚至组合大小标题达到层次的效果。常见的小标题格式可能是下面这样的：

/* common */
/* --------------------------------------------- */
function swordair(){}
/* --------------------------------------------- */

/* Generic Table
---------------------------------------------------------- */
function swordair(){}

也有人喜欢用等号代替减号，这样的标题视觉上更加突出。而且长度上的不同也可以用作层次的划分。

/* ==========================================================================
   Section comment block
   ========================================================================== */

/* Sub-section comment block
   ========================================================================== */

大部分的注释就是由 /**/ 配合星号* / 减号- / **等号=**组合起来划分区域的。因为这些字符足够简单，能制造边框效应。只要你愿意，完全可以在这些条条框框里留下任何你喜欢的信息：

/*SwordAir*/
/***********************************************************
 *                                                         *
 *    ***                          *     *                 *
 *   *                             *    * *    *           *
 *    *                            *   *   *               *
 *     *  *   *   *  ***  ** *** ***   *   *   *  ** ***   *
 *      *  *  **  * *   *  **   *  *  *******  *   **      *
 *       *  **  **  *   *  *    *  *  *     *  *   *       *
 *   ****   *   *    ***   *     ** * *     *  *   *       *
 *                                                         *
 ***********************************************************/

嘛～献丑，其实我知道自己的代码画非常难看～希望有一天能稍微拿的出手一些:)

实际上，还有更多字符可以参与到注释中来，而且它们的效果显而易见。在没有任何说明的情况下，任何人都能一看就明白：

/*↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓*/
function swordair(){}
/*↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑*/

混合文字和箭头的方式也算是挺常见的，而且往往效果很好。你能很直观的看到代码从哪里开始到哪里结束。

/* ↓↓↓ Function Start ↓↓↓ */
function swordair(){}
/* ↑↑↑ Function End ↑↑↑ */

不只是箭头，三角形也表示一种同样的意思：

/* ▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼▼ */
function swordair(){}
/* ▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲ */

其他字符也一样。当然箭头和三角都是比较常见的，之所以常见，也是有原因的。其一是因为直观，其二，其他的一些字符可能在编辑器里乱码，这样反而让代码混乱。如果是用win7或者如aptana，遇到乱码的情况要少很多。但在winXP下，notepad++在等宽字体的配置下也只能很好地显示几种，箭头和三角都是其中之一。

不过，在网页上，它们的显示完全不成问题。它们可以说是代码注释里的非主流。

/* ☰☰☰☰☰☰☰☰☰☰☰☰☰☰☰☰☰☰☰☰☰☰☰☰☰☰☰☰☰☰☰☰☰☰ */

/* ✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓ */

/* ✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗✗ */

好吧,最后这几个，连非主流都算不上，其实完全没人用～ Just For Fun!

人的认知是从概念开始的，所以人的知识结构总是再用已知的或者是已理解的东西去构建和引申那些未知的和不理解的。这话有些长，但结构问题却在不断尖锐的铸建过程中愈发凸显——说白了就是基础概念的认知。就如同带三点水的汉字很大一部分，原本都只是古代的河流名而已。

然后我就想到了那个神奇的字眼——指针。
多少有些庆幸当初还好学校没定到谭浩强的C语言书，不然毒害了一代又一代程序员的语法书可能也会把我搞死(当然观点不同，也有很多人喜欢谭浩强的)。幸好读到的是一本薄薄的但是写的却不错的C教材。至今记忆深刻的是其对于“指针”一词给于我的简洁到近乎暴露甚至是偏差的概念——

什么是指针？指针===地址。
存放指针，也就是存放地址的变量叫做指针变量，并且人们常常简称这些变量为指针。

如果baidu下指针，又会出现那些过于繁琐和修饰的定义。寄存器？内存？数？当然，变量是在寄存器里，地址指的确实是内存，其值也确实是一个数，但这一切的解释，却全部都是在混淆指针和指针变量的前提之下的。再多的绕圈子，也比不上指针就是地址这样的直白。

这次回过头来，要重新清洗下自己一知半解的概念。HTML和CSS里的诸如文档流、浮动、定位、优先级、继承等概念。一段实际应用后，理解总是加深一层。有了具体的使用后，似乎抽象的定义比具体的描述更加容易理解和记忆。在过去的2周里，对浮动、继承、行高，都有些额外的认知。过段时间整理出来。

我也明白，无论如何深入这些概念，都不能带来什么生产力。但是既然自己已经决定走这条路铸剑，就有理由把这些基础概念打扎实些。至少不至于让自己边走还要边回头眺望。

这段时间，怿飞的博客上有一篇用 JavaScript 解数学题，代码很简练优雅。于是突然想用C写写看，因为很久没写，就权当是练习也挺不错啊:)

题目是这样的：一个六位数，分别用2，3，4，5，6乘它，得到的五个新数仍是由原数中的六个数字组成，只是位置不同，则此六位数是多少？

#include <stdio.h>
#include <string.h>

#define DIGIT 6
#define MULTI 5

void swap( char *a, char *b ){
    int tmp;
    tmp = *a;
    *a = *b;
    *b = tmp;
}

void bubbleSort( char arr[] )
{
    int i,j;
    for(i = 0; i < DIGIT; i++){
        for(j = 0; j < DIGIT-1; j++){
            if ( arr[j] > arr[j+1] ){
                swap( arr+j, arr+j+1 );
            }
        }
    }
}

int main(){
    int num, numCopy, i, j, ind;
    int mul[MULTI] = {2,3,4,5,6};
    char indStr[DIGIT+1];
    char StrToCmp[DIGIT+1];
    for( num = 1000000/6; num >= 100000; num-- ){
        numCopy = num;
        for( i = 0; i < DIGIT; i++ ){
            StrToCmp[i] = numCopy%10+48;
            numCopy /= 10;
        }
        StrToCmp[DIGIT] = '\0';
        bubbleSort( StrToCmp );
        for( i = 0; i < MULTI; i++ ){
            ind = num * mul[i];
            for( j = 0; j < DIGIT; j++){
                indStr[j] = ind%10 + 48;
                ind /= 10;
            }
            indStr[DIGIT] = '\0';
            bubbleSort( indStr );
            if( strcmp( StrToCmp, indStr )){
                j = 0;
                break;
            }
        }
        if(j){
            printf( "This number is %d\n", num );
        }
    }
    getchar();
    return 0;
}

无奈水平不高，用C写费了不少事。主要是排序(总觉得这里用个qsort会很别扭)以及转换。中间的转换步骤因为又有段时间不做题的关系，有点生疏。不过最后还是捣鼓出来了，尽管写的比较简陋~。

答案是：142857。

自大学时代在ZOJ上最后做了第7道ACM的题目之后，已经过了4年多的时间。现在想来那时真的不懂得如何放置自己的精力。
这次同事辞呈去浙大考研，这么一次偶然的机会，我们俩就跑到ZOJ上。我点开了那个几乎快被我忘记的帐号，记录里还是那七道题，真是令人怀念。

刚刚学C，指针都还搞不清楚的时候那会，记得即使是最简单的题目，都会出好几次Wrong Answer。举步维艰地做了7道题之后，心思就不知道去了哪里。之后虽然学了数据结构、算法，却再也没摸过ACM。直到现在，拾起模糊的C，打开Dev C++，那种 “好吧，让我们再来干掉一道题吧” 的感觉居然又涌了上来。

于是就开始从同事推荐的Beginner开始做起，练习基本的输入输出，偶尔拿几道AC率20%的题活动下似乎是快锈掉的头脑。尽管算法什么的真的早就已经不记得多少，但是和当年做完全是两样的感觉——当年还在纠结怎么输入输出数据，现在则真的是在想法子解决问题。

写着最初学习的C语言，让我又开始认真思考这些年自己的轨迹。从C，C++，C#，Java，JS，PHP，Ruby，AS这一路接触下来，回过头来安安心心地用C做几道ACM的题目，真的是有一种返璞归真的感觉。学习新的东西的同时，不可避免的在渐渐遗忘那些印象不深的拼拼凑凑的知识。以前不曾深刻体会，但现在多少能够明白，程序，都一样。

现在的进度比较快吧。每天大概5道题，半个月过去了，已经快逼近百道。等到基础题练习的差不多了，速度就会慢到几天甚至几个周才一道吧。这段时间还能温习下经典算法，从箱子里挖出那本大学时的算法分析教材，居然还能看的津津有味。

即使是计算机这一飞速变化的领域，也存在着很多经久不变的东西。网络的飞速发展，同样有相对稳定的存在。不应该被技术的更替牵着鼻子走，独树一帜专修广达，才是正途。

“程序员要有领域”，留下这句话考研去的同事，祝他一切顺利，他引用的这句话，我也深以为然。

以前不止一次搭建过wordpress，但最终都宣告失败。原因多种多样，忙碌者有之，兴尽者有之，或者，无墨者亦有之。但终究是不想放弃的。

过去的几年，学了很多，但都疏于梳理，以至荒废。

VB C C++ Java C# XHTML+CSS JavaScript PHP ActionScript Ruby Perl

Photoshop Flash Fireworks Illustrator CorelDRAW AutoCAD 3DsMax Maya

渐行渐远的内容，以及愈发冗长的行径线路，都充斥着迷惑。当再次回首时忽然有一种冲动，摘录、梳理、铭记，一路走来，挺有趣的。

/*C*/
#include <stdio.h>
int main()
{
	printf("Hello,world!\n");
	return 0;
}
```

```
//C++
#include <iostream>
using namespace std;
int main()
{
	cout<<"Hello,world!"<<endl;
	return 0;
}
```

```
//Java
public class Hello{
	public static void main(String args[]) {
		System.out.println("Hello,world!");
	}
}
```

```
//C#
using System;
class Hello
{
	public static void Main(){
		Console.WriteLine("Hello,world!");
	}
}
```


```
//JavaScript
alert("Hello,world!");
```

```
//PHP
<?php
	echo "Hello,world!";
?>
```

```
//ActionScript
class Hello{
	function Hello():void{
		trace("Hello,world!");
	}
}
```

```
#ruby
puts "Hello,world!";
```

```
#perl
print "Hello,world!";
```

20 December 2013: 这篇是用wordpress发布的第一篇文章，虽然在2014年我会开始使用Ghost来搭建我的网站和博客，不过还是要怀念一下这4年来的wordpress体验。从这篇文章开始，我陆续要将我迁移的所有文章更新到markdown的格式，虽然传统的html也可以正常在Ghost里工作，不过还是希望做一个完整的迁移。要做的工作还有很多，需要做链接和图片的修补。对于整个网站来说，还有很大部分的静态内容需要一起迁移。我希望能在2014年前完成这些工作，在新年能有一个新的开始。