Skip to content

[Sync-En] mysqli_stmt::$insert_id and finally: sync with doc-en #1449

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
PhilDaiguille merged 1 commit into from
Oct 15, 2026
Merged

[Sync-En] mysqli_stmt::$insert_id and finally: sync with doc-en #1449

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions language/control-structures/finally.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 31d9f67dd1a2574dd870a2dc2ccacbed75d2ce36 Maintainer: lacatoire Status: ready -->
<!-- EN-Revision: 6af4cd5be387fcb28cabfca49f0d9109ebfc660f Maintainer: lacatoire Status: ready -->
<!-- Reviewed: no -->
<sect1 xml:id="control-structures.finally" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>finally</title>
Expand Down Expand Up @@ -27,15 +27,15 @@ function inverse($x) {

try {
echo inverse(5) . "\n";
} catch (\DivisionByZeroError $e) {
} catch (DivisionByZeroError $e) {
echo 'Error capturado: ', $e->getMessage(), "\n";
} finally {
echo "Primer finally.\n";
}

try {
echo inverse(0) . "\n";
} catch (\DivisionByZeroError $e) {
} catch (DivisionByZeroError $e) {
echo 'Error capturado: ', $e->getMessage(), "\n";
} finally {
echo "Segundo finally.\n";
Expand Down Expand Up @@ -250,7 +250,7 @@ function generate()
try {
yield 1;
yield 2;
} catch (\Exception $e) {
} catch (Exception $e) {
echo 'catch';
} finally {
echo "finally\n";
Expand Down Expand Up @@ -280,7 +280,7 @@ catch externo
<simpara>
Es posible utilizar &yield; dentro de un bloque &finally;, pero si se
produce un error <exceptionname>Throwable</exceptionname> y no es capturado
dentro del &foreach;, se lanza una <exceptionname>Error</exceptionname>
dentro del &foreach;, se lanza un <exceptionname>Error</exceptionname>
<literal>Cannot yield from finally in a force-closed generator</literal>.
</simpara>
<example>
Expand All @@ -296,7 +296,7 @@ function generate()
try {
yield 1;
yield 2;
} catch (\Exception $e) {
} catch (Exception $e) {
echo 'catch';
} finally {
echo "finally\n";
Expand Down Expand Up @@ -453,7 +453,7 @@ function generate()
try {
yield 1;
yield 2;
} catch (\Exception $e) {
} catch (Exception $e) {
echo 'catch';
} finally {
echo "finally interno\n";
Expand Down
111 changes: 108 additions & 3 deletions reference/mysqli/mysqli_stmt/insert-id.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 5d8dfb31071496ffd2d51609ba098e6c9a3ce0d2 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: aa135ef2689157299c23fd4b8eb8c4f70733deaa Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="mysqli-stmt.insert-id" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mysqli_stmt::$insert_id</refname>
<refname>mysqli_stmt_insert_id</refname>
<refpurpose>Obtiene el ID generado por la última consulta INSERT</refpurpose>
<refpurpose>Devuelve el valor generado para una columna AUTO_INCREMENT por la última consulta ejecutada</refpurpose>
</refnamediv>

<refsect1 role="description">
Expand All @@ -18,9 +18,114 @@
<type class="union"><type>int</type><type>string</type></type><methodname>mysqli_stmt_insert_id</methodname>
<methodparam><type>mysqli_stmt</type><parameter>statement</parameter></methodparam>
</methodsynopsis>
<simpara>
Devuelve el ID generado por una consulta <literal>INSERT</literal> o
<literal>UPDATE</literal> en una tabla con una columna que tiene el atributo
<literal>AUTO_INCREMENT</literal>. En el caso de una consulta
<literal>INSERT</literal> de varias filas, devuelve el primer valor generado
automáticamente que se insertó con éxito. Si se utiliza
<literal>LAST_INSERT_ID(expr)</literal> para establecer el valor de
<literal>AUTO_INCREMENT</literal>, o en una consulta <literal>UPDATE</literal>,
se devuelve en su lugar el valor de <literal>expr</literal>.
</simpara>
<simpara>
Devuelve <literal>0</literal> si la consulta no cambió ningún valor
<literal>AUTO_INCREMENT</literal>.
</simpara>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
&mysqli.stmt.description;
</variablelist>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
El valor del campo <literal>AUTO_INCREMENT</literal> que fue modificado por
la consulta. Devuelve cero si la consulta aún no se ha ejecutado o si no
modificó ningún valor <literal>AUTO_INCREMENT</literal>.
</simpara>
<simpara>
El valor es específico del objeto de consulta. No se ve afectado por otras
consultas ejecutadas en la misma conexión después de esta consulta, ni por
las consultas emitidas mediante otras conexiones o clientes.
</simpara>
<note>
<simpara>
Si el número es mayor que el valor máximo de un integer, será devuelto como
un &string;.
</simpara>
</note>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo con <varname>mysqli_stmt::$insert_id</varname></title>
<simpara>&style.oop;</simpara>
<programlisting role="php">
<![CDATA[
<?php

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");

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

$stmt = $mysqli->prepare("INSERT INTO myCity (Name, CountryCode, District, Population) VALUES (?, ?, ?, ?)");

$name = 'Stuttgart';
$countryCode = 'DEU';
$district = 'Stuttgart';
$population = 617000;
$stmt->bind_param('sssi', $name, $countryCode, $district, $population);
$stmt->execute();

printf("El nuevo registro tiene ID %d.\n", $stmt->insert_id);
]]>
</programlisting>
<simpara>&style.procedural;</simpara>
<programlisting role="php">
<![CDATA[
<?php

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$link = mysqli_connect("localhost", "my_user", "my_password", "world");

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

$stmt = mysqli_prepare($link, "INSERT INTO myCity (Name, CountryCode, District, Population) VALUES (?, ?, ?, ?)");

$name = 'Stuttgart';
$countryCode = 'DEU';
$district = 'Stuttgart';
$population = 617000;
mysqli_stmt_bind_param($stmt, 'sssi', $name, $countryCode, $district, $population);
mysqli_stmt_execute($stmt);

printf("El nuevo registro tiene ID %d.\n", mysqli_stmt_insert_id($stmt));
]]>
</programlisting>
&examples.outputs;
<screen>
<![CDATA[
El nuevo registro tiene ID 1.
]]>
</screen>
</example>
</refsect1>

&warn.undocumented.func;
<refsect1 role="seealso">
&reftitle.seealso;

<simplelist>
<member><function>mysqli_insert_id</function></member>
<member><function>mysqli_stmt_affected_rows</function></member>
<member><function>mysqli_stmt_execute</function></member>
</simplelist>
</refsect1>

</refentry>
Expand Down
Loading