原创 44B0X Uart_Printf()

最近在学习44B0X,在看其串口驱动时发现有个Uart_Printf()函数，深入看之，发现不解，惑也！于是查其资料，转发于下，希对同仁有用。

原形：
void Uart_Printf(char *fmt,...) //...表示可变参数（多个可变参数组成一
个列表，后面有专门的指针指向他），不限定个数和类型，
{
va_list ap;//初始化指向可变参数列表的指针
char string[256];

va_start(ap,fmt);//将第一个可变参数的地址付给ap，即ap指向可变参数列
表的开始
vsprintf(string,fmt,ap);//将参数fmt、ap指向的可变参数一起转换成格式
化字符串，放string数组中，其作用同
sprintf（），只是参数类型不同
Uart_SendString(string); //把格式化字符串从开发板串口送出去
va_end(ap); //ap付值为0，没什么实际用处，主要是为程序健壮性
}

（1）格式化字符串

printf（“%s, %-19s: %6.2”,lastname,firstname,prize）;

打印结果：Bechr，Teddy ；2000.00

我们说“ Bechr，Teddy ；2000.00 ”就是一个格式化字符串，pri
ntf的作用就是把（“%s, %-19s: 6.2”,lastname,firstname,prize）翻译成电脑
认识的字符串，而对于“%s, %-19s: 6.2”,lastname,firstname,prize电脑根部不
认识，故需要printf翻译。

（2）vsprintf

函数名: vsprintf
功 能: 送格式化输出串到指定数组中
用 法: int vsprintf(char *string, char *format, va_list param);
程序例:
----------------------------------------------------------------
#include <stdio.h>
#include <conio.h>
#include <stdarg.h>

char buffer[80];

int vspf(char *fmt, ...)
{
va_list argptr;
int cnt;

va_start(argptr, fmt);
cnt = vsprintf(buffer, fmt, argptr);
va_end(argptr);

return(cnt);
}

int main(void)
{
int inumber = 30;
float fnumber = 90.0;
char string[4] = "abc";

vspf("%d %f %s", inumber, fnumber, string);
printf("%s\n", buffer);
return 0;
}
------------------------------------------------------------------------

vsprintf与sprintf功能是一样的，即把格式化字符串输出到指定数组中，
sprintf(char *string, char *farmat [,argument,...])函数的参数从第
二个参数开始与printf是一样的，只是sprintf是输出到指定数组中，
printf是输出到屏幕（一个标准输出文件），因而sprintf多了char *string这参数。

（3）[转]va_start va_arg va_end 的使用和原理

stdarg.h中查到如下宏定义：

typedef int *va_list[1];//va_list 变量类型定义
#define va_start(ap, parmN) (void)(*(ap) = __va_start(parmN))
#define va_arg(ap, type) __va_arg(*(ap), type)//取可变参数的内容
#define va_end(ap) ((void)(*(ap) = 0))

◎用法:
func( Type para1, Type para2, Type para3, ... )
{
/****** Step 1 ******/
va_list ap;
va_start( ap, para3 ); //一定要“...”之前的那个参数

/****** Step 2 ******/
//此时ap指向第一个可变参数
//调用va_arg取得里面的值

Type xx = va_arg( ap, Type );

//Type一定要相同，如:
//char *p = va_arg( ap, char *);
//int i = va_arg( ap, int );

//如果有多个参数继续调用va_arg，ap会自动变化（一般是自增）

/****** Step 3 ******/
va_end(ap); //For robust!
}

◎研究：（此处的宏定义与前面有些差别可能是OS不同，不用管它，只要能帮助我们理解即可）
typedef char * va_list;

#define va_start _crt_va_start
#define va_arg _crt_va_arg
#define va_end _crt_va_end

#define _crt_va_start(ap,v) ( ap = (va_list)_ADDRESSOF(v) + _INTSIZEOF(v) )
#define _crt_va_arg(ap,t) ( *(t *)((ap += _INTSIZEOF(t)) - _INTSIZEOF(t)) )//注意(ap += _INTSIZEOF(t))括号
#define _crt_va_end(ap) ( ap = (va_list)0 )
va_list argptr;
C语言的函数的参数是从右向左压入堆栈的,调用va_start后，
按定义的宏运算，_ADDRESSOF得到v所在的地址，然后这个
地址加上v的大小，则使ap指向第一个可变参数如图:

栈底 高地址
| .......
| 函数返回地址
| .......
| 函数最后一个参数
| ....
| 函数第一个可变参数 <--va_start后ap指向
| 函数最后一个固定参数
| 函数第一个固定参数
栈顶 低地址


然后，用va_arg()取得类型t的可变参数值, 先是让ap指向下一个参数:
ap += _INTSIZEOF(t)，然后在减去_INTSIZEOF(t)，使得表达式结果为
ap之前的值，即当前需要得到的参数的地址，强制转换成指向此参数的
类型的指针，然后用*取值

最后，用va_end(ap)，给ap初始化，保持健壮性。