mysqli_stmt_result_metadata
(PHP 5)
mysqli_stmt_result_metadata -- Regresa metadatos del resultado de una sentencia preparada
Descripción
Estilo por procedimientos:
mixto
mysqli_stmt_result_metadata ( mysqli_stmt stmt )
Estilo orientado a objetos (método):
class
mysqli_stmt {
mixto
result_metadata ( void )
}
Si una sentencia pasada a mysqli_prepare() es una que produce
un resultado, mysqli_stmt_result_metadata() regresa el
objeto del resultado que puede ser usado para procesar los metadatos de
información tales como el número total de campos e información
del campo individual.
Nota:
Este apuntador del resultado puede ser pasado como un argumento a cualquiera
de las funciones basadas en campos que procesan los metadatos del resultado
tales como:
La estructura del resultado debe ser liberada cuando haya terminado con esta,
lo cual puede hacer pasandola a mysqli_free_result()
Nota:
El resultado regresado por mysqli_stmt_result_metadata()
contiene solo metadatos. No contiene ninguna fila del resultado. Las filas
son obtenidas usando el manejador de la sentencia con
mysqli_stmt_fetch().
Valores retornados
mysqli_stmt_result_metadata() regresa un objeto del resultado
o FALSE si ocurrio un error.
Ejemplos
Ejemplo 1. Estilo orientado a objetos
<?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\n", $field->name);
/* close resultset */ $result->close();
/* close connection */ $mysqli->close(); ?>
|
|
Ejemplo 2. Estilo por procedimientos
<?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\n", $field->name);
/* close resultset */ mysqli_free_result($result);
/* close connection */ mysqli_close($link); ?>
|
|