| gclib 386 Communications API for Galil controllers and PLCs |

All Data Structures Files Functions Variables Typedefs Macros Pages

GCLIB_DLL_EXPORTED GReturn GCALL GArrayDownload | ( | GCon | g,
|  | const GCStringIn | array_name,
|  | GOption | first,
|  | GOption | last,
|  | GCStringIn | buffer
| ) |  |

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().