本文章用于没有太多C语言知识的读者，想要读懂开源的水力建模软件EPANET时，会遇到如下的一些C标准函数,现介绍如下：
一、fgets函数
原型： char *fgets(char *s, int n, FILE *stream);
参数：
*s: 字符型指针，指向将存储到的数据地址。
n: 整型数据，将从流中读取 n - 1 个字符。
*stream: 指针数据，欲读取的流。
功能:
从文件指针stream中读取n-1个字符，存到以s为起始地址的空间里，直到读完一行，如果成功则返回s的指针，否则返回NULL。
例：
如果一个文件的当前位置的文本如下
Love ,I Have
但是，如果用
fgets(str1,4,file1);
则执行后str1="Lov"，读取了4-1=3个字符，
而如果用
fgets(str1,23,file1);
则执行str1="Love ,I Have"，读取了一行(包括行尾的'\n',并自动加上字符串结束符'\0')。
二、strtok
表头文件：
#include<string.h>
原型：
char *strtok(char *s, const char *delim);
功能：
分解字符串为一组字符串。s为要分解的字符串，delim为分隔符字符串。
参数s：
指向欲分割的字符串；
参数delim：
则为分割字符串。
返回值：
从s开头开始下一个分割后的字符串指针，如果已无从分割则返回NULL。
strtok()用来将字符串分割成一个个片段。当strtok()在参数s的字符串中发现到参数delim的分割字符时则会将该字符改为\0 字符。在第一次调用时，strtok()必需给予参数s字符串，往后的调用则将参数s设置成NULL。每次调用成功则返回下一个分割后的字符串指针。
所有delim中包含的字符都会被滤掉，并将被滤掉的地方设为一处分割的节点。
例子：
#include <stdio.h>
#include <string.h>
int main()
{
char s[]="a b j w y;z";
char *delim=" \t\n\r";
char *p;
printf("%s\n",strtok(s,delim));
while((p=strtok(NULL,delim))) printf("%s\n",p);
return 0;
}
运行结果：
三、strncpy
头文件：#include "string.h"
原型：char * strncpy(char *dest, char *src, size_t n);
其中size_t是标准C库中定义的，应为unsigned int，在64位系统中为 long unsigned int。
功能：将字符串src中最多n个字符复制到字符数组dest中(它并不像strcpy一样只有遇到NULL才停止复制，而是多了一个条件停止，就是说如果复制到第n个字符还未遇到NULL，也一样停止），返回指向dest的指针。
说明：
如果n > dest串长度，dest栈空间溢出产生崩溃异常。
否则：
1）src串长度<=dest串长度,(这里的串长度包含串尾NULL字符)
如果n∈(0, src串长度)，src的前n个字符复制到dest中。但是由于没有NULL字符，所以直接访问dest串会发生栈溢出的异常情况。
如果n = src串长度，与strcpy一致。
如果n = dest串长度，[0,src串长度]处存放于dest字串，(src串长度, dest串长度]处存放NULL。
2）src串长度>dest串长度
如果n =dest串长度，则dest串没有NULL字符，会导致输出会有乱码。如果不考虑src串复制完整性，可以将dest最后一字符置为NULL。
综上，一般情况下，使用strncpy时，建议将n置为dest串长度，复制完毕后，为保险起见，将dest串最后一字符置NULL，避免输出会有乱码的问题。当然喽，无论是strcpy还是strncpy，保证src串长度<dest串长度才是最重要的。
四、strlen
strlen所作的仅仅是一个计数器的工作，它从内存的某个位置（可以是字符串开头，中间某个位置，甚至是某个不确定的内存区域）开始扫描，直到碰到第一个字符串结束符'\0'为止，然后返回计数器值。
原型：extern unsigned int strlen(char *s）
头文件：string.h
格式：strlen （字符数组名）
功能：计算字符串s的（unsigned int型）长度，不包括'\0'在内
说明：返回s的长度，不包括结束符NULL。
五、strcomp
原型：int strcmp(const char * cs, const char * ct)
说明：strcmp(cs,ct)比较字符串cs 和ct；当cs<ct 时，返回一个-1；当cs==ct 时，返回0；当cs>ct 时，返回1
例子：
#include <stdio.h>
#include <string.h>
int main()
{
char *Mid="ab";
char *Min="aa";
char *Max="ac";
printf("strcmp(Mid,Mid)=%d\n",strcmp(Mid,Mid));
printf("strcmp(Max,Min)=%d\n",strcmp(Max,Min));
printf("strcmp(Min,Max)=%d\n",strcmp(Min,Max));
return 0;
}
六、fopen
函数功能：打开一个文件
函数原型：FILE * fopen(const char * path,const char * mode);
所在头文件：<
stdio.h>
返回值：文件顺利打开后，指向该流的文件指针就会被返回。如果文件打开失败则返回NULL。
一般而言，打开文件后会作一些文件读取或写入的动作，若打开文件失败，接下来的读写动作也无法顺利进行，所以一般在fopen()后作错误判断及处理。
参数说明：
参数path字符串包含欲打开的
文件路径及文件名，参数mode字符串则代表着
流形态。
mode有下列几种形态字符串:
r 以只读方式打开文件，该文件必须存在。
r+ 以可读写方式打开文件，该文件必须存在。
rb+ 读写打开一个二进制文件，允许读数据。
rw+ 读写打开一个文本文件，允许读和写。
w 打开只写文件，若文件存在则文件长度清为0，即该文件内容会消失。若文件不存在则建立该文件。
w+ 打开可读写文件，若文件存在则文件长度清为零，即该文件内容会消失。若文件不存在则建立该文件。
a 以附加的方式打开只写文件。
若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。（EOF符保留）
a+ 以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 （原来的EOF符不保留）
wb 只写打开或新建一个二进制文件；只允许写数据。
wb+ 读写打开或建立一个二进制文件，允许读和写。
ab+ 读写打开一个二进制文件，允许读或在文件末追加数据。
at+ 打开一个叫string的文件，a表示append,就是说写入处理的时候是接着原来文件已有内容写入，不是从头写入覆盖掉，t表示打开文件的类型是文本文件，+号表示对文件既可以读也可以写。
上述的形态字符串都可以再加一个b字符，如rb、w+b或ab+等组合，
加入b 字符用来告诉函数库以二进制模式打开文件。
如果不加b，表示默认加了t，即rt,wt,其中t表示以文本模式打开文件。
有些C编译系统可能不完全提供所有这些功能，有的C版本不用"r+","w+","a+",而用"rw","wr","ar"等，读者注意所用系统的规定。
七、strcpy
原型声明：extern char *strcpy(char *dest,const char *src);
头文件：#include <string.h>
功能：把从src地址开始且含有NULL结束符的字符串复制到以dest开始的地址空间
说明：src和dest所指内存区域不可以重叠且dest必须有足够的空间来容纳src的字符串。
返回：指向dest的指针。
八、time
函数原型：time_t time(time_t * timer)
功能: 获取当前的系统时间，返回的结果是
一个time_t类型，其实就是一个大整数，其值表示从CUT（Coordinated Universal Time）时间1970年1月1日00:00:00（称为UNIX系统的Epoch时间）到当前时刻的秒数。然后调用localtime将time_t所表示的CUT时间转换为本地时间（我们是+8区，比CUT多8个小时）并转成struct tm类型，该类型的各数据成员分别表示年月日时分秒。
补充说明：time函数的原型也可以理解为 long time(long *tloc)，即返回一个long型整数。因为在time.h这个头文件中time_t实际上就是：
#ifndef _TIME_T_DEFINED
typedef long time_t; /* time value */
#define _TIME_T_DEFINED /* avoid multiple defines of time_t */
#endif
即long。
九、ctime
原型: char *ctime(const time_t *time);
