FileWriteFields() 関数FileWriteFields()かんすう

一連のタグ名に含まれている値を csv ファイルに書き込みます。この関数を使用すると、タグ名の値のセットを保存できます。

サポートされている区切り文字はカンマだけです。

構文

[result = ] FileWriteFields (filename, offset, starttag, numberoffields)

パラメータ

filename

データを書き込む csv ファイルの名前です。ファイルが存在しない場合、新しいファイルが作成されます。リテラル文字列値、メッセージ型タグ名、または文字列式です。

offset

書き込みを開始するファイルの位置（バイト単位）です。ファイルの最後に書き込むには（追加）、-1 を使用します。リテラル整数値、整数型タグ名、または整数式です。

starttag

書き込まれる最初のデータ アイテムを含む最初のタグ名の名前です。タグ名は、"MyTag1" のように、二重引用符で囲み、数値で終わる必要があります。リテラル文字列値、メッセージ型タグ名（値 "MyTag1" を含むメッセージ型タグなど）、または文字列式です。

numberoffields

csv ファイルに書き込むデータ アイテムの名前です。リテラル整数値、整数型タグ名、または整数式です。最初のデータ アイテムは、starttag パラメータで定義されているタグ名からファイルに書き込まれ、その後のデータ アイテムは、starttag パラメータの増分数字の接尾辞付きのタグ名（MyTag1、MyTag2、MyTag3...）から書き込まれます。

戻り値

データ書き込み後のオプションの新しいファイル オフセット（バイト単位）です。これは、データの次のセットを書き込むときに使用できます。

例

一連の InTouch タグは以下のように定義されています。

このスクリプトは、RecipeTag1 ～ RecipeTag4 に含まれている値を csv ファイル c:\set.csv に書き込みます。

FileWriteFields("c:\set.csv",0,"RecipeTag1",4);

これで、ファイル c:\set.csv には以下のデータが含まれます。

Flour,27.23,14,1