_snprintf_s系列備忘

微軟的_snprintf_s總是記不清n的作用。現整理如下。

_snprintf_s有兩個版本。一個是帶參數模板的，使用於數組，另一個需要指明可操作空間的，適用於堆區變量或數組。

在debug模式下，它還會將'\0'之後至n爲止的區域設爲-2，以提醒程序員不要把n設定超界。

#include <cstdio>
#include <cstring>
#include <cstdlib>
#include <cassert>

#define LEN 8

int main() {
	const char *srcShort = "01234";
	const char *srcLong = "0123456789";
//數組版本
	char des1[LEN];
	{
		memset(des1, 0, LEN);
		_snprintf_s(des1, LEN - 1, "%s", srcLong);//src若太長則會被截斷
		assert(!memcmp(des1, srcLong, LEN - 1) && des1[LEN - 1] == '\0');
	}
	{
		memset(des1, 0, LEN);
		_snprintf_s(des1, strlen(srcShort), "%s", srcShort);//若strlen(srcShort)>LEN-1則會崩潰
		assert(!memcmp(des1, srcShort, strlen(srcShort) + 1) && des1[LEN - 1] == -2);//des1的'\0'後面，都會變爲-2.Release版則無此效果
	}
//堆區版本
	char *des2 = static_cast<char*>(malloc(LEN));
	{
		memset(des2, 0, LEN);
		_snprintf_s(des2, LEN, LEN - 1, "%s", srcLong);//src若太長則會被截斷
		assert(!memcmp(des2, srcLong, LEN - 1) && des2[LEN - 1] == '\0');
	}
	{
		memset(des2, 0, LEN);
		_snprintf_s(des2, LEN, strlen(srcShort), "%s", srcShort);//若strlen(srcShort)>LEN-1則會崩潰
		assert(!memcmp(des2, srcShort, strlen(srcShort) + 1) && des2[LEN - 1] == -2);//des1的'\0'後面，都會變爲-2.Release版則無此效果
	}
	free(des2);
//swprintf_s注意n要設置爲字符數而非字節數
	wchar_t *des3 = static_cast<wchar_t*>(malloc(LEN * 2));//字符數爲LEN，字節數爲LEN*2
	{
		memset(des3, 0, LEN * 2);
		swprintf_s(des3, LEN, L"%ls", L"0");//正確寫法，可修改的字符數爲LEN（含L'\0'），若超出則崩潰
		free(des3);
	}
	{
		des3 = static_cast<wchar_t*>(malloc(LEN * 2));
		memset(des3, 0, LEN * 2);
		swprintf_s(des3, LEN * 2, L"%ls", L"0");//錯誤寫法，debug版會將des3的L'\0'後的所有字節變爲65278,free時會告警
		assert(des3[LEN] == 65278);
		free(des3);//告警了
	}
	return 0;
}