GpCnvFltToStr

使用可能ボード

■機能       与えられた数値をGpCnvSettings関数、GpCnvSettingsToStr関数で指定された条件で1つのアスキー文字列に変換します。

■書式       

(VB.NET用)

Dim StrSize, Ret As Integer

Dim Str As New String("", xxxx)   ' (xxxxは文字列の長さを指定)

Dim FltData As Single

Ret = GpCnvFltToStr(Str, StrSize, FltData)

(C言語用)

DWORD StrSize, Ret;

char *Str;

float FltData;

Ret = GpCnvFltToStr(Str, &StrSize, FltData);

(C#用)

uint StrSize, Ret;

string Str;

float FltData;

Ret = gpib.CnvFltToStr(Str, out StrSize, FltData);

(Python用)

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

Str = ctypes.create_string_buffer(xxxx)   # (xxxxは文字列の長さを指定)

FltData = ctypes.c_float()

Ret.value = GpibPy.GpCnvFltToStr(Str, ctypes.byref(StrSize), FltData)

■モード     マスタモード/スレーブモード

■引数

Str       :   (出力)変換後の文字列

変換した文字列を返します。

StrSize   :   (入力)Strの長さ

(出力)変換された文字列の長さ

FltData   :   変換するFloat値(VBではSingle値)

Ret         :   終了情報(戻り値)

0       :   正常終了

244   :   変換された結果の文字列の長さがStrSizeを超えた

255   :   パラメータエラー

(詳細は「戻り値一覧」参照)

■補足

①この関数は以下の条件で変換を行います。

• GpCnvSettings関数、GpCnvSettingsToStr関数の設定によって数値の前後にヘッダ、単位(フッタ)を付加することができます。
  ヘッダ、単位(フッタ)を設定している場合、それぞれと数値の間には1つのスペースが入れられます。

• 上記関数を実行していない場合のデフォルトは次のとおりです。

ヘッダ: ""(NULL)

単位(フッタ)   : ""(NULL)

"+"の表示: 表示する

有効桁数: 0 (そのままの桁数で表示)

係数サフィックス: 使用しない

②この関数はGpIni()をコールしていなくても使用することができます。

③StrSizeの値は確保したStr文字列の大きさを超えないようにしてください。
Str文字列の大きさを超えて設定した場合、動作の保証はできません。