Share via


STTouches (geometry データ型)

任意の geometry インスタンスが別の geometry インスタンスと空間的に接している場合は 1 を返します。それ以外の場合は 0 を返します。

構文

.STTouches ( other_geometry )

引数

  • other_geometry
    STTouches() を呼び出したインスタンスと比較される、別の geometry インスタンスです。

戻り値の型

SQL Server の戻り値の型 : bit

CLR の戻り値の型 : SqlBoolean

説明

比較する 2 つのインスタンスの地点のセットは交差しているが、インスタンス内部が交差していない場合、これらの geometry インスタンスは接しています。

2 つの geometry インスタンスの SRID (spatial reference ID) が一致しない場合、このメソッドは常に NULL を返します。

STTouches() を使用して、2 つの geometry インスタンスが接しているかどうかをテストする例を次に示します。

DECLARE @g geometry;
DECLARE @h geometry;
SET @g = geometry::STGeomFromText('LINESTRING(0 2, 2 0, 4 2)', 0);
SET @h = geometry::STGeomFromText('POINT(1 1)', 0);
SELECT @g.STTouches(@h);