(完整版)Keilc51常用库函数汇总参考

Keil c51函数参考

一、数学函数

(1)cabs

原型：char cabs(char val);

功能：cabs函数取val的绝对值。

参数：一字节数val。

返回：cabs返回val的绝对值。

(2)abs

原型：Int abs(int val);

功能：求绝对值

参数：val整型数

返回：val的绝对值

(3)labs

原型：long labs(long val);

功能：labs函数确定长整数val的绝对值。

返回：val的绝对值。

(4)fabs

原型：float fabs(float val);

功能：fabs函数确定浮点数val的绝对值。

参数：

返回：fabs返回val的绝对值。

(5)sqrt

原型：float sprt(float x);

功能：sqrt函数计算x的平方根。

返回：sqrt函数返回x的正平方根。

(6)exp

原型：float exp(float x);

功能：exp函数计算自然对数中e的x次幂。e≈2.753581496，是无限循环小数。

返回：ex 的值。

(7)log

原型：float log(float val);

功能：log函数计算浮点数val的自然对数。自然对数基数为e。

返回：val的浮点自然对数。

(8)log10

原型：float log10(float val);

功能：logl0函数计算浮点数val的常用对数。常用对数为基数10。

返回：val的浮点常用对数。

(9)sin

原型：float sin(float x);

功能：sin函数计算浮点数x的正弦值。

参数：x必须在-65535～65535之间，或产生一个NaN错误。

返回：sin函数返回x的正弦。

(10)cos

原型：float cos(float x);

功能：COS函数计算浮点数X的余弦。

参数：X的值必须在-65535～65535之间，或产生一个NaN错误。

返回：COS函数返回X的余弦。

(11)tan

原型：float tan(float x);

功能：tan函数计算浮点数x的正切值。

参数：x必须在-65535～65535之间，或错误值NaN。

返回：tan函数返回x的正切。

(12)asin

原型：float asin(float x);

功能：求反正弦

参数：浮点数x，取值必须在-1～1之间。

返回：X的反正弦，值在-π/2～π/2之间。

(13)acos

原型：float acos(float x);

功能：求反余弦

参数：浮点数x，取值必须在-1～1之间。

返回：x的反余弦，值在0～π之间。

(14)atan

原型：float atan(float x);

功能：求反正切

参数：浮点数x，取值必须在-1～1之间。

返回：X的反正切，值在-π/2～π/2之间。

(15)sinh

原型：float sinh(float x);

功能：sinh函数计算浮点数X的双曲正弦。

参数：x必须在-65535～65535之间，或产生一个NaN错误。

返回：sinh函数返回x的双曲正弦。

(16)cosh

原型：float cosh(float x);

功能：cosh函数计算浮点数X的双曲余弦。

参数：

返回：cosh函数返回X的双曲余弦。

(17)tanh

原型：float tanh(float x);

功能：tanh函数计算浮点数x的双曲正切。

返回：tanh函数返回x的双曲正切。

(18)atan2

原型：float atan2(float y,float x);

功能：计算浮点数y/x的反正切。

参数：浮点数y，浮点数x。

返回：反正切值，值在-π～π之间。x和y的符号确定返回值的象限。

(19)ceil

原型：float ceil(float val)

功能：ceil函数计算大于或等于val的最小整数值（收尾取整）。

参数：要化为整数的数。

返回：ceil函数返回不小于val的最小float整数值。

(20)floor

原型：float floor(float val);

功能：取整。

返回：floor函数返回不大于val的最大整数值。

(21)fmod

原型：float fmod(float x,float y);

功能：取模。

返回：x/y的浮点余数。

(22)modf

原型：float modf(float val,float *ip);

功能：modf函数把浮点数val分成整数和小数部分。

返回：modf函数返回带符号小数部分val。整数部分保存在浮点数ip中。

(23)pow

原型：float pow(float x,float y);

功能：pow函数计算x的y次幂。

返回：pow函数返回值xy。如果x≠0和y=O，pow返回值1；如果x=0和y≤0，pow返回NaN。如果x

二、空操作，左右位移等内嵌代码

(1)_nop_

原型：void _nop_(void);

功能：_nop_插入一个8051NOP空操作指令到程序，用来停顿1个CPU周期。本程序是固有函数，代码要求内嵌而不是调用。

