mysqli_affected_rows
mysqli->affected_rows
Obtiene el número de filas afectadas en una operación
de MySQL previa
Descripción
Estilo por procedimientos:
mixtomysqli_affected_rows
objetoidentificador_de_enlace
Estilo orientado a objetos (característica):
mysqli
mixtoaffected_rows
mysqli_affected_rows Regresa el número de filas
afectadas por la última consulta INSERT, UPDATE, o DELETE asociada
con el identificador_de_enlace dado. Si la última
consulta fue invalida, esta función regresará -1.
Para sentencias SELECT mysqli_affected_rows trabaja
igual a mysqli_num_rows.
La función mysqli_affected_rows s&oacoute;lo trabaja
con consultas que modifican o afectan una tabla. En caso de que necesite el
número de filas de una consulta SELECT, use la función
mysqli_num_rows en su lugar.
Valores Regresados
Un entero mayor a cero indica el número de filas afectadas u obtenidas.
Cero indica que no se actualizaron registros para una sentencia UPDATE, no hubo
coincidencias con la clausula WHERE en la consulta o que no se ha ejecutado
aún ninguna consulta. -1 indica que la consulta regreso un error.
Si el número de filas afectadas es mayor que el valor entero máximo,
entonces el número de filas afectadas será regresado como una cadena.
Vea también
mysqli_num_rows,
mysqli_info.
Ejemplos
Estilo orientado a objetos
query("CREATE TABLE Language SELECT * from CountryLanguage");
printf("Affected rows (INSERT): %d\n", $mysqli->affected_rows);
$mysqli->query("ALTER TABLE Language ADD Status int default 0");
/* update rows */
$mysqli->query("UPDATE Language SET Status=1 WHERE Percentage > 50");
printf("Affected rows (UPDATE): %d\n", $mysqli->affected_rows);
/* delete rows */
$mysqli->query("DELETE FROM Language WHERE Percentage < 50");
printf("Affected rows (DELETE): %d\n", $mysqli->affected_rows);
/* select all rows */
$result = $mysqli->query("SELECT CountryCode FROM Language");
printf("Affected rows (SELECT): %d\n", $mysqli->affected_rows);
$result->close();
/* Delete table Language */
$mysqli->query("DROP TABLE Language");
/* close connection */
$mysqli->close();
?>
]]>
Estilo por procedimientos
50");
printf("Affected rows (UPDATE): %d\n", mysqli_affected_rows($link));
/* delete rows */
mysqli_query($link, "DELETE FROM Language WHERE Percentage < 50");
printf("Affected rows (DELETE): %d\n", mysqli_affected_rows($link));
/* select all rows */
$result = mysqli_query($link, "SELECT CountryCode FROM Language");
printf("Affected rows (SELECT): %d\n", mysqli_affected_rows($link));
mysqli_free_result($result);
/* Delete table Language */
mysqli_query($link, "DROP TABLE Language");
/* close connection */
mysqli_close($link);
?>
]]>
Los ejemplos anteriores producirán la siguiente salida: