Function Reference

FileWriteLine

開いているテキストファイルの最後にテキストを追加します。

FileWriteLine ( "filehandle/filename", "line" )

 

パラメータ

filehandle/filename FileOpenで返されるファイルハンドル、もしくはファイル名を表す文字列。
line テキストファイルに書き込むテキスト行。 行末に@CR、@LFがない場合、DOSラインフィード(@CRLF)が自動で追加されます。

 

返し値

成功 1を返します。
失敗 ファイルが書き込みモードで開かれていない場合、読み込み専用の場合、その他の理由で書き込めない場合、0を返します。

 

注意

テキストファイルが書き込みモードで開かれていない場合FileWriteLineコマンドは失敗します。

filenameがファイルハンドル以外で与えられた場合、ファイルは関数呼び出し中に開閉されます。大きなテキストファイルを読み込む際にはファイルハンドルを使った場合よりも処理が遅くなります。またfilenameが表すファイルが存在しない場合は作成されます。

注意:ファイルハンドルとファイル名を混ぜて使用しないでください。例えばFileOpenでファイルを開き、この関数でファイル名を使用するといったことはしないでください。一連の処理ではファイルハンドルもしくはファイル名のどちらかだけを使用してください。

テキスト書き込み時、AutoItはデフォルトではANSIを使用して書き込みます。UNICODEモードで書き込むにはファイルは必要なフラグを設定したFileOpen()で開く必要があります。

書き込むテキストには出力終了用のChr(0)文字を含めることはできません。これらの文字を書き込むにはFileWrite()でバイナリモードで開かれたファイルを使用する必要があります。

 

関連

FileFlush, FileOpen, FileRead, FileReadLine, FileWrite, FileSetPos, FileGetPos

 


$file = FileOpen("test.txt", 1)

; ファイルが書き込みモードで開かれているか調べる
If $file = -1 Then
    MsgBox(0, "Error", "Unable to open file.")
    Exit
EndIf

FileWriteLine($file, "Line1")
FileWriteLine($file, "Line2" & @CRLF)
FileWriteLine($file, "Line3")

FileClose($file)