返回：无。

(2)_testbit_

原型：bit _testbit_(bit b);

功能：_testbit_程序在生成的代码中用JBC指令来测试位b，并清零。

参数：本程序只能用在直接寻址位变量，对任何类型的表达式无效。固有函数，代码要求内嵌，而非调用。

返回：_testbit_程序返回值b

(3)_cror_

原型：unsigned char _cror_(unsigned char c, unsigned char b);

功能：_cror_程序字符c循环右移b位。固有函数，代码要求内嵌，而不是调用。参数：

返回：右移的结果

(4)_iror_

原型：unsigned int _iror_(unsigned int i, unsigned char b);

功能：_iror_程序将整数i循环右移b位。固有函数，代码要求内嵌而不是被调用。

参数：i右移的整数，b右移的次数。

返回：_iror_程序返回右移后的值。

(5)_lror_

原型：unsigned long _lror_(unsigned long l,unsigned char b);

功能：_lror_程序将长整数l循环右移b位。固有函数代码，要求内嵌而不是被调用。

参数：l要右移的数，b要右移的位数。

返回：返回右移后的值。摘要：#include。

(6)_crol_

原型：unsigned char _crol_(unsigned char c, unsigned char b);

功能：_crol_程序字符c循环左移b位。固有函数，代码要求内嵌，而不是调用。

参数：

返回：左移的结果

(7)_irol_

原型：unsigned int _irol_(unsigned int i, unsigned char b);

功能：_irol_程序将整数i循环左移b位。固有函数，代码要求内嵌而不是被调用。

参数：i左移的整数，b左移的次数。

返回：_irol_程序返回左移后的值。

(8)_lrol_

原型：unsigned long _lrol_(unsigned long l,unsigned char b);

功能：_lrol_程序将长整数l循环左移b位。固有函数，代码要求内嵌而不是被调用。

参数：l要左移的数，b要左移的位数。

返回：返回左移后的值。

(9)_chkfloat_

原型：unsigned char _chkfloat_(float val);

功能：检查浮点数的状态。

参数：浮点型变量。

返回：0，标准浮点数；1，浮点数0；2，正溢出；3，负溢出；4，NaN(不是一个数)错误状态。

(10)_push_

原型：void _push_(unsigned char _sfr);

功能：将特殊功能寄存器_sfr压入堆栈。

(11)_pop_

原型：void _pop_(unsigned char _sfr);

功能：将堆栈中的数据弹出到特殊功能寄存器_sfr。

三、字串转数字，随机数，存储池管理

(1)atof

原型：float atof(void *string);

功能：将浮点数格式的字符串转换为浮点数。如果string的第一个字符不能转换成数字，就停止处理。

参数：格式为，[{+|-}]数字[.数字][{e|E}[{+|-}]数字]。如，-12.345e+67

返回：atof函数返回string的浮点值。

(2)atoi

原型：int atoi(void *string);

功能：atoi函数转换string为一个整数值。string是一个字符序列，可以解释为一个整数。如果string的第一个字符不能转换成数字，就停止处理。

参数：atoi函数要求string有这样的格式：[空格][{+|-}]数字，如”123456”。

返回：atoi函数返回string的整数值。

(3)atol

原型：long atol(void *string);

功能：atol函数转换string为一个长整数值。string是一个字符序列，可以解释为一个长整数。如果string的第一个字符不能转换成数字，就停止处理。

参数：atol函数要求string有这样的格式：[空格][{+|-}]数字，如”1234567890”。

返回：atol函数返回string的长整数值。

(4)rand

原型：int rand(void);

功能：rand函数产生一个0～32767之间的虚拟随机数。

返回：rand函数返回一个虚拟随机数。

(5)srand

原型：void srand(int seed);

功能：srand函数设置rand函数所用的虚拟随机数发生器的起始值seed，随机数发生器对任何确定值seed产生相同的虚拟随机数序列。

返回：无。

(6)strtod

原型：unsigned long strtod(const char *string, char **ptr);

功能：strtod函数将一个浮点数格式的字符串string转换为一个浮点数。字符串开头的空白字符被忽略。

参数：要求string有下面的格式： [{+|-}]digits[.digits][{e|E}[{+|-}]digits]digits可能是一个或多个十进制数。ptr的值设置指针到string中转换部分的第一个字符。如果ptr是NULL，没有值和ptr关联。如果不能转换，则prt就设为string的值，strtod返回0。

