sqlite.h


Número total de filas modificadas

int sqlite3_total_changes(sqlite3*);

Esta función devuelve el número de filas modificadas a causa de sentencias INSERT, UPDATE o DELETE desde que la conexión de base de datos fue abierta. El contador devuelto por sqlite3_total_changes() incluye todos los cambios desde todos los contextos de disparador y los cambios hechos por acciones de claves foráneas. Sin embargo, el contador no incluye los cambios usados para implementar restricciones REPLACE, hacer rollbacks o procesar ABORT, o procesar DROP TABLE. La cuenta no incluye filas de vistas que disparen un disparador INSTEAD OF, aunque si el disparador INSTEAD OF hace cambios por si mismo, esos cambios se cuentan. La función sqlite3_total_changes() cuenta los cambios tan pronto como la sentencia que los hace se completa (cuando el manipulador de sentencia es pasado a sqlite3_reset() o sqlite3_finalize()).

Ver también la función sqlite3_changes(), el pragma count_changes y la función SQL total_changes().

Si un hilo separado realiza cambios en la misma conexión de base de datos mientras se ejecuta sqlite3_total_changes() el valor devuelto es impredecible y no significativo.