document MwStringPrintIntoBuffer slightly better

examples/basic/calculator.c

@@ -82,7 +82,7 @@ static void activate(MwWidget handle, void* client, void* user) {
 				v = fv / sv;
 			}
 
-			MwPrintIntoBuffer(buf, 256, "%g", v);
+			MwStringPrintIntoBuffer(buf, 256, "%g", v);
 
 			MwVaApply(inp,
 				  MwNtext, buf,

examples/basic/colorpicker.c

@@ -15,7 +15,7 @@ void color_callback(MwWidget handle, void* user_data, void* call_data) {
 	rgb->red &= 0xff;
 	rgb->green &= 0xff;
 	rgb->blue &= 0xff;
-	MwPrintIntoBuffer(hexColor, 8, "#%02X%02X%02X", rgb->red, rgb->green, rgb->blue);
+	MwStringPrintIntoBuffer(hexColor, 8, "#%02X%02X%02X", rgb->red, rgb->green, rgb->blue);
 	MwSetText(window, MwNbackground, hexColor);
 }
 

examples/basic/listbox.c

@@ -16,7 +16,7 @@ void activate(MwWidget handle, void* user, void* call) {
 
 	(void)user;
 
-	MwPrintIntoBuffer(msg, 256, "You pressed: %s", MwListBoxGet(handle, *(int*)call));
+	MwStringPrintIntoBuffer(msg, 256, "You pressed: %s", MwListBoxGet(handle, *(int*)call));
 
 	msgbox = MwMessageBox(wmain, msg, "wow", MwMB_ICONINFO | MwMB_BUTTONOK);
 	MwAddUserHandler(MwMessageBoxGetChild(msgbox, MwMB_BUTTONOK), MwNactivateHandler, destroy, msgbox);
@@ -48,7 +48,7 @@ int main() {
 
 	for(i = 0; i < len; i++) {
 		char sz[16];
-		MwPrintIntoBuffer(sz, 16, "%d", (int)strlen(harvard[i]));
+		MwStringPrintIntoBuffer(sz, 16, "%d", (int)strlen(harvard[i]));
 		index = MwListBoxPacketInsert(packet, -1);
 		MwListBoxPacketSetIcon(packet, index, px);
 		MwListBoxPacketSet(packet, index, 0, harvard[i]);

examples/basic/treeview.c

@@ -14,7 +14,7 @@ void activate(MwWidget handle, void* user, void* call) {
 
 	(void)user;
 
-	MwPrintIntoBuffer(msg, 256, "You pressed: %s", MwTreeViewGet(handle, call));
+	MwStringPrintIntoBuffer(msg, 256, "You pressed: %s", MwTreeViewGet(handle, call));
 
 	msgbox = MwMessageBox(wmain, msg, "wow", MwMB_ICONINFO | MwMB_BUTTONOK);
 	MwAddUserHandler(MwMessageBoxGetChild(msgbox, MwMB_BUTTONOK), MwNactivateHandler, destroy, msgbox);

examples/gldemos/clock.c

@@ -32,10 +32,10 @@ void tick(MwWidget handle, void* user, void* call) {
 		char buf[512];
 		tm = localtime(&t);
 
-		MwPrintIntoBuffer(buf, 512, "%s %02d %s", mon[tm->tm_mon], tm->tm_mday, wday[tm->tm_wday]);
+		MwStringPrintIntoBuffer(buf, 512, "%s %02d %s", mon[tm->tm_mon], tm->tm_mday, wday[tm->tm_wday]);
 		MwSetText(ldate, MwNtext, buf);
 
-		MwPrintIntoBuffer(buf, 512, "%02d:%02d %s", tm->tm_hour % 12, tm->tm_min, tm->tm_hour >= 12 ? "PM" : "AM");
+		MwStringPrintIntoBuffer(buf, 512, "%02d:%02d %s", tm->tm_hour % 12, tm->tm_min, tm->tm_hour >= 12 ? "PM" : "AM");
 		MwSetText(ltime, MwNtext, buf);
 
 		render = 1;

examples/vkdemos/vulkan.c

@@ -17,7 +17,7 @@
 char buffer[512];
 
 char* string_VkResult(VkResult res) {
-	MwPrintIntoBuffer(buffer, 512, "%d", res);
+	MwStringPrintIntoBuffer(buffer, 512, "%d", res);
 
 	return &buffer[0];
 }

include/Mw/String.h

@@ -42,11 +42,12 @@ MWDECL void MwStringSize(char* out, MwOffset size);
 MWDECL void MwStringTime(char* out, time_t t);
 
 /*!
- * @brief Prints up to n characters into a buffer
+ * @brief Prints up to n characters into a bufferMwStringPrintIntoBuffer.
+ * @note On compilers that support C99, this uses vsnprintf to safely print into a buffer; on compilers that don't, vsprintf is used.
  * @param out Buffer
  * @param size Max size
  */
-MWDECL void MwPrintIntoBuffer(char* out, MwU32 size, const char* fmt, ...);
+MWDECL void MwStringPrintIntoBuffer(char* out, MwU32 size, const char* fmt, ...);
 
 #ifdef __cplusplus
 }

src/dialog/colorpicker.c

@@ -173,13 +173,13 @@ static void color_picker_click(MwWidget handle, void* user, void* call) {
 	picker->chosen_color.green = picker->color_picker_image_data[i + 1];
 	picker->chosen_color.blue  = picker->color_picker_image_data[i + 2];
 
-	MwPrintIntoBuffer(hexColor, 8, "#%02X%02X%02X", picker->chosen_color.red & 0xff, picker->chosen_color.green & 0xff, picker->chosen_color.blue & 0xff);
+	MwStringPrintIntoBuffer(hexColor, 8, "#%02X%02X%02X", picker->chosen_color.red & 0xff, picker->chosen_color.green & 0xff, picker->chosen_color.blue & 0xff);
 
 	fr = picker->chosen_color.red > 128 ? 0 : 255;
 	fg = picker->chosen_color.green > 128 ? 0 : 255;
 	fb = picker->chosen_color.blue > 128 ? 0 : 255;
 
-	MwPrintIntoBuffer(fgColor, 8, "#%02X%02X%02X", fr, fg, fb);
+	MwStringPrintIntoBuffer(fgColor, 8, "#%02X%02X%02X", fr, fg, fb);
 	MwSetText(picker->color_display_text, MwNforeground, fgColor);
 
 	MwSetText(picker->color_display_text, MwNbackground, hexColor);
@@ -247,7 +247,7 @@ static void color_display_text_change(MwWidget handle, void* user,
 	fg = color->common.green > 128 ? 0 : 255;
 	fb = color->common.blue > 128 ? 0 : 255;
 
-	MwPrintIntoBuffer(fgColor, 9, "#%02X%02X%02X", fr, fg, fb);
+	MwStringPrintIntoBuffer(fgColor, 9, "#%02X%02X%02X", fr, fg, fb);
 	MwSetText(picker->color_display_text, MwNforeground, fgColor);
 
 	MwSetText(picker->color_display_text, MwNbackground, hexColor);

src/string.c

@@ -37,7 +37,7 @@ void MwStringTime(char* out, time_t t) {
 		sprintf(out, "%s %2d %02d:%02d %d", months[tm->tm_mon], tm->tm_mday, tm->tm_hour, tm->tm_min, 1900 + tm->tm_year);
 	}
 }
-void MwPrintIntoBuffer(char* out, MwU32 size, const char* fmt, ...) {
+void MwStringPrintIntoBuffer(char* out, MwU32 size, const char* fmt, ...) {
 	va_list va;
 	va_start(va, fmt);
 

src/widget/numberentry.c

@@ -103,9 +103,9 @@ static void mouse_up(MwWidget handle, void* ptr) {
 	if(e->mouse.x >= (w - e->right)) {
 		char s[512];
 		if(e->mouse.y >= (h / 2)) {
-			MwPrintIntoBuffer(s, 512, "%g", atof(str) - 1);
+			MwStringPrintIntoBuffer(s, 512, "%g", atof(str) - 1);
 		} else {
-			MwPrintIntoBuffer(s, 512, "%g", atof(str) + 1);
+			MwStringPrintIntoBuffer(s, 512, "%g", atof(str) + 1);
 		}
 		MwSetText(handle, MwNtext, s);
 	}

src/widget/vulkan.c

@@ -521,7 +521,7 @@ static void* mwVulkanGetFieldImpl(MwWidget handle, MwVulkanField field, MwErrorE
 	case MwVulkanField_PresentQueue:
 		return o->vkPresentQueue;
 	default:
-		MwPrintIntoBuffer(buf, 1024, "Unknown vulkan field request (%d given)", field);
+		MwStringPrintIntoBuffer(buf, 1024, "Unknown vulkan field request (%d given)", field);
 		MwDispatchError(1, buf);
 		if(out != NULL) {
 			*out = 1;