返回：strtod函数返回由string生成的浮点数。

(7)strtol

原型：long strtol(const char *string, char **ptr, unsigned char base);

功能：strtol函数将一个数字字串string转换为一个long值。

参数：输入string是一个字符序列，可以解释为一个整数。字符串开头的空白字符被忽略，符号可选。要求string有下面的格式：[whitespace][{+|-}]digitsdigits可能是一个或多个十进制数。如果base是零，数值应该有一个十进制常数、八进制常数或十六进制常数的格式。数值的基数从格式推出。如果base在2～36之间，数值必须是一个字母或数字的非零序列，表示指定基数的一个整数。字母a～z(或A～Z)分别表示值10～36。只有小于base的字母表示的值是允许的。如果base是16，数值可能以0x或0X开头，0x或0x被忽略。prt的值设置指针指向string中转换部分的第一个字符。如果prt是NULL，没有值和ptr关联。如果不能转换，prt设置为string的值，strtol返回0。

返回：strtol函数返回string生成的整数值。如溢出则返回LONG_MIN或LONG_MAX。

(8)strtoul

原型：unsigned long strtoul(const char *string, char **ptr, unsigned char base);

功能：strtoul函数转换string为一个unsigned long值。

参数：与strtol函数类似。

返回：strtoul函数返回string生成的整数值。如溢出则返回ULONG_MAX。

(9)init_mempool

原型：void inti_mempool(void xdata *p, unsigned int size);

功能：init_mempool 函数初始化存储管理程序，提供存储池的开始地址和大小。本函数必

须在任何其他的存储管理函数(calloc，free，malloc，realloc)被调用前设置存储池，只在程序的开头调用一次。可以修改源程序以适合硬件环境。

参数：p参数指向一个xdata的存储区，用calloc，free，malloc和realloc库函数管理。size参数指定存储池所用的字节数。

返回：无。

(10)malloc

原型：void xdata *malloc(unsigned int size);

功能：malloc函数从存储池分配size字节的存储块。

返回：malloc返回一个指向所分配的存储块的指针，如果没有足够的空间，则返回一个NULL指针。

(11)free

原型：void free(void xdata *p);

功能：free函数返回一个存储块到存储池。p参数指向用calloc、malloc或realloc函数分配的存储块。一旦块返回到存储就可被再分配。如果p是一个NULL指针，被忽略。本程序的源代码在KEILC51LIB目录中，可以修改源程序，根据硬件来定制本程序。

参数：

返回：无。

(12)realloc

原型：void xdata *realloc(void xdata *p,unsigned int size);

功能：realloc函数改变已分配的存储块的大小。本程序的源代码在目录KEILC5ILIB中，可以根据硬件环境定制本函数。

参数：P参数指向己分配块，size参数指定新块的大小。原块的内容复制到新块，新块中的任何其他区，如果是一个更大的块不初始化。

返回：realloc返回一个指向新块的指针。如果存储池没有足够的存储区，返回一个NULL指针，存储块不受影响。

(13)calloc

原型：void xdata *calloc(unsigned int num,unsigned int len);

功能：calloc函数从一个数组分配num个元素的存储区。每个元素占用len字节，并清0。字节总数为num*len。在LIB目录提供程序的源代码。可以修改源程序，为硬件定制本函数。

参数：num为元素数目，len为每个元素的长度。

返回：calloc函数返回一个指针，指向分配的存储区，如果不能分配，则返回一个NULL指针。

四、流输入输出

(1)_getkey

原型：char _getkey(void);

功能：_getkey函数等待从串口接收字符。_getkey和putchar函数的源代码可以修改，提供针对硬件的字符级的I/O。

返回：接收到的字符

(2)getchar

原型：char getchar(void);

功能：getchar函数用_getkey函数从输入流读一个字符。所读的字符用putchar函数显示。本函数基于_getkey或putchar函数的操作。这些函数，在标准库中提供，用8051的串口读和写字符。定制函数可以用别的I/O设备。

返回：所读的字符。

(3)ungetchar

原型：char ungetchar(char c);

功能：ungetchar函数把字符c放回到输入流。子程序被getchar和别的返回c的流输入函数调用。getchar在调用时只能传递一个字符给ungetehar。

