Recursively measures the disk usage of this.
This is essentially an analog of the 'du' command, but it also reports the number of directories and non-directory files encountered ( including things like symbolic links).
By default, errors are only reported against the toplevel file itself. Errors found while recursing are silently ignored, unless
g_file_measure_report_any_error is given in flags
.
The returned size, disk_usage
, is in bytes and should be formatted with g_format_size
in order to get something
reasonable for showing in a user interface.
progress_callback
and progress_data
can be given to request periodic progress updates while scanning. See the
documentation for FileMeasureProgressCallback for information about
when and how the callback will be invoked.
this |
a File |
flags | |
cancellable |
optional Cancellable |
progress_callback | |
disk_usage |
the number of bytes of disk space used |
num_dirs |
the number of directories encountered |
num_files |
the number of non-directories encountered |
progress_data |
user_data for |
true if successful, with the out parameters set. false otherwise, with throws set. |