linux-c库函数参考手册

isalnum（测试字符是否为英文或数字）

相关函数isalpha，isdigit，islower，isupper

表头文件#include

定义函数int isalnum (int c)

函数说明检查参数c是否为英文字母或阿拉伯数字，在标准c中相当于使用“isalpha(c) || isdigit(c)”做测试。

返回值若参数c为字母或数字，则返回TRUE，否则返回NULL(0)。

附加说明此为宏定义，非真正函数。

范例/* 找出str 字符串中为英文字母或数字的字符*/

#include < ctype.h>

main()

{

char str[]=”123c@#FDsP[e?”;

int i;

for (i=0;str[i]!=0;i++ )

if ( isalnum(str[i])) printf(“%c is an alphanumeric

character\n”,str[i]);

}

执行1 is an apphabetic character

2 is an apphabetic character

3 is an apphabetic character

c is an apphabetic character

F is an apphabetic character

D is an apphabetic character

s is an apphabetic character

P is an apphabetic character

e is an apphabetic character

isalpha （测试字符是否为英文字母）

相关函数isalnum，islower，isupper

表头文件#include

定义函数int isalpha (int c)

函数说明检查参数c是否为英文字母，在标准c中相当于使用“isupper(c)||islower(c)”

做测试。

返回值若参数c为英文字母，则返回TRUE，否则返回NULL(0)。

附加说明此为宏定义，非真正函数。

范例/* 找出str 字符串中为英文字母的字符*/

#include

main()

{

char str[]=”123c@#FDsP[e?”;

int i;

for (i=0;str[i]!=0;i++)

if(isalpha(str[i])) printf(“%c is an alphanumeric character\n”,str[i]);

}

执行c is an apphabetic character

F is an apphabetic character

D is an apphabetic character

s is an apphabetic character

P is an apphabetic character

e is an apphabetic character

isascii（测试字符是否为ASCII 码字符）

相关函数iscntrl

表头文件#include

定义函数int isascii(int c);

函数说明检查参数c是否为ASCII码字符，也就是判断c的范围是否在0到127之间。

返回值若参数c为ASCII码字符，则返回TRUE，否则返回NULL(0)。

附加说明此为宏定义，非真正函数。

范例/* 判断int i是否具有对映的ASCII码字符*/

#include

main()

{

int i;

for(i=125;i<130;i++)

if(isascii(i))

printf("%d is an ascii character:%c\n",i,i);

else

printf("%d is not an ascii character\n",i);

}

执行125 is an ascii character:}

126 is an ascii character:~

127 is an ascii character:

128 is not an ascii character

129 is not an ascii character

iscntrl（测试字符是否为ASCII 码的控制字符）

相关函数isascii

表头文件#include

定义函数int iscntrl(int c)；

函数说明检查参数c是否为ASCII控制码，也就是判断c的范围是否在0到30之间。

返回值若参数c为ASCII控制码，则返回TRUE，否则返回NULL(0)。

附加说明此为宏定义，非真正函数。

isdigit（测试字符是否为阿拉伯数字）

相关函数isxdigit

表头文件#include

定义函数int isdigit(int c)

函数说明检查参数c是否为阿拉伯数字0到9。

返回值若参数c为阿拉伯数字，则返回TRUE，否则返回NULL(0)。

附加说明此为宏定义，非真正函数。

范例/* 找出str字符串中为阿拉伯数字的字符*/

#include

main()

{

char str[]="123@#FDsP[e?";

int i;

for(i=0;str[i]!=0;i++)

if(isdigit(str[i])) printf("%c is an digit character\n",str[i]);

}

执行1 is an digit character

2 is an digit character

3 is an digit character

isgraphis（测试字符是否为可打印字符）

相关函数isprint

表头文件#include

定义函数int isgraph (int c)

函数说明检查参数c是否为可打印字符，若c所对映的ASCII码可打印，且非空格字符则返回TRUE。

