客服电话
APP下载
迪恩网络APP
随时随地掌握行业动态
官方微信
扫描二维码
关注迪恩网络微信公众号
|
本附录描述了标准C支持的库函数①。使用此附录时，请记住下列要点。 ???? 为了简洁清楚，这里删除了一些细节。如果想看全部内容，请参考标准。本书的其他地方已经对 一些函数（特别是printf函数、scanf函数以及它们的变异函数）进行了详细介绍，所以这里 只对这类函数做简短的描述。为了获得关于某个函数更详细的信息（包括如何使用这个函数的示 例），请见函数描述右下角用楷体列出的节号。 ???? 每个函数描述结尾都有其他与之相关函数的列表。相似函数非常接近于正在描述的函数。相关函 数经常会和在描述的函数联合使用。（例如，calloc函数和realloc函数与malloc函数“类似”， 而free函数则与malloc函数“相关”。）也可参见的函数和在描述的函数没有紧密联系，但是却 可能有影响。 ???? 如果把函数行为的某些方面描述为由实现定义的，那么这就意味着此函数依赖于C库的实现方式。 函数将始终行为一致，但是结果却可能会由于系统的不同而千差万别。（换句话说，请参考手册了 解可能发生的问题。）另一方面，未定义的行为是一个不好的消息：不但函数的行为可能会因系统 不同而不同，而且程序也可能会行为异常甚至崩溃。 ???? <math.h>中许多函数的描述提到了定义域错误和取值范围错误。在本附录的末尾对这两种错误 进行了定义。 ???? 下列库函数的行为是会受到当前地区影响的： ???? 字符处理函数（除了isdigit函数和isxdigit函数）。 ???? 格式化输入/输出函数。 ???? 多字节字符和字符串函数。 ???? 字符串转换函数。 ???? Strcoll函数、strftime函数和strxfrm函数。 例如，isalpha函数实际上检测字符是否在a到z之间或者在A到Z之间。在某些区域内也把 其他字符看成是字母次序的。本附录描述了在"C"（默认的）地区内库函数的行为。 ???? 一些函数实际上是宏。然而，这些宏的用法和函数完全一样，所以这里不对它们区别对待。 abort 异常终止程序 <stdlib.h> void abort(void); 产生SIGABRT信号。如果无法捕获信号（或者如果信号处理函数返回），那么程序会异常 终止，并且返回由实现定义的代码来说明不成功的终止。是否清洗输出缓冲区，是否关 闭打开的流，以及是否移除临时文件都是由实现定义的。 相似函数 exit函数、raise函数 相关函数 assert函数、signal函数 也可参见 atexit函数 26.2节 abs 整数的绝对值 <stdlib.h> int abs(int j); 返回 整数j的绝对值。如果不能表示j的绝对值，那么函数的行为是未定义的。 ① 这些材料经ANSI许可改编自American National Standards Institude ANSI/ISO 9899©1990。这个标准的副本可从 ANSI购买（ANSI, 11 West 42nd Street, New York, NY 10036）。 附录D 601 附录D 标准库函数 419 相似函数 fabs函数、labs函数 26.2节 acos 反余弦 <math.h> double acos(double x); 返回 x的反余弦值。返回值的范围在0到π之间。如果x的值不在−1到+1之间，那么就会发生定 义域错误。 相关函数 asin函数、atan函数、atan2函数、cos函数、sin函数、tan函数 23.3节 asctime 把日期和时间转换成ASCII码 <time.h> char *asctime(const struct tm *timeptr); 返回 指向以空字符结尾的字符串的指针，其格式如下所示： Mon Jul 15 12:30:45 1996\n 此格式的构造来源于timeptr指向的结构中的分解时间。 相似函数 ctime函数、strftime函数 相关函数 diffime函数、gmtime函数、localtime函数、mktime函数、time函数 26.3节 asin 反正弦 <math.h> double asin(double x); 返回 x的反正弦值。返回值的范围在-π/2到π/2之间。如果x的值不在-1到+1之间，那么就会发 生定义域错误。 相关函数 acos函数、atan函数、atan2函数、cos函数、sin函数、tan函数 23.3节 asserrt 诊断表达式的真值 <assert.h> void assert(int expression); 如果expression的值非零，那么assert函数什么也不做。如果expression的值为零， 那么assert函数向stderr写信息（说明expression的文本，含有assert函数的源文 件名，以及assert函数的行数），然后通过调用abort函数终止程序。为了使assert函 数无效，要在包含<assert.h>之前定义宏NDEBUG。 相关函数 abort函数 24.1节 atan 反正切 <math.h> double atan(double x); 返回 x的反正切值。返回值的范围在−π/2到π/2之间。 相似函数 atan2函数 相关函数 acos函数、asin函数、cos函数、sin函数、tan函数 23.3节 atan2 商的反正切 <math.h> double atan2(double y, double x); 返回 y/x的反正切值。返回值的范围在−π到π之间。如果x和y的值都为零，那么就会发生定义 域错误。 相似函数 atan函数 相关函数 acos函数、asin函数、cos函数、sin函数、tan函数 23.3节 atexit 在程序退出处注册要调用的函数 <stdlib.h> int atexit(void (*func)(void)); 注册由func指向的函数作为终止函数。如果程序正常终止（通过return或exit，而不 是abort），那么将调用函数。可以重复调用atexit函数来注册多个终止函数。最后一 个注册的函数将是在终止前第一个被调用的函数。 返回 如果成功，返回零。如果不成功，则返回非零（达到由实现定义的限制）。 相关函数 exit函数 也可参见 abort函数 26.2节 atof 把字符串转换成浮点数 <stdlib.h> 602 603 420 附录D 标准库函数 double atof(const char *nptr); 返回 对应字符串最长初始部分的double型值，此字符串是由nptr指向的，且字符串最长初 始部分具有浮点数的格式。如果无法表示此数，那么函数的行为将是未定义的。 相似函数 strtod函数 相关函数 atoi函数、atol函数 也可参见 strtol函数、strtoul函数 26.2节 atoi 把字符串转换成整数 <stdlib.h> int atoi(const char *nptr); 返回 对应字符串最长初始部分的整数，此字符串是由nptr指向的，且字符串最长初始部分具 有整数的格式。如果无法表示此数，那么函数的行为将是未定义的。 相似函数 atol函数、strtol函数、strtoul函数 相关函数 atof函数 也可参见 strtod函数 26.2节 atol 把字符串转换成长整数 <stdlib.h> long int atol(const char *nptr); 返回 对应字符串最长初始部分的长整数，此字符串是由nptr指向的，且字符串最长初始部分 具有整数的格式。如果无法表示此数，那么函数的行为将是未定义的。 相似函数 atoi函数、strtol函数、strtoul函数 相关函数 atof函数 也可参见 strtod函数 26.2节 bsearch 二分检索 <stdlib.h> void *bsearch(const void *key, const void *base, size_t memb, size_t size, int (*compar)(const void *, const void *)); 在有序数组中搜索由key指向的值。其中，数组存储在base地址上，且此数组有nmemb 个元素，每个元素大小为size个字节。compar指向“比较函数”。换句话说当传递指向 关键字的指针和数组元素时，比较函数必须返回负整数、零或正整数，这主要依赖于关键 字是小于、等于还是大于数组元素。 返回 指向数组元素的指针，此数组元素是用来测试是否等于关键字的。如果没有找到关键字， 那么返回空指针。 相关函数 qsort函数 26.2节 calloc 分配并清除内存块 <stdlib.h> void *calloc(size_t nmemb, size_t size); 为带有nmemb个元素的数组分配内存块，其中每个数组元素占size个字节。通过设置所 有位为零来清除内存块。 返回 指向内存块开始处的指针。如果不能分配所要求大小的内存块，那么返回空指针。 相似函数 malloc函数、realloc函数 相关函数 free函数 17.3节 ceil 上整数 <math.h> double ceil(double x); 返回 大于或等于x的最小整数。 相似函数 floor函数 23.3节 clearerr 清除流错误 <stdio.h> void clearerr(FILE *stream); 为stream指向的流清除文件尾指示器和错误指示器。 相关函数 feof函数、ferror函数、rewind函数 22.3节 604 605 附录D 标准库函数 421 clock 处理器时钟 <time.h> clock_t clock(void); 返回 从程序开始执行起所经过的处理器时间（ 按照“ 时钟嘀嗒” 来衡量的）。（ 用 CLOCKS_PER_SEC除以此时间来转换成秒。）如果时间无效或者无法表示，那么返回 (clock_t)-1。 相似函数 time函数 也可参见 difftime函数 26.3节 cos 余弦 <math.h> double cos(double x); 返回 x的余弦值（按照弧度衡量的）。 也可参见 acos函数、asin函数、atan函数、atan2函数、sin函数、tan函数 23.3节 cosh 双曲余弦 <math.h> double cosh(double x); 返回 x的双曲余弦值。如果x的数过大，那么可能会发生取值范围错误。 相关函数 sinh函数、tanh函数 也可参见 acos函数、asin函数、atan函数、atan2函数、cos函数、sin函数、 tan函数 23.3节 ctime 把日期和时间转换成字符串 <time.h> char *ctime(const time_t *timer); 返回 指向字符串的指针，此字符串描述了本地时间，此时间等价于timer指向的日历时间。 等价于asctime(localtime(timer))。 相似函数 asctime函数、strftime函数 相关函数 difftime函数、gmtime函数、localtime函数、mktime函数、time函数 26.3节 difftime 时间差 <time.h> double difftime(time_t time1, time_t time0); 返回 time0（较早的时间）和time1之间的差值，此值按秒来衡量。 相关函数 asctime函数、ctime函数、gmtime函数、localtime函数、mktime函数、strftime 函数、time函数 也可参见 clock函数 26.3节 div 整数除法 <stdlib.h> div_t div(int numer, int denom); 返回 含有quot（numer除以denom时的商）和rem（余数）的结构。如果无法表示结果，那 么函数的行为是未定义的。 相似函数 ldiv函数 26.2节 exit 退出程序 <stdlib.h> void exit(int status); 调用所有用atexit函数注册的函数，清洗全部输出缓冲区，关闭所有打开的流，移除任 何由tmpfile产生的文件，并终止程序。status的值说明程序是否正常终止。status 唯一可移植的值是0和EXIT_SUCCESS（两者都说明成功终止）以及EXIT_FAILURE（不 成功的终止）。status的其他值都是由实现定义的。 相似函数 abort函数 相关函数 atexit函数 9.5节、26.2节 exp 指数 <math.h> double exp(double x); 返回 e的x次幂的值（即ex）。如果x的数过大，那么可能会发生取值范围错误。 相似函数 pow函数 相关函数 log函数 606 422 附录D 标准库函数 也可参见 log10函数 23.3节 fabs 浮点数的绝对值 <math.h> double fabs(double x); 返回 x的绝对值。 相似函数 abs函数、labs函数 23.3节 fclose 关闭文件 <stdio.h> int fclose(FILE *stream); 关闭由stream指向的流。清洗保留在流缓冲区内的任何未写的输出。如果是自动分配， 那么就释放缓冲区。 返回 如果成功，就返回零。如果检测到错误，就返回EOF。 相关函数 fopen函数、freopen函数 也可参见 fflush函数 22.2节 feof 检测文件末尾 <stdio.h> int feof(FILE *stream); 返回 如果为stream指向的流设置了文件尾指示器，那么返回非零值。否则返回零。 相似函数 ferror函数 相关函数 clearerr函数、fseek函数、rewind函数 22.3节 ferror 检测文件错误 <stdio.h> int ferror(FILE *stream); 返回 如果为stream指向的流设置了文件错误指示器，那么返回非零值。否则返回零。 相似函数 feof函数 相关函数 clearerr函数、rewind函数 22.3节 fflush 清洗文件缓冲区 <stdio.h> int fflush(FILE *stream); 把任何未写入的数据写到和stream相关的缓冲区中，其中stream指向用于输出或更新 的已打开的流。如果stream是空指针，那么fflush函数清洗存储在缓冲区中的所有未 写入的流。 返回 如果成功就返回零。如果检测到错误，就返回EOF。 也可参见 fclose函数、setbuf函数、setvbuf函数 22.2节 fgetc 从文件中读取字符 <stdio.h> int fgetc(FILE *stream); 从stream指向的流中读取字符。 返回 读到的字符。如果fgetc函数遇到流的末尾，则设置流的文件尾指示器并且返回EOF。如 果读取发生错误，fgetc函数设置流的错误指示器并且返回EOF。 相似函数 getc函数、getchar函数 相关函数 fputc函数、putc函数、ungetc函数 也可参见 putchar函数 22.4节 fgetpos 获得文件位置 <stdio.h> int fgetpos(FILE *stream, fpos_t *pos); 把stream指向的流的当前位置存储到pos指向的对象中。 返回 如果成功就返回零。如果调用失败，则返回非零值，并且把由实现定义的错误码存储到 errno中。 相似函数 ftell函数 相关函数 fsetpos函数 也可参见 fseek函数、rewind函数 22.7节 fgets 从文件中读取字符串 <stdio.h> char *fgets(char *s, int n, FILE *stream); 607 608 附录D 标准库函数 423 从stream指向的流中读取字符，并且把读入的字符存储到s指向的数组中。遇到第一个 换行符已经读取了n-1个字符，或到了文件末尾时，读取操作都会停止。fgets函数会在 字符串后添加一个空字符。 返回 s（指向数组的指针，此数组存储着输入）。如果读取操作错误或fgets函数在存储任何 字符之前遇到了流的末尾，都会返回空指针。 相似函数 gets函数 相关函数 fputs函数 也可参见 puts函数 22.5节 floor 向下取整 <math.h> double floor(double x); 返回 小于或等于x的最大整数。 相 似 函 数 c e i l 函 数 2 3 .3 节 fmod 浮点模数 <math.h> double fmod(double x, double y); 返回 x除以y的余数。如果y为零，是发生定义域错误还是fmod函数返回零是由实现定义的。 也 可 参 见 d i v 函 数 、 l d i v 函 数 2 3 .3 节 fopen 打开文件 <stdio.h> FILE *fopen(const char *filename, const char *mode); 打开文件以及和它相关的流，文件名是由filename指向的。mode说明文件打开的方式。 为流清除错误指示器和文件尾指示器。 返回 文件指针。在执行下一次关于文件的操作时会用到此指针。如果无法打开文件则返回空指针。 相似函数 freopen函数 相 关 函 数 f c l o s e 函 数 、 s e t b u f 函 数 、 s e t v b u f 函 数 2 2 .2 节 fprintf 格式化写文件 <stdio.h> int fprintf(FILE *stream, const char *format, ...); 向stream指向的流写输出。format指向的字符串说明了后续参数显示的格式。 返回 写入的字符数量。如果发生错误就返回负值。 相似函数 printf函数、sprintf函数、vfprintf函数、vprintf函数、vsprintf函数 相关函数 fscanf函数 也 可 参 见 s c a n f 函 数 、 s s c a n f 函 数 2 2 .3 节 fputc 向文件写字符 <stdio.h> int fputc(int c, FILE *stream); 把字符c写到stream指向的流中。 返回 c（写入的字符）。如果写发生错误，fputc函数会为stream设置错误指示器，并且返回EOF。 相似函数 putc函数、putchar函数 相关函数 fgetc函数、getc函数 也 可 参 见 g e t c h a r 函 数 2 2 .4 节 fputs 向文件写字符串 <stdio.h> int fputs(const char *s, FILE *stream); 把s指向的字符串写到stream指向的流中。 返回 如果成功，返回非负值。如果写发生错误，则返回EOF。 相似函数 puts函数 相关函数 fgets函数 也 可 参 见 g e t s 函 数 2 2 .5 节 fread 从文件读块 <stdio.h> size_t fread(void *ptr, size_t size, size_t nmemb, FILE *stream); 609 424 附录D 标准库函数 试着从stream指向的流中读取nmemb个元素，每个元素大小为size个字节，并且把读入 的元素存储到ptr指向的数组中。 返回 实际读入的元素（不是字符）数量。如果fread遇到文件末尾或检测到读取错误，那么此 数将会小于nmemb。如果nmemb或size为零，则返回值为零。 相 关 函 数 f w r i t e 函 数 2 2 .6 节 free 释放内存块 <stdlib.h> void free (void *ptr); 释放地址为ptr的内存块（除非ptr为空指针时调用无效）。块必须通过calloc函数、 malloc函数或realloc函数进行分配。 相 关 函 数 c a l l o c 函 数 、 m a l l o c 函 数 、 r e a l l o c 函 数 1 7 .4 节 freopen 重新打开文件 <stdio.h> FILE *freopen(const char *filrname, const char *mode, FILE *stream); 在freopen函数关闭和stream相关的文件后，打开名为filename且与stream相关的文 件。Mode参数具有和fopen函数调用中相同的含义。 返回 如果操作成功，返回stream的值。如果无法打开文件则返回空指针。 相似函数 fopen函数 相 关 函 数 f c l o s e 函 数 、 s e t b u f 函 数 、 s e t v b u f 函 数 2 2 .2 节 frexp 分解成小数和指数 <math.h> double frexp(double value, int *exp); 按照下列形式把value分解成小数部分f和指数部分n： value = f × 2n 其中f是规范化的，因此0.5≤f<1或者f=0。把n存储在exp指向的整数中。 返回 f，即value的小数部分。 相关函数 ldexp函数 也 可 参 见 m o d f 函 数 2 3 .3 节 fscanf 格式化读文件 <stdio.h> int fscanf(FILE *stream, const char *format, ...); 向stream指向的流读入任意数量的数据项。format指向的字符串说明了读入项的格式。 跟在format后边的参数指向数据项存储的位置。 返回 成功读入并且存储的数据项数量。如果发生错误或在可以读数据项前到达了文件末尾，那 么就返回EOF。 相似函数 scanf函数、sscanf函数 相关函数 fprintf函数、vfprintf函数 也 可 参 见 p r i n t f 函 数 、 s p r i n t f 函 数 、 v p r i n t f 函 数 、 v s p r i n t f 函 数 2 2 .3 节 fseek 文件查找 <stdio.h> int fseek(FILE *stream, long int offset, int whence); 为stream指向的流改变文件位置指示器。如果whence是SEEk_SET，那么新位置是在文 件开始处加上offset个字节。如果whence是SEEK_CUR，那么新位置是在当前位置加上 offset个字节。如果whence是SEEK_END，那么新位置是在文件末尾加上offset个字节。 对于文本流而言，offset必须是零，或者whence必须是SEEK_SET并且offset的值是 由前一次的ftell函数调用获得的。而对于二进制流来说，fseek函数不可以支持whence 是SEEK_END的调用。 返回 如果操作成功就返回零。否则返回非零值。 相似函数 fsetpos函数、rewind函数 相关函数 ftell函数 也 可 参 见 f g e t p o s 函 数 2 2 .7 节 610 611 附录D 标准库函数 425 fsetpos 设置文件位置 <stdio.h> int fsetpos(FILE *stream, const fpos_t *pos); 根据pos（前一次fgetpos函数调用获得的）指向的值来为stream指向的流设置文件位 置指示器。 返回 如果成功就返回零。如果调用失败，返回非零值，并且把由实现定义的错误码存储在errno中。 相似函数 fseek函数、rewind函数 相关函数 fgetpos函数 也 可 参 见 f t e l l 函 数 2 2 .7 节 ftell 确定文件位置 <stdio.h> long int ftell(FILE *stream); 返回 返回stream指向的流的当前文件位置指示器。如果调用失败，返回-1L，并且把由实现定 义的错误码存储在errno中。 相似函数 fgetpos函数 相关函数 fseek函数 也 可 参 见 f s e t p o s函 数 、 r e w i n d 函 数 2 2 .7 节 fwrite 向文件写块 <stdio.h> size_t fwrite(const void *ptr, size_t size, size_t nmemb, FILE *stream); 从ptr指向的数组中写nmemb个元素到stream指向的流中，且每个元素大小为size个字节。 返回 实际写入的元素（不是字符）的数量。如果fwrite函数检测到写错误，则这个数将会小 于nmemb。 相 关 函 数 f r e a d 函 数 2 2 .6 节 getc 从文件读入字符 <stdio.h> int getc(FILE *stream); 从stream指向的流中读入一个字符。注意：getc函数通常是作为宏来实现的。它可能计 算stream不只一次。 返回 读入的字符。如果getc函数遇到流的末尾，那么它会设置流的文件尾指示器并且返回EOF。 如果读取发生错误，那么getc函数设置流的错误指示器并且返回EOF。 相似函数 fgetc函数、getchar函数 相关函数 fputc函数、putc函数、ungetc函数 也 可 参 见 p u t c h a r 函 数 2 2 .4 节 getchar 读入字符 <stdio.h> int getchar(void); 从stdin流中读入一个字符。注意：getchar函数通常是作为宏来实现的。 返回 读入的字符。如果getc函数遇到输入流的末尾，那么它会设置stdin流的文件尾指示器并 且返回EOF。如果读取发生错误，那么getc函数设置stdin流的错误指示器并且返回EOF。 相似函数 fgetc函数、getc函数 相关函数 putchar函数、ungetc函数 也 可 参 见 f p u t c 函 数 、 p u t c 函 数 7 . 3 节 、 2 2 .4 节 getenv 获取外部环境字符串 <stdlib.h> char *getenv(const char *name); 为了检查是否有任意字符串匹配name指向的字符串，搜索操作系统的外部环境列表。 返回 与匹配名相关的字符串的指针。如果没有找到匹配则返回空指针。 也 可 参 见 s y s t e m 函 数 2 6 .2 节 gets 读入字符串 <stdio.h> char *gets(char *s); 从stdin流中读入多个字符，并且把这些读入的字符存储到s指向的数组中。 612 613 426 附录D 标准库函数 返回 s（即存储输入的数组的指针）。如果读取发生错误或gets函数在存储任何字符之前遇到流 的末尾，那么返回空指针。 相似函数 fgets函数 相关函数 puts函数 也 可 参 见 f p u t s 函 数 1 3 . 3 节 、 2 2 .5 节 gmtime 转换成格林威治标准时间 <time.h> struct tm *gmtime(const time_t *timer); 返回 指向结构的指针，此结构包含的分解的UTC（协调世界时间—从前的格林威治时间）值等 价于timer指向的日历时间。如果UTC无效，则返回空指针。 相似函数 localtime函数 相关函数 asctime函数、ctime函数、difftime函数、mktime函数、strftime函数、time函 数 2 6 .3 节 isalnum 测试是字母或数字 <ctype.h> int isalnum(int c); 返回 如果isalnum是字母或数字，返回非零值；否则返回零。（如果isalph(c)或isdigit(c) 为真，则c是字母或数字。） 相关函数 isalpha函数、isdigit函数 也 可 参 见 i s l o w e r 函 数 、 i s u p p e r 函 数 2 3 .4 节 isalpha 测试字母 <ctype.h> int isalpha(int c); 返回 如果isalnum是字母，返回非零值；否则返回零。（如果islower(c)或isupper(c) 为真，则c是字母。） 相似函数 islower函数、isupper函数 相关函数 isalnum函数 也 可 参 见 t o l o w e r 函 数 、 t o u p p e r 函 数 2 3 .4 节 iscntrl 测试控制字符 <ctype.h> int iscntrl(int c); 返回 如果c是控制字符，返回非零值；否则返回零。 相 关 函 数 i s g r a p h 函 数 、 i s p r i n t 函 数 、 i s s p a c e 函 数 2 3 .4 节 isdigit 测试数字 <ctype.h> int isdigit(int c); 返回 如果c是数字，返回非零值；否则返回零。 相似函数 isxdigit函数 相 关 函 数 i s a l n u m 函 数 2 3 .4 节 isgraph 测试图形字符 <ctype.h> int isgraph(int c); 返回 如果c是显示字符（除了空格），返回非零值；否则返回零。 相似函数 isprint函数 相 关 函 数 i s c n t r l 函 数 、 i s s p a c e 函 数 2 3 .4 节 islower 测试小写字母 <ctype.h> int islower(int c); 返回 如果c是小写字母，返回非零值；否则返回零。 相似函数 isalpha函数、isupper函数 相关函数 tolower函数、toupper函数 也 可 参 见 i s a l n u m 函 数 2 3 .4 节 isprint 测试显示字符 <ctype.h> 614 附录D 标准库函数 427 int isprint(int c); 返回 如果c是显示字符（包括空格），返回非零值；否则返回零。 相似函数 isgraph函数 相 关 函 数 i s c n t r l 函 数 、 i s s p a c e 函 数 2 3 .4 节 ispunct 测试标点字符 <ctype.h> int ispunct(int c); 返回 如果c是标点符号字符，返回非零值；否则返回零。除了空格、字母和数字字符以外， 所有显示字符都可以看成是标点符号。 也 可 参 见 i s a l n u m 函 数 、 i s g r a p h 函 数 、 i s p r i n t 函 数 2 3 .4 节 isspace 测试空白字符 <ctype.h> int isspace(int c); 返回 如果c是空白字符，返回非零值；否则返回零。空白字符有空格（' '）、换页符（'\f'）、 换行符（'\n'）、回车符（'\r'），横向制表符（'\t'）和纵向制表符（'\v'）。 也 可 参 见 i s c n t r l 函 数 、 i s g r a p h 函 数 、 i s p r i n t 函 数 2 3 .4 节 isupper 测试大写字母 <ctype.h> int isupper(int c); 返回 如果c是大写字母，返回非零值；否则返回零。 相似函数 isalpha函数、islower函数 也 可 参 见 t o l o w e r 函 数 、 t o u p p e r 函 数 2 3 .4 节 isxdigit 测试十六进制数字 <ctype.h> int isxdigit(int c); 返回 如果c是十六进制数字（0-9、a-f、A-F），返回非零值；否则返回零。 相 似 函 数 i s d i g i t 函 数 2 3 . 4 节 labs 长整数的绝对值 <stdlib.h> longint labs(long int j); 返回 j的绝对值。如果不能表示j的绝对值，那么函数的行为是未定义的。 相 似 函 数 a b s 函 数 、 f a b s 函 数 2 6 .2 节 ldexp 联合小数和指数 <math.h> double ldexp(double x, int exp); 返回 x × 2exp的值。可能会发生取值范围错误。 相 关 函 数 f r e x p 函 数 2 3 .3 节 ldiv 长整数除法 <stdlib.h> ldiv_t ldiv(long int numer, long int denom); 返回 含有quot（numer除以denom的商）和rem（余数）的结构。如果无法表示结果，那么 函数的行为是未定义的。 相 似 函 数 d i v 函 数 2 6 .2 节 localeconv 获取区域转换 <locale.h> struct lconv *localeconv(void); 返回 指向结构的指针，此结构含有当前区域信息。 相 关 函 数 s e t l o c a l e 函 数 2 5 .1 节 localtime 转换成区域时间 <time.h> struct tm *localtime(const time_t *timer); 返回 指向结构的指针，此结构含有的分解时间等价于timer指向的日历时间。 相似函数 gmtime函数 相关函数 astime函数、ctime函数、difftime函数、mktime函数、strftime函数、time函 数 26.3节 615 616 428 附录D 标准库函数 log 自然对数 <math.h> double log(double x); 返回 基数为e的x的对数（即1nx）。如果x是负数，会发生定义域错误；如果x是零，则会发生 取值范围错误。 相似函数 log10函数 相关函数 exp函数 也 可 参 见 p o w 函 数 2 3 .3 节 long10 常用对数 <math.h> double log10(double x); 返回 基数为10的x的对数。如果x是负数，会发生定义域错误；如果x是零，则会发生取值范 围错误。 相似函数 log函数 也可参见 exp函数、pow函数 23.3节 longjmp 非区域跳转 <setjmp.h> void longjmp(jmp_buf env, int val); 恢复存储在env中的外部环境，并且从初始保存env的setjmp调用中返回。如果val非 零，它将是setjmp的返回值；如果val为1，则setjmp返回1。 相关函数 setjmp函数 也可参见 signal函数 24.4节 malloc 分配内存块 <stdlib.h> void *malloc(size_t size); 分配size个字节的内存块。不清除内存块。 返回 指向内存块开始处的指针。如果无法分配要求尺寸的内存块，那么返回空指针。 相似函数 calloc函数、realloc函数 相 关 函 数 f r e e 函 数 1 7 .2 节 mblen 计算多字节字符的长度 <stdlib.h> int mblen(const char *s, size_t n); 如果s是空指针，则初始化移位状态。 返回 如果s是空指针，返回非零值还是零值依赖于多字节字符是否是依赖状态编码。如果s指 向空字符则返回零；如果接下来n个或几个字节形成了一个有效的字符，那么返回s指向 的多字节字符中的字节数量；否则返回-1。 相关函数 mbtowc函数、wctomb函数 也 可 参 见 m b s t o w c s 函 数 、 s e t l o c a l e 函 数 、 w c s t o m bs 函 数 2 5 .2 节 mbstowcs 把多字节字符串转换成宽字符串 <stdlib.h> size_t mbstowcs(wchar_t *pwcs, const char *s, size_t n); 把s指向的多字节字符序列转换为宽字符序列，并把不多于n个的编码存储到pwcs指向的 数组中。如果遇到空字符则转换结束。空字符会被转换成为零值码。 返回 修改的数组元素的个数，无论如何也不包括终止码。如果遇到无效的多字节字符，则返 回（size_t）-1。 相关函数 wctombs函数 也 可 参 见 m b l e n 函 数 、 m b t o w c 函 数 、 s e t l o c a l e 函 数 、 w c t o m b 函 数 2 5 .2 节 mbtowc 把多字节字符转换成宽字符 <stdlib.h> int mbtowc(wchar_t *pwcs, const char *s, size_t n); 如果s是空指针，则初始化移位状态。如果s不是空指针，把s指向的多字节字符转换成 宽字符码。最多将检查n个字节的多字节字符。如果多字节字符有效，并且pwc不是空指 617 618 附录D 标准库函数 429 针，则把码存储到pwc指向的对象中。 返回 如果s是空指针，则返回非零值还是零值依赖于多字节字符是否是依赖状态编码。如果s 指向空字符，则返回零。如果接下来n个或几个字节形成了一个有效的字符，那么返回s 指向的多字节字符中的字节数量。如果不是这样，则返回−1。 相关函数 mblen函数、wctomb函数 也 可 参 见 m b s t o w c s 函 数 、 s e t l o c a l e 函 数 、 w c s t o m b s 函 数 2 5 .2 节 memchr 搜索内存块字符 <string.h> void *memchr(const void *s, int c, size_t n); 返回 指向字符的指针，此字符是s所指向对象的前n个字符中第一个遇到的字符c。如果没有 找到c，则返回空指针。 相似函数 strchr函数 也 可 参 见 s t r p b r k 函 数 、 s t r r c h r 函 数 、 s t r s t r 函 数 2 3 .5 节 memcmp 比较内存块 <string.h> int memcmp(const void *s1, const void *s2, size_t n); 返回 负整数、零还是正整数依赖于s1所指向对象的前n个字符是小于、等于还是大于s2所指 向对象的前n个字符。 相 似 函 数 s t r c m p 函 数 、 s t r c o l l 函 数 、 s t r n c m p 函 数 2 3 .5 节 memcpy 复制内存块 <string.h> void *memcpy(void *s1, const void *s2, size_t n); 把s2所指向对象的n个字符复制到s1所指向的对象中。如果对象重叠，则不可能正确地 工作。 返回 s1（指向目的的指针）。 相 似 函 数 m e m m o v e 函 数 、 s t r c p y 函 数 、 s t r n c p y 函 数 2 3 .5 节 memmove 复制内存块 <string.h> void *memmove(void *s1, const void *s2, size_t n); 把s2所指向对象的n个字符复制到s1所指向的对象中。如果对象重叠，即使memmove函 数比memcpy函数速度慢，但是memmove函数还将正确地工作。 返回 s1（指向目的的指针）。 相 似 函 数 m e m c p y 函 数 、 s t r c p y 函 数 、 s t r n c p y 函 数 2 3 .5 节 memset 初始化内存块 <string.h> void *memset(void *s, int c, size_t n); 把c存储到s指向的内存块的前n个字符中。 返回 s（指向内存块的指针）。 相 似 函 数 m e m c p y 函 数 、 m e m m o v e 函 数 2 3 .5 节 mktime 转换成日历时间 <time.h> time_t mktime(struct tm *timeptr); 把分解的区域时间（存储在由timeptr指向的结构中）转换成为日历时间。结构的成员 不要求一定在合法的取值范围内。而且，会忽略tm_wday（星期的天号）的值和tm_yday （年份的天号）的值。调整其他成员到正确的取值范围内之后，mktime函数把值存储在 tm_wday和tm_yday中。 返回 日历时间对应timeptr指向的结构。如果无法表示日历时间，则返回(time_t)-1。 相关函数 astime函数、ctime函数、difftime函数、gmtime函数、localtime函数、strftime 函数、time函数 26.3节 modf 分解成整数和小数部分 <math.h> double modf(double value, double *iptr); 把value分解成整数部分和小数部分。把整数部分存储到iptr指向的double型对象中。 返回 value的小数部分。 619 430 附录D 标准库函数 也 可 参 见 f r e x p 函 数 2 3 .3 节 perror 显示错误信息 <stdio.h> void perror(const char *s); 向Stderr流中写下列信息： 字符串：出错信息 这里的字符串是s所指向的字符串。出错信息是由实现定义的，它与strerror (errno) 函数调用返回的信息相匹配。 相 关 函 数 s t r e r r o r 函 数 2 4 .2 节 pow 幂 <math.h> double pow(double x, double y); 返回 x的y次幂。发生定义域错误的情况有（1）当x是负数并且y的值不是整数时；或者（2） 当x为零且y是小于或等于零，无法表示结果时。取值范围错误也是可能发生的。 相似函数 exp函数、sqrt函数 也 可 参 见 l o g 函 数 、 l o g 1 0 函 数 2 3 .3 节 printf 格式化写 <stdio.h> int printf(const char *format, ...); 向stdout流写输出。format指向的字符串说明了后续参数显示的格式。 返回 写入的字符数量。如果发生错误就返回负值。 相似函数 fprintf函数、sprintf函数、vfprintf函数、vprintf函数、vsprintf函数 相关函数 scanf函数 也 可 参 见 f s c a n f 函 数 、 s s c a n f 函 数 3 .1 节 、 2 2 .3 节 putc 向文件写字符 <stdio.h> int putc(int c, FILE *stream); 把字符c写到stream指向的流中。注意：putc函数通常作为宏来实现的。它可能不只 计算stream一次。 返回 c（写入的字符）。如果写发生错误，putc函数会设置流的错误指示器，并且返回EOF。 相似函数 fputc函数、putchar函数 相关函数 fgetc函数、getc函数 也 可 参 见 g e t c h a r 函 数 2 2 .4 节 putchar 写字符 <stdio.h> int putchar(int c); 把字符c写到stdout流中。注意：putchar函数通常作为宏来实现的。 返回 c（写入的字符）。如果写发生错误，putchar函数设置流的错误指示器，并且返回EOF。 相似函数 fputc函数、putc函数 相关函数 getchar函数 也 可 参 见 f g e t c 函 数 、 g e t c 函 数 7 .3 节 、 2 2 .4 节 puts 写字符串 <stdio.h> int puts(const char *s); 把s指向的字符串写到strout流中，然后写一个换行符。 返回 如果成功返回非负值。如果写发生错误则返回EOF。 相似函数 fputs函数 相关函数 gets函数 也可参见 fgets函数 13.3节、22.5节 qsort 排序数组 <stdlib.h> void qsort(void *base, size_t memb, size_t size, int (*compar)(const void *, const void *)); 对base指向的数组排序。数组有nmemb个元素，每个元素大小为size个字节。compar 620 621 附录D 标准库函数 431 是指向“比较函数”的指针。当把指向两个数组元素的指针传递过来时，函数依赖于第 一个数组元素是否小于、等于或者大于第二个数组元素，应该返回负数、零或正整数。 相 关 函 数 b s e a r c h 函 数 1 7 .7 节 、 2 6 .2 节 raise 产生信号 <signal.h> int raise(int sig); 产生数为sig的信号。 返回 如果成功，返回零；否则返回非零值。 相似函数 abort函数 相 关 函 数 s i g n a l 函 数 2 4 .3 节 rand 产生伪随机数 <stdlib.h> int rand(void); 返回 0到RAND_MAX（包括RAND_MAX在内）之间的伪随机整数。 相 关 函 数 s r a n d 函 数 2 6 .2 节 realloc 调整内存块 <stdlib.h> void *realloc(void *ptr, size_t size); 假设ptr指向先前由calloc函数、malloc函数或realloc函数获得内存块。realloc 函数分配size个字节的内存块，并且如果需要还会复制旧内存块的内容。 返回 指向新内存块开始处的指针。如果无法分配要求尺寸的内存块，那么返回空指针。 相似函数 calloc函数、malloc函数 相关函数 free函数 17.3节 remove 移除文件 <stdio.h> int remove(const char *filename); 删除文件，此文件名由filename指向。 返回 如果成功就返回零；否则返回非零值。 也可参见 rename函数 22.2节 rename 重命名文件 <stdio.h> int rename(const char *old, const char *new); 改变文件的名字。old和new指向的字符串分别包含旧的文件名和新的文件名。 返回 如果改名成功就返回零。如果操作失败，就返回非零值（可能因为旧文件目前是打开的）。 也可参见 remove函数 22.2节 rewind 返回到文件头 <stdio.h> void rewind(FILE *stream); 为stream指向的流设置文件位置指示器到文件的开始处。为流清除错误指示器和文件 尾指示器。 相似函数 fseek函数、fsetpos函数 相关函数 clearerr函数 也可参见 feof函数、ferror函数、fgetpos函数、ftell函数 22.7节 scanf 格式化读 <stdio.h> int scanf(const char *format, ...); 从stdin流读取任意数量数据项。format指向的字符串说明了读入项的格式。跟随在 format后边的参数指向数据项要存储的地方。 返回 成功读入并且存储的数据项数量。如果发生错误或在可以读入任意数据项之前到达了文 件末尾，就返回EOF。 相似函数 fscanf函数、sscanf函数 相关函数 printf函数、vprintf函数 也可参见 fprintf函数、sprintf函数、vfprintf函数、vsprintf函数 3.2节、22.3节 622 623 432 附录D 标准库函数 setbuf 设置缓冲区 <stdio.h> void setbuf(FILE *stream, char *buf); 如果buf不是空指针，那么setbuf的调用就等价于： (void) setvbuf(stream, buf, _IOFBF, BUFSIZ); （BUFSIZ是在<stdio.h>中定义的宏。）否则，它等价于： (void) setvbuf(stream, NULL, _IONBF, 0); 相似函数 setvbuf函数 相关函数 fopen函数、freopen函数 也 可 参 见 f f l u s h 函 数 2 2 .2 节 setjmp 准备非局部跳转 <setjmp.h> int setjmp(jmp_buf env); 为了稍候用于longjmp函数调用，所以把当前外部环境存储到env中。 返回 当直接调用时，返回为零。当从longjmp函数调用中返回时，返回非零值。 相关函数 longjmp函数 也可参见 signal函数 24.4节 setlocale 设置地区 <locale.h> char *setlocale(int category, const char *locale); 设置程序的地区部分。category说明哪部分有效。locale指向表示新地区的字符串。 返回 如果locale是空指针，就返回一个指向与当前地区的category相关的字符串的指针。 否则，返回一个指向与新地区的category相关的字符串的指针。如果操作失败，则返 回空指针。 相 关 函 数 l o c a l e e c o n v 函 数 2 5 .1 节 setvbuf 设置缓冲区 <stdio.h> int setvbuf(FILE *stream, char *buf, int mode,size_t size); 改变由stream指向的流的缓冲。mode的值可以是_IOFBF（满缓冲）、_IOLBF（行缓 冲）或者_IONBF（不缓冲）。如果buf是空指针，那么若需要则自动分配缓冲区。否则， buf指向用作缓冲区的内存块。size是内存块中字节的数量。注意：必须在打开流之后 但对流的任何操作执行之前，调用setvbuf函数。 返回 如果操作成功，就返回零。如果mode无效或者无法满足要求，则返回非零值。 相似函数 setbuf函数 相关函数 fopen函数、freopen函数 也 可 参 见 f f l u s h 函 数 2 2 .2 节 signal 安装信号处理函数 <signal.h> void (*signal(int sig, void (*func)(int)))(int); 安装func指向的函数作为数sig的信号处理函数。 返回 指向此信号前一个处理函数的指针。如果无法安装处理函数，则返回SIG_ERR。 相 关 函 数 a b o r t 函 数 、 r a i s e 函 数 2 4 .3 节 sin 正弦 <math.h> double sin(double x); 返回 x的正弦值（按照弧度衡量的）。 相 关 函 数 a c o s 函 数 、 a s i n 函 数 、 a t a n 函 数 、 a t a n 2 函 数 、 c o s 函 数 、 t a n 函 数 2 3 .3 节 sinh 双曲正弦 <math.h> double sinh(double x); 返回 x的双曲正弦值（按照弧度衡量的）。如果x的数过大，那么可能会发生取值范围错误。 相关函数 cosh函数、tanh函数 也可参见 acos函数、asin函数、atan函数、atan2函数、cos函数、sin函数、tan函数 23.3节 624 625 附录D 标准库函数 433 sprintf 格式串写 <stdio.h> int sprintf(char *s, const char *format, ...); 与fprintf函数和printf函数很类似，但是sprintf函数不是把字符写入流，而是把 字符存储到s指向的数组中。format指向的字符串说明了后续参数显示的格式。在输出 的末尾存储一个空字符到数组中。 返回 存储到数组中的字符数量，不计空字符。 相似函数 fprintf函数、printf函数、vfprintf函数、vprintf函数、vsprintf函数 相关函数 sscanf函数 也 可 参 见 f s c a n f 函 数 、 s c a n f 函 数 2 2 .8 节 sqrt 平方根 <math.h> double sqrt(double x); 返回 x的平方根。如果x是负数，则会发生定义域错误。 相 似 函 数 p o w 函 数 2 3 .3 节 srand 启动伪随机数产生器 <stdlib.h> void srand(unsigned int seed); 使用seed来初始化由rand函数调用而产生的伪随机序列。 相 关 函 数 r a n d 函 数 2 6 .2 节 sscanf 格式串读 <stdio.h> int sscanf(const char *s, const char *format, ...); 与fscanf函数和scanf函数很类似，但是sprintf函数不是从流读取字符，而是从s 指向的字符串中读取字符。format指向的字符串说明了读入项的格式。跟随在format 后的参数指向数据项要存储的地方。 返回 成功读入并且存储的数据项数量。如果在可以读入任意数据项之前到达了字符串末尾， 就返回EOF。 相似函数 fscanf函数、scanf函数 相关函数 sprintf函数、vsprintf函数 也 可 参 见 f p r i n t f 函 数 、 p r i n t f 函 数 、 v f p r i n t f 函 数 、 v p r i n t f 函 数 2 2 .8 节 strcat 字符串的连接 <string.h> char *strcat(char *s1, const char *s2); 把s2指向的字符串连接到s1指向的字符串后边。 返回 s1（指向连接后字符串的指针）。 相 似 函 数 s t r n c a t 函 数 1 3 .5 节 、 2 3 .5 节 strchr 搜索字符串中字符 <string.h> char *strchr(const char *s, int c); 返回 指向字符的指针，此字符是s所指向的字符串的前n个字符中第一个遇到的字符c。如果 没有找到c，则返回空指针。 相似函数 memchr函数 也可参见 strpbrk函数、strrchr函数、strstr函数 23.5节 strcmp 比较字符串 <string.h> int strcmp(const char *s1, const char *s2); 返回 负数、零还是正整数，依赖于s1所指向的字符串是小于、等于还是大于s2所指的字符串。 相 似 函 数 m e m c m p 函 数 、 s t r c o l l 函 数 、 s t r n c m p 函 数 1 3 .5 节 、 2 3 .5 节 strcoll 采用指定地区的比较序列进行字符串比较 <string.h> int strcoll(const char *s1, const char *s2); 返回 负数、零还是正整数，依赖于s1所指向的字符串是小于、等于还是大于s2所指的字符串。 根据当前地区的LC_COLLATE类型规则来执行比较操作。 626 434 附录D 标准库函数 相似函数 memcmp函数、strcmp函数、strncmp函数 相 关 函 数 s t r x f r m 函 数 2 3 .5 节 strcpy 字符串复制 <string.h> char *strcpy(char *s1, const char *s2); 把s2指向的字符串复制到s1所指向的数组中。 返回 s1（指向目的的指针）。 相 似 函 数 m e m c p y 函 数 、 m e m m o v e 函 数 、 s t r n c p y 函 数 1 3 .5 节 、 2 3 .5 节 strcspn 搜索集合中不在初始范围内的字符串 <string.h> size_t strcspn(const char *s1, const char *s2); 返回 最长的初始字符段的长度，此初始字符段由s1指向的，但是不包含s2指向的字符串中的 任何字符。 相 关 函 数 s t r s p n 函 数 2 3 .5 节 strerror 把错误数转换成为字符串 <string.h> char *strerror(int errnum); 返回 指向字符串的指针，此字符串含有的出错消息对应errnum的值。 相 关 函 数 p e r r o r 函 数 2 4 .2 节 strftime 把格式化的日期和时间写到字符串中 <time.h> size_t strftime(char *s, size_t maxsize, const char *format, const struct tm *timeptr); 在format指向的字符串的控制下把字符存储到s指向的数组中。格式串可能含有不用改 变就进行复制的普通字符和转换说明符，其中转换说明符要用timeptr指向的结构中的 值进行替换。maxsize参数限制了可以存储的字符的数量（包括空字符）。 返回 如果要存储的字符数量（包括空字符）超过了maxsize，那么返回零；否则，返回存储 的字符数量（不包括空字符）。 相似函数 asctime函数、ctime函数 相 关 函 数 d i f f t i m e 函 数 、 g m t i m e 函 数 、 l o c a l t i m e 函 数 、 m k t i m e 函 数 、 t i m e 函 数 2 6 .3 节 strlen 字符串长度 <string.h> size_t strlen(const char *s); 返 回 s 指 向 的 字 符 串 长 度 ， 不 包 括 空 字 符 。 1 3 .5 节 、 2 3 .5 节 strncat 有限制的字符串的连接 <string.h> char *strncat(char *s1, const char *s2, size_t n); 把来自s2所指向的数组的字符连接到s1指向的字符串后边。当遇到空字符或已经复制了 n个字符时，复制操作停止。 返回 s1（指向连接后字符串的指针）。 相 似 函 数 s t r c a t 函 数 2 3 .5 节 strncmp 有限制的字符串比较 <string.h> int strncmp(const char *s1, const char *s2, size_t n); 返回 负整数、零还是正整数，依赖于s1所指向的数组的前n个字符是小于、等于还是大于s2 所指向的数组的前n个字符。如果在其中某个数组中遇到空字符，比较都会停止。 相 似 函 数 m e m c m p 函 数 、 s t r c m p 函 数 、 s t r c o l l 函 数 2 3 .5 节 strncpy 有限制的字符串复制 <string.h> char *strncpy(char *s1, const char *s2, size_t n); 把s2指向的数组的前n个字符复制到s1所指向的数组中。如果在s2指向的数组中遇 到一个空字符，那么strncpy函数为s1指向的数组添加空字符直到写完n个字符的总 数量。 返回 s1（指向目的的指针）。 627 628 附录D 标准库函数 435 相 似 函 数 m e m c p y 函 数 、 m e m m o v e 函 数 、 s t r c p y 函 数 2 3 .5 节 strpbrk 为一组字符之一搜索字符串 <string.h> char *strpbrk(const char *s1, const char *s2); 返回 指向字符的指针，此字符是s1所指向字符串中与s2所指向字符串中的字符相匹配的最左 侧的字符。如果没有找到匹配字符，则返回空指针。 也可参见 memchr函数、strchr函数、strrchr函数、strstr函数 23.5节 strrchr 反向搜索字符串中字符 <string.h> char *strrchr(const char *s, int c); 返回 指向字符的指针，此字符是s所指向字符串中最后一个遇到的字符c。如果没有找到c， 则返回空指针。 也可参见 memchr函数、strchr函数、strpbrk函数、strstr函数 23.5节 strspn 搜索集合中在初始范围内的字符串 <string.h> size_t strspn(const char *s1, const char *s2); 返回 最长的初始字符段的长度，此初始字符段是由s1指向的且与s2指向的字符串中的全部字 符一致的字符段。 相 关 函 数 s t r c s p n 函 数 2 3 .5 节 strstr 搜索子字符串 <string.h> char *strstr(const char *s1, const char *s2); 返回 指针，此指针指向s1字符串中的字符第一次出现在s2字符串中的位置。如果没有发现匹 配，就返回空指针。 也可参见 memchr函数、strchr函数、strpbrk函数、strrchr函数 23.5节 strtod 把字符串转换成双精度数 <stdlib.h> double strtod(const char *nptr, char **endptr); 函数会跳过nptr所指向的字符串中的空白字符，然后把后续字符都转换成为double型 的值。如果endptr不是空指针，那么strtod就修改endptr指向的对象，从而使endptr 指向第一个剩余字符。如果没有发现double型的值，或者有错误的格式，那么strtod 函数把nptr存储到endptr指向的对象中。如果要表示的数过大或者过小，函数就把 ERANGE存储到errno中。 返回 转换的数。如果没有转换可以执行，就返回零。如果要表示的数过大，则返回正的或负 的HUGE_VAL，这要依赖于数的符号而定。如果要表示的数过小，则返回零。 相似函数 atof函数 相关函数 strtol函数、strtoul函数 也 可 参 见 a t o i 函 数 、 a t o l 函 数 2 6 .2 节 strtok 搜索字符串记号 <string.h> char *strtok(char *s1, const char *s2); 在s1指向的字符串中搜索“记号”。组成此记号的字符不在s2指向的字符串中。如果存 在记号，则把跟在记号后边的字符变为空字符。如果s1是空指针，则将继续由strtok 函数最近一次调用开始的搜索。在上一个记号尾部的空字符之后立即开始搜索。 返回 指向记号的第一个字符的指针。如果没有发现记号，就返回空指针。 也可参见 memchr函数、strchr函数、strpbrk函数、strrchr函数、strstr函数 23.5节 strtol 把字符串转换成长整数 <stdlib.h> long int strtol(const char *nptr, char **endptr, int base); 函数跳过nptr指向字符串中的空白字符，然后把后续字符转换成long int型的值。如 果base是2~36之间的数，则把它用作数的基数。如果base为零，除非数是以0（八进制） 或者0x/0X（十六进制）开头的，否则就把数设定为十进制的。如果endptr不是空指 针，那么strtol函数会修改endptr指向的对象以便endptr可以指向第一个剩余字符。 如果没有发现long int型的值，或者它有错误的格式，那么strtol函数会把nptr存储 629 630 436 附录D 标准库函数 到endptr指向的对象中。如果没有能表示的数，函数会把ERANGE存储到errno中。 返回 转换的数。如果没有转换可以执行，则返回零。如果无法表示数，则依赖于数的符号返 回LONG_MAX或者LONG_MIN。 相似函数 atoi函数、atol函数、strtoul函数 相关函数 strtod函数 也 可 参 见 a t o f 函 数 2 6 .2 节 strtoul 把字符串转换成无符号长整数 <stdlib.h> unsigned long int strtoul(const char *nptr, char **endptr, int base); strtuol函数和strtol函数一样，只不过前者会把字符串转换成为无符号长整数。 返回 转换的数。如果没有转换可以执行，则返回零。如果无法表示数，则返回ULONG_MAX。 相似函数 atoi函数、atol函数、strtol函数 相关函数 strtod函数 也 可 参 见 a t o f 函 数 2 6 .2 节 strxfrm 转换指定地区的字符串 <string.h> size_t strxfrm(char *s1, const char *s2, size_t n); 函数转换由s2指向的字符串，把结果的前n个字符（包括空字符）放到s1指向的数组中。 调用带有两个转换的字符串的strcmp函数应该会产生相同的结果（负数、零或正数）， 就像调用带有原始字符串的strcol函数。 返回 转换的字符串的长度（可能超过n）。 相 似 函 数 s t r c m p 函 数 、 s t r c o l l 函 数 2 3 .5 节 System 执行操作系统命令 <stdlib.h> int system(const char *string); 把string指向的字符串传递给操作系统的命令处理器（命令解释程序）来执行。 返回 当string是空指针时，如果命令处理器有效，则返回非零值。如果string不是空指针， 则返回由实现定义的值。 也 可 参 见 g e t e n v 函 数 2 6 .2 节 tan 正切 <math.h> double tan(double x); 返回 x的正切值（按照弧度衡量的）。 相 关 函 数 a c o s 函 数 、 a s i n 函 数 、 a t a n 函 数 、 a t a n 2 函 数 、 c o s 函 数 、 s i n 函 数 2 3 .3 节 tanh 双曲正切 <math.h> double tanh(double x); 返回 x的双曲正切值。 相关函数 cosh函数、sinh函数 也 可 参 见 a c o s 函 数 、 a s i n 函 数 、 a t a n 函 数 、 a t a n 2 函 数 、 c o s 函 数 、 s i n 函 数 、 t a n 函 数 2 3 .3 节 time 当前时间 <time.h> time_t time(time_t *timer); 返回 当前的日历时间。如果日历时间无效，则返回(time_t)-1。如果timer不是空指针， 也把返回值存储到timer指向的对象中。 相似函数 clock函数 相关函数 asctime函数、ctime函数、difftime函数、gmtime函数、localtime函数、mktime 函 数 、 s t r f t i m e 函 数 2 6 .3 节 tmpfile 创建临时文件 <stdio.h> FILE *tmpfile(void); 创建临时文件，此文件在被关闭或者程序结束时会被自动删除。按照"wb+"模式打开文件。 返回 文件指针。当执行对此文件的后续操作时候用到此指针。如果无法创建文件，则返回空 631 附录D 标准库函数 437 指针。 相 关 函 数 t m p n a m 函 数 、 f o p e n 函 数 2 2 .2 节 tmpnam 产生临时文件名 <stdio.h> char *tmpnam(char *s); 产生临时文件名。如果s是空指针，那么tmpnam把文件名存储在静态变量中。否则，它 会把文件名复制到s指向的字符数组中。（数组必须足够长可以存储L_tmpnam个字符， 这里的L_tmpnam是在<stdio.h>头文件中定义的宏。） 返回 指向文件名的指针。 相 关 函 数 t m p f i l e 函 数 2 2 .2 节 tolower 转换成小写字母 <ctype.h> int tolower(int c); 返回 如果c是大写字母，则返回相应的小写字母。如果c不是大写字母，则返回无变化的c。 相似函数 toupper函数 相关函数 islower函数、isupper函数 也 可 参 见 i s a l p h a 函 数 2 3 .4 节 toupper 转换成大写字母 <ctype.h> int toupper(int c); 返回 如果c是小写字母，则返回相应的大写字母。如果c不是小写字母，则返回无变化的c。 相似函数 tolower函数 相关函数 islower函数、isupper函数 也 可 参 见 i s a l p h a 函 数 2 3 . 4 节 ungetc 未读取的字符 <stdio.h> int ungetc(int c, FILE *stream); 把字符c回退到stream指向的流中，并且清除流的文件尾指示器。由连续的ungetc函 数调用回退的字符数量有变化。只能保证第一次调用成功。调用文件定位函数（fseek 函数、fsetpos函数或者rewind函数）会导致回退的字符丢失。 返回 c（回退的字符）。如果没有读取操作或者文件定位操作就试图回退过多的字符，那么函 数将会返回EOF。 相 关 函 数 f g e t c 函 数 、 g e t c 函 数 、 g e t c h a r 函 数 2 2 .4 节 va_arg 从可变实际参数列表中获取参数 <stdarg.h> 类型 va_arg(va_list ap, 类型); 从变量参数列表中获取一个参数，然后修改ap使va_arg下一次的使用可以获取后面的 参数。在va_arg第一次使用之前必须由va_start对ap进行初始化。 返回 假设参数的类型（在采用了默认的实际参数提升之后）与类型一致，返回参数的值。 相关函数 va_end函数、va_start函数 也 可 参 见 v f p r i n t f 函 数 、 v p r i n t f 函 数 、 v s p r i n t f 函 数 2 6 .1 节 va_end 结束可变实际参数列表的处理 <stdarg.h> void va_end(va_list ap); 结束与ap相关的可变实际参数列表的处理。 相关函数 va_arg函数、va_start函数 也 可 参 见 v f p r i n t f 函 数 、 v p r i n t f 函 数 、 v s p r i n t f 函 数 2 6 .1 节 va_start 开始可变实际参数列表的处理 <stdarg.h> void va_start(va_list ap, parmN); 必须在访问参数列表之前调用它。初始化ap以便稍后va_arg和va_end的使用。parmN 是最后一个普通参数的名字（此参数后边跟着，...）。 相关函数 va_arg函数、va_end函数 633 632 438 附录D 标准库函数 也 可 参 见 v f p r i n t f 函 数 、 v p r i n t f 函 数 、 v s p r i n t f 函 数 2 6 . 1 节 vfprintf 用可变实际参数列表格式化写文件 <stdio.h> int vfprintf(FILE *stream, const char *format, va_list arg); 函数等价于用arg替换带有可变实际参数列表的fprintf函数。 返回 写入的字符数量。如果发生错误就返回负值。 相似函数 fprintf函数、printf函数、sprintf函数、vprintf函数、vsprintf函数 也 可 参 见 v a _ a r g 函 数 、 v a _ e n d 函 数 、 v a _ s t a r t 函 数 2 6 .1 节 vprintf 用可变实际参数列表格式化写 <stdio.h> int vprintf(const char *format, va_list arg); 函数等价于用arg替换带有可变实际参数列表的printf函数。 返回 写入的字符数量。如果发生错误就返回负值。 相似函数 fprintf函数、printf函数、sprintf函数、vfprintf函数、vsprintf函数 也可参见 va_arg函数、va_end函数、va_start函数 26.1节 vsprintf 用可变实际参数列表格式化写字符串 <stdio.h> int vsprintf(char *s, const char *format, va_list arg); 函数等价于用arg替换带有可变实际参数列表的sprintf函数。 返回 存储的字符数量，但不计空字符。 相似函数 fprintf函数、printf函数、sprintf函数、vfprintf函数、vprintf函数 也 可 参 见 v a _ a r g 函 数 、 v a _ e n d 函 数 、 v a _ s t a r t 函 数 2 6 .1 节 wcstombs 把宽字符串转换成多字节字符串 <stdlib.h> size_t wcstombs(char *s, const wchar_t *pwcs, size_t n); 把宽字符码序列转换成为对应的多字节字符。pwcs指向含有宽字符的数组。多字节字符 存储在s指向的数组中。如果遇到存储的空字符或者要存储的多字节字符将超过n个字节 的限制，则转换结束。 返回 存储的字节数，不包括空字符。如果遇到一个代码不对应有效多字节字符时，则返回 （size_t）-1。 相关函数 mbstowcs函数 也 可 参 见 m b l e n 函 数 、 m b t o w c 函 数 、 s e t l o c a l e 函 数 、 w c t o m b 函 数 2 5 .2 节 wctomb 把宽字符转换成多字节字符 <stdlib.h> int wctomb(char *s, wchar_t wchar); 把代码为wchar的宽字符转换成为一个多字节字符。如果s不是空指针，则把结果存储 到s指向的数组中。如果s是空指针，则初始化移位状态。 返回 如果s是空指针，则返回非零值或零值，这依赖于多字节字符是否是依赖状态编码的。 如果wchar对应一个有效的多字节字符，则返回字符中字节的数量，如果不是这样，则 返回-1。 相关函数 mblen函数、mbtowc函数 也 可 参 见 m b s t o w c s 函 数 、 s e t l o c a l e 函 数 、 w c s t o m b 函 数 2 5 .2 节 <match.h>函数的错误 定义域错误 参数超出了函数的定义域。如果出现定义域错误，函数的返回值是由实现定义的，并且 函数会把EDOM存储到errno中。 取值范围错误 函数的返回值超出了double型值的取值范围。如果返回值的数太大以致于无法表示（上 溢），则函数返回正的或负的HUGE_VAL，这要依赖于正确结果的符号。此外，函数会把 ERANGE存储到errno中。如果返回值的数太小以致于无法表示（下溢），则函数返回零。 一 些 实 现 也 可 能 会 把 E R A N G E 存 储 到 e r r n o 中 。 634 635 636 |
2023-10-27
2022-08-15
2022-08-17
2022-09-23
2022-08-13
六六分期app的软件客服如何联系？不知道吗？加qq群【895510560】即可！标题：六六分期
今天小编告诉大家如何处理win10系统火狐flash插件总是崩溃的问题，可能很多用户都不知
今天小编告诉大家如何对win10系统删除桌面回收站图标进行设置，可能很多用户都不知道
今天小编告诉大家如何对win10系统电脑设置节能降温的设置方法，想必大家都遇到过需要
我们在使用xp系统的过程中,经常需要对xp系统无线网络安装向导设置进行设置，可能很多
今天小编告诉大家如何处理win7系统玩cf老是与主机连接不稳定的问题，可能很多用户都不
电脑对日常生活的重要性小编就不多说了，可是一旦碰到win7系统设置cf烟雾头的问题，很
我们在日常使用电脑的时候，有的小伙伴们可能在打开应用的时候会遇见提示应用程序无法
今天小编告诉大家如何对win7系统打开vcf文件进行设置，可能很多用户都不知道怎么对win
今天小编告诉大家如何对win10系统s4开启USB调试模式进行设置，可能很多用户都不知道怎
请发表评论