标准库
索引
本文包括大部分C标准库函数，但没有列出一些用途有限的函数以及某些可以简单的从其他函数合成的函数，也没有包含多字节和本地化函数。
标准库中的各个函数、类型以及宏分别在以下标准头文件中说明：
<assert.h> <float.h> <math.h> <stdarg.h> <stdlib.h>
<ctype.h> <limits.h> <setjmp.h> <stddef.h> <string.h>
<errno.h> <locale.h> <signal.h> <stdio.h> <time.h>
1 输入与输出<stdio.h>
头文件<stdio.h>定义了用于输入和输出的函数、类型和宏。最重要的类型是用于声明文件指针的FILE。另外两个常用的类型是 size_t和fpos_t，size_t是由运算符sizeof产生的无符号整类型；fpos_t类型定义能够唯一说明文件中的每个位置的对象。由头部定义的最有用的宏是EOF，其值代表文件的结尾。
1.1 文件操作
1.1.1 fopen
#include <stdio.h> FILE *fopen(const char *filename, const char *mode); 返回：成功为FILE指针，失败为NULL
打开以filename所指内容为名字的文件，返回与之关联的流。
mode决定打开的方式，可选值如下：
"r" 打开文本文件用于读
"w" 创建文本文件用于写，并删除已存在的内容(如果有的话)
"a" 添加；打开或创建文本文件用于在文件末尾写
"rb" 打开二进制文件用于读
"wb" 创建二进制文件用于写，并删除已存在的内容(如果有的话)
"ab" 添加；打开或创建二进制文件用于在文件末尾写
"r+" 打开文本文件用于更新(即读和写)
"w+" 创建文本文件用于更新，并删除已存在的内容(如果有的话)
"a+" 添加；打开或创建文本文件用于更新和在文件末尾写
"rb+"或"r+b" 打开二进制文件用于更新(即读和写)
"wb+"或"w+b" 创建二进制文件用于更新，并删除已存在的内容(如果有的话)
"ab+"或"a+b" 添加；打开或创建二进制文件用于更新和在文件末尾写
后六种方式允许对同一文件进行读和写，要注意的是，在写操作和读操作的交替过程中，必须调用fflush()或文件定位函数如fseek()、fsetpos()、rewind()等。
文件名filename的长度最大为FILENAME_MAX个字符，一次最多可打开FOPEN_MAX个文件(在<stdio.h>中定义)。
1.1.2 freopen
#include <stdio.h> FILE *freopen(const char *filename, const char *mode, FILE *stream); 返回：成功为stream，失败为NULL
以mode指定的方式打开文件filename，并使该文件与流stream相关联。freopen()先尝试关闭与stream关联的文件，不管成功与否，都继续打开新文件。
该函数的主要用途是把系统定义的标准流stdin、stdout、stderr重定向到其他文件。
1.1.3 fflush
#include <stdio.h> int fflush(FILE *stream); 返回：成功为0，失败返回EOF
对输出流(写打开)，fflush()用于将已写到缓冲区但尚未写出的全部数据都写到文件中；对输入流，其结果未定义。如果写过程中发生错误则返回EOF，正常则返回0。
fflush(NULL)用于刷新所有的输出流。
程序正常结束或缓冲区满时，缓冲区自动清仓。
1.1.4 fclose
#include <stdio.h> int flcose(FILE *stream); 返回：成功为0，失败返回EOF
刷新stream的全部未写出数据，丢弃任何未读的缓冲区内的输入数据并释放自动分配的缓冲区，最后关闭流。
1.1.5 remove
#include <stdio.h> int remove(const char *filename); 返回：成功为0，失败为非0值
删除文件filename。
1.1.6 rename
#include <stdio.h> int rename(const char *oldfname, const char *newfname); 返回：成功为0，失败为非0值
把文件的名字从oldfname改为newfname。
1.1.7 tmpfile
#include <stdio.h> FILE *tmpfile(void); 返回：成功为流指针，失败为NULL
以方式"wb+"创建一个临时文件，并返回该流的指针，该文件在被关闭或程序正常结束时被自动删除。
1.1.10 setbuf
#include <stdio.h> void setbuf(FILE *stream, char *buf);
如果buf为NULL，则关闭流stream的的缓冲区；否则setbuf函数等价于：
(void)setvbuf(stream, buf, _IOFBF, BUFSIZ)。
注意自定义缓冲区的尺寸必须为BUFSIZ个字节。
1.2 格式化输出
1.2.1 fprintf
#include <stdio.h> int fprintf(FILE *stream, const char *format,…); 返回：成功为实际写出的字符数，出错返回负值
按照format说明的格式把变元表中变元内容进行转换，并写入stream指向的流。
格式化字符串由两种类型的对象组成：普通字符(它们被拷贝到输出流)与转换规格说明(它们决定变元的转换和输出格式)。每个转换规格说明均以字符%开头，以转换字符结束。如果%后面的字符不是转换字符，那么该行为是未定义的。
转换字符列表如下：
字 符 说明
d, i int；有符号十进制表示法
o unsigned int；无符号八进制表示法（无前导0）
x, X unsigned int；无符号十六进制表示法（无前导0X和0x），对0x用abcdef，对0X用ABCDEF
u unsigned int；无符号十进制表示法
c int；单个字符，转换为unsigned char类型后输出
s char *；输出字符串直到'\0'或者达到精度指定的字符数
f double；形如[-]mmm.ddd的十进制浮点数表示法，d的数目由精度确定。缺省精度为6位，精度为0时不输出小数点
e, E double；形如[-]m.dddddde[+-]xx或者[-]m.ddddddE[+-]xx的十进制浮点数表示法，d的数目由精度确定。缺省精度为6位，精度为0时不输出小数点
g G double；当指数值小于-4或大于等于精度时，采用%e或%E的格式；否则使用%f的格式。尾部的0与小数点不打印
p void *；输出指针值（具体表示与实现相关）
n int *；到目前为止以此格式调用函数输出的字符的数目将被写入到相应变元中，不进行变元转换
% 不进行变元转换，输出%
在%与转换字符之间依次可以有下列标记：
标记 说明
- 指定被转换的变元在其字段内左对齐
+ 指定在输出的数前面加上正负号
空格 如果第一个字符不是正负号，那么在其前面附加一个空格
0 对于数值转换，在输出长度小于字段宽度时，加前导0
# 指定其他输出格式，对于o格式，第一个数字必须为零；对于x/X格式，指定在输出的非0值前加0x或0X；对于e/E/f/g/G格式，指定输出总有一个小数点；对于g/GG格式，还指定输出值后面无意义的0将被保留。
宽度[number] 一个指定最小字段宽的数。转换后的变元输出宽度至少要达到这个数值。如果变元的字符数小于此数值，那么在变元左/右边添加填充字符。填充字符通常为空格（设置了0标记则为0）。
. 点号用于把字段宽和精度分开
精度[number] 对于字符串，说明输出字符的最大数目；对于e/E/f格式，说明输出的小数位数；对于g/G格式，说明输出的有效位数；对于整数，说明输出的最小位数（必要时可加前导0）
h/l/L 长度修饰符，h表示对应的变元按short或unsigned short类型输出；l表示对应的变元按long或unsigned long类型输出；L表示对应的变元按long double类型输出
在格式串中字段宽度和精度二者都可以用*来指定，此时该值可通过转换对应的变元来获得，这些变元必须是int类型。
1.2.2 printf
#include <stdio.h> int printf(const char *format, …);
printf(...)等价于fprintf(stdout, ...)。
1.2.3 sprintf
#include <stdio.h> int sprintf(char *buf, const char *format, …); 返回：实际写到字符数组的字符数，不包括'\0'
与printf()基本相同，但输出写到字符数组buf而不是stdout中，并以'\0'结束。
注意，sprintf()不对buf进行边界检查，buf必须足够大，以便能装下输出结果。
1.3 格式化输入
1.3.1 fscanf
#include <stdio.h> int fscanf(FILE *stream, const char *format, …); 返回：成功为实际被转换并赋值的输入项数目，到达文件尾或变元被转换前出错为EOF
在格式串format的控制下从流stream中读入字符，把转换后的值赋给后续各个变元，在此每一个变元都必须是一个指针。当格式串format结束时函数返回。
格式串format通常包含有用于指导输入转换的转换规格说明。格式串中可以包含：
* 空格或制表符，他们将被忽略；
* 普通字符(%除外)，与输入流中下一个非空白字符相匹配；
* 转换规格说明：由一个%、一个赋值屏蔽字符*(可选)、一个用于指定最大字段宽度的数(可选)、一个用于指定目标字段的字符h/l/L(可选)、一个转换字符组成。
转换规格说明决定了输入字段的转换方式。通常把结果保存在由对应变元指向的变量中。然而，如果转换规格说明中包含有赋值屏蔽字符*，例如%*s，那么就跳过对应的输入字段，不进行赋值。输入字段是一个由非空白符组成的字符串，当遇到空白符或到达最大字段宽(如果有的话)时，对输入字段的读入结束。这意味着 scanf函数可以跨越行的界限来读入其输入，因为换行符也是空白符(空白符包括空格、横向制表符、纵向制表符、换行符、回车符和换页符)。
转换字符列表如下：
字符 输入数据；变元类型
d 十进制整数；int *
i 整数；int *。该整数可以是以0开头的八进制数，也可以是以0x/0X开头的十六进制数
o 八进制数（可以带或不带前导0）；unsigned int *
u 无符号十进制整数；unsigned int *
x 十六进制整数（可以带或不带前导0x/0X)；unsigned int *
c 字符；char *。按照字段宽的大小把读入的字符保存在指定的数组中，不加入字符'\0'。字段宽的缺省值为1。在这种情况下，不跳过空白符；如果要读入下一个非空白符，使用%1s（数字1）
s 有非空白符组成的字符串（不包含引号）；char *。该变元指针指向一个字符数组，该字符数组有足够空间来保存该字符串以及在末尾添加的'\0'
e/f/g 浮点数；float *。float浮点数的输入格式为：一个任选的正负号，一串可能包含小数点的数字和一个任选的指数字段。指数字段由字母e/E以及后跟的一个可能带正负号的整数组成
p 用printf("%p")调用输出的指针值；void *
n 将到目前为止此调用所读的字符数写入变元；int *。不读入输入字符。不增加转换项目计数
[...] 用方括号括起来的字符集中的字符来匹配输入，以找到最长的非空字符串；char *。在末尾添加'\0'。格式[]...]表示字符集中包含字符]
[^...] 用不在方括号里的字符集中的字符来匹配输入，以找到最长的非空字符串；char *。在末尾添加'\0'。格式[]...]表示字符集中包含字符]
% 字面值%，不进行赋值
字段类型字符：
* 如果变元是指向short类型而不是int类型的指针，那么在d/i/n/o/u/x这几个转换字符前可以加上字符h；
* 如果变元是指向long类型的指针，那么在d/i/n/o/u/x这几个转换字符前可以加上字符l；
* 如果变元是指向double类型而不是float类型的指针，那么在e/f/g这几个转换字符前可以加上字符l；
* 如果变元是指向long double类型的指针，那么在e/f/g前可以加上字符L。
1.3.2 scanf
#include <stdio.h> int scanf(const char *format, …);
scanf(...)等价于fscanf(stdin, ...)。
1.3.3 sscanf
#include <stdio.h> int sscanf(const char *buf, const char *format, …);
与scanf()基本相同，但sscanf()从buf指向的数组中读，而不是stdin。
1.4 字符输入输出函数
1.4.1 fgetc
#include <stdio.h> int fgetc(FILE *stream);
以unsigned char类型返回输入流stream中下一个字符(转换为int类型)。如果到达文件末尾或发生错误，则返回EOF。
1.4.2 fgets
#include <stdio.h> char *fgets(char *str, int num, FILE *stream); 返回：成功返回str，到达文件尾或发生错误返回NULL
从流stream中读入最多num-1个字符到数组str中。当遇到换行符时，把换行符保留在str中，读入不再进行。数组str以'\0'结尾。
1.4.3 fputc
#include <stdio.h> int fputc(int ch, FILE *stream); 返回：成功为所写的字符，出错为EOF
把字符ch(转换为unsigned char类型)输出到流stream中。
1.4.4 fputs
#include <stdio.h> int fputs(const char *str, FILE *stream); 返回：成功返回非负值，失败返回EOF
把字符串str输出到流stream中，不输出终止符'\0'。
1.4.5 getc
#include <stdio.h> int getc(FILE *stream);
getc()与fgetc()等价。不同之处为：当getc函数被定义为宏时，它可能多次计算stream的值。
1.4.6 getchar
#include <stdio.h> int getchar(void);
等价于getc(stdin)。
1.4.7 gets
#include <stdio.h> char *gets(char *str); 返回：成功为str，到达文件尾或发生错误则为NULL
从stdin中读入下一个字符串到数组str中，并把读入的换行符替换为字符'\0'。
gets()可读入无限多字节，所以要保证str有足够的空间，防止溢出。
1.4.8 putc
#include <stdio.h> int putc(int ch, FILE *stream);
putc()与fputc()等价。不同之处为：当putc函数被定义为宏时，它可能多次计算stream的值。
1.4.9 putchar
#include <stdio.h> int putchar(int ch);
等价于putc(ch, stdout)。
1.4.10 puts
#include <stdio.h> int puts(const char *str); 返回：成功返回非负值，出错返回EOF
把字符串str和一个换行符输出到stdout。
1.5 直接输入输出函数
1.5.1 fread
#include <stdio.h> size_t fread(void *buf, size_t size, size_t count, FILE *stream); 返回：实际读入的对象数
从流stream中读入最多count个长度为size个字节的对象，放到buf指向的数组中。
返回值可能小于指定读入数，原因可能是出错，也可能是到达文件尾。实际执行状态可用feof()或ferror()确定。
1.5.2 fwrite
#include <stdio.h> size_t fwrite(const void *buf, size_t size, size_t count, FILE *stream); 返回：实际输出的对象数
把buf指向的数组中count个长度为size的对象输出到流stream中，并返回被输出的对象数。如果发生错误，则返回一个小于count的值。
1.6 文件定位函数
1.6.1 fseek
#include <stdio.h> int fseek(FILE *stream, long int offset, int origin); 返回：成功为0，出错为非0
对流stream相关的文件定位，随后的读写操作将从新位置开始。
对于二进制文件，此位置被定位在由origin开始的offset个字符处。origin的值可能为SEEK_SET(文件开始处)、SEEK_CUR(当前位置)或SEEK_END(文件结束处)。
对于文本流，offset心须为0，或者是由函数ftell()返回的值(此时origin的值必须是SEEK_SET)。
1.7 错误处理函数
当发生错误或到达文件末尾时，标准库中的许多函数将设置状态指示符。这些状态指示符可被显式地设置和测试。另外，(定义在<errno.h>中的)整数表达式errno可包含一个出错序号，该数将进一步给出最近一次出错的信息。
1.7.1 clearerr
#include <stdio.h> void clearerr(FILE *stream);
清除与流stream相关的文件结束指示符和错误指示符。
1.7.2 feof
#include <stdio.h> int feof(FILE *stream); 返回：到达文件尾时返回非0值，否则返回0
与流stream相关的文件结束指示符被设置时，函数返回一个非0值。
1.7.3 ferror
#include <stdio.h> int ferror(FILE *stream); 返回：无错返回0，有错返回非0
与流stream相关的文件出错指示符被设置时，函数返回一个非0值。
1.7.4 perror
#include <stdio.h> void perror(const char *str);
perror(s)用于输出字符串s以及与全局变量errno中的整数值相对应的出错信息，具体出错信息的内容依赖于实现。该函数的功能类似于：
fprintf(stderr, "%s: %s\n", s, "出错信息");
可参见第3节介绍的strerror函数。
2 字符类测试<ctype.h>
头文件<ctype.h>中说明了一些用于测试字符的函数。每个函数的变元均为int类型，变元的值必须是EOF或可用unsigned char类型表示的字符，函数的返回值为int类型。如果变元满足所指定的条件，那么函数返回非0值(表示真)；否则返回值为0(表示假)。这些函数包括 2.1～2.11。
在7位ASCII字符集中，可打印字符是从0x20(' ')到0x7E('~')之间的字符；控制字符是从0(NUL)到0x1F(US)之间的字符和字符0x7F(DEL)。
2.1 isalnum
#include <ctype.h> int sialnum(int ch);
变元为字母或数字时，函数返回非0值，否则返回0。
2.2 isalpha
#include <ctype.h> int isalpha(int ch);
当变元为字母表中的字母时，函数返回非0值，否则返回0。各种语言的字母表互不相同，对于英语来说，字母表由大写和小写的字母A到Z组成。
2.3 iscntrl
#include <ctype.h> int iscntrl(int ch);
当变元是控制字符时，函数返回非0，否则返回0。
2.4 isdigit
#include <ctype.h> int isdigit(int ch);
当变元是十进制数字时，函数返回非0值，否则返回0。
2.5 isgraph
#include <ctype.h> int isgraph(int ch);
如果变元为除空格之外的任何可打印字符，则函数返回非0值，否则返回0。
2.6 islower
#include <ctype.h> int islower(int ch);
如果变元是小写字母，函数返回非0值，否则返回0。
2.7 isprint
#include <ctype.h> int isprint(int ch);
如果变元是可打印字符(含空格)，则函数返回非0值，否则返回0。
2.8 ispunct
#include <ctype.h> int ispunct(int ch);
如果变元是除空格、字母和数字外的可打印字符，则函数返回非0，否则返回0。
2.9 isspace
#include <ctype.h> int isspace(int ch);
当变元为空白字符(包括空格、换页符、换行符、回车符、水平制表符和垂直制表符)时，函数返回非0，否则返回0。
2.10 isupper
#include <ctype.h> int isupper(int ch);
如果变元为大写字母，函数返回非0，否则返回0。
2.11 isxdigit
#include <ctype.h> int isxdigit(int ch);
当变元为十六进制数字时，函数返回非0，否则返回0。
2.12 tolower
#include <string.h> int tolower(int ch);
当ch为大写字母时，返回其对应的小写字母；否则返回ch。
2.13 toupper
#include <string.h> int toupper(int ch);
当ch为小写字母时，返回其对应的大写字母；否则返回ch。
3 字符串函数<string.h>
在头文件<string.h>中定义了两组字符串函数。第一组函数的名字以str开头；第二组函数的名字以mem开头。只有函数memmove对重叠对象间的拷贝进行了定义，而其他函数都未定义。比较类函数将其变元视为unsigned char类型的数组。
3.1 strcpy
#include <string.h> char *strcpy(char *str1, const char *str2);
把字符串str2(包括'\0')拷贝到字符串str1当中，并返回str1。
3.3 strcat
#include <string.h> char *strcat(char *str1, const char *str2);
把str2(包括'\0')拷贝到str1的尾部(连接)，并返回str1。其中终止原str1的'\0'被str2的第一个字符覆盖。
3.5 strcmp
#include <string.h> int strcmp(const char *str1, const char *str2);
按字典顺序比较两个字符串，返回整数值的意义如下：
* 小于0，str1小于str2；
* 等于0，str1等于str2；
* 大于0，str1大于str2；
3.7 strchr
#include <string.h> char *strchr(const char *str, int ch);
返回指向字符串str中字符ch第一次出现的位置的指针，如果str中不包含ch，则返回NULL。
3.12 strstr
#include <string.h> char *strstr(const char *str1, const char *str2);
返回指向字符串str2第一次出现在字符串str1中的位置的指针；如果str1中不包含str2，则返回NULL。
3.13 strlen
#include <string.h> size_t strlen(const char *str);
返回字符串str的长度，'\0'不算在内。
3.16 memcpy
#include <string.h> void *memcpy(void *to, const void *from, size_t count);
把from中的count个字符拷贝到to中。并返回to。
3.20 memset
#include <string.h> void *memset(void *buf, int ch, size_t count);
把buf中的前count个字符替换为ch，并返回buf。
4 数学函数<math.h>
头文件<math.h>中说明了数学函数和宏。
宏 EDOM和ERANGE(定义在头文件<errno.h>中)是两个非0整常量，用于引发各个数学函数的定义域错误和值域错误；HUGE_VAL是一个double类型的正数。当变元取值在函数的定义域之外时，就会出现定义域错误。在发生定义域错误时，全局变量errno的值被置为EDOM，函数的返回值视具体实现而定。如果函数的结果不能用double类型表示，那么就会发生值域错误。当结果上溢时，函数返回 HUGE_VAL并带有正确的符号(正负号)，errno的值被置为ERANGE。当结果下溢时，函数返回0，而errno是否被设置为ERANGE视具体实现而定。
4.1 sin
#include <math.h> double sin(double arg);
返回arg的正弦值，arg单位为弧度。
4.2 cos
#include <math.h> double cos(double arg);
返回arg的余弦值，arg单位为弧度。
4.3 tan
#include <math.h> double tan(double arg);
返回arg的正切值，arg单位为弧度。
4.4 asin
#include <math.h> double asin(double arg);
返回arg的反正弦值sin-1(x)，值域为[-pi/2,pi/2], 其中变元范围[-1,1]。
4.5 acos
#include <math.h> double acos(double arg);
返回arg的反余弦值cos-1(x)，值域为[0,pi], 其中变元范围[-1,1]。
4.6 atan
#include <math.h> double atan(double arg);
返回arg的反正切值tan-1(x)，值域为[-pi/2,pi/2]。
4.7 atan2
#include <math.h> double atan2(double a, double b);
返回a/b的反正切值tan-1(a/b)，值域为[-pi,pi]。
4.8 sinh
#include <math.h> double sinh(double arg);
返回arg的双曲正弦值。
4.9 cosh
#include <math.h> double cosh(double arg);
返回arg的双曲余弦值。
4.10 tanh
#include <math.h> double tanh(double arg);
返回arg的双曲正切值。
4.11 exp
#include <math.h> double exp(double arg);
返回幂函数ex。
4.12 log
#include <math.h> double log(double arg);
返回自然对数ln(x)，其中变元范围arg > 0。
4.13 log10
#include <math.h> double log10(double arg);
返回以10为底的对数log10(x)，其中变元范围arg > 0。
4.14 pow
#include <math.h> double pow(double x, double y);
返回xy，如果x=0且y<=0或者如果x<0且y不是整数，那么产生定义域错误。
4.15 sqrt
#include <math.h> double sqrt(double arg);
返回arg的平方根，其中变元范围arg>=0。
4.16 ceil
#include <math.h> double ceil(double arg);
返回不小于arg的最小整数。
4.17 floor
#include <math.h> double floor(double arg);
返回不大于arg的最大整数。
4.18 fabs
#include <math.h> double fabs(double arg);
返回arg的绝对值|x|。
4.19 ldexp
#include <math.h> double ldexp(double num, int exp);
返回num * 2exp。
4.20 frexp
#include <math.h> double frexp(double num, int *exp);
把num分成一个在[1/2,1)区间的真分数和一个2的幂数。将真分数返回，幂数保存在*exp中。如果num等于0，那么这两部分均为0。
4.21 modf
#include <math.h> double modf(double num, double *i);
把num分成整数和小数两部分，两部分均与num有同样的正负号。函数返回小数部分，整数部分保存在*i中。
4.22 fmod
#include <math.h> double fmod(double a, double b);
返回a/b的浮点余数，符号与a相同。如果b为0，那么结果由具体实现而定。
5 实用函数<stdlib.h>
在头文件<stdlib.h>中说明了用于数值转换、内存分配以及具有其他相似任务的函数。
5.1 atof
#include <stdlib.h> double atof(const char *str);
把字符串str转换成double类型。等价于：strtod(str, (char**)NULL)。
5.2 atoi
#include <stdlib.h> int atoi(const char *str);
把字符串str转换成int类型。等价于：(int)strtol(str, (char**)NULL, 10)。
5.3 atol
#include <stdlib.h> long atol(const char *str);
把字符串str转换成long类型。等价于：strtol(str, (char**)NULL, 10)。
5.7 rand
#include <stdlib.h> int rand(void);
产生一个0到RAND_MAX之间的伪随机整数。RAND_MAX值至少为32767。
5.8 srand
#include <stdlib.h> void srand(unsigned int seed);
设置新的伪随机数序列的种子为seed。种子的初值为1。
5.9 calloc
#include <stdlib.h> void *calloc(size_t num, size_t size);
为num个大小为size的对象组成的数组分配足够的内存，并返回指向所分配区域的第一个字节的指针；如果内存不足以满足要求，则返回NULL。
分配的内存区域中的所有位被初始化为0。
5.10 malloc
#include <stdlib.h> void *malloc(size_t size);
为大小为size的对象分配足够的内存，并返回指向所分配区域的第一个字节的指针；如果内存不足以满足要求，则返回NULL。
不对分配的内存区域进行初始化。
5.12 free
#include <stdlib.h> void free(void *ptr);
释放ptr指向的内存空间，若ptr为NULL，则什么也不做。ptr必须指向先前用动态分配函数malloc、realloc或calloc分配的空间。
5.13 abort
#include <stdlib.h> void abort(void);
使程序非正常终止。其功能类似于raise(SIGABRT)。
5.14 exit
#include <stdlib.h> void exit(int status);
使程序正常终止。atexit函数以与注册相反的顺序被调用，所有打开的文件被刷新，所有打开的流被关闭。status的值如何被返回依具体的实现而定，但用0表示正常终止，也可用值EXIT_SUCCESS和EXIT_FAILURE。
5.16 system
#include <stdlib.h> int system(const char *str);
把字符串str传送给执行环境。如果str为NULL，那么在存在命令处理程序时，返回0值。如果str的值非NULL，则返回值与具体的实现有关。
5.19 qsort
#include <stdlib.h> void qsort(void *base, size_t n, size_t size, \ int (*compare)(const void *, const void *));
对由n个大小为size的对象构成的数组base进行升序排序。
比较函数compare的形式如下：
int func_name(const void *arg1, const voie *arg2);
其返回值必须如下所示：
* arg1 < arg2，返回值<0；
* arg1 == arg2，返回值==0；
* arg1 > arg2，返回值>0。
5.20 abs
#include <stdlib.h> int abs(int num);
返回int变元num的绝对值。
5.21 labs
#include <stdlib.h> long labs(long int num);
返回long类型变元num的绝对值。
5.22 div
#include <stdlib.h> div_t div(int numerator, int denominator);
返回numerator/denominator的商和余数，结果分别保存在结构类型div_t的两个int成员quot和rem中。
5.23 ldiv
#include <stdlib.h> ldiv_t div(long int numerator, long int denominator);
返回numerator/denominator的商和余数，结果分别保存在结构类型ldiv_t的两个long成员quot和rem中。
6 诊断<assert.h>
6.1 assert
#include <assert.h> void assert(int exp);
assert宏用于为程序增加诊断功能。当assert(exp)执行时，如果exp为0，则在标准出错输出流stderr输出一条如下所示的信息：
Assertion failed: expression, file filename, line nnn
然后调用abort终止执行。其中的源文件名filename和行号nnn来自于预处理宏__FILE__和__LINE__。
如果<assert.h>被包含时定义了宏NDEBUG，那么宏assert被忽略。
10 日期与时间函数<time.h>
头文件<time.h>中说明了一些用于处理日期和时间的类型和函数。其中的一部分函数用于处理当地时间，因为时区等原因，当地时间与日历时间可能不相同。clock_t和time_t是两个用于表示时间的算术类型，而struct tm则用于存放日历时间的各个成分。tm的各个成员的用途及取值范围如下：
int tm_sec; /* 秒，0～61 */ int tm_min; /* 分，0～59 */ int tm_hour; /* 时，0～23 */ int tm_mday; /* 日，1～31 */ int tm_mon; /* 月(从1月开始)，0～11 */ int tm_year; /* 年(从1900年开始) */ int tm_wday; /* 星期(从周日开始)，0～6 */ int tm_yday; /* 天数(从1月1日开始)，0～365 */ int tm_isdst; /* 夏令时标记 */
其中，tm_isdst在使用夏令时时其值为正，在不使用夏令时时其值为0，如果该信息不能使用，其值为负。
10.1 clock
#include <time.h> clock_t clock(void);
返回程序自开始执行到目前为止所占用的处理机时间。如果处理机时间不可使用，那么返回-1。clock()/CLOCKS_PER_SEC是以秒为单位表示的时间。
10.2 time
#include <time.h> time_t time(time_t *tp);
返回当前日历时间。如果日历时间不能使用，则返回-1。如果tp不为NULL，那么同时把返回值赋给*tp。
11 由实现定义的限制<limits.h>和<float.h>
头文件<limits.h>中定义了用于表示整类型大小的常量。以下所列的值是可接受的最小值，实际系统中可能有更大的值。
CHAR_BIT 8 char类型的位数
CHAR_MAX UCHAR_MAX或SCHAR_MAX char类型的最大值
CHAR_MIN 0或SCHAR_MIN char类型的最小值
INT_MAX 32767 int类型的最大值
INT_MIN -32767 int类型的最小值
LONG_MAX 2147483647 long的最大值
LONG_MIN -2147483647 long类型的最小值
SCHAR_MAX +127 signed char类型的最大值
SCHAR_MIN -127 signed char类型的最小值
SHRT_MAX +32767 short类型的最大值
SHRT_MIN -32767 short类型的最小值
UCHAR_MAX 255 unsigned char类型的最大值
UINT_MAX 65535 unsigned int类型的最大值
ULONG_MAX 4294967295 unsigned long的最大值
USHRT_MAX 65535 unsigned short的最大值
以下是<float.h>的一个子集，是与浮点算术运算相关的一些常量。给出的每个值代表相应量的一个最小取值。实际实现可以定义适当的值。
FLT_RADIX 2 指数表示的基数，如2、16
FLT_ROUNDS 加法的浮点舍入规则
FLT_DIG 6 float类型精度(小数位数)
FLT_EPSILON 1E-5 使“1.0 + x != 1.0”成立的最小x
FLT_MANT_DIG 基数为FLT_RADIX的尾数中的数字数
FLT_MAX 1E+37 最大浮点数
FLT_MAX_EXP 使FLT_RADIXn-1可表示的最大n
FLT_MIN 1E-37 最小的规范化浮点数
FLT_MIN_EXP 使10n为规范化数的最小n
DBL_DIG 10 double类型精度(小数位数)
DBL_EPSILON 1E-9 使“1.0 + x != 1.0”成立的最小x
DBL_MANT_DIG 基数为FLT_RADIX的尾数中的数字数
DBL_MAX 1E+37 最大双精度浮点数
DBL_MAX_EXP 使FLT_RADIXn-1可表示的最大n
DBL_MIN 1E-37 最小的规范化双精度浮点数
DBL_MIN_EXP 使10n为规范化数的最小n
索引：
1 输入与输出<stdio.h>
1.1 文件操作
1.1.1 fopen
1.1.2 freopen
1.1.3 fflush
1.1.4 fclose
1.1.5 remove
1.1.6 rename
1.1.7 tmpfile
1.1.8 tmpnam
1.1.9 setvbuf
1.1.10 setbuf
1.2 格式化输出
1.2.1 fprintf
1.2.2 printf
1.2.3 sprintf
1.2.4 snprintf
1.2.5 vprintf
1.2.6 vfprintf
1.2.7 vsprintf
1.2.8 vsnprintf
1.3 格式化输入
1.3.1 fscanf
1.3.2 scanf
1.3.3 sscanf
1.4 字符输入输出函数
1.4.1 fgetc
1.4.2 fgets
1.4.3 fputc
1.4.4 fputs
1.4.5 getc
1.4.6 getchar
1.4.7 gets
1.4.8 putc
1.4.9 putchar
1.4.10 puts
1.4.11 ungetc
1.5 直接输入输出函数
1.5.1 fread
1.5.2 fwrite
1.6 文件定位函数
1.6.1 fseek
1.6.2 ftell
1.6.3 rewind
1.6.4 fgetpos
1.6.5 fsetpos
1.7 错误处理函数
1.7.1 clearerr
1.7.2 feof
1.7.3 ferror
1.7.4 perror
2 字符类测试<ctype.h>
2.1 isalnum
2.2 isalpha
2.3 iscntrl
2.4 isdigit
2.5 isgraph
2.6 islower
2.7 isprint
2.8 ispunct
2.9 isspace
2.10 isupper
2.11 isxdigit
2.12 tolower
2.13 toupper
3 字符串函数<string.h>
3.1 strcpy
3.2 strncpy
3.3 strcat
3.4 strncat
3.5 strcmp
3.6 strncmp
3.7 strchr
3.8 strrchr
3.9 strspn
3.10 strcspn
3.11 strpbrk
3.12 strstr
3.13 strlen
3.14 strerror
3.15 strtok
3.16 memcpy
3.17 memmove
3.18 memcmp
3.19 memchr
3.20 memset
4 数学函数<math.h>
4.1 sin
4.2 cos
4.3 tan
4.4 asin
4.5 acos
4.6 atan
4.7 atan2
4.8 sinh
4.9 cosh
4.10 tanh
4.11 exp
4.12 log
4.13 log10
4.14 pow
4.15 sqrt
4.16 ceil
4.17 floor
4.18 fabs
4.19 ldexp
4.20 frexp
4.21 modf
4.22 fmod
5 实用函数<stdlib.h>
5.1 atof
5.2 atoi
5.3 atol
5.4 strtod
5.5 strtol
5.6 strtoul
5.7 rand
5.8 srand
5.9 calloc
5.10 malloc
5.11 realloc
5.12 free
5.13 abort
5.14 exit
5.15 atexit
5.16 system
5.17 getenv
5.18 bsearch
5.19 qsort
5.20 abs
5.21 labs
5.22 div
5.23 ldiv
6 诊断<assert.h>
6.1 assert
7 变长变元表<stdarg.h>
7.1 va_start
7.2 va_arg
7.3 va_end
8 非局部跳转<setjmp.h>
8.1 setjmp
8.2 longjmp
9 信号处理<signal.h>
9.1 signal
9.2 raise
10 日期与时间函数<time.h>
10.1 clock
10.2 time
10.3 difftime
10.4 mktime
10.5 asctime
10.6 ctime
10.7 gmtime
10.8 localtime
10.9 strftime
11 由实现定义的限制<limits.h> and <float.h>
索引
本文包括大部分C标准库函数，但没有列出一些用途有限的函数以及某些可以简单的从其他函数合成的函数，也没有包含多字节和本地化函数。
标准库中的各个函数、类型以及宏分别在以下标准头文件中说明：
<assert.h> <float.h> <math.h> <stdarg.h> <stdlib.h>
<ctype.h> <limits.h> <setjmp.h> <stddef.h> <string.h>
<errno.h> <locale.h> <signal.h> <stdio.h> <time.h>
1 输入与输出<stdio.h>
头文件<stdio.h>定义了用于输入和输出的函数、类型和宏。最重要的类型是用于声明文件指针的FILE。另外两个常用的类型是 size_t和fpos_t，size_t是由运算符sizeof产生的无符号整类型；fpos_t类型定义能够唯一说明文件中的每个位置的对象。由头部定义的最有用的宏是EOF，其值代表文件的结尾。
1.1 文件操作
1.1.1 fopen
#include <stdio.h> FILE *fopen(const char *filename, const char *mode); 返回：成功为FILE指针，失败为NULL
打开以filename所指内容为名字的文件，返回与之关联的流。
mode决定打开的方式，可选值如下：
"r" 打开文本文件用于读
"w" 创建文本文件用于写，并删除已存在的内容(如果有的话)
"a" 添加；打开或创建文本文件用于在文件末尾写
"rb" 打开二进制文件用于读
"wb" 创建二进制文件用于写，并删除已存在的内容(如果有的话)
"ab" 添加；打开或创建二进制文件用于在文件末尾写
"r+" 打开文本文件用于更新(即读和写)
"w+" 创建文本文件用于更新，并删除已存在的内容(如果有的话)
"a+" 添加；打开或创建文本文件用于更新和在文件末尾写
"rb+"或"r+b" 打开二进制文件用于更新(即读和写)
"wb+"或"w+b" 创建二进制文件用于更新，并删除已存在的内容(如果有的话)
"ab+"或"a+b" 添加；打开或创建二进制文件用于更新和在文件末尾写
后六种方式允许对同一文件进行读和写，要注意的是，在写操作和读操作的交替过程中，必须调用fflush()或文件定位函数如fseek()、fsetpos()、rewind()等。
文件名filename的长度最大为FILENAME_MAX个字符，一次最多可打开FOPEN_MAX个文件(在<stdio.h>中定义)。
1.1.2 freopen
#include <stdio.h> FILE *freopen(const char *filename, const char *mode, FILE *stream); 返回：成功为stream，失败为NULL
以mode指定的方式打开文件filename，并使该文件与流stream相关联。freopen()先尝试关闭与stream关联的文件，不管成功与否，都继续打开新文件。
该函数的主要用途是把系统定义的标准流stdin、stdout、stderr重定向到其他文件。
1.1.3 fflush
#include <stdio.h> int fflush(FILE *stream); 返回：成功为0，失败返回EOF
对输出流(写打开)，fflush()用于将已写到缓冲区但尚未写出的全部数据都写到文件中；对输入流，其结果未定义。如果写过程中发生错误则返回EOF，正常则返回0。
fflush(NULL)用于刷新所有的输出流。
程序正常结束或缓冲区满时，缓冲区自动清仓。
1.1.4 fclose
#include <stdio.h> int flcose(FILE *stream); 返回：成功为0，失败返回EOF
刷新stream的全部未写出数据，丢弃任何未读的缓冲区内的输入数据并释放自动分配的缓冲区，最后关闭流。
1.1.5 remove
#include <stdio.h> int remove(const char *filename); 返回：成功为0，失败为非0值
删除文件filename。
1.1.6 rename
#include <stdio.h> int rename(const char *oldfname, const char *newfname); 返回：成功为0，失败为非0值
把文件的名字从oldfname改为newfname。
1.1.7 tmpfile
#include <stdio.h> FILE *tmpfile(void); 返回：成功为流指针，失败为NULL
以方式"wb+"创建一个临时文件，并返回该流的指针，该文件在被关闭或程序正常结束时被自动删除。
1.1.10 setbuf
#include <stdio.h> void setbuf(FILE *stream, char *buf);
如果buf为NULL，则关闭流stream的的缓冲区；否则setbuf函数等价于：
(void)setvbuf(stream, buf, _IOFBF, BUFSIZ)。
注意自定义缓冲区的尺寸必须为BUFSIZ个字节。
1.2 格式化输出
1.2.1 fprintf
#include <stdio.h> int fprintf(FILE *stream, const char *format,…); 返回：成功为实际写出的字符数，出错返回负值
按照format说明的格式把变元表中变元内容进行转换，并写入stream指向的流。
格式化字符串由两种类型的对象组成：普通字符(它们被拷贝到输出流)与转换规格说明(它们决定变元的转换和输出格式)。每个转换规格说明均以字符%开头，以转换字符结束。如果%后面的字符不是转换字符，那么该行为是未定义的。
转换字符列表如下：
字 符 说明
d, i int；有符号十进制表示法
o unsigned int；无符号八进制表示法（无前导0）
x, X unsigned int；无符号十六进制表示法（无前导0X和0x），对0x用abcdef，对0X用ABCDEF
u unsigned int；无符号十进制表示法
c int；单个字符，转换为unsigned char类型后输出
s char *；输出字符串直到'\0'或者达到精度指定的字符数
f double；形如[-]mmm.ddd的十进制浮点数表示法，d的数目由精度确定。缺省精度为6位，精度为0时不输出小数点
e, E double；形如[-]m.dddddde[+-]xx或者[-]m.ddddddE[+-]xx的十进制浮点数表示法，d的数目由精度确定。缺省精度为6位，精度为0时不输出小数点
g G double；当指数值小于-4或大于等于精度时，采用%e或%E的格式；否则使用%f的格式。尾部的0与小数点不打印
p void *；输出指针值（具体表示与实现相关）
n int *；到目前为止以此格式调用函数输出的字符的数目将被写入到相应变元中，不进行变元转换
% 不进行变元转换，输出%
在%与转换字符之间依次可以有下列标记：
标记 说明
- 指定被转换的变元在其字段内左对齐
+ 指定在输出的数前面加上正负号
空格 如果第一个字符不是正负号，那么在其前面附加一个空格
0 对于数值转换，在输出长度小于字段宽度时，加前导0
# 指定其他输出格式，对于o格式，第一个数字必须为零；对于x/X格式，指定在输出的非0值前加0x或0X；对于e/E/f/g/G格式，指定输出总有一个小数点；对于g/GG格式，还指定输出值后面无意义的0将被保留。
宽度[number] 一个指定最小字段宽的数。转换后的变元输出宽度至少要达到这个数值。如果变元的字符数小于此数值，那么在变元左/右边添加填充字符。填充字符通常为空格（设置了0标记则为0）。
. 点号用于把字段宽和精度分开
精度[number] 对于字符串，说明输出字符的最大数目；对于e/E/f格式，说明输出的小数位数；对于g/G格式，说明输出的有效位数；对于整数，说明输出的最小位数（必要时可加前导0）
h/l/L 长度修饰符，h表示对应的变元按short或unsigned short类型输出；l表示对应的变元按long或unsigned long类型输出；L表示对应的变元按long double类型输出
在格式串中字段宽度和精度二者都可以用*来指定，此时该值可通过转换对应的变元来获得，这些变元必须是int类型。
1.2.2 printf
#include <stdio.h> int printf(const char *format, …);
printf(...)等价于fprintf(stdout, ...)。
1.2.3 sprintf
#include <stdio.h> int sprintf(char *buf, const char *format, …); 返回：实际写到字符数组的字符数，不包括'\0'
与printf()基本相同，但输出写到字符数组buf而不是stdout中，并以'\0'结束。
注意，sprintf()不对buf进行边界检查，buf必须足够大，以便能装下输出结果。
1.3 格式化输入
1.3.1 fscanf
#include <stdio.h> int fscanf(FILE *stream, const char *format, …); 返回：成功为实际被转换并赋值的输入项数目，到达文件尾或变元被转换前出错为EOF
在格式串format的控制下从流stream中读入字符，把转换后的值赋给后续各个变元，在此每一个变元都必须是一个指针。当格式串format结束时函数返回。
格式串format通常包含有用于指导输入转换的转换规格说明。格式串中可以包含：
* 空格或制表符，他们将被忽略；
* 普通字符(%除外)，与输入流中下一个非空白字符相匹配；
* 转换规格说明：由一个%、一个赋值屏蔽字符*(可选)、一个用于指定最大字段宽度的数(可选)、一个用于指定目标字段的字符h/l/L(可选)、一个转换字符组成。
转换规格说明决定了输入字段的转换方式。通常把结果保存在由对应变元指向的变量中。然而，如果转换规格说明中包含有赋值屏蔽字符*，例如%*s，那么就跳过对应的输入字段，不进行赋值。输入字段是一个由非空白符组成的字符串，当遇到空白符或到达最大字段宽(如果有的话)时，对输入字段的读入结束。这意味着 scanf函数可以跨越行的界限来读入其输入，因为换行符也是空白符(空白符包括空格、横向制表符、纵向制表符、换行符、回车符和换页符)。
转换字符列表如下：
字符 输入数据；变元类型
d 十进制整数；int *
i 整数；int *。该整数可以是以0开头的八进制数，也可以是以0x/0X开头的十六进制数
o 八进制数（可以带或不带前导0）；unsigned int *
u 无符号十进制整数；unsigned int *
x 十六进制整数（可以带或不带前导0x/0X)；unsigned int *
c 字符；char *。按照字段宽的大小把读入的字符保存在指定的数组中，不加入字符'\0'。字段宽的缺省值为1。在这种情况下，不跳过空白符；如果要读入下一个非空白符，使用%1s（数字1）
s 有非空白符组成的字符串（不包含引号）；char *。该变元指针指向一个字符数组，该字符数组有足够空间来保存该字符串以及在末尾添加的'\0'
e/f/g 浮点数；float *。float浮点数的输入格式为：一个任选的正负号，一串可能包含小数点的数字和一个任选的指数字段。指数字段由字母e/E以及后跟的一个可能带正负号的整数组成
p 用printf("%p")调用输出的指针值；void *
n 将到目前为止此调用所读的字符数写入变元；int *。不读入输入字符。不增加转换项目计数
[...] 用方括号括起来的字符集中的字符来匹配输入，以找到最长的非空字符串；char *。在末尾添加'\0'。格式[]...]表示字符集中包含字符]
[^...] 用不在方括号里的字符集中的字符来匹配输入，以找到最长的非空字符串；char *。在末尾添加'\0'。格式[]...]表示字符集中包含字符]
% 字面值%，不进行赋值
字段类型字符：
* 如果变元是指向short类型而不是int类型的指针，那么在d/i/n/o/u/x这几个转换字符前可以加上字符h；
* 如果变元是指向long类型的指针，那么在d/i/n/o/u/x这几个转换字符前可以加上字符l；
* 如果变元是指向double类型而不是float类型的指针，那么在e/f/g这几个转换字符前可以加上字符l；
* 如果变元是指向long double类型的指针，那么在e/f/g前可以加上字符L。
1.3.2 scanf
#include <stdio.h> int scanf(const char *format, …);
scanf(...)等价于fscanf(stdin, ...)。
1.3.3 sscanf
#include <stdio.h> int sscanf(const char *buf, const char *format, …);
与scanf()基本相同，但sscanf()从buf指向的数组中读，而不是stdin。
1.4 字符输入输出函数
1.4.1 fgetc
#include <stdio.h> int fgetc(FILE *stream);
以unsigned char类型返回输入流stream中下一个字符(转换为int类型)。如果到达文件末尾或发生错误，则返回EOF。
1.4.2 fgets
#include <stdio.h> char *fgets(char *str, int num, FILE *stream); 返回：成功返回str，到达文件尾或发生错误返回NULL
从流stream中读入最多num-1个字符到数组str中。当遇到换行符时，把换行符保留在str中，读入不再进行。数组str以'\0'结尾。
1.4.3 fputc
#include <stdio.h> int fputc(int ch, FILE *stream); 返回：成功为所写的字符，出错为EOF
把字符ch(转换为unsigned char类型)输出到流stream中。
1.4.4 fputs
#include <stdio.h> int fputs(const char *str, FILE *stream); 返回：成功返回非负值，失败返回EOF
把字符串str输出到流stream中，不输出终止符'\0'。
1.4.5 getc
#include <stdio.h> int getc(FILE *stream);
getc()与fgetc()等价。不同之处为：当getc函数被定义为宏时，它可能多次计算stream的值。
1.4.6 getchar
#include <stdio.h> int getchar(void);
等价于getc(stdin)。
1.4.7 gets
#include <stdio.h> char *gets(char *str); 返回：成功为str，到达文件尾或发生错误则为NULL
从stdin中读入下一个字符串到数组str中，并把读入的换行符替换为字符'\0'。
gets()可读入无限多字节，所以要保证str有足够的空间，防止溢出。
1.4.8 putc
#include <stdio.h> int putc(int ch, FILE *stream);
putc()与fputc()等价。不同之处为：当putc函数被定义为宏时，它可能多次计算stream的值。
1.4.9 putchar
#include <stdio.h> int putchar(int ch);
等价于putc(ch, stdout)。
1.4.10 puts
#include <stdio.h> int puts(const char *str); 返回：成功返回非负值，出错返回EOF
把字符串str和一个换行符输出到stdout。
1.5 直接输入输出函数
1.5.1 fread
#include <stdio.h> size_t fread(void *buf, size_t size, size_t count, FILE *stream); 返回：实际读入的对象数
从流stream中读入最多count个长度为size个字节的对象，放到buf指向的数组中。
返回值可能小于指定读入数，原因可能是出错，也可能是到达文件尾。实际执行状态可用feof()或ferror()确定。
1.5.2 fwrite
#include <stdio.h> size_t fwrite(const void *buf, size_t size, size_t count, FILE *stream); 返回：实际输出的对象数
把buf指向的数组中count个长度为size的对象输出到流stream中，并返回被输出的对象数。如果发生错误，则返回一个小于count的值。
1.6 文件定位函数
1.6.1 fseek
#include <stdio.h> int fseek(FILE *stream, long int offset, int origin); 返回：成功为0，出错为非0
对流stream相关的文件定位，随后的读写操作将从新位置开始。
对于二进制文件，此位置被定位在由origin开始的offset个字符处。origin的值可能为SEEK_SET(文件开始处)、SEEK_CUR(当前位置)或SEEK_END(文件结束处)。
对于文本流，offset心须为0，或者是由函数ftell()返回的值(此时origin的值必须是SEEK_SET)。
1.7 错误处理函数
当发生错误或到达文件末尾时，标准库中的许多函数将设置状态指示符。这些状态指示符可被显式地设置和测试。另外，(定义在<errno.h>中的)整数表达式errno可包含一个出错序号，该数将进一步给出最近一次出错的信息。
1.7.1 clearerr
#include <stdio.h> void clearerr(FILE *stream);
清除与流stream相关的文件结束指示符和错误指示符。
1.7.2 feof
#include <stdio.h> int feof(FILE *stream); 返回：到达文件尾时返回非0值，否则返回0
与流stream相关的文件结束指示符被设置时，函数返回一个非0值。
1.7.3 ferror
#include <stdio.h> int ferror(FILE *stream); 返回：无错返回0，有错返回非0
与流stream相关的文件出错指示符被设置时，函数返回一个非0值。
1.7.4 perror
#include <stdio.h> void perror(const char *str);
perror(s)用于输出字符串s以及与全局变量errno中的整数值相对应的出错信息，具体出错信息的内容依赖于实现。该函数的功能类似于：
fprintf(stderr, "%s: %s\n", s, "出错信息");
可参见第3节介绍的strerror函数。
2 字符类测试<ctype.h>
头文件<ctype.h>中说明了一些用于测试字符的函数。每个函数的变元均为int类型，变元的值必须是EOF或可用unsigned char类型表示的字符，函数的返回值为int类型。如果变元满足所指定的条件，那么函数返回非0值(表示真)；否则返回值为0(表示假)。这些函数包括 2.1～2.11。
在7位ASCII字符集中，可打印字符是从0x20(' ')到0x7E('~')之间的字符；控制字符是从0(NUL)到0x1F(US)之间的字符和字符0x7F(DEL)。
2.1 isalnum
#include <ctype.h> int sialnum(int ch);
变元为字母或数字时，函数返回非0值，否则返回0。
2.2 isalpha
#include <ctype.h> int isalpha(int ch);
当变元为字母表中的字母时，函数返回非0值，否则返回0。各种语言的字母表互不相同，对于英语来说，字母表由大写和小写的字母A到Z组成。
2.3 iscntrl
#include <ctype.h> int iscntrl(int ch);
当变元是控制字符时，函数返回非0，否则返回0。
2.4 isdigit
#include <ctype.h> int isdigit(int ch);
当变元是十进制数字时，函数返回非0值，否则返回0。
2.5 isgraph
#include <ctype.h> int isgraph(int ch);
如果变元为除空格之外的任何可打印字符，则函数返回非0值，否则返回0。
2.6 islower
#include <ctype.h> int islower(int ch);
如果变元是小写字母，函数返回非0值，否则返回0。
2.7 isprint
#include <ctype.h> int isprint(int ch);
如果变元是可打印字符(含空格)，则函数返回非0值，否则返回0。
2.8 ispunct
#include <ctype.h> int ispunct(int ch);
如果变元是除空格、字母和数字外的可打印字符，则函数返回非0，否则返回0。
2.9 isspace
#include <ctype.h> int isspace(int ch);
当变元为空白字符(包括空格、换页符、换行符、回车符、水平制表符和垂直制表符)时，函数返回非0，否则返回0。
2.10 isupper
#include <ctype.h> int isupper(int ch);
如果变元为大写字母，函数返回非0，否则返回0。
2.11 isxdigit
#include <ctype.h> int isxdigit(int ch);
当变元为十六进制数字时，函数返回非0，否则返回0。
2.12 tolower
#include <string.h> int tolower(int ch);
当ch为大写字母时，返回其对应的小写字母；否则返回ch。
2.13 toupper
#include <string.h> int toupper(int ch);
当ch为小写字母时，返回其对应的大写字母；否则返回ch。
3 字符串函数<string.h>
在头文件<string.h>中定义了两组字符串函数。第一组函数的名字以str开头；第二组函数的名字以mem开头。只有函数memmove对重叠对象间的拷贝进行了定义，而其他函数都未定义。比较类函数将其变元视为unsigned char类型的数组。
3.1 strcpy
#include <string.h> char *strcpy(char *str1, const char *str2);
把字符串str2(包括'\0')拷贝到字符串str1当中，并返回str1。
3.3 strcat
#include <string.h> char *strcat(char *str1, const char *str2);
把str2(包括'\0')拷贝到str1的尾部(连接)，并返回str1。其中终止原str1的'\0'被str2的第一个字符覆盖。
3.5 strcmp
#include <string.h> int strcmp(const char *str1, const char *str2);
按字典顺序比较两个字符串，返回整数值的意义如下：
* 小于0，str1小于str2；
* 等于0，str1等于str2；
* 大于0，str1大于str2；
3.7 strchr
#include <string.h> char *strchr(const char *str, int ch);
返回指向字符串str中字符ch第一次出现的位置的指针，如果str中不包含ch，则返回NULL。
3.12 strstr
#include <string.h> char *strstr(const char *str1, const char *str2);
返回指向字符串str2第一次出现在字符串str1中的位置的指针；如果str1中不包含str2，则返回NULL。
3.13 strlen
#include <string.h> size_t strlen(const char *str);
返回字符串str的长度，'\0'不算在内。
3.16 memcpy
#include <string.h> void *memcpy(void *to, const void *from, size_t count);
把from中的count个字符拷贝到to中。并返回to。
3.20 memset
#include <string.h> void *memset(void *buf, int ch, size_t count);
把buf中的前count个字符替换为ch，并返回buf。
4 数学函数<math.h>
头文件<math.h>中说明了数学函数和宏。
宏 EDOM和ERANGE(定义在头文件<errno.h>中)是两个非0整常量，用于引发各个数学函数的定义域错误和值域错误；HUGE_VAL是一个double类型的正数。当变元取值在函数的定义域之外时，就会出现定义域错误。在发生定义域错误时，全局变量errno的值被置为EDOM，函数的返回值视具体实现而定。如果函数的结果不能用double类型表示，那么就会发生值域错误。当结果上溢时，函数返回 HUGE_VAL并带有正确的符号(正负号)，errno的值被置为ERANGE。当结果下溢时，函数返回0，而errno是否被设置为ERANGE视具体实现而定。
4.1 sin
#include <math.h> double sin(double arg);
返回arg的正弦值，arg单位为弧度。
4.2 cos
#include <math.h> double cos(double arg);
返回arg的余弦值，arg单位为弧度。
4.3 tan
#include <math.h> double tan(double arg);
返回arg的正切值，arg单位为弧度。
4.4 asin
#include <math.h> double asin(double arg);
返回arg的反正弦值sin-1(x)，值域为[-pi/2,pi/2], 其中变元范围[-1,1]。
4.5 acos
#include <math.h> double acos(double arg);
返回arg的反余弦值cos-1(x)，值域为[0,pi], 其中变元范围[-1,1]。
4.6 atan
#include <math.h> double atan(double arg);
返回arg的反正切值tan-1(x)，值域为[-pi/2,pi/2]。
4.7 atan2
#include <math.h> double atan2(double a, double b);
返回a/b的反正切值tan-1(a/b)，值域为[-pi,pi]。
4.8 sinh
#include <math.h> double sinh(double arg);
返回arg的双曲正弦值。
4.9 cosh
#include <math.h> double cosh(double arg);
返回arg的双曲余弦值。
4.10 tanh
#include <math.h> double tanh(double arg);
返回arg的双曲正切值。
4.11 exp
#include <math.h> double exp(double arg);
返回幂函数ex。
4.12 log
#include <math.h> double log(double arg);
返回自然对数ln(x)，其中变元范围arg > 0。
4.13 log10
#include <math.h> double log10(double arg);
返回以10为底的对数log10(x)，其中变元范围arg > 0。
4.14 pow
#include <math.h> double pow(double x, double y);
返回xy，如果x=0且y<=0或者如果x<0且y不是整数，那么产生定义域错误。
4.15 sqrt
#include <math.h> double sqrt(double arg);
返回arg的平方根，其中变元范围arg>=0。
4.16 ceil
#include <math.h> double ceil(double arg);
返回不小于arg的最小整数。
4.17 floor
#include <math.h> double floor(double arg);
返回不大于arg的最大整数。
4.18 fabs
#include <math.h> double fabs(double arg);
返回arg的绝对值|x|。
4.19 ldexp
#include <math.h> double ldexp(double num, int exp);
返回num * 2exp。
4.20 frexp
#include <math.h> double frexp(double num, int *exp);
把num分成一个在[1/2,1)区间的真分数和一个2的幂数。将真分数返回，幂数保存在*exp中。如果num等于0，那么这两部分均为0。
4.21 modf
#include <math.h> double modf(double num, double *i);
把num分成整数和小数两部分，两部分均与num有同样的正负号。函数返回小数部分，整数部分保存在*i中。
4.22 fmod
#include <math.h> double fmod(double a, double b);
返回a/b的浮点余数，符号与a相同。如果b为0，那么结果由具体实现而定。
5 实用函数<stdlib.h>
在头文件<stdlib.h>中说明了用于数值转换、内存分配以及具有其他相似任务的函数。
5.1 atof
#include <stdlib.h> double atof(const char *str);
把字符串str转换成double类型。等价于：strtod(str, (char**)NULL)。
5.2 atoi
#include <stdlib.h> int atoi(const char *str);
把字符串str转换成int类型。等价于：(int)strtol(str, (char**)NULL, 10)。
5.3 atol
#include <stdlib.h> long atol(const char *str);
把字符串str转换成long类型。等价于：strtol(str, (char**)NULL, 10)。
5.7 rand
#include <stdlib.h> int rand(void);
产生一个0到RAND_MAX之间的伪随机整数。RAND_MAX值至少为32767。
5.8 srand
#include <stdlib.h> void srand(unsigned int seed);
设置新的伪随机数序列的种子为seed。种子的初值为1。
5.9 calloc
#include <stdlib.h> void *calloc(size_t num, size_t size);
为num个大小为size的对象组成的数组分配足够的内存，并返回指向所分配区域的第一个字节的指针；如果内存不足以满足要求，则返回NULL。
分配的内存区域中的所有位被初始化为0。
5.10 malloc
#include <stdlib.h> void *malloc(size_t size);
为大小为size的对象分配足够的内存，并返回指向所分配区域的第一个字节的指针；如果内存不足以满足要求，则返回NULL。
不对分配的内存区域进行初始化。
5.12 free
#include <stdlib.h> void free(void *ptr);
释放ptr指向的内存空间，若ptr为NULL，则什么也不做。ptr必须指向先前用动态分配函数malloc、realloc或calloc分配的空间。
5.13 abort
#include <stdlib.h> void abort(void);
使程序非正常终止。其功能类似于raise(SIGABRT)。
5.14 exit
#include <stdlib.h> void exit(int status);
使程序正常终止。atexit函数以与注册相反的顺序被调用，所有打开的文件被刷新，所有打开的流被关闭。status的值如何被返回依具体的实现而定，但用0表示正常终止，也可用值EXIT_SUCCESS和EXIT_FAILURE。
5.16 system
#include <stdlib.h> int system(const char *str);
把字符串str传送给执行环境。如果str为NULL，那么在存在命令处理程序时，返回0值。如果str的值非NULL，则返回值与具体的实现有关。
5.19 qsort
#include <stdlib.h> void qsort(void *base, size_t n, size_t size, \ int (*compare)(const void *, const void *));
对由n个大小为size的对象构成的数组base进行升序排序。
比较函数compare的形式如下：
int func_name(const void *arg1, const voie *arg2);
其返回值必须如下所示：
* arg1 < arg2，返回值<0；
* arg1 == arg2，返回值==0；
* arg1 > arg2，返回值>0。
5.20 abs
#include <stdlib.h> int abs(int num);
返回int变元num的绝对值。
5.21 labs
#include <stdlib.h> long labs(long int num);
返回long类型变元num的绝对值。
5.22 div
#include <stdlib.h> div_t div(int numerator, int denominator);
返回numerator/denominator的商和余数，结果分别保存在结构类型div_t的两个int成员quot和rem中。
5.23 ldiv
#include <stdlib.h> ldiv_t div(long int numerator, long int denominator);
返回numerator/denominator的商和余数，结果分别保存在结构类型ldiv_t的两个long成员quot和rem中。
6 诊断<assert.h>
6.1 assert
#include <assert.h> void assert(int exp);
assert宏用于为程序增加诊断功能。当assert(exp)执行时，如果exp为0，则在标准出错输出流stderr输出一条如下所示的信息：
Assertion failed: expression, file filename, line nnn
然后调用abort终止执行。其中的源文件名filename和行号nnn来自于预处理宏__FILE__和__LINE__。
如果<assert.h>被包含时定义了宏NDEBUG，那么宏assert被忽略。
10 日期与时间函数<time.h>
头文件<time.h>中说明了一些用于处理日期和时间的类型和函数。其中的一部分函数用于处理当地时间，因为时区等原因，当地时间与日历时间可能不相同。clock_t和time_t是两个用于表示时间的算术类型，而struct tm则用于存放日历时间的各个成分。tm的各个成员的用途及取值范围如下：
int tm_sec; /* 秒，0～61 */ int tm_min; /* 分，0～59 */ int tm_hour; /* 时，0～23 */ int tm_mday; /* 日，1～31 */ int tm_mon; /* 月(从1月开始)，0～11 */ int tm_year; /* 年(从1900年开始) */ int tm_wday; /* 星期(从周日开始)，0～6 */ int tm_yday; /* 天数(从1月1日开始)，0～365 */ int tm_isdst; /* 夏令时标记 */
其中，tm_isdst在使用夏令时时其值为正，在不使用夏令时时其值为0，如果该信息不能使用，其值为负。
10.1 clock
#include <time.h> clock_t clock(void);
返回程序自开始执行到目前为止所占用的处理机时间。如果处理机时间不可使用，那么返回-1。clock()/CLOCKS_PER_SEC是以秒为单位表示的时间。
10.2 time
#include <time.h> time_t time(time_t *tp);
返回当前日历时间。如果日历时间不能使用，则返回-1。如果tp不为NULL，那么同时把返回值赋给*tp。
11 由实现定义的限制<limits.h>和<float.h>
头文件<limits.h>中定义了用于表示整类型大小的常量。以下所列的值是可接受的最小值，实际系统中可能有更大的值。
CHAR_BIT 8 char类型的位数
CHAR_MAX UCHAR_MAX或SCHAR_MAX char类型的最大值
CHAR_MIN 0或SCHAR_MIN char类型的最小值
INT_MAX 32767 int类型的最大值
INT_MIN -32767 int类型的最小值
LONG_MAX 2147483647 long的最大值
LONG_MIN -2147483647 long类型的最小值
SCHAR_MAX +127 signed char类型的最大值
SCHAR_MIN -127 signed char类型的最小值
SHRT_MAX +32767 short类型的最大值
SHRT_MIN -32767 short类型的最小值
UCHAR_MAX 255 unsigned char类型的最大值
UINT_MAX 65535 unsigned int类型的最大值
ULONG_MAX 4294967295 unsigned long的最大值
USHRT_MAX 65535 unsigned short的最大值
以下是<float.h>的一个子集，是与浮点算术运算相关的一些常量。给出的每个值代表相应量的一个最小取值。实际实现可以定义适当的值。
FLT_RADIX 2 指数表示的基数，如2、16
FLT_ROUNDS 加法的浮点舍入规则
FLT_DIG 6 float类型精度(小数位数)
FLT_EPSILON 1E-5 使“1.0 + x != 1.0”成立的最小x
FLT_MANT_DIG 基数为FLT_RADIX的尾数中的数字数
FLT_MAX 1E+37 最大浮点数
FLT_MAX_EXP 使FLT_RADIXn-1可表示的最大n
FLT_MIN 1E-37 最小的规范化浮点数
FLT_MIN_EXP 使10n为规范化数的最小n
DBL_DIG 10 double类型精度(小数位数)
DBL_EPSILON 1E-9 使“1.0 + x != 1.0”成立的最小x
DBL_MANT_DIG 基数为FLT_RADIX的尾数中的数字数
DBL_MAX 1E+37 最大双精度浮点数
DBL_MAX_EXP 使FLT_RADIXn-1可表示的最大n
DBL_MIN 1E-37 最小的规范化双精度浮点数
DBL_MIN_EXP 使10n为规范化数的最小n
索引：
1 输入与输出<stdio.h>
1.1 文件操作
1.1.1 fopen
1.1.2 freopen
1.1.3 fflush
1.1.4 fclose
1.1.5 remove
1.1.6 rename
1.1.7 tmpfile
1.1.8 tmpnam
1.1.9 setvbuf
1.1.10 setbuf
1.2 格式化输出
1.2.1 fprintf
1.2.2 printf
1.2.3 sprintf
1.2.4 snprintf
1.2.5 vprintf
1.2.6 vfprintf
1.2.7 vsprintf
1.2.8 vsnprintf
1.3 格式化输入
1.3.1 fscanf
1.3.2 scanf
1.3.3 sscanf
1.4 字符输入输出函数
1.4.1 fgetc
1.4.2 fgets
1.4.3 fputc
1.4.4 fputs
1.4.5 getc
1.4.6 getchar
1.4.7 gets
1.4.8 putc
1.4.9 putchar
1.4.10 puts
1.4.11 ungetc
1.5 直接输入输出函数
1.5.1 fread
1.5.2 fwrite
1.6 文件定位函数
1.6.1 fseek
1.6.2 ftell
1.6.3 rewind
1.6.4 fgetpos
1.6.5 fsetpos
1.7 错误处理函数
1.7.1 clearerr
1.7.2 feof
1.7.3 ferror
1.7.4 perror
2 字符类测试<ctype.h>
2.1 isalnum
2.2 isalpha
2.3 iscntrl
2.4 isdigit
2.5 isgraph
2.6 islower
2.7 isprint
2.8 ispunct
2.9 isspace
2.10 isupper
2.11 isxdigit
2.12 tolower
2.13 toupper
3 字符串函数<string.h>
3.1 strcpy
3.2 strncpy
3.3 strcat
3.4 strncat
3.5 strcmp
3.6 strncmp
3.7 strchr
3.8 strrchr
3.9 strspn
3.10 strcspn
3.11 strpbrk
3.12 strstr
3.13 strlen
3.14 strerror
3.15 strtok
3.16 memcpy
3.17 memmove
3.18 memcmp
3.19 memchr
3.20 memset
4 数学函数<math.h>
4.1 sin
4.2 cos
4.3 tan
4.4 asin
4.5 acos
4.6 atan
4.7 atan2
4.8 sinh
4.9 cosh
4.10 tanh
4.11 exp
4.12 log
4.13 log10
4.14 pow
4.15 sqrt
4.16 ceil
4.17 floor
4.18 fabs
4.19 ldexp
4.20 frexp
4.21 modf
4.22 fmod
5 实用函数<stdlib.h>
5.1 atof
5.2 atoi
5.3 atol
5.4 strtod
5.5 strtol
5.6 strtoul
5.7 rand
5.8 srand
5.9 calloc
5.10 malloc
5.11 realloc
5.12 free
5.13 abort
5.14 exit
5.15 atexit
5.16 system
5.17 getenv
5.18 bsearch
5.19 qsort
5.20 abs
5.21 labs
5.22 div
5.23 ldiv
6 诊断<assert.h>
6.1 assert
7 变长变元表<stdarg.h>
7.1 va_start
7.2 va_arg
7.3 va_end
8 非局部跳转<setjmp.h>
8.1 setjmp
8.2 longjmp
9 信号处理<signal.h>
9.1 signal
9.2 raise
10 日期与时间函数<time.h>
10.1 clock
10.2 time
10.3 difftime
10.4 mktime
10.5 asctime
10.6 ctime
10.7 gmtime
10.8 localtime
10.9 strftime
11 由实现定义的限制<limits.h> and <float.h>
扫一扫
1万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
