FileSize

FileSize 对象用于更方便地处理表示文件大小的变量。如今,文件大小超过 4GB 非常常见,但不幸的是,ActiveX 脚本对表示此类大数字所需的 64 位整数没有适当的支持。因此,只要 Opus 脚本对象返回文件大小或表示字节数的数字,它都是以 FileSize 对象的形式。例如,Item.size 属性返回一个表示特定文件或文件夹大小的 FileSize

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

属性名称
返回类型
描述

<默认值>

string

返回此 FileSize 对象所代表的字节数作为 string

cy

currency

返回字节数作为 currency 值。这是一个 64 位数据类型,但它存储为小数,因此您必须将返回值乘以 10000 以获得实际的字节大小。

fmt

string

返回字节数作为自动格式化的字符串(例如,如果 FileSize 值为 1024,则将返回字符串 1 KB)。

high

decimal

返回文件大小的最高(最显著) 32 位。并非所有脚本语言都支持这种数据类型(例如 VBScript 不支持)。

highhex

string

返回文件大小的最高 32 位作为十六进制字符串。

low

decimal

返回文件大小的最低(最低有效) 32 位。

lowhex

string

返回文件大小的最低 32 位作为十六进制字符串。

val

decimal

返回字节数作为十进制值。这是一个 64 位数据类型,但并非所有脚本语言都支持它(例如 VBScript 不支持)。

valhex

string

返回字节数作为十六进制字符串。

方法名称

参数

返回类型

描述

Add

variant

none

将提供的 value 加到此 FileSize 对象的值中。您可以传递 stringintcurrency 类型,或另一个 FileSize 对象。 一些 FileSize 对象是只读的,如果您尝试修改它们,将出错。这包括 Item.size 返回的那些对象。使用 Clone 方法创建一个可修改的副本。

Clone

none

*object:*FileSize

克隆此 FileSize 对象并返回一个设置为相同值的新对象。

Compare

variant

int

将提供的 value 与此 FileSize 对象的值进行比较。返回值将为 0(相等)、1(大于)或 -1(小于)。

Div

variant

none

用提供的 value 除以此 FileSize 对象的值。您可以传递 stringintcurrency 类型,或另一个 FileSize 对象。 一些 FileSize 对象是只读的,如果您尝试修改它们,将出错。这包括 Item.size 返回的那些对象。使用 Clone 方法创建一个可修改的副本。

Mult

variant

none

将此 FileSize 对象的值乘以提供的 value。您可以传递 stringintcurrency 类型,或另一个 FileSize 对象。 一些 FileSize 对象是只读的,如果您尝试修改它们,将出错。这包括 Item.size 返回的那些对象。使用 Clone 方法创建一个可修改的副本。

Set

variant

none

FileSize 设置为提供的 value。您可以传递 stringint、// decimal *或 *currency// 类型,或另一个 FileSize 对象。您还可以传递一个 Blob,其中包含正好 1、2、4 或 8 个字节,在这种情况下,Blob 中包含的数据将用于形成数字。您可以通过在前面添加 $0x 来使用十六进制字符串。 如果 FileSize 对象是只读的,如果您尝试修改它,将出错。使用 CloneFSUtil.NewFileSize 创建一个您可以修改的新对象。

Sub

variant

none

从此 FileSize 对象的值中减去提供的 value。您可以传递 stringintcurrency 类型,或另一个 FileSize 对象。请注意,FileSize 对象是 无符号 的,因此该值不能低于零。 一些 FileSize 对象是只读的,如果您尝试修改它们,将出错。这包括 Item.size 返回的那些对象。使用 Clone 方法创建一个可修改的副本。

ToBlob

int

object:Blob

返回一个 Blob,其中包含构成当前值的字节。默认情况下,将把 8 个字节复制到 Blob(完整的 64 位数字),但您可以传递一个可选的字节数(1、2 或 4)作为参数来截断该值。

最后更新于