基 础 函 数 参 考

FileWrite

添加文本/数据到打开的文件.

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

参 数

文件句柄/文件名 由此前 FileOpen 函数返回的文件句柄. 也可以直接使用目标文件名.
文本/数据 写入到文件中的文本/数据. 写入文本时不会自动添加 @CR 或 @LF. 参见数据类型备注.

返 回 值

成功: 返回 1.
失败: 返回, 文件不是写模式打开, 文件为只读或者无法写入.

备 注

文件必须以写模式打开, 否则 FileWrite 命令失败.

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

注意:不要混用文件的句柄和名称, 即用 FileOpen 函数打开文件,
又在本函数中使用文件名. 二者只取其一, 不要两者都使用.

写入文本时, AutoIt 默认使用 ANSI 模式. 写入 Unicode 模式文本,必须使用 FileOpen() 设置相关标志.

如果写入二进制数据 (且不是文本), 将一个字节一个字节的写入. 二进制操作使用 Fileopen() 函数并强制附带二进制标志.

相 关 函 数

FileFlush, FileOpen, FileRead, FileReadLine, FileWriteLine, Binary, FileSetPos, FileGetPos

函 数 示 例


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

; 检查文件是否以写入模式打开
If $file = -1 Then
    MsgBox(0, "错误", "无法打开文件.")
    Exit
EndIf

FileWrite($file, "Line1")
FileWrite($file, "Still Line1" & @CRLF)
FileWrite($file, "Line2")

FileClose($file)

provider with jb51.net (unicode)