mysqli info

(PHP 5)

mysqli_info, mysqli->info — Obtiene información acerca de la consulta más recientemente ejecutada

Descripción

Estilo por procedimientos:

cadena mysqli_info ( mysqli $identificador_de_enlace )

Estilo orientado a objetos (propiedad)

class mysqli {
cadena info
}

La función mysqli_info() regresa una cadena proveyendo información acerca de la consulta ejecutada más recientemente. La naturaleza de esta cadena es como sigue:

Tabla 178. Valores regresados posibles de mysqli_info

Tipo de Consulta Ejemplo de cadena resultante
INSERT INTO…SELECT… Records: 100 Duplicates: 0 Warnings: 0
INSERT INTO…VALUES (…),(…),(…) Records: 3 Duplicates: 0 Warnings: 0
LOAD DATA INFILE … Records: 1 Deleted: 0 Skipped: 0 Warnings: 0
ALTER TABLE … Records: 3 Duplicates: 0 Warnings: 0
UPDATE … Rows matched: 40 Changed: 40 Warnings: 0

nota: La consultas que no sean una de las antes mencionadas no están soportadas. En esta situación, mysqli_info() regresará una cadena vacía.

Valores retornados

Una cadena representando información adicional acerca de la consulta más recientemente ejecutada.

Ver también

mysqli_affected_rows(), mysqli_warning_count(), y mysqli_num_rows().

Ejemplos

Estilo orientado a objetos

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

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

$mysqli->query("CREATE TEMPORARY TABLE t1 LIKE City");

/* INSERT INTO .. SELECT */
$mysqli->query("INSERT INTO t1 SELECT * FROM City ORDER BY ID LIMIT 150");
printf("%s\n", $mysqli->info);

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

Ejemplo 1446. Estilo por procedimientos

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

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

mysqli_query($link, "CREATE TEMPORARY TABLE t1 LIKE City");

/* INSERT INTO .. SELECT */
mysqli_query($link, "INSERT INTO t1 SELECT * FROM City ORDER BY ID LIMIT 150");
printf("%s\n", mysqli_info($link));

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

El resultado del ejemplo seria:

Records: 150  Duplicates: 0  Warnings: 0

mysqli get host info

(PHP 5)

mysqli_get_host_info, mysqli->get_host_info — Regresa una cadena que representa el tipo de conexión usada

Descripción

Estilo por procedimientos:

cadena mysqli_get_host_info ( mysqli $identificador_de_enlace )

Estilo orientado a objetos (propiedad):

class mysqli {
cadena host_info
}

La función mysqli_get_host_info() regresa una cadena describiendo la conexión utilizada, representada por el parámetro identificador_de_enlace (incluyendo el nombre del servidor).

Valores retornados

Una cadena representando el nombre del servidor y tipo de conexión.

Ver también

mysqli_get_proto_info().

Ejemplos

Ejemplo 1437. Estilo orientado a objetos

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

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

/* print host information */
printf("Host info: %s\n", $mysqli->host_info);

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

Estilo por procedimientos

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

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

/* print host information */
printf("Host info: %s\n", mysqli_get_host_info($link));

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

El resultado del ejemplo seria:

Host info: Localhost via UNIX socket

mysqli get client version

(PHP 5)

mysqli_get_client_version — Obtiene información del cliente MySQL

Descripción

int mysqli_get_client_version ( void )

Regresa el número de la versión del cliente como un entero.

Valores retornados

Un número que representa la versión de la libreria del cliente de MySQL en el formato : main_version*10000 + minor_version *100 + sub_version. Por ejemplo, 4.1.0 es regresado como 40100.

Esto es útil para determinar rápidamente la version de las librerias del cliente para saber si existen algunas capacidades.

Ver también

mysqli_get_client_info(), mysqli_get_server_info(), y mysqli_get_server_version().

Ejemplos

mysqli_get_client_version

<?php

/* We don't need a connection to determine
the version of mysql client library */

printf("Client library version: %d\n", mysqli_get_client_version());
?>

mysqli get client info

(PHP 5)

mysqli_get_client_info — Regresa en una cadena la versión del cliente de MySQL

Descripción

cadena mysqli_get_client_info ( void )

La funció mysqli_get_client_info() es usada para regresar una cadena representando la versión del cliente utilizada en la extensión MySQLi.

Valores retornados

Una cadena que representa la versión de la libreria cliente de MySQL

Ver también

mysqli_get_client_version(), mysqli_get_server_info(), y mysqli_get_server_version().

Ejemplos

Ejemplo 1435. mysqli_get_client_info

<?php

/* We don't need a connection to determine
the version of mysql client library */

printf("Client library version: %s\n", mysqli_get_client_info());
?>

mysqli free result

(PHP 5)

mysqli_free_result, result->free — Libera la memoria asociada con el resultado

Descripción

Estilo por procedimientos:

void mysqli_free_result ( mysqli_result $resultado )

Estilo orientado a objetos (método):