参数：

返回：如果成功，ungetchar函数返回字符c。如果调用者在读输入流时调用ungetchar多次，返回EOF表示一个错误条件。

(4)putchar

原型：char putchr(char c);

功能：putchar函数用8051的串口输出字符c。本程序指定执行，功能可能有变。因提供了_getkey和putchar函数的源程序，可以根据任何硬件环境修改以提供字符级的I/O。

参数：

返回：putchar函数返回输出的字符c。

(5)printf

原型：int printf(const char *fmtstr [,arguments]…);

功能：printf函数格式化一系列的字符串和数值，生成一个字符串用putchar写到输出流。参数：fmtstr参数是一个格式化字符串，可能是字符、转义系列和格式标识符。普通的字符和转义系列按说明的顺序复制到流。格式标识符通常以百分号(%)开头，要求在函数调用中包含附加的参数Arguments。格式字符串从左向右读。第一个格式标识符使用fmtstr后的第一个参数，用格式标识符转换和输出。第二个格式标识符访问fmtstr后的第二个参数。如果参数比格式标识符多，多出的参数被忽略。如果参数不够，结果是不可预料的。格式标识符用下面的格式：%[flags][width][.precision][{b|B|l|L}]type格式标识符中的每个域可以是一个字符或数字type域是一个字符，指定参数是否解释为一个字符、字符串、数字或指针。如下表所示：可选的字符b或B和l和L可直接放在类型字符前，分别指定整数类型d、i、u、o、x和X的char或long版本。flags 域是单个字符，用来对齐、输出和打印+/-号、空白、小数点、八进制和十六进制的前缀。如下表所示：width 域是一个非负数字，指定显示的最小字符数。如果输出值的字符数小于width，空白会加到左边或右边(当指定了一个标记)以达到最小的宽度。如果width用一个’0’作前缀，则填充的是零而不是空白。width域不会截短一个域。如果输出值的长度超过指定宽度，则输出所有的字符。width域可能是星号(*)，在这种情况下，参数列表的一个int参数提供宽度值。如果参数使用的是unsigned char，在星号标识符前指定一个’b’。precision域是非负数字，指定显示的字符数、小数位数或有效位。precison域可能使输出值切断或舍入。precision域可能是星号(*)，在这种情况，参数列表的一个int参数提供宽度值。如果参数使用的是unsigned char，在星号标识符前指定一个’

b’。本函数指定执行基于putchar函数的操作。本函数作为标准库提供，用805l的串口写字符，用别的I/O设备可以定制函数。必须确保参数类型和指定的格式匹配。可用类型映射确保正确的类型传递到printf。可传递给 printf 的总的字节数受到 8051 的存储区的限制。SMALL 模式和COMPACT模式最多15字节，LARGE模式最多40字节。

返回：printf函数返回实际写到输出流的字符数。

(6)sprintf

原型：int sprintf(char *buffer,const char *fmtstr [,arguments]…);

功能：sprintf函数格式化一系列的字符串和数值，并保存结果字符串在buffer fintstr。参数：参数是一个格式字符串，和printf函数指定的要求相同。

返回：sprintf函数返回实际写到buffer的字符数。

(7)vprintf

原型：void vprintf(const char *fmtstr, char *argptr);

功能：vprintf函数格式化一系列字符串和数字值，并建立一个用puschar函数写到输出流的字符串，函数类似于printf的副本，但使用参数列表的指针，而不是一个参数列表。本函数是指定执行的，基于putchar函数的操作。本函数作为标准库提供，用8051的串口写字符。别的I/O设备可以定制函数。

参数：fmtstr参数是一个指向一个格式字符串的指针，和printf函数的fmtstr参数有相同的形式和功能。argptr参数指向一系列参数，根据格式中指定的对应格式转换和输出。

返回：vprintf函数返回实际写到输出流的字符数。

(8)vsprimf

原型：void vsprintf(char *buffer, const char *fmtstr, char *argptr);

功能：vsprintf函数格式化一系列字符串和数字值，并保存字符串在Buffer中。函数类似于sprintf的副本，但使用参数列表的指针，而不是一个参数列表。

