Função PHP mysqli_stmt_reset ()

Definição e Uso

o mysqli_stmt_reset()A função aceita um objeto de instrução preparado (previamente aberto) como parâmetro e o redefine, isto é, ele altera redefine os erros, conjuntos de resultados sem buffer e dados enviados. A consulta, as ligações e os conjuntos de resultados armazenados não serão alterados.

Sintaxe

mysqli_stmt_reset($stmt);

Parâmetros

Sr. Não	Parâmetro e Descrição
1	con(Mandatory) Este é um objeto que representa uma declaração preparada.

Valores Retornados

A função PHP mysqli_stmt_reset () retorna um valor booleano que é verdadeiro em caso de sucesso e falso em caso de falha.

Versão PHP

Esta função foi introduzida pela primeira vez no PHP Versão 5 e funciona em todas as versões posteriores.

Exemplo

O exemplo a seguir demonstra o uso da função mysqli_stmt_reset () (no estilo procedural) -

<?php
   $con = mysqli_connect("localhost", "root", "password", "mydb");

   mysqli_query($con, "CREATE TABLE myplayers(ID INT, First_Name VARCHAR(255), Last_Name VARCHAR(255), Place_Of_Birth VARCHAR(255), Country VARCHAR(255))");
   print("Table Created.....\n");
   mysqli_query($con, "INSERT INTO myplayers values(1, 'Sikhar', 'Dhawan', 'Delhi', 'India')");
   mysqli_query($con, "INSERT INTO myplayers values(2, 'Jonathan', 'Trott', 'CapeTown', 'SouthAfrica')");
   print("Record Inserted.....\n");

   //Retrieving the contents of the table
   $stmt = mysqli_prepare($con, "SELECT * FROM myplayers");

   //Executing the statement
   mysqli_stmt_execute($stmt);

   $res = mysqli_stmt_reset($stmt);
   if($res){
      print("Reset Successful");	
   }

   //Binding values in result to variables
   $res = mysqli_stmt_bind_result($stmt, $id, $fname, $lname, $pob, $country);

   while (mysqli_stmt_fetch($stmt)) {
      print("Id: ".$id."\n");
      print("fname: ".$fname."\n");
      print("lname: ".$lname."\n");
      print("pob: ".$pob."\n");
      print("country: ".$country."\n");
      print("\n");

   }
   //Closing the statement
   mysqli_stmt_close($stmt);

   //Closing the connection
   mysqli_close($con);
?>

Isso produzirá o seguinte resultado -

Record Inserted.....
Reset Successful

Uma vez que reinicializamos a instrução no meio, o conteúdo do resultado não é impresso sem a função de reinicialização, este programa gera a seguinte saída -

Record Inserted.....
Reset Successful
E:\PHPExamples>php procedure_oriented.php
Table Created.....
Record Inserted.....
Id: 1
fname: Sikhar
lname: Dhawan
pob: Delhi
country: India

Id: 2
fname: Jonathan
lname: Trott
pob: CapeTown
country: SouthAfrica

Exemplo

No estilo orientado a objetos, a sintaxe desta função é $ stmt-> close (); A seguir está o exemplo desta função no estilo orientado a objetos $ minus;

<?php
   //Creating a connection
   $con = new mysqli("localhost", "root", "password", "mydb");

   //Creating a table
   $con -> query("CREATE TABLE players(ID INT, First_Name VARCHAR(255), Last_Name VARCHAR(255), Place_Of_Birth VARCHAR(255), Country VARCHAR(255))");
   print("Table Created.....\n");

   //Inserting values into the table using prepared statement
   $stmt = $con -> prepare( "INSERT INTO players values(?, ?, ?, ?, ?)");

   $res = $stmt->reset();

   if($res){
      print("Reset Successful");	
   }

   //Binding values to the parameter markers
   $stmt -> bind_param("issss", $id, $fname, $lname, $pob, $country);
   $id = 1;
   $fname = 'Shikhar';
   $lname = 'Dhawan';
   $pob = 'Delhi';
   $country = 'India';

   //Executing the statement
   $stmt->execute();

   //Closing the statement
   $stmt->close();

   //Closing the connection
   $con->close();
?>

Isso produzirá o seguinte resultado -

Table Created.....
Reset Successful

E o conteúdo da mesa dos jogadores estará vazio -

mysql> drop table players;
Query OK, 0 rows affected (0.26 sec)

Se você remover a função reset () e executar o programa acima, o conteúdo da tabela de jogadores será o seguinte -

mysql> select * from players;
+------+------------+-----------+----------------+---------+
| ID   | First_Name | Last_Name | Place_Of_Birth | Country |
+------+------------+-----------+----------------+---------+
|    1 | Shikhar    | Dhawan    | Delhi          | India   |
+------+------------+-----------+----------------+---------+
1 row in set (0.00 sec)

↰ Previous page