[postgis-tickets] [SCM] PostGIS branch master updated. 3.1.0rc1-141-g49e381b
git at osgeo.org
git at osgeo.org
Thu Apr 15 10:27:12 PDT 2021
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "PostGIS".
The branch, master has been updated
via 49e381b6b5fb76770ff30af2fedfec766ececd11 (commit)
from 338783e1d7fde6ae0f71fa9ecb0c3aa6599b8e0d (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
commit 49e381b6b5fb76770ff30af2fedfec766ececd11
Author: Martin Davis <mtnclimb at gmail.com>
Date: Thu Apr 15 10:27:02 2021 -0700
Update doc ST_AsText
diff --git a/doc/reference_output.xml b/doc/reference_output.xml
index dd75bb5..842e601 100644
--- a/doc/reference_output.xml
+++ b/doc/reference_output.xml
@@ -114,7 +114,7 @@ CIRCULARSTRING(220268 150415 1,220227 150505 2,220227 150406 3)
<funcprototype>
<funcdef>text <function>ST_AsText</function></funcdef>
<paramdef><type>geometry </type> <parameter>g1</parameter></paramdef>
- <paramdef choice="opt"><type>integer </type> <parameter>maxdecimaldigits=15</parameter></paramdef>
+ <paramdef choice="opt"><type>integer </type> <parameter>maxdecimaldigits = 15</parameter></paramdef>
</funcprototype>
<funcprototype>
<funcdef>text <function>ST_AsText</function></funcdef>
@@ -123,7 +123,7 @@ CIRCULARSTRING(220268 150415 1,220227 150505 2,220227 150406 3)
<funcprototype>
<funcdef>text <function>ST_AsText</function></funcdef>
<paramdef><type>geography </type> <parameter>g1</parameter></paramdef>
- <paramdef choice="opt"><type>integer </type> <parameter>maxdecimaldigits=15</parameter></paramdef>
+ <paramdef choice="opt"><type>integer </type> <parameter>maxdecimaldigits = 15</parameter></paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
@@ -131,19 +131,24 @@ CIRCULARSTRING(220268 150415 1,220227 150505 2,220227 150406 3)
<refsection>
<title>Description</title>
- <para>Returns the Well-Known Text representation of the geometry/geography. Optional argument may be used to reduce the maximum number
- of decimal digits after floating point used in output (defaults to 15).</para>
+ <para>Returns the <link linkend="OpenGISWKBWKT">Well-Known Text</link> (WKT) representation of the geometry/geography.
+ The optional <parameter>maxdecimaldigits</parameter> argument may be used to limit the number
+ of digits after the decimal point in output ordinates (defaults to 15).</para>
+
+ <para>To perform the inverse conversion of WKT representation to PostGIS geometry
+ use <xref linkend="ST_GeomFromText" />.</para>
<note>
- <para>The WKT spec does not include the SRID. To get the SRID as part of the data, use the non-standard
- PostGIS <xref linkend="ST_AsEWKT" /></para>
+ <para>The standard OGC WKT representation does not include the SRID.
+ To include the SRID as part of the output representation, use the non-standard
+ PostGIS function <xref linkend="ST_AsEWKT" /></para>
</note>
<warning>
- <para>WKT format does not maintain precision so to prevent floating truncation, use ST_AsBinary or ST_AsEWKB format for transport.</para>
+ <para>The textual representation of numbers in WKT may not maintain full floating-point precision.
+ To ensure full accuracy for data storage or transport it is best to use
+ <link linkend="OpenGISWKBWKT">Well-Known Binary</link> (WKB) format
+ (see <xref linkend="ST_AsBinary" /> and <xref linkend="ST_AsEWKB" />).</para>
</warning>
- <note>
- <para>ST_AsText is the reverse of <xref linkend="ST_GeomFromText" />. Use <xref linkend="ST_GeomFromText" /> to convert to a postgis geometry from ST_AsText representation.</para>
- </note>
<para>Availability: 1.5 - support for geography was introduced.</para>
<para>Enhanced: 2.5 - optional parameter precision introduced.</para>
@@ -160,24 +165,24 @@ CIRCULARSTRING(220268 150415 1,220227 150505 2,220227 150406 3)
F03F000000000000F03F000000000000F03F000000000000F03
F000000000000000000000000000000000000000000000000');
- st_astext
+ st_astext
--------------------------------
POLYGON((0 0,0 1,1 1,1 0,0 0))
-(1 row)</programlisting>
-
- <para>Providing the precision is optional.</para>
+</programlisting>
- <programlisting>SELECT ST_AsText(GeomFromEWKT('SRID=4326;POINT(111.1111111 1.1111111)'))
- st_astext
+<para>Full precision output is the default.</para>
+ <programlisting>SELECT ST_AsText('POINT(111.1111111 1.1111111)'));
+ st_astext
------------------------------
POINT(111.1111111 1.1111111)
-(1 row)</programlisting>
+</programlisting>
- <programlisting>SELECT ST_AsText(GeomFromEWKT('SRID=4326;POINT(111.1111111 1.1111111)'),2)
-st_astext
+<para>The <parameter>maxdecimaldigits</parameter> argument can be used to limit output precision.</para>
+ <programlisting>SELECT ST_AsText('POINT(111.1111111 1.1111111)'), 2);
+ st_astext
--------------------
-POINT(111.11 1.11)
-(1 row)</programlisting>
+ POINT(111.11 1.11)
+</programlisting>
</refsection>
<!-- Optionally add a "See Also" section -->
-----------------------------------------------------------------------
Summary of changes:
doc/reference_output.xml | 47 ++++++++++++++++++++++++++---------------------
1 file changed, 26 insertions(+), 21 deletions(-)
hooks/post-receive
--
PostGIS
More information about the postgis-tickets
mailing list