# FileGetSize

获取文件的大小.

    Size := FileGetSize(Filename, Units)

## 参数

Filename

  类型: 字符串

  目标文件名, 如果未指定绝对路径则假定在 A_WorkingDir 中. 如果省略, 则使用最内层文件循环的当前文件.

Units

  类型: 字符串

  如果使用此参数, 那么它会让返回结果使用的字节外的其他单位:

  - K = 千字节
  - M = 兆字节

## 返回值

类型: 整数

函数返回指定文件的大小(向下取整到最近的整数).

## 错误处理

失败时抛出 OSError.

A_LastError 被设置为操作系统 GetLastError() 函数返回的结果.

## 备注

支持任意大小的文件, 包括超过 4 GB 的文件, 都支持 Units 为字节.

如果目标文件为目录, 则报告操作系统看到的它的大小(在所有情况中可能都是零).

要计算文件夹及其所有文件的大小, 请参照此例:

    FolderSize := 0
    WhichFolder := DirSelect()  ; 提示用户选择一个文件夹.
    Loop Files, WhichFolder "\*.*", "R"
        FolderSize += A_LoopFileSize
    MsgBox "Size of " WhichFolder " is " FolderSize " bytes."

## 相关

FileGetAttrib, FileSetAttrib, FileGetTime, FileSetTime, FileGetVersion, 文件循环

## 示例

读取以字节为单位的大小, 并将其存储在 Size.

    Size := FileGetSize("C:\My Documents\test.doc")

读取以千字节为单位的大小, 并将其存储在 Size.

    Size := FileGetSize("C:\My Documents\test.doc", "K")

dftg