test(client-go): strengthen WriteArrayElements assertions and add README example

2026-06-18 03:12:57 -04:00
parent 437d29f19e
commit 474b7bd0ff
2 changed files with 39 additions and 2 deletions
@@ -153,6 +153,20 @@ integer `0`, float `0.0`, string `""`, time = Unix epoch). This is a **RESET**
 of unmentioned indices, not a preserve of existing values. Use the full-array
 form (read-modify-write) when existing element values must be preserved.

+```go
+// Set element [3] of a 10-element float array; all other indices reset to 0.0.
+err = session.WriteArrayElements(
+    ctx,
+    serverHandle, itemHandle,
+    mxgateway.DataTypeFloat,
+    10, // totalLength
+    map[uint32]*mxgateway.MxValue{
+        3: mxgateway.FloatValue(1.5),
+    },
+    userID,
+)
+```
+
 `AddItem` (and `AddItem2`) now auto-normalize a bare attribute name to the `[]`
 array address form expected by MXAccess, so callers do not need to append `[]`
 themselves. Both forms are accepted; duplicates are deduplicated by the gateway.