个人项目作业（wc.exe)

1.GitHub项目地址

项目介绍：

题目描述

Word Count
1. 实现一个简单而完整的软件工具（源程序特征统计程序）。
2. 进行单元测试、回归测试、效能测试，在实现上述程序的过程中使用相关的工具。
3. 进行个人软件过程（PSP）的实践，逐步记录自己在每个软件工程环节花费的时间。

WC 项目要求

wc.exe 是一个常见的工具，它能统计文本文件的字符数、单词数和行数。这个项目要求写一个命令行程序，模仿已有wc.exe 的功能，并加以扩充，给出某程序设计语言源文件的字符数、单词数和行数。

实现一个统计程序，它能正确统计程序文件中的字符数、单词数、行数，以及还具备其他扩展功能，并能够快速地处理多个文件。
具体功能要求：
程序处理用户需求的模式为：

wc.exe [parameter] [file_name]

基本功能列表：

wc.exe -c file.c //返回文件 file.c 的字符数

wc.exe -w file.c //返回文件 file.c 的词的数目

wc.exe -l file.c //返回文件 file.c 的行数

扩展功能：
-s 递归处理目录下符合条件的文件。
-a 返回更复杂的数据（代码行 / 空行 / 注释行）。

空行：本行全部是空格或格式控制字符，如果包括代码，则只有不超过一个可显示的字符，例如“{”。

代码行：本行包括多于一个字符的代码。

注释行：本行不是代码行，并且本行包括注释。一个有趣的例子是有些程序员会在单字符后面加注释：

} //注释
在这种情况下，这一行属于注释行。

[file_name]: 文件或目录名，可以处理一般通配符。

高级功能：

-x 参数。这个参数单独使用。如果命令行有这个参数，则程序会显示图形界面，用户可以通过界面选取单个文件，程序就会显示文件的字符数、行数等全部统计信息。

需求举例：
　　wc.exe -s -a *.c

返回当前目录及子目录中所有*.c 文件的代码行数、空行数、注释行数。

2.PSP预计时间

PSP2.1	Personal Software Process Stages	预估耗时（分钟）	实际耗时（分钟）
Planning	计划	30
· Estimate	· 估计这个任务需要多少时间	30
Development	开发	180
· Analysis	· 需求分析 (包括学习新技术)	200
· Design Spec	· 生成设计文档	30
· Design Review	· 设计复审 (和同事审核设计文档)	0
· Coding Standard	· 代码规范 (为目前的开发制定合适的规范)	20
· Design	· 具体设计	30
· Coding	· 具体编码	360
· Code Review	· 代码复审	20
· Test	· 测试（自我测试，修改代码，提交修改）	120
Reporting	报告	120
· Test Report	· 测试报告	60
· Size Measurement	· 计算工作量	30
· Postmortem & Process Improvement Plan	· 事后总结, 并提出过程改进计划	60
合计		1290

3.解题思路

拿到题目后首先想到的是：要对文件进行读写操作，但这是以前的编程经历中从未涉及到的，所以首先去学习了c语言文件读写相关的知识。

学习相关知识后，就到了该如何实现功能的问题了，解决方法是划分为几个功能模块，每个模块实现一个功能。

4.设计实现过程

设计字符数统计函数void CharCount()：当判定为字符便计数，非字符则不计。

设计单词数统计函数void WordCount()：通过从第一个字母开始读取连续的字母。

设计行数统计函数 void LineCount()：判断行数可以判断是否出现‘ ’或‘ ’来判断。
设计扩展功能统计函数int Extend()：

　　　　1、空行计算，如果一行中没有字符或者最多有一个'{'或者'}'(可能遇到‘ ’或者‘ ’)算为空行。

　　　　2、注释行计算，通过读取第一个字符为/进入判断，读取第二个字符为*或者/实现。

　　　　3、代码行计算，排除空行和注释行之外的即为代码行。

5.代码说明

