EPANET源码中用到的几个简单C语言函数介绍一

本文章用于没有太多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);