Downloads array data to a pre-dimensioned array in the controller's array table.
- Warning:
- The array must already exist on the controller and be sufficient dimension to hold the desired array data, e.g. via `DM`.
- Parameters:
-
| g | Connection's handle. |
| array_name | Null-terminated string containing the name of the array to download. Must match the array name used in `DM`. |
| first | The first element of the array for sub-array downloads. `G_BOUNDS` to omit. |
| last | The last element of the array for sub-array downloads. `G_BOUNDS` to omit. |
| buffer | Buffer containing the null-terminated data to be sent to the controller. The array data may be separated with *carriage return*, *carriage return + line feed*, or a *comma*. No spaces. |
- Returns:
- The success status or error code of the function. See gclib_errors.h for possible values.
See x_arrays.cpp for an example.
Referenced by H_DownloadArraysFromList().