主函数：

 1 int a=0;
 2 int b=0;
 3 int c=0;
 4 int main() { //主函数
 5     void CharCount(char filename[]);//字符数统计函数 
 6     void WordCount(char filename[]);//单词数统计函数
 7     void LineCount(char filename[]);//行数统计函数  
 8     int Extend(char filename[]);//扩展功能统计函数 
 9     char input[10], filename[32];
10     while (1) {
11         //输入指令
12         printf("wc.exe - c file.c      返回文件的字符数
wc.exe - w file.c      返回文件的词的数目
wc.exe - l file.c      返回文件的行数
wc.exe - a file.c      返回更复杂的数据（代码行 / 空行 / 注释行）
wc.exe - o file.c      退出
请输入指令：- ");
13         scanf("%s",&input);
14         
15         switch(input[0]){
16             case 'c':  //字符数
17                 printf("请输入文件名：");//输入文件名
18                 scanf("%s", &filename);
19                 CharCount(filename);
20                 printf("文件的字符数为：%d",a);
21                 break;
22         
23             case 'w':  //词数                
24                 printf("请输入文件名：");//输入文件名
25                 scanf("%s", &filename);
26                 WordCount(filename);
27                 printf("文件的词数为：%d", b);
28                 break;
29 
30             case 'l':  //行数
31                 printf("请输入文件名：");//输入文件名
32                 scanf("%s", &filename);           
33                 LineCount(filename);
34                 printf("文件的行数为：%d", c);
35                 break;
36 
37             case 'a':    //返回更复杂的数据（代码行 / 空行 / 注释行）。
38                 printf("请输入文件名：");//输入文件名
39                 scanf("%s", &filename);
40                 Extend(filename);
41                 break;
42         
43             case 'o':  //退出
44                 return 0;
45 
46             default:
47                 printf("你输入的指令有误！请重新输入");
48                 break;
49         }
50 
51     }
52     system("pause");
53     return 0;
54 }

各子模块功能函数：

计算字符数：

 1 void CharCount(char filename[]){//字符数统计函数 
 2     FILE *fp=NULL;
 3     fp=fopen(filename,"r");
 4     if(fp==NULL){
 5         printf("寻找文件失败
");
 6         exit(-1);
 7     }
 8     char ch;
 9     ch = fgetc(fp);
10     while(ch!=EOF){
11         if (ch != ' '&&ch != '
'&&ch != '	'&&ch != ','&&ch != '.'&&ch != '!'&&ch != ';'&&ch != '=');
12         a++; 
13         ch = fgetc(fp);  
14     }
15     a--;
16     fclose(fp);
17 }

计算词数：

 1 void WordCount(char filename[]){//单词数统计函数 
 2     FILE *fp = NULL;
 3     fp=fopen(filename,"r");
 4     if(fp==NULL){
 5         printf("寻找文件失败
");
 6         exit(-1);
 7     }
 8     char fchar = 0;
 9     fchar = fgetc(fp);
10     while (fchar != EOF)
11     {
12         if ((fchar >= 'a' && fchar <= 'z') || (fchar >= 'A' && fchar <= 'Z') )//遇到字母
13         {
14             while ((fchar >= 'a' && fchar <= 'z') || (fchar >= 'A' && fchar <= 'Z'))
15                 fchar = fgetc(fp);
16                 b++;
17                 fchar = fgetc(fp);
18         }
19         else {
20             fchar = fgetc(fp);
21         }
22     }
23     fclose(fp);
24   
25 }

计算行数：

 1 void LineCount(char filename[]){//行数统计函数 
 2     FILE *fp = NULL;
 3     fp=fopen(filename,"r");
 4     if(fp==NULL){
 5         printf("寻找文件失败
");
 6         exit(-1);
 7     }
 8     char ch;
 9     ch = fgetc(fp);
10     while (ch != EOF)
11     {
12         if (ch == '
' || ch == '	')
13             c++;
14         ch = fgetc(fp);
15     }
16     fclose(fp);
17 }

扩展功能函数：

 1 int Extend(char filename[]) {  //扩展功能 
 2     FILE *fp = NULL;
 3     fp = fopen(filename, "r");
 4     if (fp == NULL) {
 5         printf("寻找文件失败
");
 6         exit(-1);
 7     }
 8 
 9     char fchar = 0;
10     int emptyline = 0, code = 0, note = 0;
11     int l = 0, n = 0, c = 0;//l为空行类型，0是无字符空行，1是1字符空行；n为注释类型，0为非注释行，1为单注释行，2为多注释行,c为代码类型
12 
13     while (fchar != EOF) {
14         fchar = fgetc(fp);
15             if (l == 0 || l == 1) {//如果开始是空格或制表，开始判断是不是空行或者注释行或者代码行
16                 if (fchar == '
') {//回车之前没有字符，空行;1字符进入后也是没有其他字符
17                     emptyline++;
18                     l = 0;
19                     continue;
20                 }
21                 else if (fchar == '/') {//注释判断
22                     fchar = fgetc(fp);
23                     if (fchar == '/') {//单行注释
24                         n = 1;
25                         while (fchar != EOF && fchar != '
') {
26                             fchar = fgetc(fp);
27                         }
28                         n = 0;
29                         note++;
30                         continue;
31                     }
32                     else if (fchar == '*') {//多行注释
33                         n = 2;
34                         continue;
35                     }
36                 }
37                 else if( fchar == '}' && l == 0){
38                     l = 1;        //一字符空行
39                     continue;
40                 }
41                 else if(fchar == ' ' || fchar == '	'){
42                     continue;
43                 }
44                 else {
45                     c = 1;
46                 }
47             }
48             if (c == 1) {//代码行
49                 while (fchar != EOF && fchar != '
') {
50                     fchar = fgetc(fp);
51                 }
52                 l = 0;//状态变回空行
53                 code++;
54                 continue;
55             }
56             if (n == 2) {//多行注释
57                 while (fchar != EOF && fchar != '*') {
58                     while (fchar != EOF && fchar != '
') {
59                         fchar = fgetc(fp);
60                     }
61                     note++;
62                     fchar = fgetc(fp);
63                 }
64                 fchar = fgetc(fp);
65                 if (fchar == '/') {//多行结束
66                     n = 0;
67                 }
68                 continue;
69             }
70     }
71     printf("
共有空行数: %d  
代码行数: %d  
注释行数: %d
", emptyline, code, note);
72     fclose(fp);
73 }

6.测试运行

基本功能测试用例

测试-c功能：

测试-w功能：

测试-l功能：

扩展功能测试用例

测试-a功能：

7.实际花费的时间

PSP2.1	Personal Software Process Stages	预估耗时（分钟）	实际耗时（分钟）
Planning	计划	30	35
· Estimate	· 估计这个任务需要多少时间	30	20
Development	开发	180	240
· Analysis	· 需求分析 (包括学习新技术)	200	180
· Design Spec	· 生成设计文档	30	20
· Design Review	· 设计复审 (和同事审核设计文档)	0	0
· Coding Standard	· 代码规范 (为目前的开发制定合适的规范)	20	10
· Design	· 具体设计	30	60
· Coding	· 具体编码	360	540
· Code Review	· 代码复审	20	60
· Test	· 测试（自我测试，修改代码，提交修改）	120	180
Reporting	报告	120	100
· Test Report	· 测试报告	60	30
· Size Measurement	· 计算工作量	30	20
· Postmortem & Process Improvement Plan	· 事后总结, 并提出过程改进计划	60	40
合计		1290	1535

8.项目小结

收获：作为第一次项目经历，对软件工程的设计流程有了新的认识，一个项目的实现，重要的往往不是代码的质量，而是一个好的框架和一个良好的开发习惯，在这次开发过程中深刻的认识到这两点的重要性。

不足：基础知识的不足，导致前期准备时间过长。解决问题能力不足，导致编码所需时间长、错误多，部分功能完全没能力实现，需多学、多练。开发经验少，整个开发过程并不流畅。