X1The "xzip_report" Data Structure
Description#
xzip_report is not a function, but rather a macro for a built-in ds_list that tracks errors in Xzip functions which work with multiple files simultaneously. This includes:
Monitored Functions#
xzip_addxzip_deletexzip_extractxzip_movexzip_set_readonly
These functions will return true or false to indicate whether all file operations completed successfully. In the event of errors, any problematic file names will be recorded in the data structure returned by xzip_report, as it is otherwise difficult to tell which files caused the errors to occur.
Any time a monitored function returns false, it is a good idea to parse xzip_report to take appropriate action in response. This is helpful not just in debugging, but also for handling errors gracefully in compiled applications.
note
For simplicity, only file names are recorded, not file paths. Paths for each file are already known by virtue of the fact they were input as arguments to a script; using file names only makes xzip_report easier to parse.
Keep in mind that xzip_report is refreshed each time a new monitored function is run. To store the contents of a report for future usage, it should be copied to a secondary ds_list with ds_list_copy. (Assigning xzip_report to another variable with = will not work, as this will reassign the ds_list index only, not the contents of the ds_list itself.)
Example#
This will check if an error occurs during a file deletion process, and if so, the first entry in xzip_report will be queried to determine if the archive itself is the problem.