svn: /phpdoc/de/trunk/reference/bc/ book.xml functions/bcdiv.xml functions/bcmod.xml functions/bcmul.xml functions/bcpow.xml functions/bcpowmod.xml

Modified: phpdoc/de/trunk/reference/bc/book.xml
===================================================================
--- phpdoc/de/trunk/reference/bc/book.xml	2018-01-12 16:44:50 UTC (rev 343822)
+++ phpdoc/de/trunk/reference/bc/book.xml	2018-01-12 17:08:57 UTC (rev 343823)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 340322 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 343027 Maintainer: sammywg Status: ready -->

 <book xml:id="book.bc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <?phpdoc extension-membership="bundled" ?>
@@ -12,9 +12,36 @@
   &reftitle.intro;
   <para>
    Für beliebig genaue mathematische Operationen bietet PHP den Binary
-   Calculator, der Zahlen von beliebiger Länge und Genauigkeit mit bis zu 2147483647-1
-   (oder 0x7FFFFFFF-1) Stellen, die als String vorliegen, unterstützt.
+   Calculator, der Zahlen von beliebiger Länge und Genauigkeit mit bis zu <literal>2147483647</literal>
+   (oder <literal>0x7FFFFFFF</literal>) Stellen, die als String vorliegen, unterstützt,
+   falls genügend Speicherplatz vorhanden ist.
   </para>
+  <caution>
+   <para>
+    Die Übergabe von Werten vom Typ <type>float</type> an eine BCMath-Funktion,
+    die einen <type>String</type> als Operanden erwartet, funktioniert
+    möglicherweise nicht wie erwartet, aufgrund der Art wie PHP
+    <type>float</type> Werte in <type>String</type>s konvertiert, nämlich dass
+    der <type>String</type> u.U. in exponentieller Notation vorliegt (was von
+    BCMath nicht unterstützt wird), und dass der Dezimaltrenner vom Locale
+    abhängt (wohingegen BCMath immer einen Dezimalpunkt erwartet).
+   </para>
+   <informalexample>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$num1 = 0; // (string) 0 => '0'
+$num2 = -0.000005; // (string) -0.000005 => '-5.05E-6'
+echo bcadd($num1, $num2, 6); // => '0.000000'
+
+setlocale(LC_NUMERIC, 'de_DE'); // verwendet ein Dezimalkomma
+$num2 = 1.2; // (string) 1.2 => '1,2'
+echo bcsub($num1, $num2, 1); // => '0.0'
+?>
+]]>
+    </programlisting>
+   </informalexample>
+  </caution>
  </preface>
  <!-- }}} -->


Modified: phpdoc/de/trunk/reference/bc/functions/bcdiv.xml
===================================================================
--- phpdoc/de/trunk/reference/bc/functions/bcdiv.xml	2018-01-12 16:44:50 UTC (rev 343822)
+++ phpdoc/de/trunk/reference/bc/functions/bcdiv.xml	2018-01-12 17:08:57 UTC (rev 343823)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 338333 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 343028 Maintainer: sammywg Status: ready -->
 <refentry xml:id="function.bcdiv" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>bcdiv</refname>
@@ -11,13 +11,13 @@
   &reftitle.description;
   <methodsynopsis>
    <type>string</type><methodname>bcdiv</methodname>
-   <methodparam><type>string</type><parameter>left_operand</parameter></methodparam>
-   <methodparam><type>string</type><parameter>right_operand</parameter></methodparam>
+   <methodparam><type>string</type><parameter>dividend</parameter></methodparam>
+   <methodparam><type>string</type><parameter>divisor</parameter></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>scale</parameter><initializer>0</initializer></methodparam>
   </methodsynopsis>
   <para>
-   Dividiert <parameter>left_operand</parameter> durch
-   <parameter>right_operand</parameter>.
+   Dividiert <parameter>dividend</parameter> durch
+   <parameter>divisor</parameter>.
   </para>
  </refsect1>

@@ -26,18 +26,18 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>left_operand</parameter></term>
+     <term><parameter>dividend</parameter></term>
      <listitem>
       <para>
-       Der linke Operand in Stringform.
+       Der Dividend in Stringform.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>right_operand</parameter></term>
+     <term><parameter>divisor</parameter></term>
      <listitem>
       <para>
-       Der rechte Operand in Stringform.
+       Der Divisor in Stringform.
       </para>
      </listitem>
     </varlistentry>
@@ -50,7 +50,7 @@
   &reftitle.returnvalues;
   <para>
    Gibt das Ergebnis der Division als String zurück. Wenn der Parameter
-   <parameter>right_operand</parameter> 0 ist, wird &null; zurückgegeben.
+   <parameter>divisor</parameter> <literal>0</literal> ist, wird &null; zurückgegeben.
   </para>
  </refsect1>