参数：fmtstr参数是一个指向一个格式字符串的指针，和printf函数的fmtstr参数有相同的形式和功能。argptr参数指向一系列参数，根据格式中指定的对应格式转换和输出。

返回：vsprintf函数返回实际写到输出流的字符数。

(9)gets

原型：char *gets(char *string, int len);

功能：gets函数调用getchar函数读一行字符到string。这行包括所有的字符和换行符('n')。在string中换行符被一个NULL字符('n')替代。len参数指定可读的最多字符数。如果长度超过len，gets函数用NULL字符终止string并返回。本函数指定执行基于_getkey或putchar函数的操作。这些函数，在标准库中提供，用8051的串口读写。对别的I/O设备可以定制。

参数：string要读的字符串，len最多字符数。

返回：gets函数返回string

(10)scanf

原型：int scanf(sonst char *fmtstr [,argument]…);

功能：scanf函数用getchar程序读数据。输入的数据保存在由argument根据格式字符串fmtstr指定的位置。

参数：每个argument必须是一个指针，指向一个变量，对应fmtstr定义的类型，fmtstr控制解释输入的数据，fmtstr参数由一个或单个空白字符、非空白字符和下面定义的格式标识符组成。

· 空白字符，空白(' ')，制表('t')或换行('n')，使scanf跳过输入流中的空白字符。格式字符串中的单个的空白字符匹配输入流的0或多个空白字符。

· 非空白字符，除了百分号('%')，使scanf从输入流读但不保存一个匹配字符。如果输入流的下一个字符和指定的非空白字符不匹配，scanf函数终止。

· 格式标识符以百分号('%')开头，使scanf从输入流读字符，并转换字符到指定的类型值。转换后的值保存在参数列表的argument中。百分号后面的字符不被认为是一个格式标识符，只作为一个普通字符。例如%%匹配输入流的一个百分号。格式字符串从左向右读，不是格式标识符的字符必须和输入流的字符匹配。这些字符从输入流读入，但不保存，如果输入流的一个字符和格式字符串冲突，scanf终止。任何冲突的字符仍保留在输入流中。在格式字符串中的第一个格式标识符引用fmtstr后面的第一个参数，并转化输入字符，用格式标识符保存值。第二个格式标识符访问fmtstr后面的第二个参数，等等。如果参数比格式标识符多，多出的参数被忽略。如果没有足够的参数匹配格式标识符，结果是不可预料的。输入流中的值被输入域调用，用空白字符隔开。在转换输入域时，scanf遇到一个空白字符就结束一个参数的转换，而且任何当前格式标识符不认识的字符会结束一个域转换。格式标识符的格式：%[*][width][{b|h|l}]type格式标识符中的每个域可以是单个字符或数字，用来指定一个特殊的格式选项。type域是单个字符，指定输入字符是否解释为一个字符、字符串或数字。本域可以是下表中的任何值。以星号(*)作为格式标识符的第一个字符，会使输入域被扫描但不保存。星号禁止和格式标识符关联。width域是一个非负数，指定从输入流读入的最多字符数。从输入流读入的字符不超过width，并根据相应的argument转换。然而，如果一个空白字符或一个不认识字符先遇到，则读入的字符数小于width。可选字符b，h和l直接放在类型字符前面，分别指定整数类型d，i，u，o和x的char，short或long版本。本函数指定执行基于_getkey或putchar函数的操作。这些函数，作为标准库提供，用805l的串口读写。可对别的I/O设备定制函数。可以传递给scanf的字节数受8051存储区的限制。SMALL模式或COMPACT模式最多为15字节。LARGE模式最多为40字节。

返回：scanf函数返回成功转换的输入域的数目。如果有错误则返回EOF。

(11)sscanf

原型：int sscanf(char *buffer,const char *fmtstr [,argument]…);

功能：sscanf函数从buffer读字符串。

参数：输入的数据保存在由argument根据格式字符串fmtstr指定的位置。每个argument必须是指向变量的指针，对应定义在 fmtstr 的类型，控制输入数据的解释。fmtstr参数由一个或多个空白字符、非空白字符和格式标识符组成，如同scanf函数所定义。

返回：sscanf函数返回成功转换的输入域的数目，如果出现错误则返回EOF。

(12)puts

原型：int puts(const char *string);

