sqlsrv_num_rows (número de linhas)

Descarregar o driver PHP

Reporta o número de linhas num conjunto de resultados.

Syntax

  
sqlsrv_num_rows( resource $stmt )

Parâmetros

$stmt: O conjunto de resultados para contar as carreiras.

Valor de retorno

falso se houver um erro ao calcular o número de linhas. Caso contrário, devolve o número de linhas no conjunto de resultados.

Observações

sqlsrv_num_rows requer um cursor do lado do cliente, estático ou de keyset, e devolve um defeito falso se usar um cursor avançado ou dinâmico. (Um cursor para a frente é o padrão.) Para mais informações sobre cursores, veja sqlsrv_query e Tipos de Cursor (Driver SQLSRV).

Example

<?php  
   $server = "server_name";  
   $conn = sqlsrv_connect( $server, array( 'Database' => 'Northwind' ) );  
  
   $stmt = sqlsrv_query( $conn, "select * from orders where CustomerID = 'VINET'" , array(), array( "Scrollable" => SQLSRV_CURSOR_KEYSET ));  
  
   $row_count = sqlsrv_num_rows( $stmt );  
  
   if ($row_count === false)  
      echo "\nerror\n";  
   else if ($row_count >=0)  
      echo "\n$row_count\n";  
?>

O exemplo seguinte mostra que, quando há mais do que um conjunto de resultados (uma consulta em lote), o número de linhas só está disponível quando se usa um cursor do lado do cliente.

<?php  
$serverName = "(local)";  
$connectionInfo = array("Database"=>"AdventureWorks");  
$conn = sqlsrv_connect( $serverName, $connectionInfo);  
  
$tsql = "select * from HumanResources.Department";  
  
// Client-side cursor and batch statements  
$tsql = "select top 2 * from HumanResources.Employee;Select top 3 * from HumanResources.EmployeeAddress";  
  
// works  
$stmt = sqlsrv_query($conn, $tsql, array(), array("Scrollable"=>"buffered"));  
  
// fails  
// $stmt = sqlsrv_query($conn, $tsql);  
// $stmt = sqlsrv_query($conn, $tsql, array(), array("Scrollable"=>"forward"));  
// $stmt = sqlsrv_query($conn, $tsql, array(), array("Scrollable"=>"static"));  
// $stmt = sqlsrv_query($conn, $tsql, array(), array("Scrollable"=>"keyset"));  
// $stmt = sqlsrv_query($conn, $tsql, array(), array("Scrollable"=>"dynamic"));  
  
$row_count = sqlsrv_num_rows( $stmt );  
echo "\nRow count for first result set = $row_count\n";  
  
sqlsrv_next_result($stmt);  
  
$row_count = sqlsrv_num_rows( $stmt );  
echo "\nRow count for second result set = $row_count\n";  
?>

Conteúdo relacionado

  • Last updated on