GpCnvSettingsToStr

image\BLTLRGSQ.gifBoards that Support the Function image\SETUP.gif image\SANBTN.gif

 

 

image\head10.gif Operation             Contents of a change by the string change function (GpCnv***ToStr) are established.

A setup by this function is effective only when it is changed into the numerical value -> string.

 

image\head10.gif Format                 

(VB.NET)

Dim PlusFlag, Digit, CutDown As Integer

Dim Ret As Integer

Ret = GpCnvSettingsToStr(PlusFlag, Digit, CutDown)

 

(C)

DWORD PlusFlag, Digit, CutDown;

DWORD Ret;

Ret = GpCnvSettingsToStr(PlusFlag, Digit, CutDown);

 

(C#)

uint PlusFlag, Digit, CutDown;

uint Ret;

Ret = gpib.CnvSettingsToStr(PlusFlag, Digit, CutDown);

 

(Python)

Ret = ctypes.c_ulong()

PlusFlag, Digit, CutDown = ctypes.c_ulong(), ctypes.c_ulong(), ctypes.c_ulong()

Ret.value = GpibPy.GpCnvSettingsToStr(PlusFlag, Digit, CutDown)

 

image\head10.gif Mode                   Master mode / Slave mode

 

image\head10.gif Parameters

PlusFlag          : "+" The setup of the addition

0 : It isn't added.

1 : It is added.

And, when an index number part is a positive number, it is set up whether "+" is added in front of the temporary number part.

There is no change in the data head by this setup. In other words, "+" or "" (space) is put in the place where "-" is put.
Default is 1.

 

Digit               : Effective settlement of the number of beams.

The range 1 that it can be specified - 20.

The number of beams of the decimal point and under is specified. Default is 5.

 

CutDown         : The setup of rounding off.

0 : It cuts it down.

1 : It is rounded off.

It is set up whether it is rounded off when it tries to change bigger numerical value than the number of beams set up with Digit.
Default is 1.

 

Ret                 :Return value

0     : Normal completion

255 :  Illegal call

(See "Return Values" for details.)

 

image\head10.gif Notes

1 There is a GpCnvSettings function which a setup influences except for this function in the case of all the string changes.

 

2  It can be used even if this function doesn't do GpIni().