1
0
mirror of https://github.com/php/doc-ru.git synced 2026-03-23 23:32:16 +01:00
Files
Mikhail Alferov f78c6b2db2 Update bc functions to En (#1036)
* Update bcadd.xml to en

* Update bcceil.xml to en

* Update bccomp.xml to en

* Update bcdiv.xml to en

* Update bcdivmod.xml to en

* Update bcfloor.xml to en

* Update bcmod.xml to en

* Update bcmul.xml to en

* Update bcpow.xml to en

* Update bcpowmod.xml to en

* Update bcround.xml to En + Infostyle

* Update bcsqrt.xml to en

* Update bcsub.xml to en
2025-01-17 04:21:42 +03:00

149 lines
4.5 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: c7e83fbbbcde9f54affc09424d032c38492a3ff4 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.bcmod" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
<refnamediv>
<refname>bcmod</refname>
<refpurpose>
Получает остаток от деления чисел произвольной точности
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>bcmod</methodname>
<methodparam><type>string</type><parameter>num1</parameter></methodparam>
<methodparam><type>string</type><parameter>num2</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>scale</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Функция получает остаток от деления числа <parameter>num1</parameter>
на число <parameter>num2</parameter>.
Результат получит тот же знак, что и у числа <parameter>num1</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.bcadd')/db:refsect1[@role='parameters']/*)" />
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Функция возвращает остаток от деления в виде строки.
</para>
</refsect1>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('function.bcdiv')/db:refsect1[@role='errors'])" />
<refsect1 role="changelog"><!-- {{{ -->
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Параметр <parameter>scale</parameter> теперь принимает значение &null;.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Деление на <literal>0</literal> теперь выбрасывает
исключение <exceptionname>DivisionByZeroError</exceptionname> вместо возврата значения &null;.
</entry>
</row>
<row>
<entry>7.2.0</entry>
<entry>
Числа <parameter>num1</parameter> и <parameter>num2</parameter> больше
не усекаются до целого, поэтому поведение функции <function>bcmod</function> теперь
соответствует функции <function>fmod</function>, а не оператору <literal>%</literal>.
</entry>
</row>
<row>
<entry>7.2.0</entry>
<entry>
Добавили параметр <parameter>scale</parameter>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1><!-- }}} -->
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Пример получения остатка от деления функцией <function>bcmod</function></title>
<programlisting role="php">
<![CDATA[
<?php
bcscale(0);
echo bcmod( '5', '3'); // 2
echo bcmod( '5', '-3'); // 2
echo bcmod('-5', '3'); // -2
echo bcmod('-5', '-3'); // -2
?>
]]>
</programlisting>
</example>
<example>
<title>Пример получения остатка от деления чисел с десятичными знаками функцией <function>bcmod</function></title>
<programlisting role="php">
<![CDATA[
<?php
bcscale(1);
echo bcmod('5.7', '1.3'); // 0.5 с PHP 7.2.0; 0 ранее
?>
]]>
</programlisting>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>bcdiv</function></member>
<member><function>bcdivmod</function></member>
<member><methodname>BcMath\Number::mod</methodname></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
-->