函数说明

许多函数都含有一些可以省略的可选参数. 但如果指定一个可选参数时, 所有在它之前的参数都必须指定!
例如 Run ( "文件名", ["工作目录" [, 标志]] ).  如果指定了 标志, 则必须同时指定工作目录.

许多 Win___ 类的函数包含一个 “文本” 的可选参数. 这个参数用于区分具有相同标题的窗口.


某些函数通过返回值表示函数执行的成功/失败; 有些则通过设置 @error 的值来表示, 还有些则同时使用这两种方式...
@error = 0 ;始终表示成功
Return = 各不相同, 但通常以非 0 值表示成功, 以方便阅读代码...

    If someUserFunc() then  ;..........表示函数 someUserFunc() 正常工作
    If Not someUserFunc() then  ;...表示函数 someUserFunc() 失败

    $x = FileReadLine("C:\someFile.txt")
    If @error = -1 Then ;函数 FileReadLine 已读到文件尾

如果函数可以设置 @error 标志, 则应优先检查 @error 标志来判断函数的执行情况, 而不是立即使用返回值, 如果 @error 指示已发生错误, 则返回值通常是不确定的...

当插入一个函数时, 始终设置 @error 为 0.

当文档状态的返回值 = 无, AutoIt 总是会返回一个值, 以避免错误. 通常返回 1, 但你不应该依赖于这个返回值.

当一个可选参数在一或更多的可选参数之前被定义, 必须考虑默认值. 这可能是 "" (字符串参数) 或 -1(其它类型).
而一些类似 StringInStr 或 StringReplace 的函数要求指定值 0. 详情见相应函数的可选参数描述.

 

provider with jb51.net (unicode)