(const char *format, ...) 可变参数在文本日志中的巧妙使用

1. va_list是C语言中的一个数据类型，用于处理可变参数列表。它通常与stdarg.h头文件一起使用，该头文件提供了一组宏和函数来处理可变参数。

va_list类型用于存储一系列类型未知的参数，这些参数可以是任意类型，包括整数、浮点数、字符和指针等。它是一个结构体类型，通常在实现可变参数函数时定义。

使用va_list和相关的宏，可以实现在函数调用时动态地指定参数的数量和类型。这使得函数能够接受可变数量的参数，并且能够处理不同类型的参数。这种机制使得在函数定义时无需预先指定参数的类型和数量，提供了更大的灵活性和便利性。

2. va_start的实现方式是依赖于具体的编译器和平台的。在大多数情况下，va_start的实现是编译器相关的，并依赖于平台上的寄存器或者其他机制来传递参数。

在大多数情况下，编译器会将可变参数列表存储在内存中的某个位置，然后使用特定的寄存器或者指针来引用该位置。va_start的作用就是初始化这个寄存器或者指针，以便后续的va_arg宏可以正确地获取参数。

具体来说，va_start会执行以下操作：

1. 确定可变参数列表的起始位置。这个位置通常是由函数调用约定确定的，例如在C语言中，可变参数列表通常存储在栈帧中的某个特定位置。
2. 初始化一个va_list类型的变量，该变量用于存储参数列表的当前位置。这个变量通常是一个结构体或者一组寄存器，具体取决于编译器和平台。
3. 设置参数列表的初始位置，以便后续的va_arg宏可以正确地获取参数。这通常涉及到将参数列表的起始位置和当前位置信息存储到va_list类型的变量中。

一旦va_start被调用，就可以使用va_arg宏从参数列表中获取参数，直到所有参数都被获取完毕。最后，需要调用va_end宏来清理参数列表相关的资源。

3. va_arg() 用于从可变参数列表中获取一个参数。va_arg() 宏接受两个参数：va_list 类型的变量和一个类型。它会将可变参数列表中的下一个参数转换为一个指向给定类型的指针，并返回该指针的值。例：

void print_numbers(int n, ...) {  
    va_list args;  
    va_start(args, n);  
  
    for (int i = 0; i < n; i++) {  
        int value = va_arg(args, int);  
        printf("%d ", value);  
    }  
  
    va_end(args);  
}  

4. va_end()是一个宏，用于清理使用va_start()宏开始的可变参数列表。例如在函数接受可变数量的参数时，需要使用va_start()宏来开始参数列表，然后使用va_arg()宏来获取参数。一旦处理完所有参数，应该使用va_end()宏来清理参数列表。

va_end()宏会释放由va_start()宏分配的内存，并确保参数列表正确终止。如果不调用va_end()宏，可能会导致内存泄漏或其他问题。

5. 通过可变参数函数我们可以实现类似于printf函数的日志上报函数：

/// @brief 添加带数据的日志内容
/// @param format
/// @param
void model_log_add_data(const char *format, ...)
{
	// return_if_fail(stModel_log_page.inited == 1);
	OS_ERR err;
	OSMutexPend(&stModel_log_page.mutex, 0, OS_OPT_PEND_BLOCKING, NULL, &err);

	va_list args;
	va_start(args, format);

	static char buffer[256];
	vsnprintf(buffer, sizeof(buffer), format, args);
	buffer[sizeof(buffer) - 1] = '\0';
	int len = strlen(buffer);

	return_if_fail(len < MODEL_LOG_DATA_LEN);

	if (stModel_log_page.len + len > MODEL_LOG_DATA_LEN)
	{
		model_log_report();
		model_log_data_init();
	}

	strcat(stModel_log_page.data, buffer);
	// printf("%s\r\n", stModel_log_page.data);
	stModel_log_page.len += len;

	va_end(args);

	OSMutexPost(&stModel_log_page.mutex, OS_OPT_PEND_BLOCKING, &err);
}