feat: format support for webui_run and webui_script

Author: konakona418

include/webui.h

@@ -1029,6 +1029,18 @@ WEBUI_EXPORT bool webui_set_tls_certificate(const char* certificate_pem, const c
  */
 WEBUI_EXPORT void webui_run(size_t window, const char* script);
 
+/**
+ * @brief Run formatted JavaScript without waiting for the response. All clients.
+ *
+ * @param window The window number
+ * @param format The JavaScript format to be run
+ *
+ * @warning This function DOES NOT handle escape characters, proceed with caution.
+ *
+ * @example webui_run_fmt(myWindow, "alert('Hello %s');", "World");
+ */
+WEBUI_EXPORT void webui_run_fmt(size_t window, const char* format, ...);
+
 /**
  * @brief Run JavaScript without waiting for the response. Single client.
  *
@@ -1056,6 +1068,26 @@ WEBUI_EXPORT void webui_run_client(webui_event_t* e, const char* script);
 WEBUI_EXPORT bool webui_script(size_t window, const char* script, size_t timeout,
     char* buffer, size_t buffer_length);
 
+/**
+ * @brief Run formatted JavaScript and get the response back. Work only in single client mode.
+ * Make sure your local buffer can hold the response.
+ *
+ * @param window The window number
+ * @param timeout The execution timeout in seconds
+ * @param buffer The local buffer to hold the response
+ * @param buffer_length The local buffer size
+ * @param format The JavaScript format to be run
+ *
+ * @return Returns True if there is no execution error
+ *
+ * @warning This function DOES NOT handle escape characters, proceed with caution.
+ *
+ * @example bool err = webui_script_fmt(myWindow, 0, myBuffer, myBufferSize,
+ *     "return %d + %d;", 4, 6);
+ */
+WEBUI_EXPORT bool webui_script_fmt(size_t window, size_t timeout,
+    char* buffer, size_t buffer_length, const char* format, ...);
+
 /**
  * @brief Run JavaScript and get the response back. Single client.
  * Make sure your local buffer can hold the response.

include/webui.hpp

@@ -398,12 +398,27 @@ namespace webui {
             webui_run(webui_window, script.data());
         }
 
+        // Quickly run a JavaScript from a formatted string (no response waiting).
+        // Note that this function **DOES NOT** handle escape characters
+        template<typename... Args>
+        void run_fmt(const std::string_view fmt, Args... args) const {
+            webui_run_fmt(webui_window, fmt.data(), args...);
+        }
+
         // Run a JavaScript, and get the response back (Make sure your local buffer can hold the response).
         bool script(const std::string_view script, unsigned int timeout,
                     char* buffer, size_t buffer_length) const {
             return webui_script(webui_window, script.data(), timeout, buffer, buffer_length);
         }
 
+        // Run a JavaScript with formatting, and get the response back (Make sure your local buffer can hold the response).
+        // Note that this function **DOES NOT** handle escape characters
+        template <typename... Args>
+        bool script_fmt(unsigned int timeout, char* buffer, size_t buffer_length,
+                        const std::string_view fmt, Args... args) const {
+            return webui_script_fmt(webui_window, timeout, buffer, buffer_length, fmt.data(), args...);
+        }
+
         // Chose between Deno and Nodejs runtime for .js and .ts files.
         void set_runtime(unsigned int runtime) const {
             webui_set_runtime(webui_window, runtime);

src/webui.c

@@ -847,6 +847,31 @@ void webui_run(size_t window, const char* script) {
     _webui_send_all(win, 0, WEBUI_CMD_JS_QUICK, script, js_len);
 }
 
+void webui_run_fmt(size_t window, const char* fmt, ...) {
+    int len;
+    char* buf;
+
+    // Precalculate actual string length
+    va_list args;
+    va_start(args, fmt);
+    len = vsnprintf(NULL, 0, fmt, args);
+    va_end(args);
+
+    if (len < 1) return;
+
+    buf = (char*)_webui_malloc(len + 1);
+    if (buf == NULL) return;
+
+    // Format and execute
+    va_start(args, fmt);
+    vsnprintf(buf, len + 1, fmt, args);
+    va_end(args);
+
+    webui_run(window, buf);
+
+    _webui_free_mem((void*)buf);
+}
+
 void webui_set_close_handler_wv(size_t window, bool(*close_handler)(size_t window)) {
 
     // Initialization
@@ -1065,6 +1090,36 @@ bool webui_script(size_t window, const char* script, size_t timeout,
     return webui_script_client(&e, script, timeout, buffer, buffer_length);
 }
 
+bool webui_script_fmt(
+    size_t window, size_t timeout,
+    char* buffer, size_t buffer_length, 
+    const char* fmt, ...) {
+    int len;
+    char* buf;
+
+    // Precalculate actual string length
+    va_list args;
+    va_start(args, fmt);
+    len = vsnprintf(NULL, 0, fmt, args);
+    va_end(args);
+
+    if (len < 1) return false;
+
+    buf = (char*)_webui_malloc(len + 1);
+    if (buf == NULL) return false;
+
+    // Format and execute
+    va_start(args, fmt);
+    vsnprintf(buf, len + 1, fmt, args);
+    va_end(args);
+
+    bool status = webui_script(window, buf, timeout, buffer, buffer_length);
+
+    _webui_free_mem((void*)buf);
+
+    return status;
+}
+
 static uint32_t _webui_generate_random_uint32() {
     uint32_t timestamp = (uint32_t) time(NULL);
     // Get the higher 16 bits