1
0
mirror of https://github.com/php/doc-es.git synced 2026-04-25 16:18:09 +02:00
Files
Louis-Arnaud f2aafed2e3 XML schema correction: fix inline tag types in reference/ (#466)
* XML schema correction: fix inline tag types in reference/

Replace incorrect inline markup tags to match doc-en structure:
- <literal> -> <constant> for PHP constants
- <literal> -> <type> for PHP types
- Add missing <emphasis>, <acronym>, <classname> tags
- Remove extra <function> self-references in descriptions
- Fix <parameter> names to match EN

* Fix: remove invalid <parameter> inside <subscript> in log.xml
2026-04-04 09:47:53 -05:00

145 lines
4.0 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 3c6c95fcfd7d9eaa603df40327693ea8dff89d53 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.pg-result-status" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>pg_result_status</refname>
<refpurpose>Lee el estado del resultado</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>string</type><type>int</type></type><methodname>pg_result_status</methodname>
<methodparam><type>PgSql\Result</type><parameter>result</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer><constant>PGSQL_STATUS_LONG</constant></initializer></methodparam>
</methodsynopsis>
<para>
<function>pg_result_status</function> devuelve el estado de la instancia de <classname>PgSql\Result</classname>,
o la etiqueta de comando PostgreSQL asociada al resultado.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>result</parameter></term>
<listitem>
&pgsql.parameter.result;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
<para>
Puede ser <constant>PGSQL_STATUS_LONG</constant> para devolver un estado
numérico de <parameter>result</parameter> o
<constant>PGSQL_STATUS_STRING</constant> para devolver la etiqueta del
comando de <parameter>result</parameter>. Si el argumento no se
especifica, <constant>PGSQL_STATUS_LONG</constant> es el valor por omisión.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Los valores de retorno posibles son <constant>PGSQL_EMPTY_QUERY</constant>,
<constant>PGSQL_COMMAND_OK</constant>, <constant>PGSQL_TUPLES_OK</constant>,
<constant>PGSQL_TUPLES_CHUNK</constant>, <constant>PGSQL_COPY_OUT</constant>,
<constant>PGSQL_COPY_IN</constant>, <constant>PGSQL_BAD_RESPONSE</constant>,
<constant>PGSQL_NONFATAL_ERROR</constant> y <constant>PGSQL_FATAL_ERROR</constant>
si <constant>PGSQL_STATUS_LONG</constant> se
especifica. De lo contrario, se devuelve un <type>string</type> que contiene la etiqueta del comando PostgreSQL.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&pgsql.changelog.result-object;
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo con <function>pg_result_status</function></title>
<programlisting role="php">
<![CDATA[
<?php
// Conexión a la base de datos
$conn = pg_pconnect("dbname=publisher");
// Ejecución de COPY
$result = pg_query($conn, "COPY autores FROM STDIN;");
// Obtención del estado
$status = pg_result_status($result);
// Determinación del estado
if ($status == PGSQL_COPY_IN)
echo "La copia se ha realizado.";
else
echo "La copia ha fallado.";
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
La copia se ha realizado.
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>pg_connection_status</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->