الاسم
ST_EndPoint — تُعيد النقطة الأخيرة من خط (LineString) أو خط دائري (CircularLineString).
المختصر
geometry ST_EndPoint(geometry g);
الوصف
تُعيد النقطة الأخيرة من شكل LINESTRING أو CIRCULARLINESTRING بوصفها POINT. وتُعيد NULL إذا لم يكن المُدخل LINESTRING أو CIRCULARLINESTRING.
تطبّق هذه الدالة مواصفة SQL/MM. SQL-MM 3: 7.1.4
تدعم هذه الدالة الأبعاد الثلاثية ولا تُسقط قيمة Z.
تدعم هذه الدالة الأقواس الدائرية (Circular Strings) والمنحنيات.
![[ملاحظة]](../images/note.png)
|
|
|
تغيّرت في: 2.0.0 لم تعد تعمل مع الخطوط المتعددة (MultiLineStrings) ذات الشكل الواحد. في الإصدارات الأقدم من PostGIS كان الخط المتعدد المكوّن من خط واحد يعمل مع هذه الدالة ويُعيد نقطة النهاية. أما في 2.0.0 فتُعيد NULL كأي خط متعدد آخر. كان السلوك القديم ميزة غير موثقة، لكن من افترضوا أن بياناتهم مخزنة كـ LINESTRING قد يجدون أنها تُعيد NULL في 2.0.0. |
أمثلة
نقطة نهاية خط (LineString)
postgis=# SELECT ST_AsText(ST_EndPoint('LINESTRING(1 1, 2 2, 3 3)'::geometry));
st_astext
------------
POINT(3 3)
نقطة نهاية شكل ليس خطًا هي NULL
SELECT ST_EndPoint('POINT(1 1)'::geometry) IS NULL AS is_null;
is_null
----------
t
نقطة نهاية خط ثلاثي الأبعاد
--3d endpoint
SELECT ST_AsEWKT(ST_EndPoint('LINESTRING(1 1 2, 1 2 3, 0 0 5)'));
st_asewkt
--------------
POINT(0 0 5)
نقطة نهاية قوس دائري (CircularString)
SELECT ST_AsText(ST_EndPoint('CIRCULARSTRING(5 2,-3 1.999999, -2 1, -4 2, 6 3)'::geometry));
st_astext
------------
POINT(6 3)