方法
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_callback
和progress_data
可以提供,以在扫描时请求周期性的进度更新。有关回调何时以及如何被调用的信息,请参阅GFileMeasureProgressCallback
的文档。
自:2.38
参数
flags
-
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
,则必须将其初始化为NULL
的GError*
。如果没有错误,方法将保留初始化为 NULL
的参数。出错时,参数将设置为一个新的分配的 GError
;调用者将拥有数据,并负责释放它。