Please enable JavaScript to view this site.

Take Command / TCC Help v. 28

@UNQKVF[[u,]filename,"key","value"[,length]] : Add a key / file value pair to a UnQlite database.


uOptional flag that the key and value are Unicode (UTF16)
filenameDatabase opened with @UNQOPEN
keyKey to add or replace
filenameStore the contents of the file filename in the value
lengthOptional length (in bytes) to write (if -1 or nor specified, write the entire file)


The maximum file size is dependent on the amount of RAM and disk space available.


Returns 0 if successful, or the error text if not.




This example opens a database named "test.db", writes a key/file to the database, and then reads it back, saving it in a new file.


echo Testing file write and read

echo This is a test file > testfile.txt

echo %@unqopen[rwc,test.db]

echo %@unqkvf[test.db,"aaa",testfile.txt]

echo %@unqreadf[test.db,"aaa",newtestfile.txt]

echo %@unqclose[test.db]