Update to En item.xml

This commit is contained in:
Mikhail Alferov
2024-09-13 16:23:09 +03:00
committed by GitHub
parent 95f619ce7b
commit f4050b89c2

View File

@ -1,12 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 68b6b98138cb53182d7b32fa13ca9663d8526909 Maintainer: tmn Status: ready -->
<!-- EN-Revision: 2352068d5585a13365f23605208ba872f7512363 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="domnodelist.item" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>DOMNodeList::item</refname>
<refpurpose>
Получает узел с заданным индексом
</refpurpose>
<refpurpose>Извлекает узел по индексу</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
@ -15,14 +13,13 @@
<methodparam><type>int</type><parameter>index</parameter></methodparam>
</methodsynopsis>
<para>
Извлекает узел с заданным индексом <parameter>index</parameter> из объекта
класса <classname>DOMNodeList</classname>.
Метод извлекает узел с индексом <parameter>index</parameter>
из объекта <classname>DOMNodeList</classname>.
</para>
<tip>
<para>
Если требуется узнать количество узлов в коллекции, используйте свойство
<literal>length</literal> объекта класса
<classname>DOMNodeList</classname>.
Количество узлов в коллекции содержится в свойстве <literal>length</literal>
объекта <classname>DOMNodeList</classname>.
</para>
</tip>
</refsect1>
@ -44,22 +41,21 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Узел, находящийся в позиции <parameter>index</parameter> объекта
<classname>DOMNodeList</classname>, или &null;, если этот индекс недопустим.
Метод возвращает узел, который содержится в объекте
<classname>DOMNodeList</classname> в позиции <parameter>index</parameter>,
или &null;, если этот индекс недопустим.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>
Вывод содержимого таблицы
</title>
<title>Пример вывода содержимого таблицы</title>
<programlisting role="php">
<![CDATA[
<?php
$doc = new DOMDocument;
$doc = new DOMDocument();
$doc->load('book.xml');
$items = $doc->getElementsByTagName('entry');
@ -71,8 +67,26 @@ for ($i = 0; $i < $items->length; $i++) {
?>
]]>
</programlisting>
</example>
<example>
<simpara>
Доступ к элементам получают тем же синтаксисом, который открывает доступ к элементам массива:
</simpara>
<programlisting role="php">
<![CDATA[
<?php
for ($i = 0; $i < $items->length; $i++) {
echo $items[$i]->nodeValue . "\n";
}
?>
]]>
</programlisting>
</example>
<example>
<para>
Кроме того, можно воспользоваться &foreach;;, что будет намного удобнее:
Альтернативный способ — конструкция &foreach;, которой удобнее перебирать элементы:
</para>
<programlisting role="php">
<![CDATA[