executeSQLStatement()

See Also

Syntax

 executeSQLStatement(id, callbackFunction)

Parameter(s)

Description

This function executes a static defined SQL statement, identified by the id of the statement. If the callback function is set it becomes an asynchronous request. This means that overall script execution does not wait until completion of the action but instantly continues. The callback function is called when the action is ready.

Example of callback usage:

//callback definition
 function done() {alert('done!')}
//actual call
 executeSQLStatement("heavy statement id", done)
//to illustrate the continuation of the script
 alert('waiting')

Result: This will first display the text: ‘waiting’, when this is clicked away you will see the text: ‘done’.

Related functions: getRecordCount(), getDataSet()