FileSize

FileSize 对象提供了方便处理表示文件大小的变量的功能。如今，文件大于 4GB 的情况非常普遍，但不幸的是，ActiveX 脚本不支持表示此类大数字所需的 64 位整数。因此，每次 Opus 脚本对象返回表示文件大小或字节数的数字时，返回的都是一个 FileSize 对象。例如，Item.size 属性返回一个 FileSize 以表示特定文件或文件夹的大小。

你可以使用 FSUtil.NewFileSize 方法创建新的 FileSize 对象。FileSize 对象通常表示一个 无符号 的 64 位整数，但是如果你在创建时指定了 "s" 标志，它将存储一个 有符号 的整数。

属性名称	返回类型	说明
<默认值>	字符串	以 字符串 返回此 FileSize 对象表示的字节数。
cy	货币	以 货币 值返回字节数。这是一个 64 位数据类型，但存储为分数值，因此你必须将返回的值乘以 10000 以获取实际字节大小。
fmt	字符串	以自动格式化的字符串返回字节数（例如，如果 FileSize 值为 1024，则会返回字符串 1 KB）。
high	十进制	返回文件大小的最高（最显着）32 位。并非所有脚本语言都支持此数据类型（例如，VBScript 不支持）。
highhex	字符串	以十六进制字符串返回文件大小的最高 32 位。
low	十进制	返回文件大小的最低（最不显着）32 位。
lowhex	字符串	以十六进制字符串返回文件大小的最低 32 位。
val	十进制	以十进制值返回字节数。这是一个 64 位数据类型，但并非所有脚本语言都支持（例如，VBScript 不支持）。
valhex	字符串	以十六进制字符串返回字节数。

方法名称	参数	返回类型	说明
Add	变体	无	将提供的值添加到此 FileSize 对象的值中。你可以传递 字符串、int 或 货币 类型，或另一个 FileSize 对象。部分 FileSize 对象是只读的，如果你尝试修改它们，它们会出错。这包括 Item.size 返回的对象。使用 Clone 方法创建一个可修改的副本。
Clone	无	*对象:*FileSize	克隆此 FileSize 对象并返回一个新对象，该对象设置为相同的值。
Compare	变体	int	将提供的值与此 FileSize 对象的值进行比较。返回值为 0（相等）、1（大于）或 -1（小于）。
Div	变体	无	将此 FileSize 对象的值除以提供的值。你可以传递 字符串、int 或 货币 类型，或另一个 FileSize 对象。部分 FileSize 对象是只读的，如果你尝试修改它们，它们会出错。这包括 Item.size 返回的对象。使用 Clone 方法创建一个可修改的副本。
Mult	变体	无	将此 FileSize 对象的值乘以提供的值。你可以传递 字符串、int 或 货币 类型，或另一个 FileSize 对象。部分 FileSize 对象是只读的，如果你尝试修改它们，它们会出错。这包括 Item.size 返回的对象。使用 Clone 方法创建一个可修改的副本。
Set	变体	无	将 FileSize 设置为提供的值。你可以传递 字符串、int、// 十进制 或 货币 // 类型，或另一个 FileSize 对象。你还可以传递一个 Blob，该 Blob 恰好包含 1、2、4 或 8 个字节，在这种情况下，Blob 中包含的数据将用于形成数字。你可以通过在前面加上 $ 或 0x 来使用十六进制字符串。 如果 FileSize 对象是只读的，那么如果你尝试修改它，它会出错。使用 Clone 或 FSUtil.NewFileSize 创建一个可以修改的新对象。
Sub	变体	无	从此 FileSize 对象的值中减去提供的值，你可以传递 字符串、int 或 货币 类型，或另一个 FileSize 对象。请注意，FileSize 对象是 无符号的，因此该值不能低于零。部分 FileSize 对象是只读的，如果你尝试修改它们，它们会出错。这包括 Item.size 返回的对象。使用 Clone 方法创建一个可修改的副本。
ToBlob	int	对象:Blob	返回一个 Blob，其中包含表示当前值的字节。默认情况下，将把 8 个字节复制到 Blob（完整的 64 位数字），但你可以传递替代的字节数（1、2 或 4）作为参数来截断值。