GArrayUpload()

GCLIB_DLL_EXPORTED GReturn GCALL GArrayUpload	(	GCon	g,
		const GCStringIn	array_name,
		GOption	first,
		GOption	last,
		GOption	delim,
		GBufOut	buffer,
		GSize	buffer_len
	)

Uploads array data from the controller's array table.

Parameters

g	Connection's handle.
array_name	Null-terminated string containing the name of the array to upload.
first	The first element of the array for sub-array uploads. G_BOUNDS to omit.
last	The last element of the array for sub-array uploads. G_BOUNDS to omit.
delim	Sets the delimeter between array elements in the returned data, G_CR specifies carriage return, G_COMMA specifies comma.
buffer	Buffer to receive the uploaded data. The data will be null terminated unless function returns G_BAD_LOST_DATA due to the buffer being too small to hold the data.
buffer_len	The length of the receive buffer.

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_UploadArrayToList(), write_array_to_file(), and x_arrays().