PostGIS  2.4.9dev-r@@SVN_REVISION@@

◆ touches()

Datum touches ( PG_FUNCTION_ARGS  )

Definition at line 2508 of file postgis/lwgeom_geos.c.

References disjoint(), error_if_srid_mismatch(), errorIfGeometryCollection(), FALSE, gbox_overlaps_2d(), gserialized_get_gbox_p(), gserialized_get_srid(), gserialized_is_empty(), HANDLE_GEOS_ERROR, LW_FALSE, lwgeom_geos_error(), PG_FUNCTION_INFO_V1(), and POSTGIS2GEOS().

Referenced by geos_intersects().

2509 {
2510  GSERIALIZED *geom1;
2511  GSERIALIZED *geom2;
2512  GEOSGeometry *g1, *g2;
2513  char result;
2514  GBOX box1, box2;
2515 
2516  geom1 = PG_GETARG_GSERIALIZED_P(0);
2517  geom2 = PG_GETARG_GSERIALIZED_P(1);
2518 
2519  errorIfGeometryCollection(geom1,geom2);
2521 
2522  /* A.Touches(Empty) == FALSE */
2523  if ( gserialized_is_empty(geom1) || gserialized_is_empty(geom2) )
2524  PG_RETURN_BOOL(false);
2525 
2526  /*
2527  * short-circuit 1: if geom2 bounding box does not overlap
2528  * geom1 bounding box we can prematurely return FALSE.
2529  */
2530  if ( gserialized_get_gbox_p(geom1, &box1) &&
2531  gserialized_get_gbox_p(geom2, &box2) )
2532  {
2533  if ( gbox_overlaps_2d(&box1, &box2) == LW_FALSE )
2534  {
2535  PG_RETURN_BOOL(FALSE);
2536  }
2537  }
2538 
2539  initGEOS(lwpgnotice, lwgeom_geos_error);
2540 
2541  g1 = (GEOSGeometry *)POSTGIS2GEOS(geom1 );
2542  if ( 0 == g1 ) /* exception thrown at construction */
2543  {
2544  HANDLE_GEOS_ERROR("First argument geometry could not be converted to GEOS");
2545  PG_RETURN_NULL();
2546  }
2547 
2548  g2 = (GEOSGeometry *)POSTGIS2GEOS(geom2 );
2549  if ( 0 == g2 ) /* exception thrown at construction */
2550  {
2551  HANDLE_GEOS_ERROR("Second argument geometry could not be converted to GEOS");
2552  GEOSGeom_destroy(g1);
2553  PG_RETURN_NULL();
2554  }
2555 
2556  result = GEOSTouches(g1,g2);
2557 
2558  GEOSGeom_destroy(g1);
2559  GEOSGeom_destroy(g2);
2560 
2561  if (result == 2)
2562  {
2563  HANDLE_GEOS_ERROR("GEOSTouches");
2564  PG_RETURN_NULL(); /* never get here */
2565  }
2566 
2567  PG_FREE_IF_COPY(geom1, 0);
2568  PG_FREE_IF_COPY(geom2, 1);
2569 
2570  PG_RETURN_BOOL(result);
2571 }
int gserialized_get_gbox_p(const GSERIALIZED *g, GBOX *box)
Read the bounding box off a serialization and calculate one if it is not already there.
Definition: g_serialized.c:642
void error_if_srid_mismatch(int srid1, int srid2)
Definition: lwutil.c:371
int gserialized_is_empty(const GSERIALIZED *g)
Check if a GSERIALIZED is empty without deserializing first.
Definition: g_serialized.c:179
void lwgeom_geos_error(const char *fmt,...)
#define LW_FALSE
Definition: liblwgeom.h:77
int gbox_overlaps_2d(const GBOX *g1, const GBOX *g2)
Return LW_TRUE if the GBOX overlaps on the 2d plane, LW_FALSE otherwise.
Definition: g_box.c:335
#define FALSE
Definition: dbfopen.c:168
GEOSGeometry * POSTGIS2GEOS(GSERIALIZED *pglwgeom)
#define HANDLE_GEOS_ERROR(label)
int32_t gserialized_get_srid(const GSERIALIZED *s)
Extract the SRID from the serialized form (it is packed into three bytes so this is a handy function)...
Definition: g_serialized.c:100
void errorIfGeometryCollection(GSERIALIZED *g1, GSERIALIZED *g2)
Throws an ereport ERROR if either geometry is a COLLECTIONTYPE.
Here is the call graph for this function:
Here is the caller graph for this function: