ST_LinestringFromWKB
Prev  7.8.2. Well-Known Binary (WKB)  Next

Name

ST_LinestringFromWKB — Construit une géométrie depuis la représentation binaire WKB et le SRID donné.

Synopsis

geometry ST_LinestringFromWKB(bytea WKB);

geometry ST_LinestringFromWKB(bytea WKB, integer srid);

Description

La fonction ST_LinestringFromWKB prend en paramètre une représentation binaire d'une géométrie (WKB ou EWKB) et un SRID (SRID) et crée une instance du bon type géométrique, en l'occurence une LINESTRING. Cette fonction assure le rôle de Geometry Factory en SQL.

Si le SRID n'est pas précisé, la valeur 0 est prise par défaut. NULL est retourné si le paramètre bytea donné ne représente pas une LINESTRING. Alias pour ST_LineFromWKB.

[Note]

OGC SPEC 3.2.6.2 - SRID optionnel issu des tests de conformité.
[Note]

Si vous savez que toutes vos géométries sont des LINESTRING, il est plus efficace d'utiliser ST_GeomFromWKB. Cette fonction appelle simplement ST_GeomFromWKB et ajoute une validation supplémentaire indiquant qu'elle renvoie une LINESTRING.

Cette méthode implémente la spécification OGC Simple Features Implementation Specification for SQL 1.1. s3.2.6.2

Cette méthode implémente la spécification SQL/MM. SQL-MM 3 : 7.2.9

Exemples

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