名前

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

このメソッドは曲線ストリングと曲線に対応しています。

Changed: 2.0.0 以前の版のPostGISではST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)')を許しました。PostGIS 2.0.0では、SQL/MM標準により準拠させるため、これは不正となります。

Code
SELECT ST_IsEmpty('GEOMETRYCOLLECTION EMPTY'::geometry);
出力:
t
Code
SELECT ST_IsEmpty('POLYGON EMPTY'::geometry);
出力:
t
Code
SELECT ST_IsEmpty('POLYGON((1 2,3 4,5 6,1 2))'::geometry);
出力:
f
Figure
Geometry figure for visual-st-isempty-03
Code
SELECT ST_IsEmpty('POLYGON((1 2,3 4,5 6,1 2))'::geometry) = false;
出力:
t
(1 row)
Figure
Geometry figure for visual-st-isempty-04
Code
SELECT ST_IsEmpty('CIRCULARSTRING EMPTY'::geometry);
出力:
t