Files
php-doc-ru/reference/pgsql/functions/pg-field-num.xml
2011-08-13 20:10:27 +00:00

119 lines
3.4 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<!-- $Revision$ -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
<refentry xml:id="function.pg-field-num" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>pg_field_num</refname>
<refpurpose>Возвращает порядковый номер именованного поля</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>int</type><methodname>pg_field_num</methodname>
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam><type>string</type><parameter>field_name</parameter></methodparam>
</methodsynopsis>
<para>
<function>pg_field_num</function> вернет порядковый номер поля
с именем <parameter>field_name</parameter> в результате запроса
<parameter>result</parameter>.
</para>
<note>
<para>
Прежнее название функции: <function>pg_fieldnum</function>.
</para>
</note>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>result</parameter></term>
<listitem>
<para>
Ресурс результата запроса PostgreSQL, возвращаемый функциями
<function>pg_query</function>, <function>pg_query_params</function>
или <function>pg_execute</function> (в числе прочих).
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>field_name</parameter></term>
<listitem>
<para>
Наименование поля.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Номер поля (начиная с нуля), либо -1 в случае ошибки.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Получение информации о полях выборки</title>
<programlisting role="php">
<![CDATA[
<?php
$dbconn = pg_connect("dbname=publisher") or die("Невозможно соединиться с базой");
$res = pg_query($dbconn, "select author, year, title from authors where author = 'Orwell'");
echo "Столбец 'title' - это поле с номером: ", pg_field_num($res, 'title');
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Столбец 'title' - это поле с номером: 2
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>pg_field_name</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
-->