mysqli_stmt_result_metadata(3) [php man page]

MYSQLI_STMT_RESULT_METADATA(3)						 1					    MYSQLI_STMT_RESULT_METADATA(3)

mysqli_stmt::result_metadata - Returns result set metadata from a prepared statement

       Object oriented style

SYNOPSIS

       mysqli_result mysqli_stmt::result_metadata (void  )

DESCRIPTION

       Procedural style
       mysqli_result mysqli_stmt_result_metadata (mysqli_stmt  $stmt)

	If  a  statement  passed  to mysqli_prepare(3) is one that produces a result set, mysqli_stmt_result_metadata(3) returns the result object
       that can be used to process the meta information such as total number of fields and individual field information.

       Note

	      This result set pointer can be passed as an argument to any of the field-based functions that process result set metadata, such as:

		     omysqli_num_fields(3)

		     omysqli_fetch_field(3)

		     omysqli_fetch_field_direct(3)

		     omysqli_fetch_fields(3)

		     omysqli_field_count(3)

		     omysqli_field_seek(3)

		     omysqli_field_tell(3)

		     omysqli_free_result(3)

	The result set structure should be freed when you are done with it, which you can do by passing it to mysqli_free_result(3)

       Note

	       The result set returned by mysqli_stmt_result_metadata(3) contains only metadata. It does not contain any row results. The rows are
	      obtained by using the statement handle with mysqli_stmt_fetch(3).

PARAMETERS

	      o $
		stmt -Procedural style only: A statement identifier returned by mysqli_stmt_init(3).

RETURN VALUES

	Returns a result object or FALSE if an error occurred.

EXAMPLES

       Example #1

	      Object oriented style

	      <?php
	      $mysqli = new mysqli("localhost", "my_user", "my_password", "test");

	      $mysqli->query("DROP TABLE IF EXISTS friends");
	      $mysqli->query("CREATE TABLE friends (id int, name varchar(20))");

	      $mysqli->query("INSERT INTO friends VALUES (1,'Hartmut'), (2, 'Ulf')");

	      $stmt = $mysqli->prepare("SELECT id, name FROM friends");
	      $stmt->execute();

	      /* get resultset for metadata */
	      $result = $stmt->result_metadata();

	      /* retrieve field information from metadata result set */
	      $field = $result->fetch_field();

	      printf("Fieldname: %s
", $field->name);

	      /* close resultset */
	      $result->close();

	      /* close connection */
	      $mysqli->close();
	      ?>

       Example #2

	      Procedural style

	      <?php
	      $link = mysqli_connect("localhost", "my_user", "my_password", "test");

	      mysqli_query($link, "DROP TABLE IF EXISTS friends");
	      mysqli_query($link, "CREATE TABLE friends (id int, name varchar(20))");

	      mysqli_query($link, "INSERT INTO friends VALUES (1,'Hartmut'), (2, 'Ulf')");

	      $stmt = mysqli_prepare($link, "SELECT id, name FROM friends");
	      mysqli_stmt_execute($stmt);

	      /* get resultset for metadata */
	      $result = mysqli_stmt_result_metadata($stmt);

	      /* retrieve field information from metadata result set */
	      $field = mysqli_fetch_field($result);

	      printf("Fieldname: %s
", $field->name);

	      /* close resultset */
	      mysqli_free_result($result);

	      /* close connection */
	      mysqli_close($link);
	      ?>

SEE ALSO

       mysqli_prepare(3), mysqli_free_result(3).

PHP Documentation Group 											    MYSQLI_STMT_RESULT_METADATA(3)

MYSQLI_STMT_SQLSTATE(3) 						 1						   MYSQLI_STMT_SQLSTATE(3)

mysqli_stmt::$sqlstate - Returns SQLSTATE error from previous statement operation

       Object oriented style

SYNOPSIS

       string$mysqli_stmt->sqlstate ()

DESCRIPTION

       Procedural style
       string mysqli_stmt_sqlstate (mysqli_stmt  $stmt)

	Returns  a  string  containing the SQLSTATE error code for the most recently invoked prepared statement function that can succeed or fail.
       The error code consists of five characters.  '00000' means no error. The values are specified by ANSI SQL and ODBC. For a list of  possible
       values, see http://dev.mysql.com/doc/mysql/en/error-handling.html.

PARAMETERS

	      o $
		stmt -Procedural style only: A statement identifier returned by mysqli_stmt_init(3).

RETURN VALUES

	Returns  a  string  containing	the  SQLSTATE error code for the last error. The error code consists of five characters.  '00000' means no
       error.

NOTES

       Note

	       Note that not all MySQL errors are yet mapped to SQLSTATE's. The value HY000 (general error) is used for unmapped errors.

EXAMPLES

       Example #1

	      Object oriented style

	      <?php
	      /* Open a connection */
	      $mysqli = new mysqli("localhost", "my_user", "my_password", "world");

	      /* check connection */
	      if (mysqli_connect_errno()) {
		  printf("Connect failed: %s
", mysqli_connect_error());
		  exit();
	      }

	      $mysqli->query("CREATE TABLE myCountry LIKE Country");
	      $mysqli->query("INSERT INTO myCountry SELECT * FROM Country");

	      $query = "SELECT Name, Code FROM myCountry ORDER BY Name";
	      if ($stmt = $mysqli->prepare($query)) {

		  /* drop table */
		  $mysqli->query("DROP TABLE myCountry");

		  /* execute query */
		  $stmt->execute();

		  printf("Error: %s.
", $stmt->sqlstate);

		  /* close statement */
		  $stmt->close();
	      }

	      /* close connection */
	      $mysqli->close();
	      ?>

       Example #2

	      Procedural style

	      <?php
	      /* Open a connection */
	      $link = mysqli_connect("localhost", "my_user", "my_password", "world");

	      /* check connection */
	      if (mysqli_connect_errno()) {
		  printf("Connect failed: %s
", mysqli_connect_error());
		  exit();
	      }

	      mysqli_query($link, "CREATE TABLE myCountry LIKE Country");
	      mysqli_query($link, "INSERT INTO myCountry SELECT * FROM Country");

	      $query = "SELECT Name, Code FROM myCountry ORDER BY Name";
	      if ($stmt = mysqli_prepare($link, $query)) {

		  /* drop table */
		  mysqli_query($link, "DROP TABLE myCountry");

		  /* execute query */
		  mysqli_stmt_execute($stmt);

		  printf("Error: %s.
", mysqli_stmt_sqlstate($stmt));

		  /* close statement */
		  mysqli_stmt_close($stmt);
	      }

	      /* close connection */
	      mysqli_close($link);
	      ?>

	      The above examples will output:

	      Error: 42S02.

SEE ALSO

       mysqli_stmt_errno(3), mysqli_stmt_error(3).

PHP Documentation Group 												   MYSQLI_STMT_SQLSTATE(3)