ST_IsEmpty · دليل PostGIS 3.6

الاسم

ST_IsEmpty — تختبر ما إذا كان الشكل الهندسي فارغًا.

المختصر

boolean ST_IsEmpty(geometry geomA);

الوصف

تُعيد true إذا كان هذا الشكل الهندسي فارغًا. وإذا كانت القيمة true، فإن هذا الشكل الهندسي يمثل مجموعة أشكال أو مضلعًا أو نقطة فارغة، إلخ.


	يُعرّف SQL-MM ناتج ST_IsEmpty(NULL) بأنه 0، بينما يُعيد PostGIS القيمة NULL.

تطبّق هذه الدالة مواصفة OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.1

تطبّق هذه الدالة مواصفة SQL/MM. SQL-MM 3: 5.1.7

تدعم هذه الدالة الأقواس الدائرية (Circular Strings) والمنحنيات.


	تغيّرت في: 2.0.0 في الإصدارات السابقة من PostGIS كان التعبير ST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)') مسموحًا. وأصبح الآن غير مسموح في PostGIS 2.0.0 لتحقيق توافق أفضل مع معايير SQL/MM

أمثلة

SELECT ST_IsEmpty(ST_GeomFromText('GEOMETRYCOLLECTION EMPTY'));
 st_isempty
------------
 t
(1 row)

 SELECT ST_IsEmpty(ST_GeomFromText('POLYGON EMPTY'));
 st_isempty
------------
 t
(1 row)

SELECT ST_IsEmpty(ST_GeomFromText('POLYGON((1 2, 3 4, 5 6, 1 2))'));

 st_isempty
------------
 f
(1 row)

 SELECT ST_IsEmpty(ST_GeomFromText('POLYGON((1 2, 3 4, 5 6, 1 2))')) = false;
 ?column?
----------
 t
(1 row)

 SELECT ST_IsEmpty(ST_GeomFromText('CIRCULARSTRING EMPTY'));
  st_isempty
------------
 t
(1 row)