◆ GArrayDownload()

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.