1
0
mirror of https://github.com/php/doc-ru.git synced 2026-03-27 09:12:07 +01:00
Files
archived-doc-ru/reference/quickhash/quickhashintstringhash/update.xml
Mikhail Alferov 6a3eb59116 Update update.xml
2024-06-19 05:11:54 +03:00

118 lines
3.6 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: 29054534f689e0ed3a1ebe982d9ff996bf97d3ca Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="quickhashintstringhash.update" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>QuickHashIntStringHash::update</refname>
<refpurpose>Обновляет запись в хеше новым значением</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>bool</type><methodname>QuickHashIntStringHash::update</methodname>
<methodparam><type>int</type><parameter>key</parameter></methodparam>
<methodparam><type>string</type><parameter>value</parameter></methodparam>
</methodsynopsis>
<para>
Метод обновляет запись новым значением и возвращает информацию о том, обновилась ли запись.
Если есть дубликаты ключей, только первый найденный элемент получит обновлённое значение.
Чтобы предотвратить попадание повторяющихся ключей в хеш,
при создании хеша указывают константу <constant>QuickHashIntStringHash::CHECK_FOR_DUPES</constant>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
Ключ обновляемой записи.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>value</parameter></term>
<listitem>
<para>
Новое значение записи. Если передаётся нестроковое значение,
метод автоматически преобразует значение в строку, если это возможно.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Метод возвращает &true;, если нашёл и обновил запись,
и &false;, если запись ещё не была частью хеша.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Пример использования метода <function>QuickHashIntStringHash::update</function></title>
<programlisting role="php">
<![CDATA[
<?php
$hash->add(161803398, "--");
$hash->add(314159265, "Множество");
echo $hash->get(161803398), "\n";
echo $hash->get(314159265), "\n";
var_dump($hash->update(314159265, "Множество плюс один"));
var_dump($hash->update(314159999, "Множество плюс один"));
echo $hash->get(161803398), "\n";
echo $hash->get(314159265), "\n";
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
--
Множество
bool(true)
bool(false)
--
Множество плюс один
]]>
</screen>
</example>
</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
-->