翻到几年前的代码,我惊了。
扫描二维码
随时随地手机看文章
#关于程序注释#
void wanggei(int a,int b)//画网格
{
initgraph(20*a,20*b);
setbkcolor(BLUE);
cleardevice();
setwritemode(R2_XORPEN);
setfillcolor(WHITE);
settextstyle(15, 0, _T("楷体")); // 操作说明
outtextxy(20, 10, _T("操作说明"));
outtextxy(20, 30, _T("w:旋转"));
outtextxy(20, 50, _T("a:左移"));
outtextxy(20, 70, _T("d:右移"));
outtextxy(20, 90, _T("s:下移"));
return;
}
void suiji(int a[],int b[])//生成随机方块
{
int n;
srand((unsigned)time(NULL));
n=rand()%(X-9);
if(n==1)
{
a[0]=1+n;b[0]=Y+1;a[1]=1+n;b[1]=Y+2;a[2]=2+n;b[2]=Y+1;a[3]=2+n;b[3]=Y+2;//正方形的方块。
return;
}
if(n==2)
{
a[0]=1+n;b[0]=Y+1;a[1]=2+n;b[1]=Y+1;a[2]=3+n;b[2]=Y+1;a[3]=2+n;b[3]=Y+2;
return;
}
if(n==3)
{
a[0]=1+n;b[0]=Y+1;a[1]=1+n;b[1]=Y+2;a[2]=1+n;b[2]=Y+3;a[3]=1+n;b[3]=Y+4;
return;
}
if(n==4)
{
a[0]=1+n;b[0]=Y+1;a[1]=2+n;b[1]=Y+1;a[2]=2+n;b[2]=Y+2;a[3]=2+n;b[3]=Y+3;
return;
}
if(n==5)
{
a[0]=1+n;b[0]=Y+3;a[1]=1+n;b[1]=Y+1;a[2]=1+n;b[2]=Y+2;a[3]=2+n;b[3]=Y+1;
return;
}
if(n==6)
{
a[0]=2+n;b[0]=Y+1;a[1]=2+n;b[1]=Y+2;a[2]=1+n;b[2]=Y+2;a[3]=1+n;b[3]=Y+3;
return;
}
if(n==7)
{
a[0]=1+n;b[0]=Y+1;a[1]=1+n;b[1]=Y+2;a[2]=2+n;b[2]=Y+2;a[3]=2+n;b[3]=Y+3;
return;
}
}
void Judge(int a[],int b[],int n,int x[X+2][Y+2],int y[X+2][Y+2],int speed)//游戏规则
{
int i=0,j=0,k,a0[4],b0[4];
char c;
while(1)
{
for(j=1;j<=Y;j++) //消去的行
{
for(i=1;i<=X;i++)
if(i!=x[i][j]&&j!=y[i][j])break;
if(i==X+1)
{
for(i=1;i<=X;i++)
{
Rectangle(i,j);
x[i][j]=0;
y[i][j]=0;
}
for(i=1;i<=X;i++)
for(k=j+1;k<=Y;k++)
if(x[i][k]==i&&y[i][k]==k)
{
x[i][k]=0;
y[i][k]=0;
x[i][k-1]=i;
y[i][k-1]=k-1;
Rectangle(i,k);
Rectangle(i,k-1);
}
}
}
for(i=0;i<n;i++)
Rectangle(a[i],b[i]);
Sleep(1000-100*speed);
for(i=0;i<n;i++)
Rectangle(a[i],b[i]);
for(i=0;i<n;i++)
{
a0[i]=a[i];
b0[i]=b[i];
}
if(kbhit())
{
c=getch();
Move(a,b,n,c);
if(c=='s')speed=10;
}
else
{
Move(a,b,n,'0');
for(i=0;i<X+2;i++)
for(j=0;j<Y+2;j++)
for(k=0;k<n;k++)
if(a[k]==x[i][j]&&b[k]==y[i][j])
{
for(i=0;i<n;i++)
{
a[i]=a0[i];
b[i]=b0[i];
}
return;
}
}
for(i=0;i<X+2;i++)
for(j=0;j<Y+2;j++)
for(k=0;k<n;k++)
if(a[k]==x[i][j]&&b[k]==y[i][j])
{
for(i=0;i<n;i++)
{
a[i]=a0[i];
b[i]=b0[i];
}
goto ex;
}
ex:;
}
}
但,如果程序结构好,注释也多,代码的可读性应该就会更强了。
毕竟程序员最讨厌的两件事就是:
1、别人的代码不写注释。
2、自己写完代码还要写注释。
《代码大全》,讲到注释有以下几个种类:
1、复述代码—这种把代码复述一遍的注释最无聊。
2、解释代码—解释代码的思路,这种代码可以有,但是大部分时候是因为代码写得不好。
3、概述代码一句话告诉别人代码做了什么,很好的注释。
4、代码意图说明—指出代码要解决的问题。
5、传达代码无法表述的信息—非常重要。
不知道各位朋友喜欢写哪种注释,还是喜欢写完代码绝对不回头。
当然,注释只是项目文档之一,还可能要写设计文档、测试用例、变更列表、使用手册等多种文档去让别人理解及维护项目。
这样的话,如果只是单写个程序注释,应该算上是一件幸福的事情。
免责声明:本文内容由21ic获得授权后发布,版权归原作者所有,本平台仅提供信息存储服务。文章仅代表作者个人观点,不代表本平台立场,如有问题,请联系我们,谢谢!