mirror/postgresql
2
0
Fork 0
mirror of https://git.postgresql.org/git/postgresql.git synced 2025-01-24 18:55:04 +08:00
Code Issues Packages Projects Releases Wiki Activity

Update 'Mathematical Functions' table to reflect 7.3 addition of float8

Browse Source 
forms of ceil(), floor(), sign().  Back-patch this and other recent
doc fixes in this file to the 7.3 branch.
This commit is contained in:
Tom Lane 2003-01-23 01:22:59 +00:00
parent b3d7af46a9
commit 742403bdad
1 changed files with 45 additions and 39 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

84
doc/src/sgml/func.sgml
View File

@ -1,5 +1,5 @@
<!--
$Header: /cvsroot/pgsql/doc/src/sgml/func.sgml,v 1.134 2002/12/06 05:20:12 momjian Exp $
$Header: /cvsroot/pgsql/doc/src/sgml/func.sgml,v 1.135 2003/01/23 01:22:59 tgl Exp $
PostgreSQL documentation
-->
@ -520,17 +520,13 @@ PostgreSQL documentation
<para>
<xref linkend="functions-math-func-table"> shows the available
mathematical functions. In the table, <literal>dp</literal>
indicates <type>double precision</type>. The functions
<function>exp</function>, <function>ln</function>,
<function>log</function>, <function>pow</function>,
<function>round</function> (1 argument), <function>sqrt</function>,
and <function>trunc</function> (1 argument) are also available for
the type <type>numeric</type> in place of <type>double
precision</type>. Functions returning a <type>numeric</type>
result take <type>numeric</type> input arguments, unless otherwise
specified. Many of these functions are implemented on top of the
host system's C library; accuracy and behavior in boundary cases
could therefore vary depending on the host system.
indicates <type>double precision</type>. Many of these functions
are provided in multiple forms with different argument types.
Except where noted, any given form of a function returns the same
datatype as its argument.
The functions working with <type>double precision</type> data are mostly
implemented on top of the host system's C library; accuracy and behavior in
boundary cases may therefore vary depending on the host system.
</para>
<table id="functions-math-func-table">
@ -564,8 +560,8 @@ PostgreSQL documentation
</row>
<row>
<entry><function>ceil</function>(<type>numeric</type>)</entry>
<entry><type>numeric</type></entry>
<entry><function>ceil</function>(<type>dp</type> or <type>numeric</type>)</entry>
<entry>(same as input)</entry>
<entry>smallest integer not less than argument</entry>
<entry><literal>ceil(-42.8)</literal></entry>
<entry>-42</entry>
@ -580,32 +576,32 @@ PostgreSQL documentation
</row>
<row>
<entry><function>exp</function>(<type>dp</type>)</entry>
<entry><type>dp</type></entry>
<entry><function>exp</function>(<type>dp</type> or <type>numeric</type>)</entry>
<entry>(same as input)</entry>
<entry>exponential</entry>
<entry><literal>exp(1.0)</literal></entry>
<entry>2.71828182845905</entry>
</row>
<row>
<entry><function>floor</function>(<type>numeric</type>)</entry>
<entry><type>numeric</type></entry>
<entry><function>floor</function>(<type>dp</type> or <type>numeric</type>)</entry>
<entry>(same as input)</entry>
<entry>largest integer not greater than argument</entry>
<entry><literal>floor(-42.8)</literal></entry>
<entry>-43</entry>
</row>
<row>
<entry><function>ln</function>(<type>dp</type>)</entry>
<entry><type>dp</type></entry>
<entry><function>ln</function>(<type>dp</type> or <type>numeric</type>)</entry>
<entry>(same as input)</entry>
<entry>natural logarithm</entry>
<entry><literal>ln(2.0)</literal></entry>
<entry>0.693147180559945</entry>
</row>
<row>
<entry><function>log</function>(<type>dp</type>)</entry>
<entry><type>dp</type></entry>
<entry><function>log</function>(<type>dp</type> or <type>numeric</type>)</entry>
<entry>(same as input)</entry>
<entry>base 10 logarithm</entry>
<entry><literal>log(100.0)</literal></entry>
<entry>2</entry>
@ -638,14 +634,23 @@ PostgreSQL documentation
</row>
<row>
<entry><function>pow</function>(<parameter>e</parameter> <type>dp</type>,
<parameter>n</parameter> <type>dp</type>)</entry>
<entry><function>pow</function>(<parameter>x</parameter> <type>dp</type>,
<parameter>e</parameter> <type>dp</type>)</entry>
<entry><type>dp</type></entry>
<entry>raise a number to exponent <parameter>e</parameter></entry>
<entry><literal>pow(9.0, 3.0)</literal></entry>
<entry>729</entry>
</row>
<row>
<entry><function>pow</function>(<parameter>x</parameter> <type>numeric</type>,
<parameter>e</parameter> <type>numeric</type>)</entry>
<entry><type>numeric</type></entry>
<entry>raise a number to exponent <parameter>e</parameter></entry>
<entry><literal>pow(9.0, 3.0)</literal></entry>
<entry>729</entry>
</row>
<row>
<entry><function>radians</function>(<type>dp</type>)</entry>
<entry><type>dp</type></entry>
@ -657,14 +662,14 @@ PostgreSQL documentation
<row>
<entry><function>random</function>()</entry>
<entry><type>dp</type></entry>
<entry>value between 0.0 to 1.0</entry>
<entry>random value between 0.0 and 1.0</entry>
<entry><literal>random()</literal></entry>
<entry></entry>
</row>
<row>
<entry><function>round</function>(<type>dp</type>)</entry>
<entry><type>dp</type></entry>
<entry><function>round</function>(<type>dp</type> or <type>numeric</type>)</entry>
<entry>(same as input)</entry>
<entry>round to nearest integer</entry>
<entry><literal>round(42.4)</literal></entry>
<entry>42</entry>
@ -686,32 +691,31 @@ PostgreSQL documentation
</row>
-->
<row>
<entry><function>sign</function>(<type>numeric</type>)</entry>
<entry><type>numeric</type></entry>
<entry><function>sign</function>(<type>dp</type> or <type>numeric</type>)</entry>
<entry>(same as input)</entry>
<entry>sign of the argument (-1, 0, +1)</entry>
<entry><literal>sign(-8.4)</literal></entry>
<entry>-1</entry>
</row>
<row>
<entry><function>sqrt</function>(<type>dp</type>)</entry>
<entry><type>dp</type></entry>
<entry><function>sqrt</function>(<type>dp</type> or <type>numeric</type>)</entry>
<entry>(same as input)</entry>
<entry>square root</entry>
<entry><literal>sqrt(2.0)</literal></entry>
<entry>1.4142135623731</entry>
</row>
<row>
<entry><function>trunc</function>(<type>dp</type>)</entry>
<entry><type>dp</type></entry>
<entry><function>trunc</function>(<type>dp</type> or <type>numeric</type>)</entry>
<entry>(same as input)</entry>
<entry>truncate toward zero</entry>
<entry><literal>trunc(42.8)</literal></entry>
<entry>42</entry>
</row>
<row>
<entry><function>trunc</function>(<type>numeric</type>,
<parameter>r</parameter> <type>integer</type>)</entry>
<entry><function>trunc</function>(<parameter>v</parameter> <type>numeric</type>, <parameter>s</parameter> <type>integer</type>)</entry>
<entry><type>numeric</type></entry>
<entry>truncate to <parameter>s</parameter> decimal places</entry>
<entry><literal>trunc(42.4382, 2)</literal></entry>
@ -725,7 +729,7 @@ PostgreSQL documentation
<para>
Finally, <xref linkend="functions-math-trig-table"> shows the
available trigonometric functions. All trigonometric functions
have arguments and return values of type <type>double
take arguments and return values of type <type>double
precision</type>.
</para>
@ -2043,7 +2047,7 @@ PostgreSQL documentation
<para>
This section describes functions and operators for examining and
manipulating binary string values. Strings in this context include
manipulating binary string values. Strings in this context mean
values of the type <type>BYTEA</type>.
</para>
@ -2146,7 +2150,8 @@ PostgreSQL documentation
</row>
<row>
<entry><function>set_byte</function>(<parameter>string</parameter>, <parameter>offset</parameter>)</entry>
<entry><function>set_byte</function>(<parameter>string</parameter>,
<parameter>offset</parameter>, <parameter>newvalue</>)</entry>
<entry><type>bytea</type></entry>
<entry>
Set byte in string.
@ -2172,7 +2177,8 @@ PostgreSQL documentation
</row>
<row>
<entry><function>set_bit</function>(<parameter>string</parameter>, <parameter>offset</parameter>)</entry>
<entry><function>set_bit</function>(<parameter>string</parameter>,
<parameter>offset</parameter>, <parameter>newvalue</>)</entry>
<entry><type>bytea</type></entry>
<entry>
Set bit in string.