基 础 函 数 参 考

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(0, "错误", "无法打开文件.")
    Exit
EndIf

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

FileClose($file)

provider with jb51.net (unicode)