GpCnvCvdArray

$image\BLTLRGSQ.gif$ Boards that Support the Function $image\SETUP.gif$ $image\SANBTN.gif$

$image\head10.gif$ Operation 8-bytes binary data(IEEE format) is changed into double(Double) value, and stored for the array.

$image\head10.gif$ Format

(VB.NET)

Dim Ret As Integer

Dim Str(xxxx) As Byte ' (xxxx specifies the size of binary data.)

Dim DblData(xxxx) As Double ' (xxxx specifies the size of changed data.)

Dim ArraySize As Integer

Ret = GpCnvCvdArray(Str, DblData, ArraySize)

(C)

DWORD Ret;

BYTE *Str;

double *DblData;

DWORD ArraySize;

Ret = GpCnvCvdArray(Str, DblData, ArraySize);

(C#)

uint Ret;

byte[] Str = new byte[xxxx]; /* (xxxx specifies the size of binary data.) */

double[] DblData = new double[xxxx]; /* (xxxx specifies the size of changed data.) */

uint ArraySize;

Ret = gpib.CnvCvdArray(Str, DblData, ArraySize);

(Python)

Ret = ctypes.c_ulong()

Str = (ctypes.c_ubyte * xxxx)() #(xxxx specifies the size of binary data.)

DblData = (ctypes.c_double * xxxx)() #(xxxx specifies the size of changed data.)

ArraySize = ctypes.c_ulong()

Ret.value = GpibPy.GpCnvCvdArray(Str, DblData, ArraySize)

$image\head10.gif$ Mode Master mode / Slave mode

$image\head10.gif$ Parameters

Str : Binary data arrangement to change.

Specifies 8-bytes binary data (IEEE single precision format).
It must be continuous 8-bytes binary data in the array.

DblData : Changed double value array(Double value in VB, return value)

ArraySize : Size of DblDataarray

Ret : Return value

0 : Normal completion

255 : Illegal call

(See "Return Values" for details.)

$image\head10.gif$ Notes

1 Binary data set up in this function must be satisfied the following conditions.

- Specifies 8-bytes binary data (IEEE single precision format).

- 8-bytes data block continue, and it is in.

- Size of Str needs over (ArraySise * 8). A movement isn't assured in the case doesn't conform to this condition.

2 Data on the first byte in the data are changed by the default as an 'Sign Bit'.
Use GpCnvCvSettings when you want to change data on the last byte as 'Sign Bit'.

3 This function does a change by the value of ArraySize.
Be careful that it doesn't get mixed up with size of Str.
The relation between Size of Str array and ArraySize, must be following.

Size of Str array >= ArraySize * 8

In other words, a change is done for only 8 bytes first if ArraySize is set up in 1 even if there is size of the Str array 24 bytes.

4 This function can be used even if it isn't called a GpIni.

5 This function provides the function which is about equal to the CVD function of QuickBasic.