Module "sql_utils"
==================

Additional SQL helper functions.

The "sql" module just provides a generic function for doing SQL queries,
namely sql(). This module declares some wrapper functions for
sql() which do implement common usage scenarios for sql().
 
function sql_value(db, query);
------------------------------

Execute the query and return the first field of the first tuple in the
result.
 

function sql_tuple(db, query);
------------------------------

Execute the query and return the first tuple in the result.
 

function sql_keyval(db, query);
-------------------------------

Execute the query, which must return fields named 'key' and 'value', and
return a hash created from this result set.
 

function sql_array(db, query);
------------------------------

Execute the query, which must return fields named 'value', and return an
array created from this result set.
 
