个人项目作业（wc.exe)

1.GitHub项目地址

https://github.com/QiuBin666/WC

项目介绍：

题目描述

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()：判断行数可以判断是否出现‘\n’或‘\t’来判断。
设计扩展功能统计函数int Extend()：

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

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

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

5.代码说明 

主函数：

 int a=;
 int b=;
 int c=;
 int main() { //主函数
     void CharCount(char filename[]);//字符数统计函数
     void WordCount(char filename[]);//单词数统计函数
     void LineCount(char filename[]);//行数统计函数
     int Extend(char filename[]);//扩展功能统计函数
     char input[], filename[];
     while () {
         //输入指令
         printf("wc.exe - c file.c      返回文件的字符数\nwc.exe - w file.c      返回文件的词的数目\nwc.exe - l file.c      返回文件的行数\nwc.exe - a file.c      返回更复杂的数据（代码行 / 空行 / 注释行）\nwc.exe - o file.c      退出\n请输入指令：- ");
         scanf("%s",&input);

         switch(input[]){
             case 'c':  //字符数
                 printf("请输入文件名：");//输入文件名
                 scanf("%s", &filename);
                 CharCount(filename);
                 printf("文件的字符数为：%d",a);
                 break;

             case 'w':  //词数
                 printf("请输入文件名：");//输入文件名
                 scanf("%s", &filename);
                 WordCount(filename);
                 printf("文件的词数为：%d", b);
                 break;

             case 'l':  //行数
                 printf("请输入文件名：");//输入文件名
                 scanf("%s", &filename);
                 LineCount(filename);
                 printf("文件的行数为：%d", c);
                 break;

             case 'a':    //返回更复杂的数据（代码行 / 空行 / 注释行）。
                 printf("请输入文件名：");//输入文件名
                 scanf("%s", &filename);
                 Extend(filename);
                 break;

             case 'o':  //退出
                 return ;

             default:
                 printf("你输入的指令有误！请重新输入");
                 break;
         }

     }
     system("pause");
     return ;
 }

各子模块功能函数：

计算字符数：

 void CharCount(char filename[]){//字符数统计函数
     FILE *fp=NULL;
     fp=fopen(filename,"r");
     if(fp==NULL){
         printf("寻找文件失败\n");
         exit(-);
     }
     char ch;
     ch = fgetc(fp);
     while(ch!=EOF){
         if (ch != ' '&&ch != '\n'&&ch != '\t'&&ch != ','&&ch != '.'&&ch != '!'&&ch != ';'&&ch != '=');
         a++;
         ch = fgetc(fp);
     }
     a--;
     fclose(fp);
 }

计算词数：

 void WordCount(char filename[]){//单词数统计函数
     FILE *fp = NULL;
     fp=fopen(filename,"r");
     if(fp==NULL){
         printf("寻找文件失败\n");
         exit(-);
     }
     char fchar = ;
     fchar = fgetc(fp);
     while (fchar != EOF)
     {
         if ((fchar >= 'a' && fchar <= 'z') || (fchar >= 'A' && fchar <= 'Z') )//遇到字母
         {
             while ((fchar >= 'a' && fchar <= 'z') || (fchar >= 'A' && fchar <= 'Z'))
                 fchar = fgetc(fp);
                 b++;
                 fchar = fgetc(fp);
         }
         else {
             fchar = fgetc(fp);
         }
     }
     fclose(fp);

 }

计算行数：

 void LineCount(char filename[]){//行数统计函数
     FILE *fp = NULL;
     fp=fopen(filename,"r");
     if(fp==NULL){
         printf("寻找文件失败\n");
         exit(-);
     }
     char ch;
     ch = fgetc(fp);
     while (ch != EOF)
     {
         if (ch == '\n' || ch == '\t')
             c++;
         ch = fgetc(fp);
     }
     fclose(fp);
 }

扩展功能函数：

 int Extend(char filename[]) {  //扩展功能
     FILE *fp = NULL;
     fp = fopen(filename, "r");
     if (fp == NULL) {
         printf("寻找文件失败\n");
         exit(-);
     }

     char fchar = ;
     int emptyline = , code = , note = ;
     int l = , n = , c = ;//l为空行类型，0是无字符空行，1是1字符空行；n为注释类型，0为非注释行，1为单注释行，2为多注释行,c为代码类型

     while (fchar != EOF) {
         fchar = fgetc(fp);
             if (l ==  || l == ) {//如果开始是空格或制表，开始判断是不是空行或者注释行或者代码行
                 if (fchar == '\n') {//回车之前没有字符，空行;1字符进入后也是没有其他字符
                     emptyline++;
                     l = ;
                     continue;
                 }
                 else if (fchar == '/') {//注释判断
                     fchar = fgetc(fp);
                     if (fchar == '/') {//单行注释
                         n = ;
                         while (fchar != EOF && fchar != '\n') {
                             fchar = fgetc(fp);
                         }
                         n = ;
                         note++;
                         continue;
                     }
                     else if (fchar == '*') {//多行注释
                         n = ;
                         continue;
                     }
                 }
                 else if( fchar == '}' && l == ){
                     l = ;        //一字符空行
                     continue;
                 }
                 else if(fchar == ' ' || fchar == '\t'){
                     continue;
                 }
                 else {
                     c = ;
                 }
             }
             if (c == ) {//代码行
                 while (fchar != EOF && fchar != '\n') {
                     fchar = fgetc(fp);
                 }
                 l = ;//状态变回空行
                 code++;
                 continue;
             }
             if (n == ) {//多行注释
                 while (fchar != EOF && fchar != '*') {
                     while (fchar != EOF && fchar != '\n') {
                         fchar = fgetc(fp);
                     }
                     note++;
                     fchar = fgetc(fp);
                 }
                 fchar = fgetc(fp);
                 if (fchar == '/') {//多行结束
                     n = ;
                 }
                 continue;
             }
     }
     printf("\n共有空行数: %d  \n代码行数: %d  \n注释行数: %d\n", emptyline, code, note);
     fclose(fp);
 }

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.项目小结

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

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