int SQLiteClose();

Closes the currently open SQLite database.

Return Value

Returns zero if the call was successful.

Remarks

SQLiteClose() closes the currently open SQLite database.  When you no longer need to access your database, it is important to close it so that any allocated memory is freed by the SQLite engine.

DragonFireSDK supports SQLite version 3.7.6.2.

Availability

Available in DragonFireSDK 2.0 and later.

Example

#include "DragonFireSDK.h"

int OnColumn(char *value, char *name)

{

  // Print the column name and value to the console window:

   printf("OnColumn: %s\t%s\n", name, value);

  return(1);

}

int OnRow(char *value)

{

  // Print the row to the console window:

   printf("OnRow: %s\n", value);

  return(1);

}

void AppMain()

{

  int result;

  // Create or open the database:

   result=SQLiteOpen("mydatabase.db");

   printf("SQLiteOpen result: %d\n", result);

  // Set up the OnColumn callback:

   result=SQLiteSetOnColumn(OnColumn);

   printf("SQLiteSetOnColumn result: %d\n", result);

  // Set up the OnRow callback:

   result=SQLiteSetOnRow(OnRow);

   printf("SQLiteSetOnRow result: %d\n", result);

  // Drop the any existing 'mytable':

   result=SQLiteExec("drop table mytable");

   printf("SQLiteExec (drop table query) result: %d\n", result);

  // Create a table called 'mytable':

   result=SQLiteExec("create table mytable (firstname varchar(30), lastname varchar(30), address varchar(50))");

   printf("SQLiteExec (create query) result: %d\n", result);

  // Insert a record into 'mytable':

   result=SQLiteExec("insert into mytable (firstname, lastname, address) values ('John','Doe','123 Main Street')");

   printf("SQLiteExec (insert query) result: %d\n", result);

  // Select all the rows from 'mytable':

   result=SQLiteExec("select * from mytable");

   printf("SQLiteExec (select query) result: %d\n", result);

  // Print the last encountered error to the console:

   printf("SQLiteGetLastError: %s\n", SQLiteGetLastError());

}

void AppExit()

{

  int result;

  // Close the database:

   result=SQLiteClose();

   printf("SQLiteClose result: %d\n", result);

}

void OnTimer()

{

}