GpCnvStrToDblArray

■機能 GpCnvSettings関数で指定されたセパレータで区切られたアスキー文字列をDouble値に変換し、配列に格納します。セパレータのデフォルトは","(カンマ)です。

■書式

(VB.NET用)

Dim ArraySize, Ret As Integer

Dim Str As String

Dim DblData(xxxx) As Double ' (xxxxはデータ数のMax値を指定)

Ret = GpCnvStrToDblArray(Str, DblData, ArraySize)

(C言語用)

DWORD ArraySize, Ret;

char *Str;

double *DblData;

Ret = GpCnvStrToDblArray(Str, DblData, &ArraySize);

(C#用)

uint ArraySize, Ret;

string Str;

double[] DblData = new double[xxxx]; /* (xxxxはデータ数のMax値を指定) */

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

(Python用)

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

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

DblData = (ctypes.c_double * xxxx)() #xxxxはデータ数のMax値を指定

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

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

■引数

Str : 変換する文字列

Double値に変換する文字列を指定します。
この文字列にヘッダが含まれていても問題はありません。
また、大文字・小文字は同一文字として判断します。

DblData : (出力)変換したDouble値の配列

ArraySize : (入力)DblDataの配列の大きさ

(出力)実際にデータを格納した数

Ret : 終了情報(戻り値)

0 : 正常終了

244 : ArraySizeを超える、セパレータで区切られたデータブロックがある

255 : パラメータエラー

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

■補足

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

「<ヘッダ>+<数値を示す文字列>」もしくは「<数値を示す文字列>」があり、それらがセパレータで区切られている場合

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

③GpCnvSettings関数でヘッダ等を設定した場合、各データブロックにはそれを取り除いた上で①の条件が適用されます。

④ArraySizeの値は確保したDblData配列の大きさを超えないようにしてください。
DblData配列の大きさを超えて設定した場合、動作の保証はできません。

⑤変換する文字列の各データブロックの長さの上限は256バイトです。