ST_AddEdgeNewFaces
Prev | 10.6. Topology Editors | Next

## Name

ST_AddEdgeNewFaces — Add a new edge and, if in doing so it splits a face, delete the original face and replace it with two new faces.

## Synopsis

`integer ST_AddEdgeNewFaces(`varchar atopology, integer anode, integer anothernode, geometry acurve`)`;

## Description

Add a new edge and, if in doing so it splits a face, delete the original face and replace it with two new faces. Returns the id of the newly added edge.

Updates all existing joined edges and relationships accordingly.

If any arguments are null, the given nodes are unknown (must already exist in the `node` table of the topology schema) , the `acurve` is not a `LINESTRING`, the `anode` and `anothernode` are not the start and endpoints of `acurve` then an error is thrown.

If the spatial reference system (srid) of the `acurve` geometry is not the same as the topology an exception is thrown.

Availability: 2.0

This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.12

## Examples

## See Also

ST_RemEdgeNewFace

ST_AddEdgeModFace

Prev | Up | Next
ST_AddIsoEdge | Home | ST_AddEdgeModFace