Api de Base de datos en OpenACS 5.1 (Cuarta Parte) Otras funciones

Completaremos la Api de BD de openAcs con la mención a otras funciones de interés que serán a veces necesarias para dar funcionalidad a nuestras aplicaciones.
Su uso es en la mayoria de las veces practicamente identico en el caso de las funciones que devuelven el resultado de una busqyeda asi que tan solo haremos mención a su sintaxis.

db_null -> Es un valor que representa el valor NULL, OpenACS necesita este valor para proporcionar independencia
sobre la base de datos.
Así utilizaremos este valor en vez del null nativo de nuestro gestor de base de datos.

db_type -> Devuelve el Gestor de base de datos que está siendo utilizado.

db_version -> Nos proporciona la versión del Gestor de BD utilizado.

db_name -> Nos dá el nombre de la Base de datos del Sistema OpenACS.

db_nexval -> Proporciona el siguiente valor de una secuencia de nuestra base de datos.
Su uso es el siguente: db_nexval secuencia.
Por ejemplo supongamos que tenemos una secuencia llamada numero_factura y queremos generar el valor siguiente:
set nuevo_numero= db_nextval numero_factura

db_resultrows -> Nos devuelve el numero de filas afectadas (en una operación de actualizacion,borrado, insercion,etc) o devueltas en
en una sentencia sql anterior.

db_string -> Devuelve la primera columna del resultado de una consulta.Si la consulta no devuelve filas entonces
se devuelve el valor default y en caso de que este no haya sido definido se genera un error.
Ejemplo de uso:
db_string nombre "SELECT nombre FROM amigos WHERE amigo_id=id" - default db_null

db_list -> Devuelve una lista TCL con los valores de la primera columna de los resultados.
Ejemplo:
db_list lista_nombres "SELECT nombre FROM amigos"

db_list_of_lists -> Nos devuelve una lista de listas en TCL con todos los valores de todas las columnas de las filas resultado que nos
proporcione la sentencia SQL.
Ejemplo:
db_list_of_lists lista_datos_amigos "SELECT nombre,apellidos,telefono FROM amigos"

db_list_of_ns_sets -> Devuelve una lista de ns_sets con los valores devueltos por la sentencia sql.
Un ns_sets es un conjunto clave-valor, para mas información revisar la documentación de la Api de Aol-server:
http://aolserver.com/docs/devel/tcl/api/general.html#ns_set

Existen otras funciones en la API para bases de datos pero con las funciones que hemos comentado en estas cuatro partes tenemos toda la funcionalidad que requerimos para desarrollar nuestras aplicaciones.
Para mayor detalle podemos consultar la documentación oficial para la Api de BD en Ingles:
http://openacs.org/doc/openacs-5-1/db-api-detailed.html