C语言-自定义格式化输出

va_start和va_end详解
宏定义中的特殊参数(#、##、…和__VA_ARGS__)
下面是 <stdarg.h> 里面重要的几个宏定义如下：

typedef char* va_list;
void va_start ( va_list ap, prev_param ); /* ANSI version */
type va_arg ( va_list ap, type ); 
void va_end ( va_list ap ); 

说明：

1）va_list：一个字符指针，可以理解为指向当前参数的一个指针，取参必须通过这个指针进行。

2）va_start：对ap进行初始化，让ap指向可变参数表里面的第一个参数。第一个参数是 ap 本身，第二个参数是在变参表前面紧挨着的一个变量，即“...”之前的那个参数；

3）va_arg: 获取参数。它的第一个参数是ap，第二个参数是要获取的参数的指定类型。按照指定类型获取当前参数，返回这个指定类型的值，然后把 ap 的位置指向变参表中下一个变量的位置；

4）va_end：释放指针，将输入的参数 ap 置为 NULL。通常va_start和va_end是成对出现。 

使用上面的宏获取参数的步骤如下：

<Step 1> 定义一个 va_list 类型的变量，(假设va_list 类型变量被定义为ap)；
<Step 2> 调用va_start ，对ap 进行初始化，让它指向可变参数表里面的第一个参数。 
<Step 3> 获取参数，并使用参数。
<Step 4> 获取所有的参数之后，将 ap 指针关掉。

#define MY_DEBUG_LOG(terminal,channel,...) do {\
                                               SEGGER_RTT_SetTerminal(terminal);\
                                               SEGGER_RTT_printf(channel,"[%04d-%02d-%02d %02d:%02d:%02d] ",RTC_date_time_now.year,RTC_date_time_now.month,RTC_date_time_now.day,RTC_date_time_now.hour,RTC_date_time_now.minute,RTC_date_time_now.millisecond/1000);\
                                               SEGGER_RTT_printf(channel,__VA_ARGS__);} while(0)
/**
  * @brief  将数据写入到basic_data_rw_buff缓存
  * @note   如果超出缓存，则将缓存数据写入SD卡后，再将数据写入到缓存
  * @param  file 要写入的文件
  * @param  format 格式化参数
  * @param  ... 参数
  * @retval None
  */
static inline FRESULT print_data_to_buff(FIL *file, char *format, ...)
{
  uint16_t print_byte = 0;
  UINT bw;
  FRESULT f_res = FR_OK;
  va_list argp;
  basic_data_file_para.byte_to_use = BASIC_DATA_RW_BUFF_SIZE - basic_data_file_para.wrtie_byte_cnt;
  va_start(argp, format);
  print_byte = vsnprintf((char *)&basic_data_rw_buff[basic_data_file_para.wrtie_byte_cnt], basic_data_file_para.byte_to_use, format, argp);

  /* 超出写入缓存 */
  if (basic_data_file_para.byte_to_use < print_byte)
  {
    log_i("print_data_to_buff 超出缓存！");
    /* 存储数据 */
    f_res = f_write(file, &basic_data_rw_buff, basic_data_file_para.wrtie_byte_cnt, &bw);
    /* 重新将数据写入缓存 */
    basic_data_file_para.wrtie_byte_cnt = 0;
    basic_data_file_para.byte_to_use = BASIC_DATA_RW_BUFF_SIZE - basic_data_file_para.wrtie_byte_cnt;
    print_byte = vsnprintf((char *)&basic_data_rw_buff[basic_data_file_para.wrtie_byte_cnt], basic_data_file_para.byte_to_use, format, argp);
    basic_data_file_para.wrtie_byte_cnt += print_byte;
  }
  else
  {
    basic_data_file_para.wrtie_byte_cnt += print_byte;
  }

  va_end(argp);
  return f_res;
}