名前

ST_LinestringFromWKB — WKB表現と与えられたSRIDからジオメトリを生成します。

概要

geometry ST_LinestringFromWKB(bytea WKB);

geometry ST_LinestringFromWKB(bytea WKB, integer srid);

説明

ST_LinestringFromWKBは、ジオメトリのWell-Known Binary表現と空間参照系識別番号(SRID)を取り、適切なジオメトリ型のインスタンスを生成します。この場合、LINESTRINGジオメトリです。この関数はSQLのジオメトリファクトリの役割を果たします。

SRIDが指定されていない場合は-1(不明)となります。入力byteaLINESTRINGを表現していない場合はNULLを返します。これはST_LineFromWKBの別名です。

[注記]

OGC SPEC 3.2.6.2 - optional SRID is from the conformance suite.

[注記]

全てのジオメトリがLINESTRINGであると知っている場合は、ST_GeomFromWKBを使う方が効果的です。この関数はST_GeomFromWKBの呼び出しと、LINESTRINGを返すかどうかの評価とを行います。

このメソッドはOpenGIS Simple Features Implementation Specification for SQL 1.1.の実装です s3.2.6.2

このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 7.2.9

SELECT
  ST_LineStringFromWKB(
	ST_AsBinary(ST_GeomFromText('LINESTRING(1 2, 3 4)'))
  ) AS aline,
  ST_LinestringFromWKB(
	ST_AsBinary(ST_GeomFromText('POINT(1 2)'))
  ) IS NULL AS null_return;
   aline                            | null_return
------------------------------------------------
010200000002000000000000000000F ... | t

関連情報

ST_GeomFromWKB, ST_LineFromWKB