TextWrite（テキストファイルにデータを書き込む）

FileId

ファイル識別子を数値，または値を格納した変数名で指定します。

このファイル識別子は，TextOpenコマンドで実行結果として返される値です。

なお，この項目を指定する場合は，TextOpenコマンドのファイルオープン時の動作には，ReadOnly（ファイルを読み込みモードでオープン）以外を指定してください。

Data

書き込むデータを文字列，または値を格納した変数名で指定します。

NewLine

データを書き込んだあとを改行する場合には真（True）を，改行しない場合には偽（False）を指定します。

この値は省略できます。省略した場合，真（True）を仮定します。

Position

ファイルの先頭を0とした読み書き開始位置を数値，または値を格納した変数名で指定します。

この値は省略できます。省略した場合，現在の読み書き開始位置を仮定します。

指定したファイル識別子のテキスト形式ファイルに対しデータを現在の読み書き開始位置，または指定した読み書き開始位置から書き込みます。コマンドが正常に実行された場合は真（True）を，エラーが発生した場合は偽（False）を，コマンドの実行結果として返します。

読み書き開始位置は，コマンドの実行結果が真（True）でNewLineに真（True）が指定してある場合は次行になり，NewLineに偽（False）が指定してある場合は書き込んだデータの直後になります。

すでに存在するファイルに対してTextOpenコマンドのModeオペランドにWriteOnly，またはReadWriteを指定し，TextWriteコマンドを実行した場合，TextWriteコマンドは，単純に指定された文字数分の上書きを行います。したがって，出力する文字数（改行コードを含む）が既存ファイルより少ない場合，少ない文字数分オープン前の内容がファイルに残ります。
TextWriteコマンドはBOM（Byte Order Mark）を付加して出力することはできません。また，BOM付きのファイルの先頭行を上書きする場合はBOMを上書きします。

次のようなスクリプトでカレントディレクトリ下のテキストファイル"ABC.TXT"にデータを書き込む。
' スクリプトファイル
Dim  file1
file1 = TextOpen ( _BIN_+"ABC.TXT" ,Create )
If  file1 = 0  Then
  Message( Target_DispOn, "実行結果", _BIN_+"ABC.TXTのオープンに失敗" )
Else
  TextWrite ( file1 ,"JP1/Scriptについての追加情報" )
  TextWrite ( file1 ,"                 目次" ,False )
  TextClose ( file1)
End
 
; ABC.TXT
JP1/Scriptについての追加情報
                 目次