方法
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-
类型:
GFileMeasureProgressCallbackGFileMeasureProgressCallback。参数可以为 NULL。 progress_data-
类型:
gpointerprogress_callback的用户数据。参数可以为 NULL。数据由方法的调用者拥有。 disk_usage-
类型:
guint64*使用的磁盘空间字节数。
参数将由函数设置。 参数可以为 NULL。 num_dirs-
类型:
guint64*遇到的目录数量。
参数将由函数设置。 参数可以为 NULL。 num_files-
类型:
guint64*遇到的非目录数量。
参数将由函数设置。 参数可以为 NULL。 error-
类型:
GError **恢复性错误的返回位置。
参数可以为 NULL。如果返回位置不为 NULL,则必须将其初始化为NULL的GError*。如果没有错误,方法将保留初始化为 NULL的参数。出错时,参数将设置为一个新的分配的 GError;调用者将拥有数据,并负责释放它。