C 庫 - vsprintf() 函式

---

---

C 庫函式 vsprintf(char *str, const char *format, va_list arg) 使用傳遞給它的引數列表將格式化的輸出傳送到字串。當需要使用在執行時動態建立的引數列表來格式化字串時，此函式非常有用。

語法

以下是 C 庫函式 vsprintf() 的語法：

int vsprintf(char *str, const char *format, va_list arg);

引數

此函式接受三個引數：

• *char str: 指向儲存結果 C 字串的緩衝區的指標。緩衝區必須足夠大，以容納結果字串，包括空終止符。
• *const char format: 包含要寫入字串 str 的文字的 C 字串。它可以包含可選的嵌入式格式說明符，這些說明符將被後續引數列表中指定的值替換。
• va_list arg: 表示可變引數列表的值。這通常使用 va_start 宏初始化，並應傳遞給 vsprintf。

返回值

該函式返回寫入字串 str 的字元總數，不包括空終止符。如果發生錯誤，則函式返回負值。

示例 1：簡單的字串格式化

以下程式碼演示了簡單的字串格式化，其中單個字串引數被格式化為佔位符 %s。

以下是 C 庫 vsprintf() 函式的示例。

#include <stdio.h>
#include <stdarg.h>

void formatString(char *buffer, const char *format, ...) {
    eva_list args;
    va_start(args, format);
    vsprintf(buffer, format, args);
    va_end(args);
}

int main() {
    char buffer[100];
    formatString(buffer, "Hello, %s!", "World");
    printf("%s\n", buffer);
    return 0;
}

輸出

以上程式碼產生以下結果：

Hello, World!

示例 2：多種資料型別

以下程式碼演示了使用適當的格式說明符將多種資料型別（字串、整數和浮點數）格式化到緩衝區中。

#include <stdio.h>
#include <stdarg.h>

void formatString(char *buffer, const char *format, ...) {
   va_list args;
   va_start(args, format);
   vsprintf(buffer, format, args);
   va_end(args);
}

int main() {
   char buffer[100];
   formatString(buffer, "Name: %s, Age: %d, Score: %.2f", "Alice", 30, 95.5);
   printf("%s\n", buffer);
   return 0;
}

輸出

執行以上程式碼後，我們得到以下結果：

Name: Alice, Age: 30, Score: 95.50

示例 3：處理長字串

以下程式碼演示瞭如何處理和格式化長字串，確保緩衝區可以容納整個格式化字串而不會被截斷。

#include <stdio.h>
#include <stdarg.h>

void formatString(char *buffer, const char *format, ...) {
   va_list args;
   va_start(args, format);
   vsprintf(buffer, format, args);
   va_end(args);
}

int main() {
   char buffer[200];
   const char *longString = "This is a very long string that needs to be formatted properly into the buffer.";
   formatString(buffer, "Formatted String: %s", longString);
   printf("%s\n", buffer);
   return 0;
}

輸出

以上程式碼的輸出如下：

Formatted String: This is a very long string that needs to be formatted properly into the buffer.