fbsql_affected_rows

(PHP 4 >= 4.0.6, PHP 5, PHP 7)

fbsql_affected_rowsObtiene el numero de filas afectadas en la anterior operación de FrontBase

Descripción

fbsql_affected_rows ([ resource $link_identifier ] ) : int

fbsql_affected_rows() devuelve el número de filas afectadas por la última consulta INSERT, UPDATE o DELETE asociada al link_identifier.

Nota:

En caso de utilizar transacciones, se tiene que llamar fbsql_affected_rows() después de la consulta INSERT, UPDATE, o DELETE, no después del commit.

Si la última consulta fue un DELETE sin WHERE, todos los registros habrán sido borrados de la tabla, sin embargo la función devolverá cero.

Nota:

Cuando se usa UPDATE, FrontBase no actualiza las columnas donde el nuevo valor es el mismo que el antiguo. Esto da la posibilidad de que fbsql_affected_rows() no devuelva el número de columnas encontradas, sino únicamente el número de columnas afectadas literalmente por la consulta.

Parámetros

link_identifier

Un identificador de enlace FrontBase devuelto por fbsql_connect() o fbsql_pconnect().

Es opcional y si no se especifica, la función intentará encontrar un enlace abierto al servidor FrontBase y de no encontrarse ningún enlace abierto intentará crear uno como si fbsql_connect() fuese invocada sin parámetros.

Valores devueltos

Si la última consulta falló, esta función devolverá -1.

Ver también