Ξ
Δ
◄
►
¬
Ѕ
过滤筛选
指令
内置变量
内置函数
控制流语句
运算符
声明
命令
Ahk2Exe 编译器
高亮关键词
<script type="text/javascript">$(function(){0<=window.navigator.userAgent.toLowerCase().indexOf("ucbrowser")&&CaoNiMaDeUc()})</script> <style type="text/css"> .sized { width: 3em; } </style> <script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-1632085368384154" crossorigin="anonymous"></script><script src="https://autohotkey.top/gtag.js"></script></head> <body> <h1>FileOpen() <span class="ver">[AHK_L 42+]</span></h1> <p>打开文件, 从其中读取特定内容和/或将新内容写入其中.</p> <pre class="Syntax">file := <span class="func">FileOpen</span>(Filename, Flags <span class="optional">, Encoding</span>)</pre> <h2 id="Parameters">参数</h2> <dl> <dt>Filename</dt> <dd> <p>要打开文件的路径, 如果未指定绝对路径, 则假定在 <a href="../Variables.htm#WorkingDir">A_WorkingDir</a> 中.</p> <p><span class="ver">[v1.1.17+]:</span> 如下所示, 指定一个(或两个) 星号来打开标准 输入(input)/输出(output)/错误(error) 流:</p> <pre> FileOpen("*", "r") <em>; 标准输入(stdin)</em> FileOpen("*", "w") <em>; 标准输出(stdout)</em> FileOpen("**", "w") <em>; 标准错误(stderr)</em></pre> </dd> <dt>Flags</dt> <dd><p>在 <span class="ver">[AHK_L 54+]</span> 表示希望使用的访问模式的字符串, 后面跟着其他选项(中间可以含有空格或 tab); 或在 <span class="ver">[AHK_L 42+]</span> 数字标志的组合(总和). 下面的表格中描述了支持的值.</p></dd> <dt>Encoding</dt> <dd><p>如果文件没有 UTF-8 或 UTF-16 <a href="https://en.wikipedia.org/wiki/Byte_order_mark">字节顺序标记</a>, 或者使用了 <code>h</code>(handle) 标志, 读写文件时使用的代码页(带字节顺序标记的文件 AutoHotkey 自动识别, 指定的 <i>Encoding</i> 无效). 如果省略本参数, 则使用 <a href="../Variables.htm#FileEncoding">A_FileEncoding</a> 的当前值.</p></dd> </dl> <h2 id="Flags">Flags</h2> <h3 id="Access_modes">访问模式(互斥的)</h3> <table class="info"> <tr> <th class="sized center">Flag</th> <th class="sized right">Dec</th> <th class="sized right">Hex</th> <th abbr="Descr">描述</th> </tr> <tr> <td class="center">r</td> <td class="right">0</td> <td class="right">0x0</td> <td><i>读取:</i> 当文件不存在时失败.</td> </tr> <tr> <td class="center">w</td> <td class="right">1</td> <td class="right">0x1</td> <td><i>写入:</i> 创建新文件, <b style="color:red">若文件已存在则覆盖它们</b>.</td> </tr> <tr> <td class="center">a</td> <td class="right">2</td> <td class="right">0x2</td> <td><i>追加:</i> 如果文件不存在则创建新文件, 否则移动文件指针到文件末尾.</td> </tr> <tr> <td class="center">rw</td> <td class="right">3</td> <td class="right">0x3</td> <td><i>读取/写入:</i> 当文件不存在时创建新文件.</td> </tr> <tr> <td class="center">h</td> <td> </td> <td> </td> <td>表示 <i>Filename</i> 是包装在对象中的文件句柄. 忽略共享模式标志. 当文件对象销毁时, 文件句柄 <b>不会</b> 自动关闭并且调用 <a href="../objects/File.htm#Close">Close</a> 没有效果. 注意当 <i>Filename</i> 是非搜寻设备(例如管道或通信设备) 的句柄时不应该使用 <a href="../objects/File.htm#Seek">Seek</a>, <a href="../objects/File.htm#Tell">Tell</a> 和 <a href="../objects/File.htm#Length">Length</a>.</td> </tr> </table> <h3 id="Sharing_mode_flags">共享模式标志</h3> <table class="info"> <tr> <th class="sized center">Flag</th> <th class="sized right">Dec</th> <th class="sized right">Hex</th> <th abbr="Descr">描述</th> </tr> <tr> <td class="center">-rwd</td> <td> </td> <td> </td> <td>为读取, 写入和/或删除访问进行文件锁定. 可以使用 <code>r</code>, <code>w</code> 和 <code>d</code> 的任意组合. 指定 <code>-</code> 相当于指定 <code>-rwd</code>. 如果完全省略, 默认为共享所有访问.</td> </tr> <tr> <td> </td> <td class="right">0</td> <td class="right">0x0</td> <td>如果 <i>Flags</i> 是数值的, 缺少共享模式标志会让文件被锁定.</td> </tr> <tr> <td> </td> <td class="right">256</td> <td class="right">0x100</td> <td>共享 <i>读取</i> 访问.</td> </tr> <tr> <td> </td> <td class="right">512</td> <td class="right">0x200</td> <td>共享 <i>写入</i> 访问.</td> </tr> <tr> <td> </td> <td class="right">1024</td> <td class="right">0x400</td> <td>共享 <i>删除</i> 访问.</td> </tr> </table> <h3 id="EOL_options">行结束符(EOL) 选项</h3> <table class="info"> <tr> <th class="sized center">Flag</th> <th class="sized right">Dec</th> <th class="sized right">Hex</th> <th abbr="Descr">描述</th> </tr> <tr> <td class="center">`n</td> <td class="right">4</td> <td class="right">0x4</td> <td>读取时把 <code>`r`n</code> 替换为 <code>`n</code> 而写入时把 <code>`n</code> 替换为 <code>`r`n</code>.</td> </tr> <tr> <td class="center">`r</td> <td class="right">8</td> <td class="right">0x8</td> <td>读取时把单独的 <code>`r</code> 替换为 <code>`n</code>.</td> </tr> </table> <h2 id="Return_Value">返回值</h2> <p>如果成功打开文件, 则返回值为<a href="../objects/File.htm">文件对象</a>.</p> <p>如果函数失败, 则返回值为 0, 且在 <span class="ver">[AHK_L 54+]</span> <a href="../Variables.htm#LastError">A_LastError</a> 包含错误码.</p> <p>使用 <code>if file</code> 或 <code>IsObject(file)</code> 可以判断函数是否成功执行.</p> <h2 id="Remarks">备注</h2> <p>当创建 UTF-8 或 UTF-16 文件时, 会写入字节顺序标记到文件中, <b>除非</b> <i>Encoding</i>(或当参数 <i>Encoding</i> 省略时, 则使用 <a href="FileEncoding.htm">A_FileEncoding</a>) 包含 <code>UTF-8-RAW</code> 或 <code>UTF-16-RAW</code>.</p> <p>当以读取方式打开含有 UTF-8 或 UTF-16 字节顺序标记(BOM) 的文件时, 会把文件指针放置到这个标志后, 来从输出中排除 BOM. 因此, 在刚刚打开这样的文件时 <code>File.Position</code> 可能为 3 或 2.</p> <h2 id="Related">相关</h2> <p><a href="FileEncoding.htm">FileEncoding</a>, <a href="../objects/File.htm">文件对象</a>, <a href="FileRead.htm">FileRead</a></p> <h2 id="Examples">示例</h2> <div class="ex" id="writeread"> <p><a class="ex_number" href="#writeread"></a> 写入一些文本到文件, 然后从文件读取回内存(它提供了与此 <a href="DllCall.htm#file">DllCall 示例</a>相同的功能).</p> <pre>FileSelectFile, FileName, S16,, Create a new file: if (FileName = "") return file := FileOpen(FileName, "w") if !IsObject(file) { MsgBox Can't open "%FileName%" for writing. return } TestString := "This is a test string.`r`n" <em>; 通过这种方式写入内容到文件时, 要使用 `r`n 而不是 `n 来开始新行.</em> file.Write(TestString) file.Close() <em>; 现在已经把内容写入文件了, 重新把它们读取回内存中.</em> file := FileOpen(FileName, "r-d") <em>; 读取文件 ("r"), 共享除删除 ("-d") 外的所有访问权限</em> if !IsObject(file) { MsgBox Can't open "%FileName%" for reading. return } CharsToRead := StrLen(TestString) TestString := file.Read(CharsToRead) file.Close() MsgBox The following string was read from the file: %TestString%</pre> </div> <div class="ex" id="ExReadLine"> <p><a class="ex_number" href="#ExReadLine"></a> 以只读模式打开脚本并读取它的首行.</p> <pre>file := FileOpen(A_ScriptFullPath, "r") MsgBox % file.ReadLine()</pre> </div> <div class="ex" id="ExStreams"> <p><a class="ex_number" href="#ExStreams"></a> 演示标准 input/output 流的用法.</p> <pre><em>; 打开控制台窗口以进行此次演示.</em> DllCall("AllocConsole") stdin := FileOpen("*", "r `n") <em>; 需要 <span class="ver">[v1.1.17+]</span></em> stdout := FileOpen("*", "w `n") <em>; 对于较旧的版本: ; stdin := FileOpen(DllCall("GetStdHandle", "int", -10, "ptr"), "h `n") ; stdout := FileOpen(DllCall("GetStdHandle", "int", -11, "ptr"), "h `n")</em> stdout.Write("Enter your query.`n\> ") stdout.Read(0) <em>; 清除写入缓冲区.</em> query := RTrim(stdin.ReadLine(), "`n") stdout.WriteLine("Your query was '" query "'. Have a nice day.") stdout.Read(0) <em>; 清除写入缓冲区.</em> Sleep 5000 </pre> </div> <a href="https://dftg.net">dftg</a><!-- Cloudflare Pages Analytics --><script defer src='https://static.cloudflareinsights.com/beacon.min.js' data-cf-beacon='{"token": "d5a9c4fcb9b6482fa53ce820d892f969"}'></script><!-- Cloudflare Pages Analytics --><script defer src="https://static.cloudflareinsights.com/beacon.min.js/vcd15cbe7772f49c399c6a5babf22c1241717689176015" integrity="sha512-ZpsOmlRQV6y907TI0dKBHq9Md29nnaEIPlkf84rnaERnq6zvWvPUqr2ft8M1aS28oN72PdrCzSjY4U6VaAw1EQ==" data-cf-beacon='{"rayId":"956463261c93f849","version":"2025.6.2","r":1,"serverTiming":{"name":{"cfExtPri":true,"cfEdge":true,"cfOrigin":true,"cfL4":true,"cfSpeedBrain":true,"cfCacheStatus":true}},"token":"51750bb5dc4f40cc91a5ec55c63bbc01","b":1}' crossorigin="anonymous"></script> </body> </html>