Ξ
Δ
◄
►
¬
Ѕ
过滤筛选
指令
内置变量
内置函数
控制流语句
运算符
声明
命令
Ahk2Exe 编译器
高亮关键词
<script type="text/javascript">$(function(){0<=window.navigator.userAgent.toLowerCase().indexOf("ucbrowser")&&CaoNiMaDeUc()})</script> <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>IniWrite</h1> <p>写入值到标准格式的 .ini 文件.</p> <pre class="Syntax"> <span class="func">IniWrite</span>, Value, Filename, Section, Key <span class="func">IniWrite</span>, Pairs, Filename, Section </pre> <h2 id="Parameters">参数</h2> <dl> <dt>Value</dt> <dd> <p>将被写入到 <em>Key</em> 的等号(=) 右边的字符串或数字.</p> <p>如果文本较长, 可以通过<a href="../Scripts.htm#continuation">延续片段</a>的方法将其分解成较短的几行, 这样可以增加可读性和可维护性.</p> </dd> <dt>Pairs</dt> <dd> <p><span class="ver">[AHK_L 57+]:</span> 将写入 ini 文件的 Section 的完整内容, 不包括 [SectionName] 头. <em>Key</em> 必须省略. <em>Pairs</em> 不能包含空行. 如果 section 已经存在, 则 ini 文件中此 section 中最后一个 key=value 对之前的所有内容都将被覆盖(译者注: 从原 section 头下第一行开始到最后一个 键=值 对之间的所有内容都将被被删除(即, 原有 section 中的所有键=值对和键=值对之间的注释(如果有) 将被删除) , 从 section 头下第一行开始写入 <em>Pairs</em> 的内容, 原最后一个键=值对后面的注释和 [SectionName] 头上的注释(如果有) 都将保持原样). <em>Pairs</em> 可以是不包含等号(=) 的内容, 但这可能产生不一致的效果. 注释可以写入文件, 但是在使用 <a href="IniRead.htm">IniRead</a> 读出时将不包含注释.</p> </dd> <dt>Filename</dt> <dd><p>ini 文件名, 如果未指定绝对路径, 则假定在 <a href="../Variables.htm#WorkingDir">%A_WorkingDir%</a> 中.</p></dd> <dt>Section</dt> <dd><p>ini 文件中的段名, 它是包含在方括号中的标题短语(在此参数中不需要加方括号).</p></dd> <dt>Key</dt> <dd><p>ini 文件中的键名.</p></dd> </dl> <h2 id="Error_Handling">错误处理</h2> <p><span class="ver">[v1.1.04+]</span>: 此命令失败时会抛出异常. 想了解更多信息, 请参阅<a href="Catch.htm#RuntimeErrors">运行时错误</a>.</p> <p>如果遇到问题则 <a href="../misc/ErrorLevel.htm">ErrorLevel</a> 被置为 1, 否则为 0.</p> <h2 id="Remarks">备注</h2> <p>可以将超过 65,535 个字符的值写入文件, 但可能会产生不一致的结果, 因为 IniRead 或其他应用程序通常无法正确读取它们.</p> <p>标准的 ini 文件看起来像这样:</p> <pre>[SectionName] Key=Value</pre> <p>新文件将使用系统默认的 ANSI 代码页或者是 UTF-16, 这取决于 <a href="../Variables.htm#IsUnicode"> AutoHotkey 的版本</a>.</p> <p><b>Unicode:</b> IniRead 和 IniWrite 依靠外部函数 <a href="http://msdn.microsoft.com/en-us/library/ms724353.aspx">GetPrivateProfileString</a> 和 <a href="http://msdn.microsoft.com/en-us/library/ms725501.aspx">WritePrivateProfileString</a> 来读写值. 这些函数仅支持 Unicode 为 UTF-16 编码的文件; 其他所有文件都被认为使用系统默认的 ANSI 代码页. 在 <a href="../Variables.htm#IsUnicode">Unicode 脚本</a>中, IniWrite 为每个新文件使用 UTF-16 编码. 如果不希望这样, 那么请确保在执行 IniWrite 前目标文件已经存在. 例如:</p> <pre>FileAppend,, NonUnicode.ini, CP0 <em>; 在大多数情况下最后一个参数是可选的.</em></pre> <h2 id="Related">相关</h2> <p><a href="IniDelete.htm">IniDelete</a>, <a href="IniRead.htm">IniRead</a>, <a href="RegWrite.htm">RegWrite</a></p> <h2 id="Examples">示例</h2> <div class="ex" id="ExBasic"> <p><a class="ex_number" href="#ExBasic"></a> 将一个值写入位于标准格式 .ini 文件中 section2 的一个键.</p> <pre>IniWrite, this is a new value, C:\Temp\myfile.ini, section2, key</pre> </div> <a href="https://dftg.net">dftg</a></body> </html>