名稱

ST_Disjoint — 測試兩個幾何物件是否沒有共同點

概要

boolean ST_Disjoint( geometry A , geometry B );

描述

如果兩個幾何物件是不相交的,則返回 true。 如果兩個幾何物件沒有共同點,則它們是不相交的。

如果一對幾何物件的任何其他空間關係為真,則它們不是不相交的。不相交意味著 ST_Intersects 為假。

以數學術語表示:ST_Disjoint(A, B) ⇔ A ⋂ B = ∅

[Important]

增強功能:3.0.0 版本啟用對 GEOMETRYCOLLECTION 的支持

由 GEOS 模組執行

[Note]

此函數呼叫不使用索引。可以使用取反的 ST_Intersects 謂詞作為更高效的替代方案,它會使用索引:ST_Disjoint(A,B) = NOT ST_Intersects(A,B)

[Note]

注意:這是返回布林值的「允許」版本,而不是整數。

此方法實作了 OGC 簡單要素 SQL 1.1 實作規範 s2.1.1.2 //s2.1.13.3 - a.Relate(b, 'FF*FF****')

此方法實作了 SQL/MM 規範。SQL-MM 3: 5.1.26

範例

SELECT ST_Disjoint('POINT(0 0)'::geometry, 'LINESTRING ( 2 0, 0 2 )'::geometry);
 st_disjoint
---------------
 t
(1 row)
SELECT ST_Disjoint('POINT(0 0)'::geometry, 'LINESTRING ( 0 0, 0 2 )'::geometry);
 st_disjoint
---------------
 f
(1 row)
    

另請參閱

ST_Intersects