sqlite_save_dbT_sqlite_save_dbSqliteSaveDbSqliteSaveDb (Operator)

Name

sqlite_save_dbT_sqlite_save_dbSqliteSaveDbSqliteSaveDb — Saving of a copy of an open database.

Signature

sqlite_save_db( : : SqliteHandle, FileNameBackup : )

Description

sqlite_save_dbsqlite_save_dbSqliteSaveDbSqliteSaveDbSqliteSaveDb saves a copy of an open database specified in SqliteHandleSqliteHandleSqliteHandleSqliteHandlesqliteHandle to a file specified in FileNameBackupFileNameBackupFileNameBackupFileNameBackupfileNameBackup. This is particulary useful to save an in-memory database created with ':memory:'":memory:"":memory:"":memory:"":memory:" in sqlite_opensqlite_openSqliteOpenSqliteOpenSqliteOpen.

If saving fails, the error H_ERR_FNF (5200) will be returned. An error message will be output in the HDevelop Output Console, see set_systemset_systemSetSystemSetSystemSetSystem parameter 'do_low_error'"do_low_error""do_low_error""do_low_error""do_low_error".

Find more information about the Sqlite extension package in the introduction to this chapter.

Execution Information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

SqliteHandleSqliteHandleSqliteHandleSqliteHandlesqliteHandle (input_control) framegrabber → (handle)

handle to a SQLite data base

FileNameBackupFileNameBackupFileNameBackupFileNameBackupfileNameBackup (input_control) filename.write → (string)

full path of the database file

Default value: 'C:/TEMP/mydata.db' "C:/TEMP/mydata.db" "C:/TEMP/mydata.db" "C:/TEMP/mydata.db" "C:/TEMP/mydata.db"

Suggested values: 'C:/TEMP/mydata.db'"C:/TEMP/mydata.db""C:/TEMP/mydata.db""C:/TEMP/mydata.db""C:/TEMP/mydata.db"

Module

Foundation

Operators