1
0
mirror of https://github.com/php/doc-uk.git synced 2026-03-24 23:22:14 +01:00
Files
2024-04-24 21:48:55 +03:00

134 lines
4.2 KiB
XML
Raw Permalink 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: 0a192fcd9cc43c0007de795063b4494974058992 Maintainer: mproshchuk Status: ready -->
<refentry xml:id="function.reset" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>reset</refname>
<refpurpose>Встановлює внутрішній вказівних масиву на його перший елемент</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>mixed</type><methodname>reset</methodname>
<methodparam><type class="union"><type>array</type><type>object</type></type><parameter role="reference">array</parameter></methodparam>
</methodsynopsis>
<para>
<function>reset</function> переміщує внутрішній вказівник масиву
<parameter>array</parameter> до його першого елемента та повертає значення
цього елемента.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>array</parameter></term>
<listitem>
<para>
Вхідний масив.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Повертає значення першого елемента масиву або &false;, якщо масив
порожній.
</para>
&return.falseproblem;
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&standard.changelog.calling-on-objects;
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Використання <function>reset</function></title>
<programlisting role="php">
<![CDATA[
<?php
$array = array('крок перший', 'крок другий', 'крок третій', 'крок четвертий');
// Початково вказівник знаходиться на першому елементі
echo current($array) . "<br />\n"; // "крок перший"
// Пропустимо два кроки
next($array);
next($array);
echo current($array) . "<br />\n"; // "крок третій"
// Перевстановлення вказівника, починається знову з "крок перший"
reset($array);
echo current($array) . "<br />\n"; // "крок перший"
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<simpara>
Значення, що повертається для порожнього масиву, таке ж, як для масиву, у
якого перший елемент — <type>bool</type> &false;. Щоб точно визначити, що
значення першого елемента масиву може бути &false;, треба
<function>поміряти</function> масив або перевірити, чи не повертає функція
<function>key</function> &null; після виклику <function>reset</function>.
</simpara>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>current</function></member>
<member><function>each</function></member>
<member><function>end</function></member>
<member><function>next</function></member>
<member><function>prev</function></member>
<member><function>array_key_first</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
-->