doc-es/reference/bc/functions/bcscale.xml at master · php/doc-es · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ddb05f8827151e25dd1c3e058f95f6c024bc881b Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.bcscale" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>bcscale</refname>
  <refpurpose>Define o recupera la precisión por defecto para todas las funciones bc math</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>int</type><methodname>bcscale</methodname>
   <methodparam><type>int</type><parameter>scale</parameter></methodparam>
  </methodsynopsis>
  <para>
   Define la precisión por defecto para todas las llamadas posteriores a las funciones
   bc math que omiten el argumento de precisión.
  </para>
  <methodsynopsis>
   <type>int</type><methodname>bcscale</methodname>
   <methodparam choice="opt"><type>null</type><parameter>scale</parameter><initializer>&null;</initializer></methodparam>
  </methodsynopsis>
  <para>
   Recupera el factor de precisión actual.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>scale</parameter></term>
     <listitem>
      <para>
       El factor de precisión.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Retorna la precisión anterior cuando se utiliza como definidor.
   De lo contrario, se retorna la precisión actual.
  </para>
 </refsect1>

 <refsect1 role="errors">
  &reftitle.errors;
  <simpara>
   Esta función levanta una excepción <exceptionname>ValueError</exceptionname> si <parameter>scale</parameter>
   está fuera del rango válido.
  </simpara>
 </refsect1>

 <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> ahora es nullable.
      </entry>
     </row>
     <row>
      <entry>7.3.0</entry>
      <entry>
       <function>bcscale</function> ahora puede ser utilizada para recuperar
       la precisión actual; cuando se utiliza para definir una nueva
       precisión, ahora retorna la precisión anterior.
       Anteriormente, <parameter>scale</parameter> era obligatorio,
       y <function>bcscale</function> siempre retornaba &true;.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Ejemplo con <function>bcscale</function></title>
    <programlisting role="php">
<![CDATA[
<?php

// precisión por defecto: 3
bcscale(3);
echo bcdiv('105', '6.55957'); // 16.007

// lo mismo sin utilizar bcscale()
echo bcdiv('105', '6.55957', 3); // 16.007

?>
]]>
    </programlisting>
   </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
-->