class mysqli_result {
void free ( void )
}

La función mysqli_free_result() libera la memoria asociada al resultado representado por el parámetro resultado, la cuál fue tomada por mysqli_query(), mysqli_store_result() o mysqli_use_result().

nota: Usted debe siempre liberar el resultado con mysqli_free_result(), cuando su objeto resultado no se necesite más.

Valores retornados

Esta función no regresa ningun valor.

mysqli_field tell

(PHP 5)

mysqli_field_tell, result->current_field — Obtiene la posición de desplazamiento del apuntador de un resultado

Descripción

Estilo por procedimientos:

int mysqli_field_tell ( mysqli_result $resultado )

Estilo orientado a objetos (propiedad):

class mysqli_result {
int current_field
}

Regresa la posición del apuntador usada en la última llamada a mysqli_fetch_field(). Este valor puede ser usada como un argumento de mysqli_field_seek().

Valores retornados

Regresa la posición actual del apuntador de campo.

Ver también

mysqli_fetch_field(), y mysqli_field_seek().

Ejemplos

Estilo orientado a objetos

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

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

$query = "SELECT Name, SurfaceArea from Country ORDER BY Code LIMIT 5";

if ($result = $mysqli->query($query)) {

/* Get field information for all columns */
while ($finfo = $result->fetch_field()) {

/* get fieldpointer offset */
$currentfield = $result->current_field;

printf("Column %d:\n", $currentfield);
printf("Name: %s\n", $finfo->name);
printf("Table: %s\n", $finfo->table);
printf("max. Len: %d\n", $finfo->max_length);
printf("Flags: %d\n", $finfo->flags);
printf("Type: %d\n\n", $finfo->type);
}
$result->close();
}

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

Estilo por procedimientos

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

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

$query = "SELECT Name, SurfaceArea from Country ORDER BY Code LIMIT 5";

if ($result = mysqli_query($link, $query)) {

/* Get field information for all fields */
while ($finfo = mysqli_fetch_field($result)) {

/* get fieldpointer offset */
$currentfield = mysqli_field_tell($result);

printf("Column %d:\n", $currentfield);
printf("Name: %s\n", $finfo->name);
printf("Table: %s\n", $finfo->table);
printf("max. Len: %d\n", $finfo->max_length);
printf("Flags: %d\n", $finfo->flags);
printf("Type: %d\n\n", $finfo->type);
}
mysqli_free_result($result);
}

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

El resultado del ejemplo seria:

Column 1:
Name:     Name
Table:    Country
max. Len: 11
Flags:    1
Type:     254

Column 2:
Name:     SurfaceArea
Table:    Country
max. Len: 10
Flags:    32769
Type:     4

mysqli field seek

(PHP 5)

mysqli_field_seek, result->field_seek — Fija el apuntador del resultado a una posicion específica

Descripción

Estilo por procedimientos:

int mysqli_field_seek ( mysqli_result $resultado, int $fieldnr )

Estilo orientado a objetos (método):

class mysqli_result {
int field_seek ( int $fieldnr )
}

Fija el apuntador a la posición dada. En la siguiente llamada a la función mysqli_fetch_field(), traerá la definición de la columna asociada con esa posición.

nota: Para encontrar el inicio de una fila, pase una posición con valor cero.

Valores retornados

mysqli_field_seek() Regresa la posición previa del apuntador de campo.

Ver también

mysqli_fetch_field().

Ejemplos

Estilo orientado a objetos

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

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

$query = "SELECT Name, SurfaceArea from Country ORDER BY Code LIMIT 5";

if ($result = $mysqli->query($query)) {

/* Get field information for 2nd column */
$result->field_seek(1);
$finfo = $result->fetch_field();

printf("Name: %s\n", $finfo->name);
printf("Table: %s\n", $finfo->table);
printf("max. Len: %d\n", $finfo->max_length);
printf("Flags: %d\n", $finfo->flags);
printf("Type: %d\n\n", $finfo->type);

$result->close();
}

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

Estilo por procedimientos

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

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

$query = "SELECT Name, SurfaceArea from Country ORDER BY Code LIMIT 5";

if ($result = mysqli_query($link, $query)) {

/* Get field information for 2nd column */
mysqli_field_seek($result, 1);
$finfo = mysqli_fetch_field($result);

printf("Name: %s\n", $finfo->name);
printf("Table: %s\n", $finfo->table);
printf("max. Len: %d\n", $finfo->max_length);
printf("Flags: %d\n", $finfo->flags);
printf("Type: %d\n\n", $finfo->type);

mysqli_free_result($result);
}

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

El resultado del ejemplo seria:

Name:     SurfaceArea
Table:    Country
max. Len: 10
Flags:    32769
Type:     4

mysqli field count

(PHP 5)

mysqli_field_count, mysqli->field_count — Regresa el número de columnas para la consulta más reciente

Descripción

Estilo por procedimientos:

int mysqli_field_count ( mysqli $identificador_de_enlace )

