PHP 8.2.0 Alpha 2 available for testing

sqlsrv_cancel

(No version information available, might only be in Git)

sqlsrv_cancelОтменяет оператор

Описание

sqlsrv_cancel(resource $stmt): bool

Отменяет оператор. Все неиспользованные результаты, связанные с оператором, удаляются. После вызова sqlsrv_cancel() указанный оператор может быть выполнен повторно, если он был создан с помощью sqlsrv_prepare(). Вызов sqlsrv_cancel() не требуется, если все результаты, связанные с оператором, были использованы.

Список параметров

stmt

Ресурс оператора, который нужно отменить.

Возвращаемые значения

Возвращает true в случае успешного выполнения или false в случае возникновения ошибки.

Примеры

Пример #1 Пример использования sqlsrv_cancel()

<?php
$serverName 
"serverName\sqlexpress";
$connectionInfo = array( "Database"=>"dbName""UID"=>"username""PWD"=>"password");
$conn sqlsrv_connect$serverName$connectionInfo);
if( 
$conn === false ) {
     die( 
print_rsqlsrv_errors(), true));
}

$sql "SELECT Sales FROM Table_1";

$stmt sqlsrv_prepare$conn$sql);

if( 
$stmt === false ) {
     die( 
print_rsqlsrv_errors(), true));
}

if( 
sqlsrv_execute$stmt ) === false) {
     die( 
print_rsqlsrv_errors(), true));
}

$salesTotal 0;
$count 0;

while( (
$row sqlsrv_fetch_array$stmt)) && $salesTotal <=100000)
{
     
$qty $row[0];
     
$price $row[1];
     
$salesTotal += ( $price $qty);
     
$count++;
}

echo 
"$count продаж составили первый $$salesTotal выручки.<br />";

// Отменить ожидающие результаты. Оператор можно использовать повторно.
sqlsrv_cancel$stmt);
?>

Примечания

Основное различие между sqlsrv_free_stmt() и sqlsrv_cancel() заключается в том, что ресурс оператора, отменённый с помощью sqlsrv_cancel(), может быть повторно выполнен, если он был создан с помощью sqlsrv_prepare(). Ресурс оператора, отменённый с помощью sqlsrv_free_statement(), не может быть повторно выполнен.

Смотрите также

  • sqlsrv_free_stmt() - Освобождает все ресурсы для указанного оператора
  • sqlsrv_prepare() - Подготавливает запрос к исполнению

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top