PIC单片机的C语言应用下的函数库.doc

PICC库函数 本章将详细列出PICC编译器的库函数。每个函数均从函数名开始，然后按照以下几个标题给出详细解释。 提要：函数的C语言定义以及定义函数的头文件。 描述：对函数及其目的进行叙述性描述。 例程：给出一个能说明该函数的应用例子。 数据类型：列出函数中使用的一些特殊的数据类型（如结构体等）的C语言定义。这些数据类型的定义包含在提要标题下列出的头文件中。 参阅：给出相关联的函数。 返回值： 如果函数有返回值，则在本标题下将给出返回值的类型和性质，同时还包括错误返回的信息。 1 ABS函数 1. 提 要 #include stdlib.h int abs (int j) 2. 描 述 abs( )函数返回变量j的绝对值。 3. 例 程 #include stdio.h #include stdlib.h void main (void) { int a = -5； printf(The absolute value of %d is %d\n，a，abs(a))； } 4. 2 ACOS函数 1. 提 要 #include math.h double acos (double f) 2. 描 述 acos( )函数是cos( ) 的反函数。函数参数在[-1，1]区间内，返回值是一个用弧度表示的角度，而且该返回值的余弦值等于函数参数。 3. 例 程 #include math.h #include stdio.h /*以度为单位，打印[-1，1]区间内的反余弦值*/ void main (void) { float i，a； for(i = -1.0i 1.0；i += 0.1) { a = acos(i)*180.0/3.141592； printf(acos(%f) = %f degrees\n，i，a)； } } sin( )，cos( )，tan( )，asin( )，atan( )，atan2( ) π]。如果函数参数超出区间[-1，1]，则返回值将为0。 3 ASCTIME函数 1. 提 要 #include time.h char * asctime (struct tm * t) 2. 描 述 asctime( )函数通过指针 t 从上struct tm结构体中获得时间，返回描述当前日期和时间的26个字符串，其格式如下： Sun Sep 16 01:03:52 1973\n\0 值得注意的是,在字符串的末尾有换行符。字符串中的每个字长是固定的。以下例程得到当前时间，通过localtime( )函数将其转换成一个struct tm指针，最后转换成ASCII码并打印出来。其中，time( )函数需要用户提供（详情请参阅time( )函数）。 3. 例 程 #include stdio.h #include time.h void main (void) { time_t clock； struct tm * tp； time(clock)； tp = localtime(clock)； printf(%s，asctime(tp))； } 4. 阅 ctime( )，gmtime( )，localtime( )，time( ) 5. 注意：由于编译器不提供time( )例行程序，故在本例程中它需要由用户提供。详情请参照time( )函数。 6. 数据类型 struct tm { int tm_sec； int tm_min； int tm_hour； int tm_mday； int tm_mon； int tm_year； int tm_wday； int tm_yday； int tm_isdst； }； 4 ASIN1. 提 要 #include math.h double asin (double f) 2. 描 述 asin( )函数是sin( )的反函数。它的函数参数在[-1，1]区间内，返回一个用弧度表示的角度值，而且这个返回值的正弦等于函数参数。 3. 例 程 #include math.h #include stdio.h void main (void) { float i，a； for(i = -1.0；i 1.0 ；i += 0.1) { a = asin(i)*180.0/3.141592； printf(asin(%f) = %f degrees\n，i，a)； } } 4. 阅 sin( )，cos( )，tan( )，acos( )，atan( )，atan2( ) 5. π/2，π/2]。如果函数参数的值超出区间[-1，1]，则函数返回值将为0。 5 ATAN函数 1. 提 要 #include math.