函数参考

FileWriteLine

向此前已打开的文本文件尾追加一行数据.

FileWriteLine ( "文件句柄/文件名", "数据" )

参数

文件句柄 目标文件句柄,可由此前调用 FileOpen 函数的返回值获得.另外也可以直接使用目标文件名.
数据 准备写入的数据.如果该行字符 并没有 以字符 @CR 或 @LF 结束则程序将自动添加一个 DOS 的换行符(@CRLF).

返回值

成功: 返回值为 1 .
失败: 返回值为 0 ,说明文件无法以写入模式打开,文件具有只读属性或者无法写入数据.

注意/说明

目标文件必须以写入模式打开,否则 FileWriteLine 命令将失败.

若给定的是文件名而不是文件句柄,那么该文件将在函数执行期间被打开并关闭,如果打开的文件较大则会比使用文件句柄要慢得多.如果该文件并不存在则程序将自动创建该文件.

注意:不要混用文件句柄和文件名,比如使用 FileOpen 函数打开某个文件然后又以文件名的形式使用本函数.在程序中要么使用文件句柄要么就使用文件名,不要两者都用!

当写入文本时, AutoIt 默认使用 ANSI 模式. 要写入 Unicode 模式的文本,必须使用 FileOpen() 并加上相关标志来打开文件.

写入文本不能包含 Chr(0) 字符. 输出是无效的. FileWrite() 使用打开于二进制模式的文件句柄可以使用于写入这类字符.

相关

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

示例/演示


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

; 检查打开的文件是否可写
If $file = -1 Then
    MsgBox(4096, "错误", "不能打开文件.")
    Exit
EndIf

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

FileClose($file)