功能：puts函数用putchar函数写string和换行符n到输出流。本函数指定执行基于putchar函数的操作。本函数作为标准库提供，写字符到8051的串口。用别的I/O口可以定制函数。

参数：输出的字符串。

返回：如果出现错误，puts函数返回EOF，如果没有则返回0。

五、字符测试

(1)isalpha

原型：bit isalpha(char c);

功能：isalpha函数测试参数c，确定是否是一个字母(‘A’～’Z’，’a’～’z’)。

返回：如果c是一个字母，isalpha函数返回1(真)，否则返回0(假)。

(2)isalnum

原型：bit isalnum(char c);

功能：isalnum函数测试参数c，确定是否是一个字母或数字字符(‘A’～’Z’，’a’～’z’，’0’～’9’)。

返回：如果c是一个字母或数字字符，isalnum函数返回1(真)，否则返回0(假)。

(3)iscntrl

原型：bit iscntrl (char c);

功能：iscntrl函数测试参数c，确定是否是一个控制字符(0x00~0x1F或0x7F)。

返回：如果c是一个控制字符，iscntrl函数返回1(真)，否则返回0(假)。

(4)isdigit

原型：bit isdigit(char c);

功能：isdigit函数测试参数c，确定是否是一个十进制数(’0’～’9’)。

返回：如果c是一个十进制数，isdigit函数返回1(真)，否则返回0(假)。

(5)isgraph

原型：bit isgraph(char c);

功能：isgraph函数测试参数c，确定是否是一个可打印字符(0x21～0x7E，不包括空格)。

返回：如果c是一个可打印字符，isgraph函数返回1(真)，否则返回0(假)。

(6)isprint

原型：bit isprint(char c);

功能：isprint函数测试参数c，确定是否是一个可打印字符(0x20～0x7E)。

返回：如果c是一个可打印字符，isprint函数返回1(真)，否则返回0(假)。

(7)ispunct

原型：bit ispunct(char c);

功能：ispunct函数测试参数c，确定是否是一个标点符号字符( ! , . : ; ? ” # $ % & ’ ` ( ) < >

[ ] { }* + - = / | @ ^ _ ~ )。

返回：如果c是一个标点符号字符，ispunct函数返回1(真)，否则返回0(假)。

(8)islower

原型：bit islower(char c);

功能：islower函数测试参数c，确定是否是一个小写字母字符(‘a’～’z’)。

返回：如果c是一个小写字母字符，islower函数返回1(真)，否则返回0(假)。

(9)isupper

原型：bit isupper(char c);

功能：isupper函数测试参数c，确定是否是一个大写字母字符(‘A’～’Z’)。

返回：如果c是一个大写字母字符，isupper函数返回1(真)，否则返回0(假)。

(10)isspace

原型：bit isspace(char c);

功能：isspace函数测试参数c，确定是否是一个空白字符(0x09～0x0D或0x20)。

返回：如果c是一个空白字符，isspace函数返回1(真)，否则返回0(假)。

(11)isxdigit

原型：bit isalnum(char c);

功能：isalnum函数测试参数c，确定是否是一个十六进制数‘(A’～’F’，’a’～’f’，’0’～’9’)。

返回：如果c是一个十六进制数，isalnum函数返回1(真)，否则返回0(假)。

(12)tolower

原型：char tolower(char c);

功能：tolower函数转换c为一个小写字符。如果c不是一个字母，tolower函数无效。(13)toupper

原型：char toupper(char c);

功能：toupper函数转换c为一个大写字符。如果c表示一个字母，toupper函数无效。

参数：

返回：toupper宏返回c的大写。

(14)toint

原型：char toint(char c);

功能：toint函数解释c为十六进制值。ASCII字符’0’～’9’生成值0～9。ASCII字符’A’～’F’和’a’～’f’生成值10～15。如果c表示一个十六进制数，函数返回-1。

返回：toint宏返回c的十六进制ASCII值。

(15)_tolower

原型：#define _tolower(c) ( (c)-'A'+'a' )

功能：_tolower宏是在已知c是一个大写字符的情况下可用的lower的一个版本。

返回：_tolower宏返回c的小写。

(16)_toupper

原型：#define _toupper(c) ( (c)-'a'+'A' )

功能：_toupper宏是在已知c是一个小写字符的情况下可用的toupper的一个版本。

返回：_toupper宏返回c的大写。

