方法

GioFilemeasure_disk_usage

自:2.38

声明 [src]

gboolean
g_file_measure_disk_usage (
  GFile* file,
  GFileMeasureFlags flags,
  GCancellable* cancellable,
  GFileMeasureProgressCallback progress_callback,
  gpointer progress_data,
  guint64* disk_usage,
  guint64* num_dirs,
  guint64* num_files,
  GError** error
)

描述 [src]

递归测量文件的磁盘使用率。

这实际上是'du'命令的一个对等操作,但它还会报告遇到的目录和非目录文件的数量(包括符号链接等)。

默认情况下,仅对顶级文件本身报告错误。递归时找到的错误会被静默忽略,除非在flags中提供了G_FILE_MEASURE_REPORT_ANY_ERROR

返回的大小disk_usage是以字节为单位,使用g_format_size()格式化,以便在用户界面中显示某个合理的值。

progress_callbackprogress_data可以提供,以在扫描时请求周期性的进度更新。有关回调何时以及如何被调用的信息,请参阅GFileMeasureProgressCallback的文档。

自:2.38

参数

flags

类型: GFileMeasureFlags

GFileMeasureFlags.

cancellable

类型: GCancellable

可选的GCancellable

参数可以为NULL
数据由方法的调用者拥有。
progress_callback

类型: GFileMeasureProgressCallback

GFileMeasureProgressCallback

参数可以为NULL
progress_data

类型: gpointer

progress_callback的用户数据。

参数可以为NULL
数据由方法的调用者拥有。
disk_usage

类型: guint64*

使用的磁盘空间字节数。

参数将由函数设置。
参数可以为NULL
num_dirs

类型: guint64*

遇到的目录数量。

参数将由函数设置。
参数可以为NULL
num_files

类型: guint64*

遇到的非目录数量。

参数将由函数设置。
参数可以为NULL
error

类型: GError **

恢复性错误的返回位置。

参数可以为NULL
如果返回位置不为NULL,则必须将其初始化为NULLGError*
如果没有错误,方法将保留初始化为NULL的参数。
出错时,参数将设置为一个新的分配的GError;调用者将拥有数据,并负责释放它。

返回值

类型: gboolean

TRUE表示成功,并且已设置输出参数。否则返回FALSE,并将error设置为。