ST_CircularString(ST_Point,ST_Point,ST

ST_CircularString(ST_Point,ST_Point,ST_Point,...)-Konstruktor

Konstruiert einen Kreisbogenfolgenwert aus einer Liste von Punkten in einem angegebenen räumlichen Bezugssystem.

Syntax

NEW ST_CircularString(pt1,pt2,pt3[,pt4,...,ptN])

Parameter

Name	Typ	Beschreibung
pt1	ST_Point	Der erste Punkt eines Segments.
pt2	ST_Point	Jeder Punkt auf dem Segment zwischen dem ersten und dem letzten Punkt.
pt3	ST_Point	Der letzte Punkt eines Segments.
pt4,...,ptN	ST_Point	Zusätzliche Punkte, die weitere Segmente definieren, die jeweils mit dem vorherigen Endpunkt beginnen, durch den ersten zusätzlichen Punkt gehen und mit dem zweiten zusätzlichen Punkt enden.

Konstruiert einen Kreisbogenfolgenwert aus einer Liste von Punkten. Mindestens drei Punkte müssen angegeben werden. Der erste dieser drei Punkte ist der Startpunkt eines Segments, der dritte Punkt ist das Ende des Segments und der zweite Punkt ist ein beliebiger Punkt auf dem Segment zwischen dem ersten und dritten Punkt. Weitere Punkte können in Paaren angegeben werden, um der Kreisbogenfolge weitere Segmente hinzuzufügen. Alle angegebenen Punkte müssen dieselbe SRID aufweisen. Die sich daraus ergebende Kreisbogenfolge wird mit dieser gemeinsamen SRID erstellt. Die angegebenen Punkte dürfen nicht leer sein und müssen dieselbe Antwort für Is3D und IsMeasured aufweisen. Die Kreisbogenfolge ist 3D, wenn alle Punkte 3D sind. Die Kreisbogenfolge wird gemessen, wenn alle Punkte gemessen werden.

Hinweis

Standardmäßig verwendet ST_CircularString das Originalformat für eine Geometrie, wenn es verfügbar ist. Andernfalls wird das interne Format verwendet. Weitere Hinweise zu den internen Formaten und Originalformaten finden Sie unter STORAGE FORMAT-Klausel, CREATE SPATIAL REFERENCE SYSTEM-Anweisung.

Standards und Kompatibilität

Beispiel

Der folgende Code gibt einen Fehler zurück: Mindestens drei Punkte müssen angegeben werden.

SELECT NEW ST_CircularString( NEW ST_Point( 0, 0 ), NEW ST_Point( 1, 1 ) )

Das folgende Beispiel gibt den Wert CircularString (0 0, 1 1, 2 0) zurück.

SELECT NEW ST_CircularString( NEW ST_Point( 0, 0 ), NEW ST_Point( 1, 1 ), NEW ST_Point(2,0) )

Der folgende Code gibt einen Fehler zurück: Das erste Segment hat drei Punkte, die nachfolgenden Segmente haben zwei.

SELECT NEW ST_CircularString( NEW ST_Point( 0, 0 ), NEW ST_Point( 1, 1 ), NEW ST_Point(2,0), NEW ST_Point(1,-1) )

Das folgende Beispiel gibt den Wert CircularString (0 0, 1 1, 2 0, 1 -1, 0 0) zurück.

SELECT NEW ST_CircularString( NEW ST_Point( 0, 0 ), NEW ST_Point( 1, 1 ), NEW ST_Point(2,0), NEW ST_Point(1,-1), NEW ST_Point( 0, 0 ) )