Modified: phpdoc/de/trunk/reference/bc/functions/bcmod.xml
===================================================================
--- phpdoc/de/trunk/reference/bc/functions/bcmod.xml	2018-01-12 16:44:50 UTC (rev 343822)
+++ phpdoc/de/trunk/reference/bc/functions/bcmod.xml	2018-01-12 17:08:57 UTC (rev 343823)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 343029 Maintainer: sammywg Status: ready -->
 <refentry xml:id="function.bcmod" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>bcmod</refname>
@@ -11,11 +11,11 @@
   &reftitle.description;
   <methodsynopsis>
    <type>string</type><methodname>bcmod</methodname>
-   <methodparam><type>string</type><parameter>left_operand</parameter></methodparam>
+   <methodparam><type>string</type><parameter>dividend</parameter></methodparam>
    <methodparam><type>string</type><parameter>modulus</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Liefert den Modulo des <parameter>left_operand</parameter> unter Verwendung
+   Liefert den Modulo des <parameter>dividend</parameter> unter Verwendung
    von <parameter>modulus</parameter>.
   </para>
  </refsect1>
@@ -25,10 +25,10 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>left_operand</parameter></term>
+     <term><parameter>dividend</parameter></term>
      <listitem>
       <para>
-       Der linke Operand in Stringform.
+       Der Dividend in Stringform.
       </para>
      </listitem>
     </varlistentry>
@@ -47,11 +47,36 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Gibt den Modulo als String zurück. Ist <parameter>modulus</parameter> 0,
+   Gibt den Modulo als String zurück. Ist <parameter>modulus</parameter> <literal>0</literal>,
    wird &null; zurückgegeben.
   </para>
  </refsect1>

+ <refsect1 role="changelog"><!-- {{{ -->
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>7.2.0</entry>
+      <entry>
+       <parameter>dividend</parameter> und <parameter>modulus</parameter> werden
+       nicht länger zu einer Ganzzahl abgeschnitten, so dass nun das Verhalten
+       von <function>bcmod</function> eher <function>fmod</function> statt dem
+       <literal>%</literal> Operator entspricht.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1><!-- }}} -->
+
  <refsect1 role="examples">
   &reftitle.examples;
   <example>

Modified: phpdoc/de/trunk/reference/bc/functions/bcmul.xml
===================================================================
--- phpdoc/de/trunk/reference/bc/functions/bcmul.xml	2018-01-12 16:44:50 UTC (rev 343822)
+++ phpdoc/de/trunk/reference/bc/functions/bcmul.xml	2018-01-12 17:08:57 UTC (rev 343823)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 338333 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 343822 Maintainer: sammywg Status: ready -->
 <refentry xml:id="function.bcmul" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>bcmul</refname>
@@ -53,6 +53,30 @@
   </para>
  </refsect1>

+ <refsect1 role="changelog"><!-- {{{ -->
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>7.3.0</entry>
+      <entry>
+       <function>bcmul</function> liefert nun Zahlen mit den angeforderten
+       Nachkommastellen zurück. Zuvor haben die zurückgelieferten Zahlen
+       möglicherweise abschließende Dezimalnullen ausgelassen.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1><!-- }}} -->
+
  <refsect1 role="examples">
   &reftitle.examples;
   <example>
@@ -68,6 +92,28 @@
   </example>
  </refsect1>

+ <refsect1 role="notes">
+  &reftitle.notes;
+  <note>
+   <para>
+    Vor PHP 7.3.0 kann <function>bcmul</function> ein Ergebnis mit weniger Nachkommastellen,
+    als der <parameter>scale</parameter> Parameter angibt, zurückliefern.
+    Dies geschieht nur, wenn das Ergebnis nicht die gesamte Präzision, die durch
+    <parameter>scale</parameter> erlaubt ist, benötigt. Zum Beispiel:
+    <example>
+     <title><function>bcmul</function>-Nachkommastellen-Beispiel</title>
+     <programlisting role="php">
+<![CDATA[
+<?php
+echo bcmul('5', '2', 2);     // gibt "10" aus, nicht "10.00"
+?>
+]]>
+     </programlisting>
+    </example>
+   </para>
+  </note>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>

Modified: phpdoc/de/trunk/reference/bc/functions/bcpow.xml
===================================================================
--- phpdoc/de/trunk/reference/bc/functions/bcpow.xml	2018-01-12 16:44:50 UTC (rev 343822)
+++ phpdoc/de/trunk/reference/bc/functions/bcpow.xml	2018-01-12 17:08:57 UTC (rev 343823)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 338333 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 343101 Maintainer: sammywg Status: ready -->
 <refentry xml:id="function.bcpow" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>bcpow</refname>
@@ -11,13 +11,13 @@
   &reftitle.description;
   <methodsynopsis>
    <type>string</type><methodname>bcpow</methodname>
-   <methodparam><type>string</type><parameter>left_operand</parameter></methodparam>
-   <methodparam><type>string</type><parameter>right_operand</parameter></methodparam>
+   <methodparam><type>string</type><parameter>base</parameter></methodparam>
+   <methodparam><type>string</type><parameter>exponent</parameter></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>scale</parameter><initializer>0</initializer></methodparam>
   </methodsynopsis>
   <para>
