このトピックでは、ST_Split関数について説明します。 この関数は、入力ジオメトリオブジェクトを分割してGeometryCollectionオブジェクトを返します。
構文
ジオメトリST_Split (ジオメトリ入力、ジオメトリブレード);パラメーター
| パラメーター | 説明 |
| 入力 | 指定するジオメトリオブジェクト。 |
| ブレード | 入力ジオメトリオブジェクトを分割するために使用するジオメトリオブジェクト。 |
説明
- この関数は、MultiPointオブジェクト、MultiLineオブジェクト、またはMultiPolygonオブジェクトを使用して、ラインオブジェクトを分割できます。 この関数は、ラインオブジェクトを使用してMultiPolygonオブジェクトを分割することもできます。
- この関数は常にGeometryCollectionオブジェクトを返します。
- 理論的には、ST_Union関数を使用してST_Split関数によって返された結果を処理すると、ST_Union関数はST_Split関数の入力ジオメトリオブジェクトを返します。
- ブレードパラメーターをMultiPolygonオブジェクトに設定した場合、この関数は、MultiPolygonオブジェクトの境界を使用して入力ジオメトリオブジェクトを分割します。
例
次のステートメントを実行して、LineStringオブジェクトを使用してポリゴンオブジェクトを分割します。
ST_Split (入力、ブレード)
から (ST_MakeEnvelope(0,0、2,2) を入力、'LINESTRING(1 -1,1 3)'::geometry as blade) をt;