(17)toascii

原型：#define toascii(c) ( (c) & 0x7F )

功能：toascii宏转换c为一个7位ASCII字符。宏只转换变量c的低7位。

返回：toascii宏返回c的7位ASCII字符。

六、跳转

(1)setjmp

原型：volatile int setjmp(jmp_buf env);

功能：setjmp函数保存当前CPU的状态在env，该状态可以调用longjmp函数来恢复。参数：当同时使用时，setjmp和longjmp函数提供一种方法实行非局部跳转。setjmp函数保存当前指令地址和别的CPU寄存器。一个longjmp的并发调用恢复指令指针和寄存器，在setjmp调用后面恢复运行。只有声明了volatile属性的局部变量和函数参数被恢复。

返回：当CPU的当前状态被复制到env，setjmp函数返回一个0。一个非零值表示执行了longjmp函数来返回setjmp函数调用。在这种情况下，返回值是传递给longjmp函数的值。

(2)longjmp

原型：volatile void longjmp(jmp_bufenv,int retval);

功能：longjmp函数恢复用setjmp函数保存在env的状态。retval参数指定从setjmp函数调用返回值。longjmp和setjmp函数可以用来执行非局部跳转，通常用来控制一个错误恢复程序。只有用volatile属性声明的局部变量和函数参数被恢复。

七、字符串操作

(1)strcat

原型：char *strcat(char *s1,char *s2);

功能：strcat函数连接或添加s2到s1，并用NULL字符终止s1。

参数：s1目标字符串，s2源字符串。

返回：s1。

(2)strncat

原型：char *strncat(char *s1,char *s2,int len);

功能：strncat函数从s2添加最多len个字符到s1，并用NULL结束。如果s2的长度小于len，s2连带NULL全部复制。

参数：s1目标字符串，s2源字符串，len连接的最多字符数。

返回：strncat函数返回s1。

(3)strcmp

原型：char strcmp(char *s1,char *s2);

功能：strcmp函数比较字串s1和s2的内容，并返回一个值表示它们的关系。

返回：若s1s2返回正数。

(4)strncmp

原型：char *strncmp(char *s1,char *s2,int len);

功能：strncmp函数比较s1的前len字节和s2，返回一个值表示它们的关系。

参数：s1,s2为字串，len为比较的长度。

返回：若s1s2返回正数。

(5)strcpy

原型：char *strcpy(char *s1, char *s2);

功能：strcpy函数复制字符串s2到字符串s1，并用NULL字符结束s1。

参数：s1目标字符串，s2源字符串。

返回：字符串s1。

(6)strncpy

原型：char *strncpy(char *dest, char *s2, int len);

功能：strncpy函数从字符串s2复制最多len个字符到字符串s1。

返回：字符串s1。

(7)strlen

原型：int strlen(char *s);

功能：strlen函数计算字符串s的字节数，不包括NULL结束符。

参数：s要测试长度的字串。

返回：字符串s的长度。

(8)strchr

原型：char *strchr(const char *s, char c);

功能：strchr函数搜索字符串s中第一个出现的c。s中的NULL字符终止搜索。

参数：s被搜索的字符串，c要查找的字符。

返回：字符串s中指向c的指针，如没有发现则返回一个NULL指针。

(9)strops

原型：int strpos(const char *s, char c);

功能：strpos函数查找字符串s中c的第一次出现，包括s的NULL结束符。

参数：s被搜索的字符串，c要查找的字符。

返回：s中和c匹配的字符的索引。如没匹配则返回-1。s中第一个字符的索引是0。

(10)strrchr

原型：char *strrchr(const char *s, char c);

功能：strrchr函数查找字符串s中c的最后一次出现，包括s的NULL结束符。

参数：s被搜索的字符串，c要查找的字符。

返回：strrchr函数返回s中和c匹配的字符的指针，如没匹配则返回NULL。

(11)strrpos

原型：int strrpos(const char *s, char c);

功能：strrpos函数查找字符串s中c的最后一次出现，包括s的NULL结束符。

参数：s被搜索的字符串，c要查找的字符。

返回：s中和c匹配的最后字符的索引。如没匹配则返回-1，s中第一个字符的索引是0。

(12)strcspn

原型：int strcspn(char *s, char *set);

功能：在字符串s中查找字符串set中的任何字符。

