GpCnvDblToStr

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

$image\head10.gif$ Operation The numerical value given to it is changed into one ASCII characters on the condition specified by the GpCnvSettings function, the GpCnvSettingsToStr function.

$image\head10.gif$ Format

(VB.NET)

Dim StrSize, Ret As Integer

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

Dim DblData As Double

Ret = GpCnvDblToStr(Str, StrSize, DblData)

(C)

DWORD StrSize, Ret;

char *Str;

double DblData;

Ret = GpCnvDblToStr(Str, &StrSize, DblData);

(C#)

uint StrSize, Ret;

string Str;

double DblData;

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

(Python)

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

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

DblData = ctypes.c_double()

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

$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 : Double value to change

Ret : Return value

0 : Normal completion

244 : There is a data block divided with separator beyond 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.

*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)

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 that it was secured.
A movement can't be assured when it is set up beyond the size of the Str charactor array.