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.
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. |
See x_arrays.cpp for an example.