Update QueryExecute() Examples

docs/03.reference/01.functions/queryexecute/_examples.md

@@ -2,43 +2,53 @@
 # SELECT
 
 ```luceescript+trycf
-    _test = queryNew(
-        "_id, _need, _forWorld",
-        "integer, varchar, varchar",
-        [[01,'plant', 'agri'],[02, 'save','water']]
-    );
-    queryResult = queryExecute(
-        sql = 'SELECT * FROM _test WHERE _need = :need',
-        params = {
-            need: {
-                value: "plant",
-                type: "varchar"
-            }
-        },
-        options = {
-            dbtype = 'query'
+_test = queryNew(
+    "_id, _need, _forWorld",
+    "integer, varchar, varchar",
+    [[01,'plant', 'agri'],[02, 'save','water']]
+);
+queryResult = QueryExecute(
+    sql = "SELECT * FROM _test WHERE _need = :need",
+    params = {
+        need: {
+            value: "plant",
+            type: "varchar"
         }
-    );
-    dump(queryResult);
+    },
+    options = {
+        dbtype = "query"
+    }
+);
+dump(queryResult);
 ```
 
 # INSERT
 
-and returning the generated key in result
-
 ```luceescript
-queryExecute(
-        sql = 'insert into user (name) values (:name)',
-        params = {
-            name: {
-                value: "lucee",
-                type: "varchar"
-            }
-        },
-        options = {
-            dbtype = 'query',
-            result: "insertResult"
+QueryExecute(
+    sql = "insert into user (name) values (:name)",
+    params = {
+        name: {
+            value: "lucee",
+            type: "varchar"
         }
-    );
-    dump( insertResult.generatedKey );
+    },
+    options = {
+        dbtype = "query",
+        // return the autoincrement generated key from database
+        result: "insertResult"
+    }
+);
+dump(insertResult.generatedKey);
+```
+
+Concise alternative with unnamed function arguments and removed optional dbtype:
+
+```luceescript
+QueryExecute(
+    "insert into user (name) values (:name)",
+    {"name": {"value": "lucee", "type": "varchar"}},
+    {"result": "insertResult"}
+);
+dump(insertResult.generatedKey);
 ```

docs/recipes/index.json

@@ -1080,7 +1080,7 @@
     "file": "query-handling.md",
     "title": "Query Execution",
     "path": "/docs/recipes/query-handling.md",
-    "hash": "27a215f080947142d2f2c2a05404e199",
+    "hash": "6c6cd8eb8788c6cb77b3270a2388559d",
     "keywords": [
       "cfquery",
       "queryExecute",

docs/recipes/query-handling.md

@@ -235,16 +235,16 @@ query name="result" datasource="myDB" sql="SELECT * FROM table" params=[];
 
 **Best for:** High-performance applications, legacy codebases, developers who prefer explicit control
 
-### 2. queryExecute - The Modern Alternative
+### 2. QueryExecute - The Modern Alternative
 
 **Syntax:**
 
-```javascript
-result = queryExecute(
-    sql: "SELECT * FROM users WHERE id = ?",
-    params: [123],
-    options: {
-        datasource: "myDB",
+```luceescript
+result = QueryExecute(
+    "SELECT * FROM users WHERE id = :id",
+    {id: {value: 123, type: "integer"}},
+    {
+        datasource: "myDB",  // if not configured globally
         returntype: "query"  // optional
     }
 );