sqlsrv_rows_affected

2025-01-02

Mengembalikan jumlah baris yang dimodifikasi oleh pernyataan terakhir yang dijalankan. Fungsi ini tidak mengembalikan jumlah baris yang dikembalikan oleh pernyataan SELECT.

Sintaks

  
sqlsrv_rows_affected( resource $stmt)

Parameter

$stmt: Sumber daya pernyataan yang sesuai dengan pernyataan yang dijalankan.

Tampilkan Nilai

Bilangan bulat yang menunjukkan jumlah baris yang dimodifikasi oleh pernyataan terakhir yang dijalankan. Jika tidak ada baris yang dimodifikasi, nol (0) dikembalikan. Jika tidak ada informasi tentang jumlah baris yang dimodifikasi yang tersedia, baris negatif (-1) dikembalikan. Jika terjadi kesalahan dalam mengambil jumlah baris yang dimodifikasi, false akan dikembalikan.

Contoh

Contoh berikut menampilkan jumlah baris yang dimodifikasi oleh pernyataan UPDATE. Contoh mengasumsikan bahwa SQL Server dan database AdventureWorks diinstal di komputer lokal. Semua output ditulis ke konsol saat contoh dijalankan dari baris perintah.

<?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);  
?>

Lihat Juga

Referensi API Driver SQLSRV

Tentang Contoh Kode dalam Dokumentasi

Memperbarui Data (Driver Microsoft untuk PHP untuk SQL Server)