Boards that Support the Function
Operation The numerical value given to it is changed into one ASCII characters on the condition specified by the GpCnvSettings function, the GpCnvSettingsToStr function.
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)
Mode Master mode / Slave mode
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.)
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.