GpCnvDblArrayToStr

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

$image\head10.gif$ Operation It is changed into one ASCII characters that it has the numerical value arrangement given to it divided on the condition specified by the GpCnvSettings function, the GpCnvSettingsToStr function with separator. The default of separator is "," (comma).

$image\head10.gif$ Format

(VB.NET)

Dim StrSize, ArraySize, Ret As Integer

Dim Str As New String("", xxxx) ' (xxxx is the string length)

Dim DblData(xxxx) As Double ' (xxxx is Max value of number data)

Ret = GpCnvDblArrayToStr(Str, StrSize, DblData, ArraySize)

(C)

DWORD StrSize, ArraySize, Ret;

char *Str;

double *DblData;

Ret = GpCnvDblArrayToStr(Str, &StrSize, DblData, ArraySize);

(C#)

uint StrSize, ArraySize, Ret;

string Str;

double[] DblData = new double[xxxx]; /* (xxxx is Max value of number data) */

Ret = gpib.CnvDblArrayToStr(Str, out StrSize, DblData, ArraySize);

(Python)

StrSize, ArraySize, Ret = ctypes.c_ulong(), ctypes.c_ulong(), ctypes.c_ulong()

Str = ctypes.create_string_buffer(xxxx) # (xxxx is the string length)

DblData = (ctypes.c_double * xxxx)() # (xxxx is Max value of number data)

Ret.value = GpibPy.GpCnvDblArrayToStr(Str, ctypes.byref(StrSize), DblData, ArraySize)

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

$image\head10.gif$ Parameters Str : (OUT) Changed string.

StrSize : (IN) Length of "Str"

(OUT)Length of changed characters.

DblData : Array of Double value to change

ArraySize : The size of the array of DblData

Ret : Return value

0 : Normal completion

244 : The length of the characters of the changed result exceeded StrSize.

255 : Illegal call

(See "Return Values" for details.)

$image\head10.gif$ Notes 1 This function does a change on the following condition.

*One space is put between the temporary number part and the index number part. And the space isn't put before and behind separator.

*A header, a unit (footer) can be added before and behind the numerical value by the settlement of the GpCnvSettings function, the GpCnvSettingsToStr function. When a header, a unit (Footer) are set up, one space is put in each and the space of the numerical value.

*The default when the above function isn't carried out is as the next.

Header : ""(NULL)

Unit(Footer) : ""(NULL)

Separator : ","(Comma)

Display of "+ " : Indicated

The effective number of beams. : 5

Suffix : Not in use

2 This function can be used even if it doesn't call GpIni().

3 Prevent the value of ArraySize from your exceeding the size of Str charactor array and DblData array that it was secured. A movement can't be assured when it is set up beyond the size of the Str charactor array and DblData array.