STNumCurves (geometry データ型)

  • [アーティクル]

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceMicrosoft Fabric の SQL 分析エンドポイントMicrosoft Fabric のウェアハウス

このメソッドは、geometry インスタンスが 1 次元の空間データ型の場合に、そこに含まれる曲線の数を返します。 1 次元の空間データ型には、LineString、CircularString、CompoundCurve があります。 STNumCurves() は単純型に対してのみ機能し、MultiLineString のような geometry コレクションでは機能しません。

構文

  
.STNumCurves()

Note

SQL Server 2014 (12.x) 以前のバージョンの Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。

戻り値の型

SQL Server の戻り値の型: geometry

CLR 戻り値の型: SqlGeometry

解説

空の 1 次元 geometry インスタンスは 0 を返します。 geometry インスタンスが 1 次元のインスタンスではない場合や初期化されていない場合は、NULL が返されます。

例

A. CircularString インスタンスに対して STNumCurves() を使用する

次の例では、CircularString インスタンスに含まれる曲線の数を取得する方法を示します。

 DECLARE @g geometry;  
 SET @g = geometry::Parse('CIRCULARSTRING(10 0, 0 10, -10 0, 0 -10, 10 0)');  
 SELECT @g.STNumCurves();

B. CompoundCurve インスタンスに対して STNumCurves() を使用する

次の例では、STNumCurves() を使用して、CompoundCurve インスタンスに含まれる曲線の数を返します。

 DECLARE @g geometry;  
 SET @g = geometry::Parse('COMPOUNDCURVE(CIRCULARSTRING(10 0, 0 10, -10 0, 0 -10, 10 0))');  
 SELECT @g.STNumCurves();

参照

空間データ型の概要
Geometry インスタンスの OGC メソッド