技术支持
新闻资讯
技术支持
首页 > 技术支持 > 技术支持

C51 库函数(转)

发布时间:2012.05.16
转载自 09rtwang
最终编辑 lcdbbs
C-51软件包的库包含标准的应用程序,每个函数都在相应的头文件(.h)中有原型声明。如果使用库函数,必须在源程序中用预编译指令定义与该函数相关的头文件(包含了该函数的原型声明)。例如:
#include
#include
如果省掉头文件,编译器则期望标准的C参数类型,从而不能保证函数的正确执行。
3.1 CTYPE.H:字符函数
在CTYPE.H头文件中包含下列一些库函数:

函数名: isalpha
原 型: extern bit isalpha(char)
功 能: isalpha检查传入的字符是否在‘A’-‘Z’和‘a’-‘z’之间,如果为真返回
值为1,否则为0。

函数名: isalnum
原 型: extern bit isalnum(char)
功 能: isalnum检查字符是否位于‘A’-‘Z’,‘a’-‘z’或‘0’-‘9’之间,为真返
回值是1,否则为0。

函数名: iscntrl
原 型: extern bit iscntrl(char)
功 能: iscntrl检查字符是否位于0x00~0x1F之间或0x7F,为真返回值是1,否则为0。

函数名: isdigit
原 型: extern bit isdigit(char)
功 能: isdigit检查字符是否在‘0’-‘9’之间,为真返回值是1,否则为0。

函数名: isgraph
原 型: extern bit isgraph(char)
功 能: isgraph检查变量是否为可打印字符,可打印字符的值域为0x21~0x7E。若为可
打印,返回值为1,否则为0。

函数名: isprint
原 型: extern bit isprint(char)
功 能:除与isgraph相同外,还接受空格字符(0X20)。

