ST_LinestringFromWKB · دليل PostGIS 3.6

الاسم

ST_LinestringFromWKB — تُنشئ geometry من WKB باستخدام SRID المعطى.

المختصر

geometry ST_LinestringFromWKB(bytea WKB);

geometry ST_LinestringFromWKB(bytea WKB, integer srid);

الوصف

تأخذ الدالة ST_LinestringFromWKB تمثيلًا ثنائيًا معروفًا لشكل هندسي ومعرّف النظام المرجعي المكاني (SRID)، وتُنشئ نسخة من نوع geometry المناسب، وهو في هذه الحالة geometry من نوع LINESTRING. تؤدي هذه الدالة دور مصنع الأشكال الهندسية (Geometry Factory) في SQL.

إذا لم يُحدَّد SRID فقيمته الافتراضية 0. وتُعاد NULL إذا لم يكن المُدخل bytea يمثّل geometry من نوع LINESTRING. هذه الدالة اسم بديل لـ 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