C51 庫(kù)函數(shù)(3)
3.3 STRING.H:串函數(shù)
串函數(shù)通常將指針串作輸入值。一個(gè)串就包括2個(gè)或多個(gè)字符。串結(jié)以空字符表示。在函數(shù)memcmp,memcpy,memchr,memccpy,memmove和memset中,串長(zhǎng)度由調(diào)用者明確規(guī)定,使這些函數(shù)可工作在任何模式下。
函數(shù)名: memchr
原 型: extern void *memchr(void *sl, char val,int len);
功 能: memchr順序搜索s1中的len個(gè)字符找出字符val,成功時(shí)返回s1中指向val的
指針,失敗時(shí)返回NULL。
函數(shù)名: memcmp
原 型: extern char memcmp(void *sl, void *s2,int len);
功 能: memcmp逐個(gè)字符比較串s1和s2的前l(fā)en個(gè)字符。相等時(shí)返回0,如果串s1大
于或小于s2,則相應(yīng)返回一個(gè)正數(shù)或負(fù)數(shù)。
函數(shù)名: memcpy
原 型: extern void *memcpy(void *dest, void *src,int len);
功 能: memcpy由src所指內(nèi)存中拷貝len個(gè)字符到dest中,返回批向dest中的最后一
個(gè)字符的指針。如果src和dest發(fā)生交迭,則結(jié)果是不可預(yù)測(cè)的。
函數(shù)名: memccpy
原 型: extern void *memccpy(void *dest, void *src,char val,int len);
功 能: memccpy拷貝src中l(wèi)en個(gè)字符到dest中,如果實(shí)際拷貝了len個(gè)字符返回NULL。
拷貝過(guò)程在拷貝完字符val后停止,此時(shí)返回指向dest中下一個(gè)元素的指針。
函數(shù)名: memmove
原 型: extern void *memmove(void *dest, void *src,int len);
功 能: memmove工作方式與memcpy相同,但拷貝區(qū)可以交迭。
函數(shù)名: memset
原 型: extern void *memset(void *s, char val,int len);
功 能: memset 將val值填充指針s中l(wèi)en個(gè)單元。
函數(shù)名: strcat
原 型: extern char *strcat(char *s1, char *s2);
功 能: strcat將串s2拷貝到串s1結(jié)尾。它假定s1定義的地址區(qū)足以接受兩個(gè)串。返
回指針指向s1串的第一字符。
函數(shù)名: strncat
原 型: extern char *strncat(char *s1, char *s2,int n);
功 能: strncat拷貝串s2中n個(gè)字符到串s1結(jié)尾。如果s2比n短,則只拷貝s2。
函數(shù)名: strcmp
原 型: extern char strcmp(char *s1, char *s2);
功 能: strcmp比較串s1和s2,如果相等返回0,如果s1s2則返回
一個(gè)正數(shù)。
函數(shù)名: strncmp
原 型: extern char strncmp(char *s1, char *s2,int n);
功 能: strncmp比較串s1和s2中前n個(gè)字符,返回值與strncmp相同。
函數(shù)名: strcpy
原 型: extern char *strcpy(char *s1, char *s2);
功 能: strcpy將串s2包括結(jié)束符拷貝到s1,返回指向s1的第一個(gè)字符的指針。
函數(shù)名: strncpy
原 型: extern char *strncpy(char *s1, char *s2,int n);
功 能: strncpy與strcpy相似,但只拷貝n個(gè)字符。如果s2長(zhǎng)度小于n,則s1串以‘0’
補(bǔ)齊到長(zhǎng)度n。
函數(shù)名: strlen
原 型: extern int strlen(char *s1);
功 能: strlen返回串s1字符個(gè)數(shù)(包括結(jié)束字符)。
函數(shù)名: strchr,strpos
原 型: extern char *strchr(char *s1, char c);
extern int strpos(char *s1,char c);
功 能: strchr搜索s1串中第一個(gè)出現(xiàn)的‘c’字符,如果成功,返回指向該字符的別指
針,搜索也包括結(jié)束符。搜索一個(gè)空字符返回指向空字符的指針而不是空指針。
strpos與strchr相似,但它返回字符在串中的位置或-1,s1串的第一個(gè)字符位置是0。
函數(shù)名: strrchr,strrpos
原 型: extern char *strrchr(char *s1, char c);
extern int strrpos(char *s1,char c);
功 能: strrchr搜索s1串中最后一個(gè)出現(xiàn)的‘c’字符,如果成功,返回指向該字符的
指針,否則返回NULL。對(duì)s1搜索也返回指向字符的指針而不是空指針。
strrpos與strrchr相似,但它返回字符在串中的位置或-1。
函數(shù)名: 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串中第一個(gè)不包含在set中的字符,返回值是s1中包含在set里
字符的個(gè)數(shù)。如果s1中所有字符都包含在set里,則返回s1的長(zhǎng)度(包括結(jié)束符)。如果s1是空串,則返回0。
strcspn與strspn類似,但它搜索的是s1串中的第一個(gè)包含在set里的字符。strpbrk與strspn很相似,但它返回指向搜索到字符的指針,而不是個(gè)數(shù),如果未找到,則返回NULL。
strrpbrk與strpbrk相似,但它返回s1中指向找到的set字集中最后一個(gè)字符的指針。
3.4 STDLIB.H:標(biāo)準(zhǔn)函數(shù)
函數(shù)名: atof
原 型: extern double atof(char *s1);
功 能: atof將s1串轉(zhuǎn)換為浮點(diǎn)值并返回它。輸入串必須包含與浮點(diǎn)值規(guī)定相符的數(shù)。
C51編譯器對(duì)數(shù)據(jù)類型float和double相同對(duì)待。
函數(shù)名: atol
原 型: extern long atol(char *s1);
功 能: atol將s1串轉(zhuǎn)換成一個(gè)長(zhǎng)整型值并返回它。輸入串必須包含與長(zhǎng)整型值規(guī)定相
符的數(shù)。
函數(shù)名: atoi
原 型: extern int atoi(char *s1);
功 能: atoi將s1串轉(zhuǎn)換為整型數(shù)并返回它。輸入串必須包含與整型數(shù)規(guī)定相符的數(shù)。
3.5 MATH.H:數(shù)學(xué)函數(shù)
函數(shù)名: 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的絕對(duì)值,如果val為正,則不作改變返回;如果為負(fù),則
返回相反數(shù)。這四個(gè)函數(shù)除了變量和返回值的數(shù)據(jù)不一樣外,它們功能相同。
函數(shù)名: exp,log,log10
原 型: extern float exp(float x);
extern float log(float x);
extern float log10(float x);
功能:exp返回以e為底x的冪,log返回x的自然數(shù)(e=2.718282),log10返回x以10
為底的數(shù)。
函數(shù)名: sqrt
原 型: extern float sqrt(float x);
功 能: sqrt返回x的平方根。
函數(shù)名:rand,srand
原 型: extern int rand(void);
extern void srand(int n);
功 能: rand返回一個(gè)0到32767之間的偽隨機(jī)數(shù)。srand用來(lái)將隨機(jī)數(shù)發(fā)生器初始化成
一個(gè)已知(或期望)值,對(duì)rand的相繼調(diào)用將產(chǎn)生相同序列的隨機(jī)數(shù)。
函數(shù)名: cos,sin,tan
原 型: extern float cos(flaot x);
extern float sin(flaot x);
extern flaot tan(flaot x);
功 能: cos返回x的余弦值。Sin返回x的正弦值。tan返回x的正切值,所有函數(shù)變量
范圍為-π/2~+π/2,變量必須在±65535之間,否則會(huì)產(chǎn)生一個(gè)NaN錯(cuò)誤。
函數(shù)名: 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的反正切值,它們
的值域?yàn)?π/2~+π/2。atan2返回x/y的反正切,其值域?yàn)?π~+π。
函數(shù)名: cosh,sinh,tanh
原 型: extern float cosh(float x);
extern float sinh(float x);
extern float tanh(float x);
功 能: cosh返回x的雙曲余弦值;sinh返回x的雙曲正弦值;tanh返回x的雙曲正切
值。
函數(shù)名: fpsave,fprestore
原 型: extern void fpsave(struct FPBUF *p);
extern void fprestore (struct FPBUF *p);
功 能: fpsave保存浮點(diǎn)子程序的狀態(tài)。fprestore將浮點(diǎn)子程序的狀態(tài)恢復(fù)為其原始狀
態(tài),當(dāng)用中斷程序執(zhí)行浮點(diǎn)運(yùn)算時(shí)這兩個(gè)函數(shù)是有用的。
3.6 ABSACC.H:絕對(duì)地址訪問(wèn)
函數(shù)名: CBYTE,DBYTE,PBYTE,XBYTE
原 型: #define CBYTE((unsigned char *)0x50000L)
#define DBYTE((unsigned char *)0x40000L)
#define PBYTE((unsigned char *)0x30000L)
#define XBYTE((unsigned char *)0x20000L)
功 能:上述宏定義用來(lái)對(duì)8051地址空間作絕對(duì)地址訪問(wèn),因此,可以字節(jié)尋址。CBYTE
尋址CODE區(qū),DBYTE尋址DATA區(qū),PBYTE尋址XDATA區(qū)(通過(guò)MOVX @R0命令),XBYTE尋址XDATA區(qū)(通過(guò)MOVX @DPTR命令)。
例:下列指令在外存區(qū)訪問(wèn)地址0x1000
xval=XBYTE[0x1000];
XBYTE[0X1000]=20;
通過(guò)使用#define指令,用符號(hào)可定義絕對(duì)地址,如符號(hào)X10可與XBYTE[0x1000]地址相等:#define X10 XBYTE[0x1000]。
函數(shù)名: 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。通過(guò)靈活的數(shù)據(jù)類型,
所有地址空間都可以訪問(wèn)。
3.7INTRINS.H:內(nèi)部函數(shù)
函數(shù)名: _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位,該函數(shù)與8051“RLA”指令
相關(guān),上面幾個(gè)函數(shù)不同于參數(shù)類型。
例:
#include
main()
{
unsigned int y;
y=0x00ff;
y=_irol_(y,4);
}
函數(shù)名: _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位,該函數(shù)與8051“RRA”指令
相關(guān),上面幾個(gè)函數(shù)不同于參數(shù)類型。
例:
#include
main()
{
unsigned int y;
y=0x0ff00;
y=_iror_(y,4);
}
函數(shù)名: _nop_
原 型: void _nop_(void);
功能:_nop_產(chǎn)生一個(gè)NOP指令,該函數(shù)可用作C程序的時(shí)間比較。C51編譯器在_nop_函
數(shù)工作期間不產(chǎn)生函數(shù)調(diào)用,即在程序中直接執(zhí)行了NOP指令。
例:
P()=1;
_nop_();
P()=0;
函數(shù)名: _testbit_
原 型:bit _testbit_(bit x);
功能:_testbit_產(chǎn)生一個(gè)JBC指令,該函數(shù)測(cè)試一個(gè)位,當(dāng)置位時(shí)返回1,否則返回0。
如果該位置為1,則將該位復(fù)位為0。8051的JBC指令即用作此目的。 _testbit_只能用于可直接尋址的位;在表達(dá)式中使用是不允許的。
STDARG.H:變量參數(shù)表
C51編譯器允許再入函數(shù)的變量參數(shù)(記號(hào)為“…”)。頭