diff --git a/reference/mysqli/mysqli/functions/mysqli-affected-rows.xml b/reference/mysqli/mysqli/functions/mysqli-affected-rows.xml new file mode 100644 index 0000000000..5943cfc07e --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-affected-rows.xml @@ -0,0 +1,182 @@ + + + + + + mysqli_affected_rows + mysqli->affected_rows + Obtiene el número de filas afectadas en una operación + de MySQL previa + + + Descripción + Estilo por procedimientos: + + mixtomysqli_affected_rows + objetoidentificador_de_enlace + + Estilo orientado a objetos (característica): + + mysqli + mixtoaffected_rows + + + mysqli_affected_rows Regresa el número de filas + afectadas por la última consulta INSERT, UPDATE, o DELETE asociada + con el identificador_de_enlace dado. Si la última + consulta fue invalida, esta función regresará -1. + + + + Para sentencias SELECT mysqli_affected_rows trabaja + igual a mysqli_num_rows. + + + + La función mysqli_affected_rows s&oacoute;lo trabaja + con consultas que modifican o afectan una tabla. En caso de que necesite el + número de filas de una consulta SELECT, use la función + mysqli_num_rows en su lugar. + + + + Valores Regresados + + Un entero mayor a cero indica el número de filas afectadas u obtenidas. + Cero indica que no se actualizaron registros para una sentencia UPDATE, no hubo + coincidencias con la clausula WHERE en la consulta o que no se ha ejecutado + aún ninguna consulta. -1 indica que la consulta regreso un error. + + + + Si el número de filas afectadas es mayor que el valor entero máximo, + entonces el número de filas afectadas será regresado como una cadena. + + + + + Vea también + + mysqli_num_rows, + mysqli_info. + + + + Ejemplos + + Estilo orientado a objetos + +query("CREATE TABLE Language SELECT * from CountryLanguage"); +printf("Affected rows (INSERT): %d\n", $mysqli->affected_rows); + +$mysqli->query("ALTER TABLE Language ADD Status int default 0"); + +/* update rows */ +$mysqli->query("UPDATE Language SET Status=1 WHERE Percentage > 50"); +printf("Affected rows (UPDATE): %d\n", $mysqli->affected_rows); + +/* delete rows */ +$mysqli->query("DELETE FROM Language WHERE Percentage < 50"); +printf("Affected rows (DELETE): %d\n", $mysqli->affected_rows); + +/* select all rows */ +$result = $mysqli->query("SELECT CountryCode FROM Language"); +printf("Affected rows (SELECT): %d\n", $mysqli->affected_rows); + +$result->close(); + +/* Delete table Language */ +$mysqli->query("DROP TABLE Language"); + +/* close connection */ +$mysqli->close(); +?> +]]> + + + + Estilo por procedimientos + + 50"); +printf("Affected rows (UPDATE): %d\n", mysqli_affected_rows($link)); + +/* delete rows */ +mysqli_query($link, "DELETE FROM Language WHERE Percentage < 50"); +printf("Affected rows (DELETE): %d\n", mysqli_affected_rows($link)); + +/* select all rows */ +$result = mysqli_query($link, "SELECT CountryCode FROM Language"); +printf("Affected rows (SELECT): %d\n", mysqli_affected_rows($link)); + +mysqli_free_result($result); + +/* Delete table Language */ +mysqli_query($link, "DROP TABLE Language"); + +/* close connection */ +mysqli_close($link); +?> +]]> + + + + Los ejemplos anteriores producirán la siguiente salida: + + + + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-autocommit.xml b/reference/mysqli/mysqli/functions/mysqli-autocommit.xml new file mode 100644 index 0000000000..fc381e2028 --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-autocommit.xml @@ -0,0 +1,143 @@ + + + + + + mysqli_autocommit + mysqli->auto_commit + Activa o desactiva la modificación de auto-entrega de + la base de datos + + + Descripción + Estilo por procedimientos: + + boolmysqli_autocommit + objetoidentificador_de_enlace + boolmodo + + Estilo orientado a objetos (método) + + mysqli + + bool + auto_commit + boolmodo + + + + mysqli_autocommit Es usado para cambiar entre on u off + el modo de auto-entrega en las consultas para la conexión a la base + de datos representada por el objeto identificador_de_enlace. + + + + mysqli_autocommit No funciona sobre tablas que no son + del tipo transaccional (como MyISAM o ISAM). + + + Para determinar el estado actual de auto-entrega use el comando SQL: + 'SELECT @@autocommit'. + + + + + Valores que regresa + + &return.success; + + + + Vea también + + mysqli_commit, + mysqli_rollback. + + + + Ejemplos + + Estilo orientado a objetos + +autocommit(TRUE); + +if ($result = $mysqli->query("SELECT @@autocommit")) { + $row = $result->fetch_row(); + printf("Autocommit is %s\n", $row[0]); + $result->free(); +} + +/* close connection */ +$mysqli->close(); +?> +]]> + + + + Estilo por procedimientos + + +]]> + + + + Los ejemplos anteriores producirán la siguiente salida: + + + + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-bind-param.xml b/reference/mysqli/mysqli/functions/mysqli-bind-param.xml new file mode 100644 index 0000000000..c4195e95e4 --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-bind-param.xml @@ -0,0 +1,49 @@ + + + + + + mysqli_bind_param + Alias para mysqli_stmt_bind_param + + + Descripción + + Esta función es un alias de mysqli_stmt_bind_param. + Para una descripción detallada vea + mysqli_stmt_bind_param. + + + + mysqli_bind_param es obsoleta y será removida. + + + + + Vea tambi&eacuite;n + + mysqli_stmt_bind_param + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-bind-result.xml b/reference/mysqli/mysqli/functions/mysqli-bind-result.xml new file mode 100644 index 0000000000..322c2a3a9d --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-bind-result.xml @@ -0,0 +1,49 @@ + + + + + + mysqli_bind_result + Alias para mysqli_stmt_bind_result + + + Descripción + + Esta funció es un alias de mysqli_stmt_bind_result. + Para una descripción detallada vea + mysqli_stmt_bind_result. + + + + mysqli_bind_result es obsoleta y será removida. + + + + + Vea también + + mysqli_stmt_bind_result + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-change-user.xml b/reference/mysqli/mysqli/functions/mysqli-change-user.xml new file mode 100644 index 0000000000..94111194ff --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-change-user.xml @@ -0,0 +1,188 @@ + + + + + + mysqli_change_user + mysqli->change_user + Cambia el usuario de la conexión a la base de datos especificada + + + Descripción + Estilo por procedimientos: + + boolmysqli_change_user + objectidentificador_de_enlace + cadenausuario + cadenacontraseña + cadenabase_de_datos + + Estilo orientado a objetos (método): + + mysqli + + bool + change_user + cadenausuario + cadenacontraseńa + cadenabase_de_datos + + + + mysqli_change_user Es usada para cambiar el usuario para + la conexión de base de datos indicada por el parámetro + identificador_de_enlace y para fijar la actual base de datos a la específicada + por el parámetro base_de_datos. + + + Si se desea, se puede pasar el valor &null; en lugar del parámetro + base_de_datos resultando en solo cambiar el usaurio y no + seleccionar la base de datos. Para seleccionar una base de datos en este caso + use la función mysqli_select_db. + + + Para poder cambiar de usuario de forma exitosa se debe proveer de un + usuario y contraseña + validos, y tales parámetros debe contar con los suficientes permisos + para acceder a la base de datos deseada. Si por cualquier razón la + autorización falla, el actual usuario autenticado permanecerá activo. + + + + El uso de este comando siempre producirá que la conexión actual + a la base de datos se comporte como si fuera una nueva conexión, + sin importar si la operación fue completada exitosamente. Este reinicio + implica el hacer la restauración no actualizada "rollback" de cualquier + transacción activa, cerrar todas las tablas temporales y des-asegurar + todas las tablas aseguradas. + + + + + Valores regresados + + &return.success; + + + + Vea también: + + mysqli_connect + mysqli_select_db + + + + Ejemplos + + Estilo orientado a objetos + +query("SET @a:=1"); + +/* reset all and select a new database */ +$mysqli->change_user("my_user", "my_password", "world"); + +if ($result = $mysqli->query("SELECT DATABASE()")) { + $row = $result->fetch_row(); + printf("Default database: %s\n", $row[0]); + $result->close(); +} + +if ($result = $mysqli->query("SELECT @a")) { + $row = $result->fetch_row(); + if ($row[0] === NULL) { + printf("Value of variable a is NULL\n"); + } + $result->close(); +} + +/* close connection */ +$mysqli->close(); +?> +]]> + + + + Estilo por procedimientos + + +]]> + + + + Los ejemplos anteriores producirán la siguiente salida: + + + + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-character-set-name.xml b/reference/mysqli/mysqli/functions/mysqli-character-set-name.xml new file mode 100644 index 0000000000..8d8b099f4e --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-character-set-name.xml @@ -0,0 +1,124 @@ + + + + + + mysqli_character_set_name + mysqli->character_set_name + Regresa el conjunto de caracteres determinados por default para + la conexión de base de datos + + + Descripción + Estilo por procedumientos: + + cadenamysqli_character_set_name + objetoidentificador_de_enlace + + Estilo orientado a objetos (método): + + mysqli + + cadena + character_set_name + void + + + + Regresa el conjuntos de caracteres actual, determinado para la conexión + de base de datos específicada por el parámetro + identificador_de_enlace. + + + + Valores regresados + El conjunto de caracteres por defecto, determinados para la + conexión actual + + + Vea también + + mysqli_client_encoding. + mysqli_real_escape_string. + + + + Ejemplos + + Estilo orientado a objetos + +character_set_name(); +printf ("Current character set is %s\n", $charset); + +$mysqli->close(); +?> +]]> + + + + Estilo por procedimientos + + +]]> + + + + Los ejemplos anteriores producirán la siguiente salida: + + + + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-client-encoding.xml b/reference/mysqli/mysqli/functions/mysqli-client-encoding.xml new file mode 100644 index 0000000000..2a06f63ced --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-client-encoding.xml @@ -0,0 +1,45 @@ + + + + + + mysqli_client_encoding + Alias de mysqli_character_set_name + + + Descripción + + Esta función es un alias de mysqli_character_set_name. + Para una descripción detallada vea + mysqli_character_set_name. + + + + Vea también + + mysqli_client_encoding. + mysqli_real_escape_string. + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-close.xml b/reference/mysqli/mysqli/functions/mysqli-close.xml new file mode 100644 index 0000000000..d055f04ed4 --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-close.xml @@ -0,0 +1,67 @@ + + + + + + mysqli_close + mysqli->close + Cierra la conexión de base de datos previamente abierta + + + Descripción + Estilo por procedimientos: + + boolmysqli_close + objetoidentificador_de_enlace + + Estilo orientado a objetos (método): + + mysqli + + bool + close + void + + + + La función mysqli_close cierra una conexión + de base de datos previamente abierta, específicada por el parámetro + identificador_de_enlace. + + + + Valores regresados + + &return.success; + + + + Vea también + + mysqli_connect, + mysqli_init, + mysqli_real_connect. + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-commit.xml b/reference/mysqli/mysqli/functions/mysqli-commit.xml new file mode 100644 index 0000000000..a4661c18e2 --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-commit.xml @@ -0,0 +1,136 @@ + + + + + + mysqli_commit + mysqli->commit + Completa la transacción actual + + + Descripción + Estilo por procedimientos: + + boolmysqli_commit + objetoidentificador_de_enlace + + Estilo orientado a objetos (método) + + mysqli + + bool + commit + void + + + + Entrega la transacción actual para la conexión de base de datos + específicada por el parametro + link. + + + + Valores regresados + + &return.success; + + + + Vea también + + mysqli_autocommit, + mysqli_rollback. + + + + Ejemplos + + + Estilo orientado a objetos + +query("CREATE TABLE Language LIKE CountryLanguage Type=InnoDB"); + +/* set autocommit to off */ +$mysqli->autocommit(FALSE); + +/* Insert some values */ +$mysqli->query("INSERT INTO Language VALUES ('DEU', 'Bavarian', 'F', 11.2)"); +$mysqli->query("INSERT INTO Language VALUES ('DEU', 'Swabian', 'F', 9.4)"); + +/* commit transaction */ +$mysqli->commit(); + +/* drop table */ +$mysqli->query("DROP TABLE Language"); + +/* close connection */ +$mysqli->close(); +?> +]]> + + + + Estilo por procedimientos + + +]]> + + + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-connect-errno.xml b/reference/mysqli/mysqli/functions/mysqli-connect-errno.xml new file mode 100644 index 0000000000..d41ffbc08e --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-connect-errno.xml @@ -0,0 +1,92 @@ + + + + + + mysqli_connect_errno + Regresa el código de error de la última llamada a la conexión + + + Descripción + + intmysqli_connect_errno + void + + + La función mysqli_connect_errno regresará + el últumo código de error generado por + mysqli_connect. + Si no han ocurrido errores, esta función regresará cero. + + + + Los números de error del cliente, están listados en el archivo + de MySQL errmsg.h. + Los números de error del servidor, están listados en el archivo + de MySQL mysqld_error.h. + En la distribución de las fuentes de MySQL, tu puedes encontrar una + lista completa de los mensajes de error y de los números de error + en el documento Docs/mysqld_error.txt. + + + + + Valores regresados + + Un código de error para la última llamada a mysqli_connect, + si ésta falla. + Si no hay error entonces se regresa Cero. + + + + Vea también + + mysqli_connect, + mysqli_connect_error, + mysqli_errno, + mysqli_error, + mysqli_sqlstate + + + + Ejemplo + + + mysqli_connect_errno + + +]]> + + + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-connect-error.xml b/reference/mysqli/mysqli/functions/mysqli-connect-error.xml new file mode 100644 index 0000000000..79167570c6 --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-connect-error.xml @@ -0,0 +1,84 @@ + + + + + + mysqli_connect_error + Regresa una descripción del último error de la + conexión + + + Descripción + + cadenamysqli_connect_error + void + + + La función mysqli_connect_error es identica a + la función mysqli_connect_errno, excepto en que + en vez de regresar el número del código de error, la función + mysqli_connect_error regresará el mensaje de error + correspondiente a la última llamada a la función mysqli_connect. + Si no ha ocurrido error, está función regresará una cadena + vacía. + + + + Valores regresados + + Una cadena que describe el error o una cadena vacía si no ha ocurrido + error. + + + + Vea también + + mysqli_connect, + mysqli_connect_errno, + mysqli_errno, + mysqli_error, + mysqli_sqlstate + + + + Ejemplo + + + mysqli_connect_error + + +]]> + + + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-connect.xml b/reference/mysqli/mysqli/functions/mysqli-connect.xml new file mode 100644 index 0000000000..987e2531a4 --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-connect.xml @@ -0,0 +1,158 @@ + + + + + + mysqli_connect + mysqli() + Abre una nueva conexión al servidor MySQL + + + Descripción + Estilo por procedimientos + + objetomysqli_connect + cadenaequipo_anfitrión + cadenausuario + cadenacontraseña + cadenabase_de_datos + intpuerto + cadenasocket + + Estilo orientado a objetos (constructor): + + mysqli + + __construct + cadenaequipo_anfitrión + cadenausuario + cadenacontraseña + cadenabase_de_datos + intpuerto + cadenasocket + + + + La función mysqli_connect intenta abrir una conexión + al servidor MySQL que se está ejecutando en equipo_afitrión + el cual puede ser el nombre de un equipo o una dirección IP. Pasando el + valor &null; o la cadena "localhost" a este parámetro, se asume que + está en el mismo equipo. Cuando sea posible se usar&Acute; "pipes" en vez + del protocolo TCP/IP. En caso exitoso, la función mysqli_connect + regresará un objeto representando la conexión a la base de datos, + o &false; en caso contrario. + + + En los parámetros usuario y contraseña + se específica el nombre de usuario y contraseña con los cuales + se debe conectar al servidor MySQL. Si no se da contraseña el valor + &null; es tomado, el servidor MySQL intentará verificar al usuario + contra los registros de usuarios que esten sin contraseña. Esto permite + que un usuario pueda ser usado con diferentes permisos (dependiendo si se + provee contraseña o no). + + + Si se específica el parámetro base_de_datos + especificará la base de datos a usar por defecto cuando se ejecuten + consultas. + + + Los parámetros puerto y socket + son usados junto con el parámetro equipo_anfitrión + para controla a futuro como conectar al servidor de base de datos. + El parámetro puerto específica el número + de puerto al que se intenta conectar en el servidor MySQL, mientras que el + parámetro socket específica el socket o + la pipa nombrada "pipe" que debe ser usada. + + + + Especificar el parámetro socket no determina + explícitamente el tipo de conexión a ser usado cuando se conecta + al servidor MySQL. El parámetro equipo_anfitrión + determina como se hace la conexión a la base de datos MySQL. + + + + + Valores regresados + + Regresa un objeto el cuál representa la conexión al servidor + MySQL o &false; en caso contrario. + + + + Ejemplos + + Estilo orientado a objetos + +host_info); + +/* close connection */ +$mysqli->close(); +?> +]]> + + + + Estilo por procedimientos + + +]]> + + + + Los ejemplos anteriores producirán la siguiente salida: + + + + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-data-seek.xml b/reference/mysqli/mysqli/functions/mysqli-data-seek.xml new file mode 100644 index 0000000000..8a3567b0a4 --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-data-seek.xml @@ -0,0 +1,159 @@ + + + + + + mysqli_data_seek + result->data_seek + Ajusta el apuntador arbitrariamente a una fila en el resultado + + + Descripción + Estilo por procedimientos: + + boolmysqli_data_seek + objetoresultado + intposición + + Estilo orientado a objetos (método): + + resultado + + bool + data_seek + intposición + + + + La función mysqli_data_seek busca arbitrariamente + apuntar al valor específicado por posición + en el conjunto resultante representado por result. + Los valores del parámetro posición + deben estar entre cero y el total de filas menus uno (0 .. mysqli_num_rows - 1). + + + + Está función solo puede ser usada con resultados sin almacenamiento + intermedio logrados por el uso de las funciones + mysqli_store_result o mysqli_query. + + + + + Valores regresados + + &return.success; + + + + Vea también + + mysqli_store_result, + mysqli_fetch_row, + mysqli_num_rows. + + + + Ejemplos + + Estilo orientado a onjetos + +query( $query)) { + + /* seek to row no. 400 */ + $result->data_seek(399); + + /* fetch row */ + $row = $result->fetch_row(); + + printf ("City: %s Countrycode: %s\n", $row[0], $row[1]); + + /* free result set*/ + $result->close(); +} + +/* close connection */ +$mysqli->close(); +?> +]]> + + + + Estilo por procedimientos + + +]]> + + + + Los ejemplos anteriores producirán la siguiente salida: + + + + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-debug.xml b/reference/mysqli/mysqli/functions/mysqli-debug.xml new file mode 100644 index 0000000000..f39213ca28 --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-debug.xml @@ -0,0 +1,78 @@ + + + + + + mysqli_debug + Realiza operaciones de rastreo de errores + + + Descripción + + voidmysqli_debug + cadenaacción + + + La función mysqli_debug es usada para realizar + operaciones de rastreo y eliminación de errores utilizando la libreria + "Fred Fish". El parámetro acción + es una cadena que representa las operaciones de rastreo de errores a realizar. + + + + Para usar la funció mysqli_debug se debe compilar + el cliente de MySQL con soporte para rastreo de errores "debugging". + + + + + Valores regresados + mysqli_debug no regresa ningún valor. + + + Vea también + + mysqli_dump_debug_info, + mysqli_report + + + + Ejemplo + + + Generar un archivo de rastreo + + +]]> + + + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-disable-reads-from-master.xml b/reference/mysqli/mysqli/functions/mysqli-disable-reads-from-master.xml new file mode 100644 index 0000000000..36a5cff28b --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-disable-reads-from-master.xml @@ -0,0 +1,40 @@ + + + + + + mysqli_disable_reads_from_master + + + + Descripción + + voidmysqli_disable_reads_from_master + intidentificador_de_enlace + + + &warn.experimental.func; + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-disable-rpl-parse.xml b/reference/mysqli/mysqli/functions/mysqli-disable-rpl-parse.xml new file mode 100644 index 0000000000..7e9789bae7 --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-disable-rpl-parse.xml @@ -0,0 +1,40 @@ + + + + + + mysqli_disable_rpl_parse + + + + Descripción + + voidmysqli_disable_rpl_parse + objetoidentificador_de_enlace + + + &warn.experimental.func; + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-dump-debug-info.xml b/reference/mysqli/mysqli/functions/mysqli-dump-debug-info.xml new file mode 100644 index 0000000000..873a07ee19 --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-dump-debug-info.xml @@ -0,0 +1,56 @@ + + + + + + mysqli_dump_debug_info + mysqli->dump_debug_info + Vacía información de rastreo de errores en el log + + + Descripción + + boolmysqli_dump_debug_info + objetoidentificador_de_enlace + + + Esta función está diseñada para ser ejecutada por un + usaurio con privilegios de SUPER usuario y es usada para vaciar la información + de rastreo de errores en el log del servidor MySQL relacionado a la conexión + específicada por el parámetro identificador_de_enlace. + + + + Valores regresados + + &return.success; + + + + Vea también + + mysqli_debug. + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-embedded-connect.xml b/reference/mysqli/mysqli/functions/mysqli-embedded-connect.xml new file mode 100644 index 0000000000..225fb816e2 --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-embedded-connect.xml @@ -0,0 +1,40 @@ + + + + + + mysqli_embedded_connect + Abre una conexió a un servidor MySQL embebido. + + + Descripción + + objectmysqli_embedded_connect + void + + + &warn.experimental.func; + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-enable-reads-from-master.xml b/reference/mysqli/mysqli/functions/mysqli-enable-reads-from-master.xml new file mode 100644 index 0000000000..378457a376 --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-enable-reads-from-master.xml @@ -0,0 +1,40 @@ + + + + + + mysqli_enable_reads_from_master + + + + Descripción + + voidmysqli_enable_reads_from_master + objetoidentificador_de_enlace + + + &warn.experimental.func; + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-enable-rpl-parse.xml b/reference/mysqli/mysqli/functions/mysqli-enable-rpl-parse.xml new file mode 100644 index 0000000000..8dd0b89845 --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-enable-rpl-parse.xml @@ -0,0 +1,40 @@ + + + + + + mysqli_enable_rpl_parse + + + + Descripción + + voidmysqli_enable_rpl_parse + objetoidentificador_de_enlace + + + &warn.experimental.func; + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-errno.xml b/reference/mysqli/mysqli/functions/mysqli-errno.xml new file mode 100644 index 0000000000..d149f310fc --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-errno.xml @@ -0,0 +1,136 @@ + + + + + + mysqli_errno + mysql->errno + Regresa el código de error para la función más + recientemente llamada + + + Descripción + Estilo por procedimientos: + + intmysqli_errno + objetoidentificador_de_enlace + + Estilo orientado a objetos (propiedad): + + mysqli + interrno + + + La función mysqli_errno regresará el último + código de error para la función de MySQLi más recientemente + llamada, que pueda ser exitosa o fallar con respecto al identificador de enlace a + la base de datos definido por el parámetro identificador_de_enlace. + Si no han ocurrido errores, está función regresará cero. + + + + Los números de error del cliente, están listados en el archivo + de MySQL errmsg.h. + Los números de error del servidor, están listados en el archivo + de MySQL mysqld_error.h. + En la distribución de las fuentes de MySQL, tu puedes encontrar una + lista completa de los mensajes de error y de los números de error + en el documento Docs/mysqld_error.txt. + + + + + Valores regresados + + Un valor de código de error para la última llamada si falló. + Cero significa que no han ocurrido errores. + + + + Vea también + + mysqli_connect_errno, + mysqli_connect_error, + mysqli_error, + mysqli_sqlstate + + + + Ejemplos + + Estilo orientado a objetos + +query("SET a=1")) { + printf("Errorcode: %d\n", $mysqli->errno); +} + +/* close connection */ +$mysqli->close(); +?> +]]> + + + + Estilo por procedimientos + + +]]> + + + + Los ejemplos anteriores producirán la siguiente salida: + + + + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-error.xml b/reference/mysqli/mysqli/functions/mysqli-error.xml new file mode 100644 index 0000000000..ab2ff5c597 --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-error.xml @@ -0,0 +1,124 @@ + + + + + + mysqli_error + Regresa una cadena con la descripció del último error + + + Descripción + Estilo por procedimientos: + + cadenamysqli_error + objetoidentificador_de_enlace + + Estilo orientado a objetos (propiedad) + + mysqli + cadenaerror + + + La funció mysqli_error es identica a la correspondiente + mysqli_errno en todos los sentidos, excepto en que en + lugar de regresar un valor numérico, la función mysqli_error + regresará un mensaje de error, representando el último error + ocurrido para la conexió de base de datos identificador_de_enlace. + Si no han ocurrido errores, está función regresará una cadena vacía. + + + + Valores regresados + + Una cadena que describe el error. Una cadena vacía si no han ocurrido + errores. + + + + Vea también + + mysqli_connect_errno, + mysqli_connect_error, + mysqli_errno, + mysqli_sqlstate + + + + Ejemplos + + Estilo orientado a objetos + +query("SET a=1")) { + printf("Errormessage: %s\n", $mysqli->error); +} + +/* close connection */ +$mysqli->close(); +?> +]]> + + + + Estilo por procedimientos + + +]]> + + + + Los ejemplos anteriores producirán la siguiente salida: + + + + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-escape-string.xml b/reference/mysqli/mysqli/functions/mysqli-escape-string.xml new file mode 100644 index 0000000000..04693fc703 --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-escape-string.xml @@ -0,0 +1,36 @@ + + + + + + mysqli-escape-string + Alias de mysqli_real_escape_string + + + Descripción + + Esta función es un alias de mysqli_real_escape_string. + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-execute.xml b/reference/mysqli/mysqli/functions/mysqli-execute.xml new file mode 100644 index 0000000000..cee8916b41 --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-execute.xml @@ -0,0 +1,49 @@ + + + + + + mysqli_execute + Alias de mysqli_stmt_execute + + + Descripción + + Esta función es un alias de mysqli_stmt_execute. + Para una descipció más detallada vea la descripción de + mysqli_stmt_execute. + + + + mysqli_execute es obsoleta y será removida. + + + + + Vea también + + mysqli_stmt_execute + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-fetch-array.xml b/reference/mysqli/mysqli/functions/mysqli-fetch-array.xml new file mode 100644 index 0000000000..c9aeb7b352 --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-fetch-array.xml @@ -0,0 +1,184 @@ + + + + + + mysqli_fetch_array + result->fetch_array + Obtiene una fila como una matriz asociativa, una matriz numérica o ambos. + + + Descripción + Estilo por procedimientos: + + mixtomysqli_fetch_array + objetoresultado + inttipo_de_resultado + + Estilo orientado a objetos (método): + + resultado + + mixto + fetch_array + inttipo_de_resultado + + + + Regresa una matrix que corresponde a las filas obtenidas o &null; si no hay + más filas para el resultado, representado por el parámetro + resultado. + + + mysqli_fetch_array es una versión mejorada de la función + mysqli_fetch_row. Ademá de almacenar los datos en + índices numéricos de la matriz resultante, la función + mysql_fetch_array también puede almacenar los datos en + índices asociativos, usando los nombre de los campos de el resultado como llaves. + + &database.field-case; + + Si dos o más columnas de el resultado tienen el mismo nombre, la última + columna tomara precedencia y sobre escribirá lo primero. Para acceder a + varias columnas con el mismo nombre, la forma de índice numérica + debe ser usada. + + + El parámetro opcional tipo_de_resultado es una + constante que indica qué tipo de matriz debe ser producido para la fila + de datos actual. Los posibles valires para este parámetro son las constantes + MYSQLI_ASSOC, MYSQLI_NUM, o MYSQLI_BOTH. Por defecto la función + mysqli_fetch_array asumirá el valor de MYSQLI_BOTH. + + + Al usar la constante MYSQLI_ASSOC, esta función se comportará + identica a la función mysqli_fetch_assoc, mientras + que con MYSQLI_NUM se comportará identica a la función + mysql_fetch_row. La opción final MYSQLI_BOTH + creará una matriz con los atributos de ambos. + + + + Valores regresados + + Regresa una matriz que corresponde a las filas obtenidas o &null; si no hay + más filas en el resultado. + + + + Vea también + + mysqli_fetch_assoc, + mysqli_fetch_row, + mysqli_fetch_object. + + + + Ejemplos + + Estilo orientado a objetos + +query($query); + +/* numeric array */ +$row = $result->fetch_array(MYSQLI_NUM); +printf ("%s (%s)\n", $row[0], $row[1]); + +/* associative array */ +$row = $result->fetch_array(MYSQLI_ASSOC); +printf ("%s (%s)\n", $row["Name"], $row["CountryCode"]); + +/* associative and numeric array */ +$row = $result->fetch_array(MYSQLI_BOTH); +printf ("%s (%s)\n", $row[0], $row["CountryCode"]); + +/* free result set */ +$result->close(); + +/* close connection */ +$mysqli->close(); +?> +]]> + + + + Estilo por procedimientos + + +]]> + + + + Los ejemplos anteriores producián la siguiente salida: + + + + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-fetch-assoc.xml b/reference/mysqli/mysqli/functions/mysqli-fetch-assoc.xml new file mode 100644 index 0000000000..9ba03ec38b --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-fetch-assoc.xml @@ -0,0 +1,159 @@ + + + + + + mysqli_fetch_assoc + mysqli->fetch_assoc + Obtiene una fila del resultado como una matriz asociativa + + + Descripción + Estilo por procedimientos: + + matrizmysqli_fetch_assoc + objetoresultado + + Estilo orientado a objetos (método): + + resultado + + matriz + fetch_assoc + void + + + + Regresa una matriz asociativa que corresponde a las filas obtenidas o &null; + si no hay mas filas. + + + La función mysqli_fetch_assoc es usada para regresar + una representación asociativa de la siguiente fila en el resultado, + representado por el parámetro resultado, donde + cada llave en la matriz representa el nombre de las columnas en el resultado. + + + Si dos o más columnas de el resultado tienen el mismo nombre, la última + columna tomara precedencia y sobre escribirá lo primero. Para acceder a + varias columnas con el mismo nombre, la forma de índice numérica + debe ser usada. + + &database.field-case; + + + Valores regresados + + Regresa una matriz que corresponde a las filas obtenidas o &null; si no hay + más filas en el resultado. + + + + Vea también + + mysqli_fetch_array, + mysqli_fetch_row, + mysqli_fetch_object. + + + + Ejemplos + + Estilo orientado a objetos + +query($query)) { + + /* fetch associative array */ + while ($row = $result->fetch_assoc()) { + printf ("%s (%s)\n", $row["Name"], $row["CountryCode"]); + } + + /* free result set */ + $result->close(); +} + +/* close connection */ +$mysqli->close(); +?> +]]> + + + + Estilo por procedimientos + + +]]> + + + + Los ejemplos anteriores producirán la siguiente salida: + + + + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-fetch-field-direct.xml b/reference/mysqli/mysqli/functions/mysqli-fetch-field-direct.xml new file mode 100644 index 0000000000..c9acfd6d97 --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-fetch-field-direct.xml @@ -0,0 +1,209 @@ + + + + + + mysqli_fetch_field_direct + result->fetch_field_direct + + Obtiene los metadatos de un campo + + + + Descripción + Estilo por procedimientos: + + mixtomysqli_fetch_field_direct + objetoresultado + intindice_de_campo + + Estilo orientado a objetos (método): + + resultado + + mixto + fetch_field_direct + intindice_de_campo + + + + La función mysqli_fetch_field_direct regresa un + objeto el cuál contiene información de la definición del + campo del resultado específicado. El valor de indice_de_campo debe estar + en el rango de 0 a número de campos -1. + + + + Valores regresados + + Regresa un objeto el cual contiene información de la definición del + campo o &false; si no hay información para el indice_de_campo + específicado. + + + + Atributos del objeto + + + + Atributo + Descripción + + + + + name + Nombre de la columna + + + orgname + Nombre original de la columna si se dió un alias + + + table + Nombre de la tabla a la que pertenece el campo + + + orgtable + Nombre original de la tabla si se dió un alias + + + def + El valor por defecto para este campo, representado como una cadena + + + max_length + La amplitud máxima de campo de el campo para el resultado + + + flags + Un entero que representa los bit bandera para el campo + + + type + Tipo de dato utilizado para este campo + + + decimals + Número de decimales usadas (para campos entero) + + + +
+ + + + Vea también + + mysqli_num_fields + mysqli_fetch_field + mysqli_fetch_fields + + + + Ejemplos + + Estilo orientado a objetos + +query($query)) { + + /* Get field information for column 'SurfaceArea' */ + $finfo = $result->fetch_field_direct(1); + + 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", $finfo->type); + + $result->close(); +} + +/* close connection */ +$mysqli->close(); +?> +]]> + + + + Estilo por procedimientos + +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", $finfo->type); + + mysqli_free_result($result); +} + +/* close connection */ +mysqli_close($link); +?> +]]> + + + + Los ejemplos anteriores producirán la siguiente salida: + + + + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-fetch-field.xml b/reference/mysqli/mysqli/functions/mysqli-fetch-field.xml new file mode 100644 index 0000000000..326d21edd2 --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-fetch-field.xml @@ -0,0 +1,214 @@ + + + + + + mysqli_fetch_field + result->fetch_field + Regresa metadatos de el campo en el resultado + + + Descripción + Estilo por procedimientos: + + mixtomysqli_fetch_field + objetoresultado + + Estilo orientado a objetos (método): + + resultado + + mixto + fetch_field + + + + + La función mysqli_fetch_field regresa un objeto + con información de definición de un campo de un resultado. + Ejecute esta función repetidamente para obtener la información + de todas las columnas en un resultado. mysqli_fetch_field + regresa &false; cuando no hay más columnas en el resultado. + + + + Valores regresados + + Regresa un objeto el cual contiene la información de la definición + del campo o &false; si no hay información disponible. + + + + Atributos del objeto + + + + Atributo + Descripción + + + + + name + El nombre de la columna + + + orgname + Nombre original de la columna, si se específico un alias + + + table + El nombre de la tablaa la cuál pertenece + + + orgtable + Nombre original de la tabla si se específico un alias + + + def + El valor por defecto de este campo, representado con una cadena + + + max_length + La máma amplitud del campo para el resultado + + + flags + Un entero representando los bit de bandera para el campo + + + type + El tipo de dato usado para este campo + + + decimals + El número de decimales utilizadas (para campos numéricos) + + + +
+ + + + Vea también + + mysqli_num_fields + mysqli_fetch_field_direct + mysqli_fetch_fields + mysqli_field_seek + + + + Ejemplos + + Estilo orientado a objetos + +query($query)) { + + /* Get field information for all columns */ + while ($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 + +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); +?> +]]> + + + + Los ejemplos anteriores producirán la siguiente salida: + + + + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-fetch-fields.xml b/reference/mysqli/mysqli/functions/mysqli-fetch-fields.xml new file mode 100644 index 0000000000..cf59644f8a --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-fetch-fields.xml @@ -0,0 +1,166 @@ + + + + + + mysqli_fetch_fields + result->fetch_fields + Regresa una matriz de objetos representando los campos en un + resultado + + + Descripción + Estilo por procedimientos: + + mixtomysqli_fetch_fields + objetoresultado + + Estilo orientado a objetos (método): + + resultado + + mixto + fetch_fields + + + + + Esta función sirve identica en propósito a la función + mysqli-fetch-field con la minima diferencia de que, + en lugar de regresar un objeto a la vez para cada campo, las columnas son + regresadas como una matiz de objetos. Para una descripción de los + atributos de cada objeto y su significado vea la función + mysqli_fetch_field. + + + + Valores regresados + + Regresa una matriz de objetos que contienen la información de definició + de los campos o &false; si no hay información del campo disponible. + + + + Vea también + + mysqli_num_fields + mysqli_fetch_field + mysqli_fetch_field_direct + + + + Ejemplos + + Estilo orientado a objetos + +query($query)) { + + /* Get field information for all columns */ + $finfo = $result->fetch_fields(); + + for ($i=0; $i < count($finfo); $i++) { + printf("Name: %s\n", $finfo[$i]->name); + printf("Table: %s\n", $finfo[$i]->table); + printf("max. Len: %d\n", $finfo[$i]->max_length); + printf("Flags: %d\n", $finfo[$i]->flags); + printf("Type: %d\n\n", $finfo[$i]->type); + } + $result->close(); +} + +/* close connection */ +$mysqli->close(); +?> +]]> + + + + Estilo por procedimientos + +name); + printf("Table: %s\n", $finfo[$i]->table); + printf("max. Len: %d\n", $finfo[$i]->max_length); + printf("Flags: %d\n", $finfo[$i]->flags); + printf("Type: %d\n\n", $finfo[$i]->type); + } + mysqli_free_result($result); +} + +/* close connection */ +mysqli_close($link); +?> +]]> + + + + Los ejemplos anteriores producirán la siguiente salida: + + + + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-fetch-lengths.xml b/reference/mysqli/mysqli/functions/mysqli-fetch-lengths.xml new file mode 100644 index 0000000000..dc2142f4d7 --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-fetch-lengths.xml @@ -0,0 +1,155 @@ + + + + + + mysqli_fetch_lengths + result->lengths + Regresa la longitud de las columnas de la fila actual en el + resultado + + + Descripción + Estilo por procedimientos: + + mixtomysqli_fetch_lengths + objetoresultado + + Estilo orientado a objetos(propiedad): + + resultado + mixtolengths + + + La función mysqli_fetch_lengths regresa una matriz + conteniendo la longitud de cada columna de la fila actual en el resultado + representado por el parámetro result. Si hay + información regresa una matriz numéricamente ordenada representando + la longitud de cada columna o &false; si falla. + + + + Valores regresados + + Una matriz de enteros representando el tamaņo de cada columna (sin incluir + el caracter NULL al final de la columna). &false; si ocurre un error. + + + mysql_fetch_lengthsEs valida solo para la fila actual + en el resultado. Regresa &false; si se llama antes de ejecutar + mysql_fetch_row/array/object o después de obtener todas las filas + en el resultado. + + + + Ejemplos + + Estilo orientado a objetos + +query($query)) { + + $row = $result->fetch_row(); + + /* display column lengths */ + for ($i=0; $i < count($result->lengths); $i++) { + printf("Field %2d has Length %2d\n", $i+1, $result->lengths[$i]); + } + $result->close(); +} + +/* close connection */ +$mysqli->close(); +?> +]]> + + + + Estilo por procedimientos + + +]]> + + + + Los ejemplos anteriores producirán la siguiente salida: + + + + + + + + diff --git a/reference/mysqli/mysqli/functions/mysqli-fetch.xml b/reference/mysqli/mysqli/functions/mysqli-fetch.xml new file mode 100644 index 0000000000..3722df03d6 --- /dev/null +++ b/reference/mysqli/mysqli/functions/mysqli-fetch.xml @@ -0,0 +1,49 @@ + + + + + + mysqli_fetch + Alias de mysqli_stmt_fetch + + + Descripción + + Esta función es un alias de mysqli_stmt_fetch. + Para una descripción más detallada vea + mysqli_stmt_fetch. + + + + mysqli_fetch es obsoleta y será removida. + + + + + Vea también + + mysqli_stmt_fetch + + + + +