1.1文学程序

文学程序(literate program)：接口及其实现的代码与对其进行解释的正文交织在一起。文学程序由英文正文和带标签的程序代码块组成。例如，

1 〈compute x * y〉≡2 sum = 0;3 for (i = 0; i < n; i++)4 sum += x[i]*y[i];

定义了名为〈compute x * y〉的代码块，其代码计算了数组x和y的点积。在另一个代码块中使用该代码块时，直接引用即可：

1 〈function dotproduct〉≡2 int dotProduct(int x[], int y[], intn) {3 inti, sum;4

5 〈compute x o y〉6 returnsum;7 }

文学程序可以按各个小片段的形式给出，并附以完备的文档。英文正文包含了传统的程序注释，这些并不受程序设计语言的注释规范的限制。

下面是文学编程系统的另一个特性，她有助于逐点对程序进行描述；下面以一个检测输入中相邻的相同单词的double程序，作为文学程序的例子：

先从定义根代码块来实现double，该代码块将使用对应于程序各个组件的其他代码块：

1 〈double.c 3〉≡2 〈includes 4〉3 〈data 4〉4 〈prototypes 4〉5 〈functions 3〉

main函数处理double的参数。它会打开各个文件，并调用doubleword扫描文件：

1 〈functions 3〉≡2 int main(int argc, char *argv[]) {3 inti;4

5 for (i = 1; i < argc; i++) {6 FILE *fp = fopen(argv[i], "r");7 if (fp ==NULL) {8 fprintf(stderr, "%s: can't open '%s' (%s)\n",9 argv[0], argv[i], strerror(errno));10 returnEXIT_FAILURE;11 } else{12 doubleword(argv[i], fp);13 fclose(fp);14 }15 }16 if (argc == 1) doubleword(NULL, stdin);17 returnEXIT_SUCCESS;18 }19

20 〈includes 4〉≡21 #include

22 #include

23 #include

getword从打开的文件读取下一个单词，复制到buf [0..size  1]中，并返回1；在到达文件末尾时该函数返回0。

1 functions 3〉+≡2 int getword(FILE *fp, char *buf, intsize) {3 intc;4

5 c =getc(fp);6 〈scan forward to a nonspace character or EOF 5〉7 〈copy the word into buf[0..size-1] 5〉8 if (c !=EOF)9 ungetc(c, fp);10 return〈found a word? 5〉;11 }12

13 〈prototypes 4〉≡14 int getword(FILE *, char *, int);

getword除了从输入获取下一个单词之外，每当遇到一个换行字符时都对linenum加1。doubleword输出时将使用linenum。

1 〈data 4〉≡2 intlinenum;3

4 〈scan forward to a nonspace character or EOF 5〉≡5 for ( ; c != EOF && isspace(c); c =getc(fp))6 if (c == '\n')7 linenum++;8

9 〈includes 4〉+≡10 #include

size的值限制了getword所能存储的单词的长度，getword函数会丢弃过多的字符并将大写字母转换为小写：

1 〈copy the word into buf[0..size-1] 5〉≡2 {3 int i = 0;4 for ( ; c != EOF && !isspace(c); c =getc(fp))5 if (i < size - 1)6 buf[i++] =tolower(c);7 if (i

剩下的代码逻辑是，如果buf中保存了一个单词则返回1，否则返回0：

1 〈found a word? 5〉≡2 buf[0] != '\0'

doubleword读取各个单词，并将其与前一个单词比较，发现重复时输出。它只查看以字母开头的单词：

1 〈functions 3〉+≡2 void doubleword(char *name, FILE *fp) {3 char prev[128], word[128];4

5 linenum = 1;6 prev[0] = '\0';7 while (getword(fp, word, sizeof(word)) {8 if (isalpha(word[0]) && strcmp(prev, word)==0)9 〈word is a duplicate 6〉10 strcpy(prev, word);11 }12 }13 〈prototypes 4〉+≡14

15 void doubleword(char *, FILE *);16

17 〈includes 4〉+≡18 #include

输出是很容易的，但仅当name不为NULL时才输出文件名及后接的冒号：

1 〈word is a duplicate 6〉≡2 {3 if(name)4 printf("%s:", name);5 printf("%d: %s\n", linenum, word);6 }

总结：整个程序的设计符合学习C语言经常提的：自顶向下，逐步细化，模块化！

1.2程序设计风格

上例double说明了本书中程序所使用的风格惯例。一般来说，较长且富于语义的名称用于全局变量和例程，而数学符号般的短名称则用于局部变量。

代码中几乎没有注释，因为围绕对应代码块的正文代替了注释。本书将效法C程序设计方面的典范，最低限度地使用注释。

库函数strcpy将一个字符串复制到另一个字符串中并返回目标字符串，对该函数的不同实现就说明了"地道的C语言"和新手C程序员编写的代码之间的差别，后一种代码通常使用数组：

1 char *strcpy(char dst[], const charsrc[]) {2 inti;3

4 for (i = 0; src[i] != '\0'; i++)5 dst[i] =src[i];6 dst[i] = '\0';7 returndst;8 }

"地道"的版本则使用指针：

1 char *strcpy(char *dst, const char *src) {2 char *s =dst;3

4 while (*dst++ = *src++)5 ;6 returns;7 }

这两个版本都是strcpy的合理实现。指针版本使用通常的惯用法将赋值、指针递增和测试赋值操作的结果合并为单一的赋值表达式。它还修改了其参数dst和src，

这在C语言中是可接受的，因为所有参数都是传值的，实际上参数只不过是已初始化的局部变量。

1.3 效率

程序员似乎被效率问题困扰着。他们可能花费数小时来微调代码，使之运行得更快。遗憾的是，大部分这种工作都是无用功。当猜测程序的运行时间花费在何处时，程序员的直觉非常糟糕。

微调程序是为了使之更快，但通常总是会使之更大、更难理解、更可能包含错误。除非对执行时间的测量表明程序太慢，否则这样的微调没有意义。程序只需要足够快即可，不一定要尽可能快。

如果I/O占了程序运行时间的60%，在搜索例程中节省1%是无意义的。

微调：

微调通常会引入错误。最快崩溃的程序绝非胜者。可靠性比效率更重要；与交付足够快的可靠软件相比，交付快速但会崩溃的软件，从长远看来代价更高。

微调经常在错误的层次上进行。快速算法的直接简明的实现，比慢速算法的手工微调实现要好得多。例如，减少线性查找的内层循环的指令数，注定不如直接使用二分查找。

微调无法修复低劣的设计。如果程序到处都慢，这种低效很可能是设计导致的。当基于编写得很糟糕或不精确的问题说明给出设计时，或者根本就没有总体设计时，就会发生这种令人遗憾的情况。

一些C程序员在寻求提高效率的途径时，大量使用宏和条件编译。只要有可能，本书将避免使用这两种方法。使用宏来避免函数调用基本上是不必要的。仅当客观的 测量结果表明有问题的调用的开销大大超出其余代码的运行时间时，使用宏才有意义。操作I/O是较适宜采用宏的少数情况之一。例如，标准的I/O函数 getc、putc、getchar和putchar通常实现为宏。

条件编译通常用于配置特定平台或环境的代码，或者用于代码调试的启用/禁用。这些问题是实际存在的，但条件编译通常只是解决问题的较为容易的方法，而且总会使代码更难于阅读。如果应用程序必须在编译时配置，与C语言的条件编译工具相比，版本控制工具更擅长完成该工作。