sqlsrv_rows_affected

Artículo
06/02/2023

Devuelve el número de filas modificadas mediante la última instrucción ejecutada. Esta función no devuelve el número de filas que devuelve una instrucción SELECT.

Sintaxis

  
sqlsrv_rows_affected( resource $stmt)

Parámetros

$stmt: un recurso de instrucción correspondiente a una instrucción ejecutada.

Valor devuelto

Un valor entero que indica el número de filas modificadas mediante la última instrucción ejecutada. Si no hay filas modificadas, se devuelve cero (0). Si no hay información sobre el número de filas modificadas disponibles, se devuelve un valor uno negativo (-1). Si se produjo un error al recuperar el número de filas modificadas, se devuelve el valor False .

Ejemplo

En el ejemplo siguiente se muestra el número de filas modificadas mediante una instrucción UPDATE. En el ejemplo se da por hecho que SQL Server y la base de datos AdventureWorks están instalados en el equipo local. Los resultados se agregan a la consola cuando se ejecuta el ejemplo en la línea de comandos.

<?php  
/* Connect to the local server using Windows Authentication and  
specify the AdventureWorks database as the database in use. */  
$serverName = "(local)";  
$connectionInfo = array( "Database"=>"AdventureWorks");  
$conn = sqlsrv_connect( $serverName, $connectionInfo);  
if( $conn === false )  
{  
     echo "Could not connect.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
  
/* Set up Transact-SQL query. */  
$tsql = "UPDATE Sales.SalesOrderDetail   
         SET SpecialOfferID = ?   
         WHERE ProductID = ?";  
  
/* Set parameter values. */  
$params = array(2, 709);  
  
/* Execute the statement. */  
$stmt = sqlsrv_query( $conn, $tsql, $params);  
  
/* Get the number of rows affected and display appropriate message.*/  
$rows_affected = sqlsrv_rows_affected( $stmt);  
if( $rows_affected === false)  
{  
     echo "Error in calling sqlsrv_rows_affected.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
elseif( $rows_affected == -1)  
{  
      echo "No information available.\n";  
}  
else  
{  
      echo $rows_affected." rows were updated.\n";  
}  
  
/* Free statement and connection resources. */  
sqlsrv_free_stmt( $stmt);  
sqlsrv_close( $conn);  
?>

Consulte también

Referencia de API del controlador SQLSRV

Sobre los ejemplos de código de la documentación

Actualización de datos (controladores de Microsoft para PHP para SQL Server)

Compartir vía