C51 库函数（转）

3.3 STRING.H：串函数串函数通常将指针串作输入值。一个串就包括2个或多个字符。串结以空字符表示。在函数memcmp，memcpy，memchr，memccpy，memmove和memset中，串长度由调用者明确规定，使这些函数可工作在任何模式下。函数名： memchr原 型： extern void *memchr(void *sl， char val，int len);功 能： memchr顺序搜索s1中的len个字符找出字符val，成功时返回s1中指向val的指针，失败时返回NULL。函数名： memcmp原 型： extern char memcmp(void *sl， void *s2，int len);功 能： memcmp逐个字符比较串s1和s2的前len个字符。相等时返回0，如果串s1大于或小于s2，则相应返回一个正数或负数。函数名： memcpy原 型： extern void *memcpy(void *dest， void *src，int len);功 能： memcpy由src所指内存中拷贝len个字符到dest中，返回批向dest中的最后一个字符的指针。如果src和dest发生交迭，则结果是不可预测的。函数名： memccpy原 型： extern void *memccpy(void *dest， void *src，char val，int len);功 能： memccpy拷贝src中len个字符到dest中，如果实际拷贝了len个字符返回NULL。拷贝过程在拷贝完字符val后停止，此时返回指向dest中下一个元素的指针。函数名： memmove原 型： extern void *memmove(void *dest， void *src，int len);功 能： memmove工作方式与memcpy相同，但拷贝区可以交迭。函数名： memset原 型： extern void *memset(void *s， char val，int len);功 能： memset 将val值填充指针s中len个单元。函数名： strcat原 型： extern char *strcat(char *s1， char *s2);功 能： strcat将串s2拷贝到串s1结尾。它假定s1定义的地址区足以接受两个串。返回指针指向s1串的第一字符。函数名： strncat原 型： extern char *strncat(char *s1， char *s2，int n);功 能： strncat拷贝串s2中n个字符到串s1结尾。如果s2比n短，则只拷贝s2。函数名： strcmp原 型： extern char strcmp(char *s1， char *s2);功 能： strcmp比较串s1和s2，如果相等返回0，如果s1s2则返回一个正数。函数名： strncmp原 型： extern char strncmp(char *s1， char *s2，int n);功 能： strncmp比较串s1和s2中前n个字符，返回值与strncmp相同。函数名： strcpy原 型： extern char *strcpy(char *s1， char *s2);功 能： strcpy将串s2包括结束符拷贝到s1，返回指向s1的第一个字符的指针。函数名： strncpy原 型： extern char *strncpy(char *s1， char *s2，int n);功 能： strncpy与strcpy相似，但只拷贝n个字符。如果s2长度小于n，则s1串以‘0’补齐到长度n。函数名： strlen原 型： extern int strlen(char *s1);功 能： strlen返回串s1字符个数（包括结束字符）。函数名： strchr，strpos原 型： extern char *strchr(char *s1， char c);extern int strpos（char *s1，char c）；功 能： strchr搜索s1串中第一个出现的‘c’字符，如果成功，返回指向该字符的别指针，搜索也包括结束符。搜索一个空字符返回指向空字符的指针而不是空指针。strpos与strchr相似，但它返回字符在串中的位置或-1，s1串的第一个字符位置是0。函数名： strrchr，strrpos原 型： extern char *strrchr(char *s1， char c);extern int strrpos（char *s1，char c）；功 能： strrchr搜索s1串中最后一个出现的‘c’字符，如果成功，返回指向该字符的指针，否则返回NULL。对s1搜索也返回指向字符的指针而不是空指针。strrpos与strrchr相似，但它返回字符在串中的位置或-1。函数名： strspn，strcspn，strpbrk，strrpbrk原 型： extern int strspn(char *s1， char *set);extern int strcspn(char *s1，char *set);extern char *strpbrk(char *s1,char *set);extern char *strpbrk(char *s1,char *set);功 能： strspn搜索s1串中第一个不包含在set中的字符，返回值是s1中包含在set里字符的个数。如果s1中所有字符都包含在set里，则返回s1的长度（包括结束符）。如果s1是空串，则返回0。strcspn与strspn类似，但它搜索的是s1串中的第一个包含在set里的字符。strpbrk与strspn很相似，但它返回指向搜索到字符的指针，而不是个数，如果未找到，则返回NULL。strrpbrk与strpbrk相似，但它返回s1中指向找到的set字集中最后一个字符的指针。3．4 STDLIB.H：标准函数函数名： atof原 型： extern double atof(char *s1);功 能： atof将s1串转换为浮点值并返回它。输入串必须包含与浮点值规定相符的数。C51编译器对数据类型float和double相同对待。函数名： atol原 型： extern long atol(char *s1);功 能： atol将s1串转换成一个长整型值并返回它。输入串必须包含与长整型值规定相符的数。函数名： atoi原 型： extern int atoi(char *s1);功 能： atoi将s1串转换为整型数并返回它。输入串必须包含与整型数规定相符的数。3.5 MATH.H：数学函数函数名： abs，cabs，fabs，labs原 型： extern int abs(int va1);extern char cabs(char val);extern float fabs(float val);extern long labs(long val);功 能： abs决定了变量val的绝对值，如果val为正，则不作改变返回；如果为负，则返回相反数。这四个函数除了变量和返回值的数据不一样外，它们功能相同。函数名： exp，log，log10原 型： extern float exp(float x);extern float log(float x);extern float log10(float x);功 能：exp返回以e为底x的幂，log返回x的自然数（e=2.718282），log10返回x以10为底的数。函数名： sqrt原 型： extern float sqrt(float x);功 能： sqrt返回x的平方根。函数名：rand，srand原 型： extern int rand(void);extern void srand（int n）；功 能： rand返回一个0到32767之间的伪随机数。srand用来将随机数发生器初始化成一个已知（或期望）值，对rand的相继调用将产生相同序列的随机数。函数名： cos，sin，tan原 型： extern float cos(flaot x);extern float sin(flaot x)；extern flaot tan(flaot x);功 能： cos返回x的余弦值。Sin返回x的正弦值。tan返回x的正切值，所有函数变量范围为-π/2～+π/2，变量必须在±65535之间，否则会产生一个NaN错误。函数名： acos，asin，atan，atan2原 型： extern float acos(float x);extern float asin(float x);extern float atan(float x);extern float atan(float y,float x);功 能： acos返回x的反余弦值，asin返回x的正弦值，atan返回x的反正切值，它们的值域为-π/2～+π/2。atan2返回x/y的反正切，其值域为-π～+π。函数名： cosh，sinh，tanh原 型： extern float cosh(float x);extern float sinh(float x);extern float tanh(float x);功 能： cosh返回x的双曲余弦值；sinh返回x的双曲正弦值；tanh返回x的双曲正切值。函数名： fpsave，fprestore原 型： extern void fpsave(struct FPBUF *p);extern void fprestore (struct FPBUF *p);功 能： fpsave保存浮点子程序的状态。fprestore将浮点子程序的状态恢复为其原始状态，当用中断程序执行浮点运算时这两个函数是有用的。3.6 ABSACC.H：绝对地址访问函数名： CBYTE，DBYTE，PBYTE，XBYTE原 型： #define CBYTE((unsigned char *)0x50000L)#define DBYTE((unsigned char *)0x40000L)#define PBYTE((unsigned char *)0x30000L)#define XBYTE((unsigned char *)0x20000L)功 能： 上述宏定义用来对8051地址空间作绝对地址访问，因此，可以字节寻址。CBYTE寻址CODE区，DBYTE寻址DATA区，PBYTE寻址XDATA区（通过MOVX @R0命令），XBYTE寻址XDATA区（通过MOVX @DPTR命令）。例：下列指令在外存区访问地址0x1000xval=XBYTE[0x1000];XBYTE[0X1000]=20;通过使用#define指令，用符号可定义绝对地址，如符号X10可与XBYTE[0x1000]地址相等：#define X10 XBYTE[0x1000]。函数名： CWORD，DWORD，PWORD，XWORD原 型： #define CWORD((unsigned int *)0x50000L)#define DWORD((unsigned int *)0x40000L)#define PWORD((unsigned int *)0x30000L)#define XWORD((unsigned int *)0x20000L)功 能：这些宏与上面相似，只是它们指定的类型为unsigned int。通过灵活的数据类型，所有地址空间都可以访问。3.7   INTRINS.H：内部函数函数名： _crol_，_irol_，_lrol_原 型： unsigned char _crol_(unsigned char val,unsigned char n);unsigned int _irol_(unsigned int val,unsigned char n);unsigned int _lrol_(unsigned int val,unsigned char n);功 能：_crol_，_irol_，_lrol_以位形式将val左移n位，该函数与8051“RLA”指令相关，上面几个函数不同于参数类型。例：#includemain(){unsigned int y;y=0x00ff;y=_irol_(y,4); }函数名： _cror_，_iror_，_lror_原 型： unsigned char _cror_(unsigned char val,unsigned char n);unsigned int _iror_(unsigned int val,unsigned char n);unsigned int _lror_(unsigned int val,unsigned char n);功 能：_cror_，_iror_，_lror_以位形式将val右移n位，该函数与8051“RRA”指令相关，上面几个函数不同于参数类型。例：#includemain(){unsigned int y;y=0x0ff00;y=_iror_(y,4); }函数名： _nop_原 型： void _nop_(void);功 能：_nop_产生一个NOP指令,该函数可用作C程序的时间比较。C51编译器在_nop_函数工作期间不产生函数调用，即在程序中直接执行了NOP指令。例：P()=1;_nop_();P()=0;函数名： _testbit_原 型：bit _testbit_(bit x);功 能：_testbit_产生一个JBC指令，该函数测试一个位，当置位时返回1，否则返回0。如果该位置为1，则将该位复位为0。8051的JBC指令即用作此目的。 _testbit_只能用于可直接寻址的位；在表达式中使用是不允许的。STDARG.H：变量参数表C51编译器允许再入函数的变量参数（记号为“…”）。头文件STDARG.H允许处理函数的参数表,在编译时它们的长度和数据类型是未知的。为此，定义了下列宏。宏 名： va_list功 能： 指向参数的指针。宏 名： va_stat(va_list pointer,last_argument)功 能： 初始化指向参数的指针。宏 名： type va_arg(va_list pointer,type)功 能：返回类型为type的参数。宏 名： va_end(va_list pointer)功 能： 识别表尾的哑宏。3.8 SETJMP.H：全程跳转Setjmp.h中的函数用作正常的系列数调用和函数结束，它允许从深层函数调用中直接返回。函数名： setjmp原 型： int setjmp(jmp_buf env);功 能： setjmp将状态信息存入env供函数longjmp使用。当直接调用setjmp 时返回值是0，当由longjmp调用时返回非零值，setjmp只能在语句IF或SWITCH中调用一次。函数名： long jmp原 型： long jmp(jmp_buf env,int val);功 能：longjmp恢复调用setjmp时存在env中的状态。程序继续执行，似乎函数setjmp已被执行过。由setjmp返回的值是在函数longjmp中传送的值val，由setjmp调用的函数中的所有自动变量和未用易失性定义的变量的值都要改变。3.9 REGxxx.H：访问SFR和SFR-BIT地址文件REG51.H，REG52.H和REG552.H允许访问8051系列的SFR和SFR-bit的地址，这些文件都包含#include指令，并定义了所需的所有SFR名以寻址8051系列的外围电路地址，对于8051系列中其它一些器件，用户可用文件编辑器容易地产生一个“.h”文件。下例表明了对8051 PORT0和PORT1的访问：#includemain() {if(p0==0x10) p1=0x50;}