function.mysqli-stmt-result-metadata -- http://www.mundoscript.com/php/function.mysqli-stmt-result-metadata.html mysqli_stmt_result_metadata

Manual de PHP
Anterior		Siguiente

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 ( objeto stmt)

Estilo orientado a objetos (método):

class 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:
mysqli_num_fields()
mysqli_fetch_field()
mysqli_fetch_field_direct()
mysqli_fetch_fields()
mysqli_field_count()
mysqli_field_seek()
mysqli_field_tell()
mysqli_free_result()

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_fetch().

Valores retornados

mysqli_stmt_result_metadata() regresa un objeto del resultado o FALSE si ocurrio un error.

Vea también:

mysqli_prepare(), mysqli_free_result()

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); ?>

Anterior	Inicio	Siguiente
mysqli_stmt_reset	Subir	mysqli_stmt_send_long_data