oosqlBackupRemaining



Returns the number of pages still to be backed up in the source database file. This function is part of the Online Backup Feature for the online backup feature of SQLite.

Arguments: The single argument is:
buHandle [required] The non-null handle to the backup returned from oosqlBackupInit .
Return value: The number of pages in the source database file that still need to be backed up.
Details The functionality of theoosqlBackupRemainingroutine is similar to that of the sqlite3_backup_remaining SQLite API .
Example: This example shows how to calculate the percentage complete of a backup. The code snippet would be executed after a call to oosqlBackupStep(). Maybe every call, or every 5th call, ...
remain = oosqlBackupRemaining(buHandle)
pages = oosqlBackupPageCount(buHandle)
percentComplete = 100 * (pages - remain) / pages
say "Backup" percentComplete "percent complete..."
/* Output might be:
Backup 8 percent complete...
Backup 16 percent complete...
Backup 24 percent complete...
Backup 32 percent complete...
Backup 40 percent complete...
Backup 48 percent complete...
*/