Newport XPS-D - Gatheringdataget

XPS Unified Programmer’s Manual
7.2.1.42 GatheringDataGet
Name
GatheringDataGet – Reads one data line from the current gathering buffer.
Input tests
- Refer to section 7.1: “Input Tests Common to all XPS Functions”.
- Checks index number: (-17)
• IndexPoint ≥ 0.
• IndexPoint <currently gathered data number.
- Checks gathering state: (-32)
Description
This function reads a line of data from the current gathering buffer. The buffer line
number is defined by the index of an acquired point.
The separator is “;” in the returned data line.
Gathering must be configured in order to use this function, otherwise (-32) error is
returned.
Prototype
int GatheringDataGet(int SocketID, int IndexPoint, char * DataBufferLine)
Input parameters
SocketID int Socket identifier gets by the
“TCP_ConnectToServer” function.
IndexPoint int Index of an acquired data from the current
gathering buffer.
Output parameters
DataBufferLine char * String contains values from the current buffer at
the selected index.
Return (In addition to the results of “Input Tests Common to all XPS
Functions”)
• 0: No error.
• -32: Gathering not configured.
EDH0373En1023 — 01/18 88