参数：s源字串，set查找的字串。

返回：strcspn函数返回s中和set匹配的第一个字符的索引。如果s的第一个字符和set中的一个字符匹配，返回0。如果s中没有字符匹配，返回字符串的长度。

(13)strpbrk

原型：char *strpbrk(char *s, char *set);

功能：查找字符串s中第一个出现的set中的任何字符，不包括NULL结束符。

参数：s源字串，set查找的字串。

返回：s匹配的字符的指针。如果s没有字符和set匹配，返回一个NULL指针。

(14)strrpbrk

原型：char *strrpbrk(char *s, char *set);

功能：查找字符串s中最后一个出现的set中的任何字符，不包括NULL结束符。

返回：s最后匹配的字符的指针。如果s没有字符和set匹配，返回一个NULL指针。

(15)strspn

原型：int strspn(char *s, char *set);

功能：查找字符串s中set没有的字符。

返回：strspn函数返回s第一个和set不匹配的字符的索引。如果s中的第一个字符和set中的字符不匹配，返回0。如果s中的所有字符set中都有，返回string的长度。

(16)strstr

原型：char *strstr(const char *s, char *sub);

功能：在字符串s中搜索子串sub。

返回：strstr函数返回子字符串sub在字符串s中第一次出现的位置的指针。指针指向第一次出现的开头。如果s中不存在sub，则返回一个NULL指针。

(17)memcmp

原型：char memcmp(void *buf1,void *buf2,int len);

功能：memcmp函数比较两个缓冲区buf1和bur2长度为len的字节，并返回一个值。

返回：若返回0，则bufl=buf2；若返回负数，则buf1bul2。

(18)memcpy

原型：void *memcpy(void *s1,void *s2,int len);

功能：memcpy函数从字符串s2复制len字节到字符串s1。如果存储缓冲区重叠，memcpy函数不能保证s2中的那个字节在被覆盖前复制到s1。如果缓冲区重叠用memmove函数。

参数：s1目标缓冲区，s2源缓冲区，len拷贝的字节数。

返回：s1。

(19)memchr

原型：void *memchr(void *buf,char c,int len);

功能：memchr函数在buf中的前len个字节中查找字符c。

返回：memchr函数返回字符c在buf中的指针，如没有则返回一个NULL指针。

(20)memccpy

原型：void *memccpy(void *dest,void *src,char c,int len);

功能：memccpy函数从src到dest复制0或更多的字符，直到字符c被复制或len字节被复制，哪个条件先遇到就执行哪个条件。

返回：memccpy函数返回一个指针，指向dest最后一个复制的字符的后一个字节。如果最后一个字符是c，则返回一个NULL指针。

(21)memmove

原型：void *memmove(void *dest,void *src,int len);

功能：memmove函数从src复制len字节到dest。如果存储缓冲区重叠，memmove函数保证src中的那个字节在被覆盖前复制到dest。

参数：dest目标缓冲区，src源缓冲区，len移动的字节数。

返回：memmove函数返回dest

(22)memset

原型：void *memset(void *buf,char c,int len);

功能：memset函数设置buf的前len字节为c。

参数：buf要初始化的缓冲区，c要设值的值，len缓冲区长度。

返回：memset函数返回dest。

八、可变参数

(1)va_arg

原型：type va_arg(argptr, type);

功能：va_arg宏用来从一个可变长度参数列表索引argptr提取并列参数。type参数指定提取参数的数据类型。本宏对每个参数只能调用一次，且必须根据参数列表中的参数顺序调用。第一次调用va_arg返回va_start宏中指定的prevparm参数后的第一个参数。后来对va_arg的调用依次返回余下的参数。

参数：

返回：va_arg宏返回指定参数类型的值。

(2)va_end

原型：void va_end(argptr);

功能：va_end宏用来终止可变长度参数列表指针argptr的使用，argptr用va_start宏初始化。参数：

返回：无。

(3)va_start

原型：void va_start(argptr, prevparm);

功能：va_start 宏用在一个可变长度参数列表的函数中时，用 va_arg 和va_end 宏初始化argptr。prevparm 参数必须是用三点号(…)指定的可选参数前紧挨的函数参数。此函数必须在用va_arg宏访问前初始化可变长度参数列表指针。

参数：

返回：无。