php/archived-doc-ru
1
0
Fork 0
mirror of https://github.com/php/doc-ru.git synced 2026-03-23 23:32:16 +01:00
Code Issues Packages Projects Releases Wiki Activity

Update set.xml to en

Browse Source
This commit is contained in:
Mikhail Alferov
2026-01-28 08:24:58 +03:00
committed by GitHub
parent 4f554c246c
commit b43f1760fa
1 changed files with 15 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
reference/quickhash/quickhashinthash/set.xml
View File

@@ -1,26 +1,25 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bfe06c36ec1c0a37909704b292a204195b0bc14f Maintainer: sergey Status: ready -->
<!-- EN-Revision: 34c7b33526bef25c40c2ab0dcd8709c8948964c5 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="quickhashinthash.set">
<refnamediv>
<refname>QuickHashIntHash::set</refname>
<refpurpose>Обновляет запись в хеше новым значением или добавляет новую, если запись не существует</refpurpose>
<refpurpose>Обновляет запись в хеше новым значением или добавляет новую, если хеш не содержит запись</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>bool</type><methodname>QuickHashIntHash::set</methodname>
<modifier>public</modifier> <type>int</type><methodname>QuickHashIntHash::set</methodname>
<methodparam><type>int</type><parameter>key</parameter></methodparam>
<methodparam><type>int</type><parameter>value</parameter></methodparam>
</methodsynopsis>
<simpara>
Метод пытается обновить запись новым значением. Если запись ещё не существует, вместо обновления метод добавит
новую запись.
Метод возвращает информацию о том, добавилась ли запись или обновилась.
Если есть дубликаты ключей, только первый найденный элемент получит обновлённое значение.
Чтобы предотвратить попадание повторяющихся ключей в состав хеша,
при создании хеша указывают константу <constant>QuickHashIntHash::CHECK_FOR_DUPES</constant>.
Метод обновляет значение записи хеша или добавляет новую, если хеш не содержит ключ.
Метод сообщит о результате: запись добавилась, обновилась или возникла ошибка.
При дублировании ключей значение обновится только у первого найденного элемента.
Передача константы <constant>QuickHashIntHash::CHECK_FOR_DUPES</constant>
в конструктор или фабричный метод класса исключает дублирование ключей в хеше.
</simpara>
</refsect1>
@@ -31,7 +30,7 @@
<term><parameter>key</parameter></term>
<listitem>
<simpara>
Ключ записи, которую нужно добавить или обновить.
Ключ записи, которую требуется добавить или обновить.
</simpara>
</listitem>
</varlistentry>
@@ -49,15 +48,15 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
Метод возвращает 2, если нашёл и обновил запись,
1, если добавил запись, или 0, если возникла ошибка.
Метод возвращает 2, если добавил запись,
1, если нашёл и обновил, или 0, если возникла ошибка.
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Пример использования метода <function>QuickHashIntHash::set</function></title>
<title>Пример обновления или добавления записи в хеше методом <function>QuickHashIntHash::set</function></title>
<programlisting role="php">
<![CDATA[
<?php
@@ -69,19 +68,19 @@ var_dump($hash->get(46692));
var_dump($hash->set(46692, 16091));
var_dump($hash->get(46692));
echo "Set->Update\n";
echo "\n\nSet->Update\n";
var_dump($hash->set(46692, 29906));
var_dump($hash->get(46692));
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
Set->Add
bool(false)
int(2)
int(16091)
Set->Update
int(1)
int(29906)