名前

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が指定されていない場合は0 (不明)となります。入力byteaLINESTRINGを表現していない場合はNULLを返します。これはST_LineFromWKBの別名です。

[注記]

OGC SPEC 3.2.6.2 - 任意引数SRIDは仕様適合のためです。

[注記]

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

このメソッドはOGC 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