函数名: ispunct
原 型: extern bit ispunct(char)
功 能: ispunct检查字符是否位为标点或空格。如果该字符是个空格或32个标点和格式
字符之一(假定使用ASCII字符集中128个标准字符),则返回1,否则返回0。Ispunct对下列字符返回1:
(空格)!“$%^&()+,-./:<=>?_[‘~{
}


函数名: islower
原 型: extern bit islower(char)
功 能: islower检查字符变量是否位于‘a’-‘z’之间,为真返回值是1,否则为0。

函数名: isupper
原 型: extern bit isupper(char)
功 能: isupper检查字符变量是否位于‘A’-‘Z’之间,为真返回值是1,否则为0。

函数名: isspace
原 型: extern bit isspace(char)
功 能: isspace检查字符变量是否为下列之一:空格、制表符、回车、换行、垂直制表
符和送纸。为真返回值是1,否则为0。

函数名: isxdigit
原 型: extern bit isxdigit(char)
功 能: isxdigit检查字符变量是否位于‘0’-‘9’,‘A’-‘F’或‘a’-‘f’之间,
为真返回值是1,否则为0。

函数名: toascii
原 型: toascii(c)((c)&0x7F);
功 能:该宏将任何整型值缩小到有效的ASCII范围内,它将变量和0x7F相与从而去掉低
7位以上所有数位。

函数名: toint
原 型: extern char toint(char)
功 能: toint将ASCII字符转换为16进制,返回值0到9由ASCII字符‘0’到‘9’得
到,10到15由ASCII字符‘a’-‘f’(与大小写无关)得到。
函数名: tolower
原 型: extern char tolower(char)
功 能: tolower将字符转换为小写形式,如果字符变量不在‘A’-‘Z’之间,则不作转
换,返回该字符。

函数名: _tolower
原 型: tolower(c);(c-‘A’+‘a’)
功 能:该宏将0x20参量值逐位相或。

函数名: toupper
原 型: extern char toupper(char)
功 能: toupper将字符转换为大写形式,如果字符变量不在‘a’-‘z’之间,则不作转
换,返回该字符。

函数名: _toupper
原 型: _toupper(c);((c)-‘a’+’A’)
功 能: _toupper宏将c与0xDF逐位相与。

3.2 STDIO.H:一般I/O函数
C51编译器包含字符I/O函数,它们通过处理器的串行接口操作,为支持其它I/O机制,只需修改getkey()和putchar()函数,其它所有I/O支持函数依赖这两个模块,不需要改动。在使用8051串行口之前,必须将它们初始化,下例以2400波特率,12MHz初始化串口:
SCON=0x52
TMOD=0x20
TR1=1
TH1=0Xf3
其它工作模式和波特率等细节问题可以从8051用户手册中得到。

函数名: _getkey
原 型: extern char _getkey();
功 能: _getkey()从8051串口读入一个字符,然后等待字符输入,这个函数是改变整个
输入端口机制应作修改的唯一一个函数。

函数名: getchar
原 型: extern char _getchar();
功 能: getchar()使用_getkey从串口读入字符,除了读入的字符马上传给putchar函数
以作响应外,与_getkey相同。

函数名: gets
原 型: extern char *gets(char *s,int n);
功 能:该函数通过getchar从控制台设备读入一个字符送入由‘s’指向的数据组。考
虑到ANSI标准的建议,限制每次调用时能读入的最大字符数,函数提供了一个字符计数器‘n’,在所有情况下,当检测到换行符时,放弃字符输入。

函数名: ungetchar
原 型: extern char ungetchar(char);
功 能: ungetchar将输入字符推回输入缓冲区,因此下次gets或getchar可用该字符。
ungetchar成功时返回‘char’,失败时返回EOF,不可能用ungetchar处理多个字符。

函数名: _ungetchar
原 型: extern char _ungetchar(char);
功 能: _ungetchar将传入字符送回输入缓冲区并将其值返回给调用者,下次使用getkey
时可获得该字符,写回多个字符是不可能的。

函数名: putchar
原 型: extern putchar(char);
功 能: putchar通过8051串口输出‘char’,和函数getkey一样,putchar是改变整个
输出机制所需修改的唯一一个函数。

函数名: printf
原 型: extern int printf(const char*,…);
功 能: printf以一定格式通过8051串口输出数值和串,返回值为实际输出的字符数,
参量可以是指针、字符或数值,第一个参量是格式串指针。
注:允许作为printf参量的总字节数由C51库限制,因为8051结构上存贮空间有限,在SMALL和COMPACT模式下,最大可传递15个字节的参数(即5个指针,或1个指针和3个长字节),在LARGE模式下,至多可传递40个字节的参数。格式控制串包含下列域(方括号内的域是可能的):
%[flags][width][.precision]type
“width”域定义了参量欲显示的字符数,它必须是一个十进制数,如果实际显示的字符数小于“width”,输出左端补以空格,如果“width”域以0开始,则左端补0。
“flag”域用来定义下面选项:

Falg
意 义
-
输出左齐
+
输出值如果是有符号数值,则加上+/-号
‘ ‘(空格)
输出值如果为正则左边补以空格显示
#
如果它与0,x或X联用,则在输出前加上字符0、0x,0X。当与值类型g、G、f、e、E联用时,‘#’使输出数产生一个十进制小数点。
b,B
它们与格式类型d、i、o、u、x、X联用,这样参量类型被接受为‘[unsigned]char’,如:%bu,%bd或%bx。
L,L
它们与格式类型d、i、o、u、x、X联用,这样参量类型被接受为‘[unsigned]long’,如:%lu,%ld或%lx。
*
下一个参量不作输出。




“type“域定义参量如下类型:

字 符
类 型
输 出 格 式
d
int
有符号十进制数(16位)
U
int
无符号十进制数
o
int
无符号八进制数
X,x
int
无符号十六进制数
f
float
[-]dddd.dddd形式的浮点数
e,E
float
[-]d.ddddE[sign]dd形式的浮点数
g,G
float
e或f形式浮点数,看哪一种输出形式好。
c
char
字符
s
pointer
指向一个带结束符号的串
p
pointer
带存贮器指示符和偏移的指针。M:aaaa。
M:=C(ode),D(ata),I(data),P(data) aaaa:指针偏移值。




例子:
printf(“Int-Val%d,Char-Val%bd,Long-Val%d”,I,c,l);
printf(“String%s,Character%c”,array,character);
printf(“Pointer%p”,&array[10]);

函数名: sprintf
原 型: extern int sprintf(char *s,const char*,…);
功 能: sprintf与printf相似,但输出不显示在控制台上,而是通过一个指针S,送入
可寻址的缓冲区。
注:sprintf允许输出的参量总字节数与printf完全相同。

函数名: puts
原 型: extern int puts(const char*,…);
功 能: puts将串‘s’和换行符写入控制台设备,错误时返回EOF,否则返回一非负数。

函数名: scanf
原 型: extern int scanf(const char*,…);
功 能: scanf在格式串控制下,利用getcha函数由控制台读入数据,每遇到一个值(符
号格式串规定),就将它按顺序赋给每个参量,注意每个参量必须都是指针。scanf返回它所发现并转换的输入项数。若遇到错误返回EOF。格式串包括:
l 空格、制表符等,这些空白字符被忽略。
l 字符,除需匹配的“%”(格式控制字符)外。
l 转换指定字符“%”,后随几个可选字符;赋值抑制符“*”,一个指定最大域宽的数。
注:scanf参量允许的总字节数与printf相同,格式控制串可包括下列域(方括号内是可选的):
%[flags][width]type
格式串总是以百分号开始,每个域包含一个或多个字符或数。
“width”域定义了参量可接受的字符数,“width”必须是一个正十进制数。如果实际输入字符数量小于“width”,则不会进行填充。
‘flag’域用来定义下面选项:

Flag
意 义
*
输入被忽略
b,h
它们用作格式类型d,i,o,u和x的前缀,用这些变量可定义参量是字符指针还是无符号字符指针。如%bu,%bd,%bx。
L
它们被作格式类型d,i,o,u和x的前缀,使用这个前缀可定义参量是长指针还是无符号字长指针。如%lu,%ld,%lx。




“type”域定义参量为如下类型:

描 述 符
类 型
输 入 格 式
d
ptr to int
有符号十进制数(16位)
i
ptr to int
如C中记号一样,整型值
u
ptr to int
无符号十进制数
o
ptr to int
无符号八进制数
x
ptr to int
无符号十六进制数
f,e,g
ptr to float
浮点数
c
ptr to char
一个字符
s
ptr to string
一个字串



例子:
scanf(“%d%bd%ld”,&i,&c,&l);
scanf(“%f”,&f);
scanf(“%3s,%c”,&string[0],&character);

函数名: sscanf
原 型: extern int sscanf(const *s,const char*,…);
功 能: sscanf与scanf方式相似,但串输入不是通过控制台,而是通过另一个以空结束
的指针。
注:sscanf参量允许的总字节数由C-51库限制,这是因为8051处理器结构内存的限制,在SMALL和COMPACT模式,最大允许15字节参数(即至多5个指针,或2个指针,2个长整型或1个字符型)的传递。在LARGE模式下,最大允许传送40个字节的参数。

 


版权所有 Copyright(C)2011  深圳市华之晶科技有限公司