Estilo orientado a objetos (método):

class mysqli {
int field_count ( void )
}

Regresa el número de columnas para la más reciente consulta en la conexión representada por el parámetro identificador_de_enlace. Esta función puede ser usada cuando se use la función Returns the number of columns for the most recent query on the connection represented by the link parameter. This function can be useful when using the mysqli_store_result() function to determine if the query should have produced a non-empty result set or not without knowing the nature of the query.

Valores retornados

An integer representing the number of fields in a result set

Ejemplos

Esitlo 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')");

$mysqli->real_query($HTTP_POST_VARS['query']);

if (mysqli_field_count($link)) {
/* this was a select/show or describe query */
$result = $mysqli->store_result();

/* process resultset */
$row = $result->fetch_row();

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

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

Estilo procedural

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

mysqli_real_query($link, $HTTP_POST_VARS['query']);

if (mysqli_field_count($link)) {
/* this was a select/show or describe query */
$result = mysqli_store_result($link);

/* process resultset */
$row = mysqli_fetch_row($result);

/* free resultset */
mysqli_free_result($result);
}

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

mysqli fetch row

(PHP 5)

mysqli_fetch_row, result->fetch_row — Obtiene una fila del resultado como una matriz enumerada

Descripción

Estilo por procedimientos:

mixto mysqli_fetch_row ( mysqli_result $resultado )

Estilo orientado a objetos (método):

class mysqli_result {
mixto fetch_row ( void )
}

Regresa una matriz que corresponde a la fila obtenida, o NULL si no hay más filas.

La función mysqli_fetch_row() obtiene una fila de datos del resultado, representado por el parámetro result y lo regresa como una matriz enumerada, donde cada columna es almacenada en la matriz empezando de 0 (cero). Cada llamada subsecuente a la función mysqli_fetch_row() regresará la siguiente fila dentro del resultado, o NULL si no hay más filas.

Valores retornados

mysqli_fetch_row() regresa una matriz que corresponde a la fila obtenida o NULL si no hay más filas en el resultado.

nota: Los nombres de campos retornados por esta función diferencian entre mayusculas y minusculas.

nota: Esta funcion define campos NULL como valores PHP NULL.

Ver también

mysqli_fetch_array(), mysqli_fetch_assoc(), mysqli_fetch_object(), mysqli_query(), y mysqli_data_seek().

Ejemplos

Estilo orientado a objetos

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

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

$query = "SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 50,5";

if ($result = $mysqli->query($query)) {

/* fetch object array */
while ($row = $result->fetch_row()) {
printf ("%s (%s)\n", $row[0], $row[1]);
}

/* free result set */
$result->close();
}

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

Ejemplo 1428. Estilo por procedimientos

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

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

$query = "SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 50,5";

if ($result = mysqli_query($link, $query)) {

/* fetch associative array */
while ($row = mysqli_fetch_row($result)) {
printf ("%s (%s)\n", $row[0], $row[1]);
}

/* free result set */
mysqli_free_result($result);
}

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

El resultado del ejemplo seria:

Pueblo (USA)
Arvada (USA)
Cape Coral (USA)
Green Bay (USA)
Santa Clara (USA)

mysqli fetch object

(PHP 5)

mysqli_fetch_object, result->fetch_object — Regresa la fila actual del resultado como un objeto

Descripción

Estilo por procedimientos:

mixto mysqli_fetch_object ( mysqli_result $resultado )

Estilo orientado a objetos (método):

class mysqli_result {
mixto fetch_object ( void )
}

La función mysqli_fetch_object() regresará la fila actual en el resultado como un objeto donde los atributos del objeto representan los nombre de los campos encontrados dentro del resultado. Si no hay más filas en el resultado, se regresa NULL

Valores retornados

Regresa un objeto que corresponde a la fila obtenida o NULL si no hay más filas en el resultado.

nota: Los nombres de campos retornados por esta función diferencian entre mayusculas y minusculas.

nota: Esta funcion define campos NULL como valores PHP NULL.

Ver también

mysqli_fetch_array(), mysqli_fetch_assoc(), mysqli_fetch_row(), mysqli_query(), y mysqli_data_seek().

Ejemplos

Estilo orientado a objetos

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

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

$query = "SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 50,5";

if ($result = $mysqli->query($query)) {

/* fetch object array */
while ($obj = $result->fetch_object()) {
printf ("%s (%s)\n", $obj->Name, $obj->CountryCode);
}

/* free result set */
$result->close();
}

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

Estilo por procedimientos

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

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

$query = "SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 50,5";

if ($result = mysqli_query($link, $query)) {

/* fetch associative array */
while ($obj = mysqli_fetch_object($result)) {
printf ("%s (%s)\n", $obj->Name, $obj->CountryCode);
}

/* free result set */
mysqli_free_result($result);
}

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

El resultado del ejemplo seria:

Pueblo (USA)
Arvada (USA)
Cape Coral (USA)
Green Bay (USA)
Santa Clara (USA)