虚方法

GioFilemeasure_disk_usage

自: 2.38

声明 [源]

gboolean
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
)

描述 [源]

递归测量 file 的磁盘使用情况。

这实际上是命令‘du’的一个等价物，但它还报告遇到的目录和非目录文件的数量（包括符号链接等）。

默认情况下，错误仅针对顶级文件本身报告。在递归过程中发现的错误将被静默忽略，除非在 flags 中提供了 G_FILE_MEASURE_REPORT_ANY_ERROR。

返回的大小，disk_usage，以字节为单位，应使用g_format_size()格式化，以便在用户界面中显示合理的内容。

可以提供 progress_callback 和 progress_data 来请求在扫描期间的定期进度更新。有关在何时以及如何调用回调的详细信息，请参阅 GFileMeasureProgressCallback 的文档。

自: 2.38

参数

flags

类型: GFileMeasureFlags

GFileMeasureFlags.

cancellable

类型: GCancellable

可选 GCancellable。

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

类型: GFileMeasureProgressCallback

一个 GFileMeasureProgressCallback。

progress_data

类型: gpointer

progress_callback 的用户数据。

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

类型: guint64*

使用的磁盘空间字节数。

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

类型: guint64*

遇到的目录数量。

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

类型: guint64*

遇到的非目录数量。

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

类型: GError **

恢复错误的返回位置的地址。

参数可以为 NULL。
如果返回位置不为 NULL，则必须将其初始化为 NULL 的 GError*。
如果虚函数没有错误，则将最终初始化为 NULL。
在出错的情况下，将设置参数为新分配的 GError；调用者将负责拥有数据，并负责释放它。

返回值

类型: gboolean

TRUE 表示成功，并且已设置输出参数。否则 FALSE，并设置 error。