Modules/MySQL/MysqlQuery: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
(4 intermediate revisions by 3 users not shown) | |||
Line 2: | Line 2: | ||
{{ModuleFunction|MySQL}} | {{ModuleFunction|MySQL}} | ||
This functions queries the MySQL server through the MySQL connection that has been opened by [[mysqlOpen]]. The result of the query is then passed to the script by calling callback_function. It's syntax and functionality is similar to that of [[executeSQLSelect]]. | This functions queries the MySQL server through the MySQL connection that has been opened by [[Modules/MySQL/MysqlOpen|mysqlOpen]]. The result of the query is then passed to the script by calling callback_function. It's syntax and functionality is similar to that of [[executeSQLSelect]]. | ||
==Syntax== | ==Syntax== | ||
<syntaxhighlight lang="lua">bool mysqlQuery ( mysql | <syntaxhighlight lang="lua">bool mysqlQuery ( mysql mysqlobj, string callback_function, string query )</syntaxhighlight> | ||
===Required Arguments=== | ===Required Arguments=== | ||
*''' | *'''mysqlobj''' : A ''mysql'' object created by [[Modules/MySQL/MysqlCreate|mysqlCreate]] | ||
*'''callback_function''' : The function that is called if the operation is done ( | *'''callback_function''' : The function that is called if the operation is done (see below) | ||
*'''query''' : The MySQL query that is sent | *'''query''' : The MySQL query that is sent | ||
Line 30: | Line 30: | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
function onMySQLResult ( table ) | function onMySQLResult ( table ) | ||
outputServerLog ( " | outputServerLog ( "Printing some test results" ) | ||
outputServerLog ( table[1][1] ) | outputServerLog ( table[1][1] ) | ||
outputServerLog ( table[1][2] ) | outputServerLog ( table[1][2] ) | ||
end | end | ||
function onMySQLOpen ( | function onMySQLOpen ( result ) | ||
if ( result ) then | if ( result ) then | ||
outputServerLog ( " | outputServerLog ( "MySQL connection established." ) | ||
mysqlQuery ( | mysqlQuery ( db, "onMySQLResult", "SELECT * FROM test" ) | ||
else | else | ||
outputServerLog ( " | outputServerLog ( "MySQL connection failed." ) | ||
end | end | ||
end | end | ||
function mysqltest () | function mysqltest () | ||
mysqlOpen ( "onMySQLOpen", "localhost", "bastage", "bastage_pw", "test", 3306 ) | db = mysqlCreate () | ||
mysqlOpen ( db, "onMySQLOpen", "localhost", "bastage", "bastage_pw", "test", 3306 ) | |||
end | end | ||
</syntaxhighlight> | </syntaxhighlight> |
Latest revision as of 20:48, 29 September 2009
This function is provided by the external module MySQL. You must install this module to use this function. | |
This functions queries the MySQL server through the MySQL connection that has been opened by mysqlOpen. The result of the query is then passed to the script by calling callback_function. It's syntax and functionality is similar to that of executeSQLSelect.
Syntax
bool mysqlQuery ( mysql mysqlobj, string callback_function, string query )
Required Arguments
- mysqlobj : A mysql object created by mysqlCreate
- callback_function : The function that is called if the operation is done (see below)
- query : The MySQL query that is sent
Callback Arguments
Your callback function has to accept the following arguments.
On success:
- table: The 2-dimensional table where the results are stored in: table [row_index] [column_index].
On failure:
- boolean: False, when no rows are found or an error occured.
Optional Arguments
None
Example
function onMySQLResult ( table ) outputServerLog ( "Printing some test results" ) outputServerLog ( table[1][1] ) outputServerLog ( table[1][2] ) end function onMySQLOpen ( result ) if ( result ) then outputServerLog ( "MySQL connection established." ) mysqlQuery ( db, "onMySQLResult", "SELECT * FROM test" ) else outputServerLog ( "MySQL connection failed." ) end end function mysqltest () db = mysqlCreate () mysqlOpen ( db, "onMySQLOpen", "localhost", "bastage", "bastage_pw", "test", 3306 ) end