返回值若参数c为可打印字符，则返回TRUE，否则返回NULL(0)。

附加说明此为宏定义，非真正函数。

范例/* 判断str字符串中哪些为可打印字符*/

#include

main()

{

char str[]="a5 @;";

int i;

for(i=0;str[i]!=0;i++)

if(isgraph(str[i])) printf("str[%d] is printable

character:%d\n",i,str[i]);

}

执行str[0] is printable character:a

str[1] is printable character:5

str[3] is printable character:@

str[4] is printable character:;

islower（测试字符是否为小写字母）

相关函数isalpha，isupper

表头文件#include

定义函数int islower(int c)

函数说明检查参数c是否为小写英文字母。

返回值若参数c为小写英文字母，则返回TRUE，否则返回NULL(0)。

附加说明此为宏定义，非真正函数。

范例#include

main()

{

char str[]="123@#FDsP[e?";

int i;

for(i=0;str[i]!=0;i++)

if(islower(str[i])) printf("%c is a lower-case character\n",str[i]);

}

执行c is a lower-case character

s is a lower-case character

e is a lower-case character

isprint（测试字符是（否为可打印字符）

相关函数isgraph

表头文件#include

定义函数int isprint(int c);

函数说明检查参数c是否为可打印字符，若c所对映的ASCII码可打印，其中包含空格字符，则返回TRUE。

返回值若参数c为可打印字符，则返回TRUE，否则返回NULL(0)。

附加说明此为宏定义，非真正函数。

范例/* 判断str字符串中哪些为可打印字符包含空格字符*/

#include

main()

{

char str[]="a5 @;";

int i;

for(i=0;str[i]!=0;i++)

if(isprint(str[i])) printf("str[%d] is printable

character:%d\n",i,str[i]);

}

执行str[0] is printable character:a

str[1] is printable character:5

str[2] is printable character:

str[3] is printable character:@

str[4] is printable character:;

isspace（测试字符是否为空格字符）

相关函数isgraph

表头文件#include

定义函数int isspace(int c)

函数说明检查参数c是否为空格字符，也就是判断是否为空格('')、定位字符('\t')、CR('\r')、换行('\n')、垂直定位字符('\v')或翻页('\f')的情况。

返回值若参数c为空格字符，则返回TRUE，否则返回NULL(0)。

附加说明此为宏定义，非真正函数。

范例/*将字符串str[]中内含的空格字符找出，并显示空格字符的ASCII码*/ #include

main()

{

char str="123c @# FD\tsP[e?\n";

int i;

for(i=0;str[i]!=0;i++)

if(isspace(str[i]))

printf("str[%d] is a white-space character:%d\n",i,str[i]);

}

执行str[4] is a white-space character:32

str[7] is a white-space character:32

str[10] is a white-space character:9 /* \t */

str[16] is a white-space character:10 /* \t */

ispunct（测试字符是否为标点符号或特殊符号）

相关函数isspace，isdigit，isalpha

表头文件#inlude

定义函数int ispunct(int c)

函数说明检查参数c是否为标点符号或特殊符号。返回TRUE也就是代表参数c为非空格、非数字和非英文字母。

返回值v若参数c为标点符号或特殊符号，则返回TRUE，否则返回NULL(0)。

附加说明此为宏定义，非真正函数。

范例/*列出字符串str中的标点符号或特殊符号*/

#include

main()

{

char str[]="123c@ #FDsP[e?";

int i;

for(i=0;str[i]!=0;i++)

if(ispunct(str[i])) printf("%c\n",str[i]);

}

执行v

@#[?

isupper（测试字符是否为大写英文字母）

相关函数isalpha，islower

表头文件#include

定义函数int isupper(int c)

函数说明检查参数c是否为大写英文字母。

返回值若参数c为大写英文字母，则返回TRUE，否则返回NULL(0)。

附加说明此为宏定义，非真正函数。

范例/*找出字符串str中为大写英文字母的字符*/

#include

main()

{

char str[]="123c@#FDsP[e?";

int i;

for(i=0;str[i]!=0;i++)

if(isupper(str[i])) printf("%c is an uppercase character\n",str[i]);

}

执行F is an uppercase character

D is an uppercase character

P is an uppercase character

isxdigit（测试字符是否为16进制数字）

相关函数isalnum，isdigit

表头文件#include

定义函数int isxdigit (int c)

函数说明检查参数c是否为16进制数字，只要c为下列其中一个情况则返回TRUE。16进制数字:0123456789ABCDEF。

返回值若参数c为16进制数字，则返回TRUE，否则返回NULL(0)。

附加说明此为宏定义，非真正函数。

范例/*找出字符串str中为十六进制数字的字符*/

#include

main()

{

char str[]="123c@#FDsP[e?";

int i;

for(i=0;str[i]!=0;i++)

if(isxdigit(str[i])) printf("%c is a hexadecimal digits\n",str[i]);

}

执行1 is a hexadecimal digits

2 is a hexadecimal digits

3 is a hexadecimal digits

c is a hexadecimal digits

F is a hexadecimal digits

D is a hexadecimal digits

e is a hexadecimal digits

2

atof（将字符串转换成浮点型数）

相关函数atoi，atol，strtod，strtol，strtoul

表头文件#include

定义函数double atof(const char *nptr);

函数说明atof()会扫描参数nptr字符串，跳过前面的空格字符，直到遇上数字或正负符号才开始做转换，而再遇到非数字或字符串结束时('\0')才结束转换，并将结果返

回。参数nptr字符串可包含正负号、小数点或E(e)来表示指数部分，如123.456

或123e-2。

返回值返回转换后的浮点型数。

附加说明atof()与使用strtod(nptr,(char**)NULL)结果相同。

范例/* 将字符串a 与字符串b转换成数字后相加*/

#include

main()

{

char *a=”-100.23”;

char *b=”200e-2”;

float c;

c=atof(a)+atof(b);

printf(“c=%.2f\n”,c);

}

执行c=-98.23

atoi（将字符串转换成整型数）

相关函数atof，atol，atrtod，strtol，strtoul

表头文件#include

定义函数int atoi(const char *nptr);

函数说明atoi()会扫描参数nptr字符串，跳过前面的空格字符，直到遇上数字或正负符号才开始做转换，而再遇到非数字或字符串结束时('\0')才结束转换，并将结果返

回。

返回值返回转换后的整型数。

附加说明atoi()与使用strtol(nptr，(char**)NULL，10)；结果相同。

范例/* 将字符串a 与字符串b转换成数字后相加*/

#include

mian()

{

char a[]=”-100”;

char b[]=”456”;

int c;

c=atoi(a)+atoi(b);

printf(c=%d\n”,c);

}

执行c=356

atol（将字符串转换成长整型数）

相关函数atof，atoi，strtod，strtol，strtoul

表头文件#include

定义函数long atol(const char *nptr);

函数说明atol()会扫描参数nptr字符串，跳过前面的空格字符，直到遇上数字或正负符号才开始做转换，而再遇到非数字或字符串结束时('\0')才结束转换，并将结果返

回。

返回值返回转换后的长整型数。

附加说明atol()与使用strtol(nptr,(char**)NULL,10)；结果相同。

范例/*将字符串a与字符串b转换成数字后相加*/

#include

main()

{

char a[]=”1000000000”;

char b[]=” 234567890”;

long c;

c=atol(a)+atol(b);

printf(“c=%d\n”,c);

}

执行c=1234567890

gcvt（将浮点型数转换为字符串，取四舍五入）

相关函数ecvt，fcvt，sprintf

表头文件#include

定义函数char *gcvt(double number，size_t ndigits，char *buf);

函数说明gcvt()用来将参数number转换成ASCII码字符串，参数ndigits表示显示的位数。

gcvt()与ecvt()和fcvt()不同的地方在于，gcvt()所转换后的字符串包含小数点

或正负符号。若转换成功，转换后的字符串会放在参数buf指针所指的空间。

返回值返回一字符串指针，此地址即为buf指针。

附加说明

范例#include

main()

{

double a=123.45;

double b=-1234.56;

char *ptr;

int decpt,sign;

gcvt(a,5,ptr);

printf(“a value=%s\n”,ptr);

ptr=gcvt(b,6,ptr);

printf(“b value=%s\n”,ptr);

}

执行a value=123.45

b value=-1234.56

strtod（将字符串转换成浮点数）

相关函数atoi，atol，strtod，strtol，strtoul

表头文件#include

定义函数double strtod(const char *nptr,char **endptr);

函数说明strtod()会扫描参数nptr字符串，跳过前面的空格字符，直到遇上数字或正负符号才开始做转换，到出现非数字或字符串结束时('\0')才结束转换，并将结果返

回。若endptr不为NULL，则会将遇到不合条件而终止的nptr中的字符指针由

endptr传回。参数nptr字符串可包含正负号、小数点或E(e)来表示指数部分。

如123.456或123e-2。

返回值返回转换后的浮点型数。

附加说明参考atof()。

范例/*将字符串a，b，c 分别采用10，2，16 进制转换成数字*/

#include

mian()

{

char a[]=”1000000000”;

char b[]=”1000000000”;

char c[]=”ffff”;

printf(“a=%d\n”,strtod(a,NULL,10));

printf(“b=%d\n”,strtod(b,NULL,2));

printf(“c=%d\n”,strtod(c,NULL,16));

}

执行a=1000000000

b=512

c=65535

strtol（将字符串转换成长整型数）

相关函数atof，atoi，atol，strtod，strtoul

表头文件#include

定义函数long int strtol(const char *nptr,char **endptr,int base);

函数说明strtol()会将参数nptr字符串根据参数base来转换成长整型数。参数base范围从2至36，或0。参数base代表采用的进制方式，如base值为10则采用10进

制，若base值为16则采用16进制等。当base值为0时则是采用10进制做转换，

但遇到如'0x'前置字符则会使用16进制做转换。一开始strtol()会扫描参数nptr

字符串，跳过前面的空格字符，直到遇上数字或正负符号才开始做转换，再遇到

非数字或字符串结束时('\0')结束转换，并将结果返回。若参数endptr不为NULL，

则会将遇到不合条件而终止的nptr中的字符指针由endptr返回。

返回值返回转换后的长整型数，否则返回ERANGE并将错误代码存入errno中。

附加说明ERANGE指定的转换字符串超出合法范围。

范例/* 将字符串a，b，c 分别采用10，2，16进制转换成数字*/

#include

main()

{

char a[]=”1000000000”;

char b[]=”1000000000”;

char c[]=”ffff”;

printf(“a=%d\n”,strtol(a,NULL,10));

printf(“b=%d\n”,strtol(b,NULL,2));

printf(“c=%d\n”,strtol(c,N ULL,16));

}

执行a=1000000000

b=512

c=65535

strtoul（将字符串转换成无符号长整型数）

相关函数atof，atoi，atol，strtod，strtol

表头文件#include

定义函数unsigned long int strtoul(const char *nptr,char **endptr,int base);

函数说明strtoul()会将参数nptr字符串根据参数base来转换成无符号的长整型数。参数base范围从2至36，或0。参数base代表采用的进制方式，如base值为10则采

用10进制，若base值为16则采用16进制数等。当base值为0时则是采用10

进制做转换，但遇到如'0x'前置字符则会使用16进制做转换。一开始strtoul()

会扫描参数nptr字符串，跳过前面的空格字符串，直到遇上数字或正负符号才开

始做转换，再遇到非数字或字符串结束时('\0')结束转换，并将结果返回。若参

数endptr不为NULL，则会将遇到不合条件而终止的nptr中的字符指针由endptr

返回。

返回值返回转换后的长整型数，否则返回ERANGE并将错误代码存入errno中。

附加说明ERANGE指定的转换字符串超出合法范围。

范例参考strtol()

toascii（将整型数转换成合法的ASCII 码字符）

相关函数isascii，toupper，tolower

表头文件#include

定义函数int toascii(int c)

函数说明toascii()会将参数c转换成7位的unsigned char值，第八位则会被清除，此字符即会被转成ASCII码字符。

返回值将转换成功的ASCII码字符值返回。

范例#include

main()

{

int a=217;

char b;

printf(“before toascii () : a value =%d(%c)\n”,a,a);

b=toascii(a);

printf(“after toascii() : a value =%d(%c)\n”,b,b);

}

执行before toascii() : a value =217()

after toascii() : a value =89(Y)

tolower（将大写字母转换成小写字母）

相关函数isalpha，toupper

表头文件#include

定义函数int tolower(int c);

函数说明若参数c为大写字母则将该对应的小写字母返回。

返回值返回转换后的小写字母，若不须转换则将参数c值返回。

附加说明

范例/* 将s字符串内的大写字母转换成小写字母*/

#include

main()

{

char s[]=”aBcDeFgH12345;!#$”;

int i;

printf(“before tolower() : %s\n”,s);

for(i=0;I

s[i]=tolower(s[i]);

printf(“after tolower() : %s\n”,s);

}

执行before tolower() : aBcDeFgH12345;!#$

after tolower() : abcdefgh12345;!#$

toupper（将小写字母转换成大写字母）

相关函数isalpha，tolower

表头文件#include

定义函数int toupper(int c);

函数说明若参数c为小写字母则将该对映的大写字母返回。

返回值返回转换后的大写字母，若不须转换则将参数c值返回。

附加说明

范例/* 将s字符串内的小写字母转换成大写字母*/

#include

main()

{

char s[]=”aBcDeFgH12345;!#$”;

int i;

printf(“before toupper() : %s\n”,s);

for(i=0;I

s[i]=toupper(s[i]);

printf(“after toupper() : %s\n”,s);

}

执行before toupper() : aBcDeFgH12345;!#$

after toupper() : ABCDEFGH12345;!#$

3

calloc（配置内存空间）

相关函数malloc，free，realloc，brk

表头文件#include

定义函数void *calloc(size_t nmemb，size_t size);

函数说明calloc()用来配置nmemb个相邻的内存单位，每一单位的大小为size，并返回指向第一个元素的指针。这和使用下列的方式效果相同:malloc(nmemb*size);不过，

在利用calloc()配置内存时会将内存内容初始化为0。

返回值若配置成功则返回一指针，失败则返回NULL。

范例/* 动态配置10个struct test 空间*/

#include

struct test

{

int a[10];

char b[20];

}

main()

{

struct test *ptr=calloc(sizeof(struct test),10);

}

free（释放原先配置的内存）

相关函数malloc，calloc，realloc，brk

表头文件#include

定义函数void free(void *ptr);

函数说明参数ptr为指向先前由malloc()、calloc()或realloc()所返回的内存指针。调用free()后ptr所指的内存空间便会被收回。假若参数ptr所指的内存空间已被

收回或是未知的内存地址，则调用free()可能会有无法预期的情况发生。若参数

ptr为NULL，则free()不会有任何作用。

getpagesize（取得内存分页大小）

相关函数sbrk

表头文件#include

定义函数size_t getpagesize(void);

函数说明返回一分页的大小，单位为字节（byte）。此为系统的分页大小，不一定会和硬件分页大小相同。

返回值内存分页大小。附加说明在Intel x86 上其返回值应为4096bytes。

范例#include

main()

{

printf(“page size = %d\n”,getpagesize( ) );

}

malloc（配置内存空间）

相关函数calloc，free，realloc，brk

表头文件#include

定义函数void * malloc(size_t size);

函数说明malloc()用来配置内存空间，其大小由指定的size决定。

返回值若配置成功则返回一指针，失败则返回NULL。

范例void p = malloc(1024); /*配置1k的内存*/

mmap（建立内存映射）

相关函数munmap，open

表头文件#include

#include

定义函数void *mmap(void *start,size_t length,int prot,int flags,int fd,off_t offsize);

函数说明mmap()用来将某个文件内容映射到内存中，对该内存区域的存取即是直接对该文件内容的读写。参数start指向欲对应的内存起始地址，通常设为NULL，代表让

系统自动选定地址，对应成功后该地址会返回。参数length代表将文件中多大的

部分对应到内存。

参数prot代表映射区域的保护方式有下列组合

PROT_EXEC 映射区域可被执行

PROT_READ 映射区域可被读取

PROT_WRITE 映射区域可被写入

PROT_NONE 映射区域不能存取

参数flags会影响映射区域的各种特性

MAP_FIXED 如果参数start所指的地址无法成功建立映射时，则放弃映射，不对

地址做修正。通常不鼓励用此旗标。

MAP_SHARED对映射区域的写入数据会复制回文件内，而且允许其他映射该文件的

进程共享。

MAP_PRIVATE 对映射区域的写入操作会产生一个映射文件的复制，即私人的“写

入时复制”（copy on write）对此区域作的任何修改都不会写回原来的文件内容。

MAP_ANONYMOUS建立匿名映射。此时会忽略参数fd，不涉及文件，而且映射区域

无法和其他进程共享。

MAP_DENYWRITE只允许对映射区域的写入操作，其他对文件直接写入的操作将会被

拒绝。

MAP_LOCKED 将映射区域锁定住，这表示该区域不会被置换（swap）。

在调用mmap()时必须要指定MAP_SHARED 或MAP_PRIVATE。参数fd为open()返回

的文件描述词，代表欲映射到内存的文件。参数offset为文件映射的偏移量，通

常设置为0，代表从文件最前方开始对应，offset必须是分页大小的整数倍。

返回值若映射成功则返回映射区的内存起始地址，否则返回MAP_FAILED(－1)，错误原因存于errno 中。

错误代码EBADF 参数fd 不是有效的文件描述词

EACCES 存取权限有误。如果是MAP_PRIVATE 情况下文件必须可读，使用

MAP_SHARED则要有PROT_WRITE以及该文件要能写入。

EINVAL 参数start、length 或offset有一个不合法。

EAGAIN 文件被锁住，或是有太多内存被锁住。

ENOMEM 内存不足。

范例/* 利用mmap()来读取/etc/passwd 文件内容*/

#include

#include

#include

#include

#include

main()

{

int fd;

void *start;

struct stat sb;

fd=open(“/etc/passwd”,O_RDONLY); /*打开/etc/passwd*/

fstat(fd,&sb); /*取得文件大小*/

start=mmap(NULL,sb.st_size,PROT_READ,MAP_PRIVATE,fd,0);

if(start= = MAP_FAILED) /*判断是否映射成功*/

return;

printf(“%s”,start);

munma(start,sb.st_size); /*解除映射*/

closed(fd);

}

执行root : x : 0 : root : /root : /bin/bash

bin : x : 1 : 1 : bin : /bin :

daemon : x : 2 : 2 :daemon : /sbin

adm : x : 3 : 4 : adm : /var/adm :

lp : x :4 :7 : lp : /var/spool/lpd :

sync : x : 5 : 0 : sync : /sbin : bin/sync :

shutdown : x : 6 : 0 : shutdown : /sbin : /sbin/shutdown

halt : x : 7 : 0 : halt : /sbin : /sbin/halt

mail : x : 8 : 12 : mail : /var/spool/mail :

news : x :9 :13 : news : /var/spool/news :

uucp : x :10 :14 : uucp : /var/spool/uucp :

operator : x : 11 : 0 :operator : /root:

games : x : 12 :100 : games :/usr/games:

gopher : x : 13 : 30 : gopher : /usr/lib/gopher-data:

ftp : x : 14 : 50 : FTP User : /home/ftp:

nobody : x :99: 99: Nobody : /:

xfs :x :100 :101 : X Font Server : /etc/xll/fs : /bin/false

gdm : x : 42 :42 : : /home/gdm: /bin/bash

kids : x : 500 :500 :/home/kids : /bin/bash

munmap（解除内存映射）

相关函数mmap

表头文件#include

#include

定义函数int munmap(void *start,size_t length);

函数说明munmap()用来取消参数start所指的映射内存起始地址，参数length则是欲取消的内存大小。当进程结束或利用exec相关函数来执行其他程序时，映射内存会自

动解除，但关闭对应的文件描述词时不会解除映射。

返回值如果解除映射成功则返回0，否则返回－1，错误原因存于errno中错误代码EINVAL 参数start或length 不合法。

范例参考mmap（）

4

asctime（将时间和日期以字符串格式表示）

相关函数time，ctime，gmtime，localtime

表头文件#include

定义函数char * asctime(const struct tm * timeptr);

函数说明asctime()将参数timeptr所指的tm结构中的信息转换成真实世界所使用的时间日期表示方法，然后将结果以字符串形态返回。此函数已经由时区转换成当地时

间，字符串格式为:“Wed Jun 30 21:49:08 1993\n”

返回值若再调用相关的时间日期函数，此字符串可能会被破坏。此函数与ctime不同处在于传入的参数是不同的结构。

附加说明返回一字符串表示目前当地的时间日期。

范例#include

main()

{

time_t timep;

time (&timep);

printf(“%s”,asctime(gmtime(&timep)));

}

执行Sat Oct 28 02:10:06 2000

ctime（将时间和日期以字符串格式表示）

相关函数time，asctime，gmtime，localtime

表头文件#include

定义函数char *ctime(const time_t *timep);

函数说明ctime()将参数timep所指的time_t结构中的信息转换成真实世界所使用的时间日期表示方法，然后将结果以字符串形态返回。此函数已经由时区转换成当地时

间，字符串格式为“Wed Jun 30 21 :49 :08 1993\n”。若再调用相关的时间日

期函数，此字符串可能会被破坏。

返回值返回一字符串表示目前当地的时间日期。

范例#include

main()

{

time_t timep;

time (&timep);

printf(“%s”,ctime(&timep));

}

执行Sat Oct 28 10 : 12 : 05 2000

gettimeofday（取得目前的时间）

相关函数time，ctime，ftime，settimeofday

表头文件#include

#include

定义函数int gettimeofday ( struct timeval * tv , struct timezone * tz )

函数说明gettimeofday()会把目前的时间有tv所指的结构返回，当地时区的信息则放到tz 所指的结构中。

timeval结构定义为:

struct timeval{

long tv_sec; /*秒*/

long tv_usec; /*微秒*/

};

timezone 结构定义为:

struct timezone{

int tz_minuteswest; /*和Greenwich 时间差了多少分钟*/

int tz_dsttime; /*日光节约时间的状态*/

};

上述两个结构都定义在/usr/include/sys/time.h。tz_dsttime 所代表的状态如

下

DST_NONE /*不使用*/

DST_USA /*美国*/

DST_AUST /*澳洲*/

DST_WET /*西欧*/

DST_MET /*中欧*/

DST_EET /*东欧*/

DST_CAN /*加拿大*/

DST_GB /*大不列颠*/

DST_RUM /*罗马尼亚*/

DST_TUR /*土耳其*/

DST_AUSTALT /*澳洲（1986年以后）*/

返回值成功则返回0，失败返回－1，错误代码存于errno。附加说明EFAULT指针tv和tz所指的内存空间超出存取权限。

范例#include

#include

main(){

struct timeval tv;

struct timezone tz;

gettimeofday (&tv , &tz);

printf(“tv_sec; %d\n”, tv,.tv_sec) ;

printf(“tv_usec; %d\n”,bdcf155b312b3169a451a418_usec);

printf(“tz_minuteswest; %d\n”, tz.tz_minuteswest);

printf(“tz_dsttime, %d\n”,tz.tz_dsttime);

}

执行tv_sec: 974857339

tv_usec:136996

tz_minuteswest:-540

tz_dsttime:0

gmtime（取得目前时间和日期）

相关函数time,asctime,ctime,localtime

表头文件#include

定义函数struct tm*gmtime(const time_t*timep);

函数说明gmtime()将参数timep 所指的time_t 结构中的信息转换成真实世界所使用的时间日期表示方法，然后将结果由结构tm返回。

结构tm的定义为

struct tm

{

int tm_sec;

int tm_min;

int tm_hour;

int tm_mday;

int tm_mon;

int tm_year;

int tm_wday;

int tm_yday;

int tm_isdst;

};

int tm_sec 代表目前秒数，正常范围为0-59，但允许至61秒

int tm_min 代表目前分数，范围0-59

int tm_hour 从午夜算起的时数，范围为0-23

int tm_mday 目前月份的日数，范围01-31

int tm_mon 代表目前月份，从一月算起，范围从0-11

int tm_year 从1900 年算起至今的年数

int tm_wday 一星期的日数，从星期一算起，范围为0-6

int tm_yday 从今年1月1日算起至今的天数，范围为0-365

int tm_isdst 日光节约时间的旗标

此函数返回的时间日期未经时区转换，而是UTC时间。

返回值返回结构tm代表目前UTC 时间

范例#include

main(){

char *wday[]={"Sun","Mon","Tue","Wed","Thu","Fri","Sat"};

time_t timep;

struct tm *p;

time(&timep);

p=gmtime(&timep);

printf(“%d%d%d”,(1900+p->tm_year), (1+p->tm_mon),p->tm_mday);

printf(“%s%d;%d;%d\n”, wday[p->tm_wday], p->tm_hour, p->tm_min,

p->tm_sec);

}

执行2000/10/28 Sat 8:15:38

localtime（取得当地目前时间和日期）

相关函数time, asctime, ctime, gmtime

表头文件#include

定义函数struct tm *localtime(const time_t * timep);

函数说明localtime()将参数timep所指的time_t结构中的信息转换成真实世界所使用的时间日期表示方法，然后将结果由结构tm返回。结构tm的定义请参考gmtime()。

此函数返回的时间日期已经转换成当地时区。

返回值返回结构tm代表目前的当地时间。

范例#include

main(){

char *wday[]={“Sun”,”Mon”,”Tue”,”Wed”,”Thu”,”Fri”,”Sat”};

time_t timep;

struct tm *p;

time(&timep);

p=localtime(&timep); /*取得当地时间*/

printf (“%d%d%d ”, (1900+p->tm_year),( l+p->tm_mon), p->tm_mday);

printf(“%s%d:%d:%d\n”, wday[p->tm_wday],p->tm_hour, p->tm_min,

p->tm_sec);

}

执行2000/10/28 Sat 11:12:22

mktime（将时间结构数据转换成经过的秒数）

相关函数time，asctime，gmtime，localtime

表头文件#include

定义函数time_t mktime(strcut tm * timeptr);

函数说明mktime()用来将参数timeptr所指的tm结构数据转换成从公元1970年1月1日0时0分0 秒算起至今的UTC时间所经过的秒数。

返回值返回经过的秒数。

范例/* 用time()取得时间（秒数），利用localtime()

转换成struct tm 再利用mktine（）将struct tm转换成原来的秒数*/

#include

main()

{

time_t timep;

strcut tm *p;

time(&timep);

printf(“time() : %d \n”,timep);

p=localtime(&timep);

timep = mktime(p);

pr intf(“time()->localtime()->mktime():%d\n”,timep);

本文来源：https://www.bwwdw.com/article/yddl.html