Files
php-doc-ru/reference/gmp/functions/gmp-setbit.xml
sergey 668b64d4ea review
git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@348028 c90b9560-bf6c-de11-be94-00142212c4b1
2019-09-21 12:56:15 +00:00

177 lines
4.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: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: tmn Status: ready -->
<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.gmp-setbit">
<refnamediv>
<refname>gmp_setbit</refname>
<refpurpose>Установка бита</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>void</type><methodname>gmp_setbit</methodname>
<methodparam><type>GMP</type><parameter>a</parameter></methodparam>
<methodparam><type>int</type><parameter>index</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>bit_on</parameter><initializer>&true;</initializer></methodparam>
</methodsynopsis>
<para>
Устанавливает в 1 бит с индексом <parameter>index</parameter> в числе <parameter>a</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>a</parameter></term>
<listitem>
<para>
Изменяемое значение.
</para>
&gmp.parameter;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>index</parameter></term>
<listitem>
<para>
Индекс устанавливаемого бита. Индекс 0 указывает на младший бит.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>bit_on</parameter></term>
<listitem>
<para>
True для установки бита (установки в 1/включен); false для его очистки (установки в 0/выключен).
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&gmp.return;
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Пример использования <function>gmp_setbit</function> - 0 индекс</title>
<programlisting role="php">
<![CDATA[
<?php
$a = gmp_init("2"); //
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
gmp_setbit($a, 0); // 0b10 now becomes 0b11
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
2 -> 0b10
3 -> 0b11
]]>
</screen>
</example>
<example>
<title>Пример использования <function>gmp_setbit</function> - 1 индекс</title>
<programlisting role="php">
<![CDATA[
<?php
$a = gmp_init("0xfd");
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
gmp_setbit($a, 1); // index starts at 0
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
253 -> 0b11111101
255 -> 0b11111111
]]>
</screen>
</example>
<example>
<title>Пример использования <function>gmp_setbit</function> очистка бита</title>
<programlisting role="php">
<![CDATA[
<?php
$a = gmp_init("0xff");
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
gmp_setbit($a, 0, false); // clear bit at index 0
echo gmp_strval($a), ' -> 0b', gmp_strval($a, 2), "\n";
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
255 -> 0b11111111
254 -> 0b11111110
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
В отличие от большинства GMP функций, <function>gmp_setbit</function>
должна вызываться для уже существующего GMP ресурса (например, созданного
функцией <function>gmp_init</function>). Число не будет создаваться
автоматически.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>gmp_clrbit</function></member>
<member><function>gmp_testbit</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
-->