[postgis-tickets] [SCM] PostGIS branch master updated. 3.4.0rc1-646-g7a073e69b
git at osgeo.org
git at osgeo.org
Fri Sep 29 01:00:20 PDT 2023
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 7a073e69b60a0c56573553c8c630d05a641bd2e9 (commit)
via 458f51b31a0749ac2b6472d9152d4e335547da40 (commit)
via c920fedd640e15244d047cc0afc46d8af0d34bf1 (commit)
via ba61460327d693dc734d74da5774f390e905a39a (commit)
from 4ad7b3117c4354c6127fd6b5626c723e26d2e9b1 (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 7a073e69b60a0c56573553c8c630d05a641bd2e9
Merge: 4ad7b3117 458f51b31
Author: Sandro Santilli <strk at kbt.io>
Date: Fri Sep 29 01:00:18 2023 -0700
Merge pull request '[Feature] Add ST_HasZ/ST_HasM' (!155) from lbartoletti/postgis:add_hasz_hasm into master
Reviewed-on: https://git.osgeo.org/gitea/postgis/postgis/pulls/155
commit 458f51b31a0749ac2b6472d9152d4e335547da40
Author: Loïc Bartoletti <loic.bartoletti at oslandia.com>
Date: Fri Sep 29 08:23:10 2023 +0200
Add paragraph about availability version and z/m support
diff --git a/doc/reference_accessor.xml b/doc/reference_accessor.xml
index 08165efe3..06d8309c5 100644
--- a/doc/reference_accessor.xml
+++ b/doc/reference_accessor.xml
@@ -3152,6 +3152,10 @@ SELECT ST_Zmflag(ST_GeomFromEWKT('POINT(1 2 3 4)'));
<para>Geometry objects with a Z dimension typically represent three-dimensional (3D) geometries, while those without it are two-dimensional (2D) geometries.</para>
<para>This function is useful for determining if a geometry has elevation or height information.</para>
+
+ <para role="availability" conformance="3.5.0">Availability: 3.5.0</para>
+ <para>&Z_support;</para>
+ <para>&M_support;</para>
</refsection>
<refsection>
@@ -3197,6 +3201,10 @@ SELECT ST_Zmflag(ST_GeomFromEWKT('POINT(1 2 3 4)'));
<para>Geometry objects with an M dimension typically represent measurements or additional data associated with spatial features.</para>
<para>This function is useful for determining if a geometry includes measure information.</para>
+
+ <para role="availability" conformance="3.5.0">Availability: 3.5.0</para>
+ <para>&Z_support;</para>
+ <para>&M_support;</para>
</refsection>
<refsection>
commit c920fedd640e15244d047cc0afc46d8af0d34bf1
Author: Loïc Bartoletti <loic.bartoletti at oslandia.com>
Date: Fri Sep 29 08:22:41 2023 +0200
fix availabity version
diff --git a/postgis/postgis.sql.in b/postgis/postgis.sql.in
index 49880dd33..2840dfb55 100644
--- a/postgis/postgis.sql.in
+++ b/postgis/postgis.sql.in
@@ -1660,14 +1660,14 @@ CREATE OR REPLACE FUNCTION ST_NDims(geometry)
LANGUAGE 'c' IMMUTABLE STRICT PARALLEL SAFE
_COST_DEFAULT;
--- Availability: 3.6.0
+-- Availability: 3.5.0
CREATE OR REPLACE FUNCTION ST_HasZ(geometry)
RETURNS boolean
AS 'MODULE_PATHNAME', 'LWGEOM_hasz'
LANGUAGE 'c' IMMUTABLE STRICT PARALLEL SAFE
_COST_DEFAULT;
--- Availability: 3.6.0
+-- Availability: 3.5.0
CREATE OR REPLACE FUNCTION ST_HasM(geometry)
RETURNS boolean
AS 'MODULE_PATHNAME', 'LWGEOM_hasm'
commit ba61460327d693dc734d74da5774f390e905a39a
Author: Loïc Bartoletti <loic.bartoletti at oslandia.com>
Date: Thu Sep 28 15:23:07 2023 +0200
[Feature] Add ST_HasZ/ST_HasM
These functions have been available for a long time with ST_ZMFlags and in lwgeom
but were not exposed in SQL.
However, we have had a deprecation note for ST_ZMFlags for several versions now.
This MR proposes to simply expose these methods with their ISO names.
diff --git a/doc/reference_accessor.xml b/doc/reference_accessor.xml
index bd92d89ea..08165efe3 100644
--- a/doc/reference_accessor.xml
+++ b/doc/reference_accessor.xml
@@ -3129,4 +3129,95 @@ SELECT ST_Zmflag(ST_GeomFromEWKT('POINT(1 2 3 4)'));
</refsection>
</refentry>
+ <refentry xml:id="ST_HasZ">
+ <refnamediv>
+ <refname>ST_HasZ</refname>
+ <refpurpose>Checks if a geometry has a Z dimension.</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>boolean <function>ST_HasZ</function></funcdef>
+ <paramdef><type>geometry</type> <parameter>geom</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>Checks if the input geometry has a Z dimension and returns a boolean value. If the geometry has a Z dimension, it returns true; otherwise, it returns false.</para>
+
+ <para>Geometry objects with a Z dimension typically represent three-dimensional (3D) geometries, while those without it are two-dimensional (2D) geometries.</para>
+
+ <para>This function is useful for determining if a geometry has elevation or height information.</para>
+ </refsection>
+
+ <refsection>
+ <title>Examples</title>
+
+ <programlisting>SELECT ST_HasZ(ST_GeomFromText('POINT(1 2 3)'));
+ --result
+ true
+</programlisting>
+ <programlisting>SELECT ST_HasZ(ST_GeomFromText('LINESTRING(0 0, 1 1)'));
+ --result
+ false
+</programlisting>
+ </refsection>
+
+ <refsection>
+ <title>See Also</title>
+ <para><xref linkend="ST_Zmflag"/></para>
+ <para><xref linkend="ST_HasM"/></para>
+ </refsection>
+</refentry>
+
+<refentry xml:id="ST_HasM">
+ <refnamediv>
+ <refname>ST_HasM</refname>
+ <refpurpose>Checks if a geometry has an M (measure) dimension.</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>boolean <function>ST_HasM</function></funcdef>
+ <paramdef><type>geometry</type> <parameter>geom</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ </refsynopsisdiv>
+
+ <refsection>
+ <title>Description</title>
+
+ <para>Checks if the input geometry has an M (measure) dimension and returns a boolean value. If the geometry has an M dimension, it returns true; otherwise, it returns false.</para>
+
+ <para>Geometry objects with an M dimension typically represent measurements or additional data associated with spatial features.</para>
+
+ <para>This function is useful for determining if a geometry includes measure information.</para>
+ </refsection>
+
+ <refsection>
+ <title>Examples</title>
+
+ <programlisting>SELECT ST_HasM(ST_GeomFromText('POINTM(1 2 3)'));
+ --result
+ true
+</programlisting>
+ <programlisting>SELECT ST_HasM(ST_GeomFromText('LINESTRING(0 0, 1 1)'));
+ --result
+ false
+</programlisting>
+ </refsection>
+
+ <refsection>
+ <title>See Also</title>
+ <para><xref linkend="ST_Zmflag"/></para>
+ <para><xref linkend="ST_HasZ"/></para>
+ </refsection>
+</refentry>
+
+
</section>
diff --git a/postgis/postgis.sql.in b/postgis/postgis.sql.in
index e962965e7..49880dd33 100644
--- a/postgis/postgis.sql.in
+++ b/postgis/postgis.sql.in
@@ -1660,6 +1660,20 @@ CREATE OR REPLACE FUNCTION ST_NDims(geometry)
LANGUAGE 'c' IMMUTABLE STRICT PARALLEL SAFE
_COST_DEFAULT;
+-- Availability: 3.6.0
+CREATE OR REPLACE FUNCTION ST_HasZ(geometry)
+ RETURNS boolean
+ AS 'MODULE_PATHNAME', 'LWGEOM_hasz'
+ LANGUAGE 'c' IMMUTABLE STRICT PARALLEL SAFE
+ _COST_DEFAULT;
+
+-- Availability: 3.6.0
+CREATE OR REPLACE FUNCTION ST_HasM(geometry)
+ RETURNS boolean
+ AS 'MODULE_PATHNAME', 'LWGEOM_hasm'
+ LANGUAGE 'c' IMMUTABLE STRICT PARALLEL SAFE
+ _COST_DEFAULT;
+
-- Availability: 1.2.2
CREATE OR REPLACE FUNCTION ST_AsEWKT(geometry)
RETURNS TEXT
-----------------------------------------------------------------------
Summary of changes:
doc/reference_accessor.xml | 99 ++++++++++++++++++++++++++++++++++++++++++++++
postgis/postgis.sql.in | 14 +++++++
2 files changed, 113 insertions(+)
hooks/post-receive
--
PostGIS
More information about the postgis-tickets
mailing list