-   Potenziert <parameter>left_operand</parameter> mit
-   <parameter>right_operand</parameter>.
+   Potenziert <parameter>base</parameter> mit
+   <parameter>exponent</parameter>.
   </para>
  </refsect1>

@@ -26,18 +26,21 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>left_operand</parameter></term>
+     <term><parameter>base</parameter></term>
      <listitem>
       <para>
-       Der linke Operand in Stringform.
+       Die Basis in Stringform.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>right_operand</parameter></term>
+     <term><parameter>exponent</parameter></term>
      <listitem>
       <para>
-       Der rechte Operand in Stringform.
+       Der Exponent in Stringform. Ist der Exponent nicht ganzzahlig, wird er
+       abgeschnitten. Der gültige Bereich des Exponenten ist Plattformabhängig,
+       ist allerdings wenigstens <literal>-2147483648</literal> bis
+       <literal>2147483647</literal>.
       </para>
      </listitem>
     </varlistentry>
@@ -53,6 +56,30 @@
   </para>
  </refsect1>

+ <refsect1 role="changelog"><!-- {{{ -->
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>7.3.0</entry>
+      <entry>
+       <function>bcpow</function> liefert nun Zahlen mit den angeforderten
+       Nachkommastellen zurück. Zuvor haben die zurückgelieferten Zahlen
+       möglicherweise abschließende Dezimalnullen ausgelassen.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1><!-- }}} -->
+
  <refsect1 role="examples">
   &reftitle.examples;
   <example>
@@ -73,7 +100,7 @@
   &reftitle.notes;
   <note>
    <para>
-    <function>bcpow</function> kann ein Ergebnis mit weniger Dezimalstellen
+    Vor PHP 7.3.0 kann <function>bcpow</function> ein Ergebnis mit weniger Dezimalstellen
     liefern als der <parameter>scale</parameter> Parameter angibt.
     Das geschieht nur, wenn das Ergebnis nicht die gesamte Genauigkeit benötigt,
     die durch den <parameter>scale</parameter> erlaubt ist. Zum Beispiel:

Modified: phpdoc/de/trunk/reference/bc/functions/bcpowmod.xml
===================================================================
--- phpdoc/de/trunk/reference/bc/functions/bcpowmod.xml	2018-01-12 16:44:50 UTC (rev 343822)
+++ phpdoc/de/trunk/reference/bc/functions/bcpowmod.xml	2018-01-12 17:08:57 UTC (rev 343823)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 338333 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 343026 Maintainer: sammywg Status: ready -->
 <refentry xml:id="function.bcpowmod" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>bcpowmod</refname>
@@ -12,14 +12,14 @@
   &reftitle.description;
   <methodsynopsis>
    <type>string</type><methodname>bcpowmod</methodname>
-   <methodparam><type>string</type><parameter>left_operand</parameter></methodparam>
-   <methodparam><type>string</type><parameter>right_operand</parameter></methodparam>
+   <methodparam><type>string</type><parameter>base</parameter></methodparam>
+   <methodparam><type>string</type><parameter>exponent</parameter></methodparam>
    <methodparam><type>string</type><parameter>modulus</parameter></methodparam>
    <methodparam choice="opt"><type>int</type><parameter>scale</parameter><initializer>0</initializer></methodparam>
   </methodsynopsis>
   <para>
    Benutzen Sie diese schnelle Exponentialmethode, um
-   <parameter>left_operand</parameter> mit <parameter>right_operand</parameter>
+   <parameter>base</parameter> mit <parameter>exponent</parameter>
    unter Berücksichtigung des Modulo <parameter>modulus</parameter> zu
    potenzieren.
   </para>
@@ -30,18 +30,19 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>left_operand</parameter></term>
+     <term><parameter>base</parameter></term>
      <listitem>
       <para>
-       Der linke Operand in Stringform.
+       Der Basis als ganzzahliger String (d.h. ohne Nachkommastellen).
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>right_operand</parameter></term>
+     <term><parameter>exponent</parameter></term>
      <listitem>
       <para>
-       Der rechte Operand in Stringform.
+       Der Exponent als nicht-negativer, ganzzahliger String (d.h. ohne
+       Nachkommastellen).
       </para>
      </listitem>
     </varlistentry>
@@ -49,7 +50,7 @@
      <term><parameter>modulus</parameter></term>
      <listitem>
       <para>
-       Modulo in Stringform.
+       Der Modulus als ganzzahliger String (d.h. ohne Nachkommastellen).
       </para>
      </listitem>
     </varlistentry>
@@ -61,7 +62,8 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Gibt das Ergebnis als String zurück. Ist <parameter>modulus</parameter> 0,
+   Gibt das Ergebnis als String zurück. Ist <parameter>modulus</parameter> <literal>0</literal>
+   oder <parameter>exponent</parameter> kleiner Null,
    wird &null; zurückgegeben.
   </para>
  </refsect1>