contains()

Datum contains

(

PG_FUNCTION_ARGS

)

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

{
        SHARED_GSERIALIZED *shared_geom1 = ToastCacheGetGeometry(fcinfo, 0);
        SHARED_GSERIALIZED *shared_geom2 = ToastCacheGetGeometry(fcinfo, 1);
        const GSERIALIZED *geom1 = shared_gserialized_get(shared_geom1);
        const GSERIALIZED *geom2 = shared_gserialized_get(shared_geom2);
        int result;
        GEOSGeometry *g1, *g2;
        GBOX box1, box2;
        PrepGeomCache *prep_cache;
        gserialized_error_if_srid_mismatch(geom1, geom2, __func__);
 
        /* A.Contains(Empty) == FALSE */
        if (gserialized_is_empty(geom1) || gserialized_is_empty(geom2))
                PG_RETURN_BOOL(false);
 
        POSTGIS_DEBUG(3, "contains called.");
 
        /*
        ** short-circuit 1: if geom2 bounding box is not completely inside
        ** geom1 bounding box we can return FALSE.
        */
        if (gserialized_get_gbox_p(geom1, &box1) &&
            gserialized_get_gbox_p(geom2, &box2))
        {
                if (!gbox_contains_2d(&box1, &box2))
                        PG_RETURN_BOOL(false);
        }
 
        /*
        ** short-circuit 2: if geom2 is a point and geom1 is a polygon
        ** call the point-in-polygon function.
        */
        if (is_poly(geom1) && is_point(geom2))
        {
                SHARED_GSERIALIZED *shared_gpoly = is_poly(geom1) ? shared_geom1 : shared_geom2;
                SHARED_GSERIALIZED *shared_gpoint = is_point(geom1) ? shared_geom1 : shared_geom2;
                const GSERIALIZED *gpoly = shared_gserialized_get(shared_gpoly);
                const GSERIALIZED *gpoint = shared_gserialized_get(shared_gpoint);
                RTREE_POLY_CACHE *cache = GetRtreeCache(fcinfo, shared_gpoly);
                int retval;
 
                POSTGIS_DEBUG(3, "Point in Polygon test requested...short-circuiting.");
                if (gserialized_get_type(gpoint) == POINTTYPE)
                {
                        LWGEOM* point = lwgeom_from_gserialized(gpoint);
                        int pip_result = pip_short_circuit(cache, lwgeom_as_lwpoint(point), gpoly);
                        lwgeom_free(point);
 
                        retval = (pip_result == 1); /* completely inside */
                }
                else if (gserialized_get_type(gpoint) == MULTIPOINTTYPE)
                {
                        LWMPOINT* mpoint = lwgeom_as_lwmpoint(lwgeom_from_gserialized(gpoint));
                        int found_completely_inside = LW_FALSE;
 
                        retval = LW_TRUE;
                        for (uint32_t i = 0; i < mpoint->ngeoms; i++)
                        {
                                int pip_result;
                                LWPOINT* pt = mpoint->geoms[i];
                                /* We need to find at least one point that's completely inside the
                                 * polygons (pip_result == 1).  As long as we have one point that's
                                 * completely inside, we can have as many as we want on the boundary
                                 * itself. (pip_result == 0)
                                 */
                                if (lwpoint_is_empty(pt)) continue;
                                pip_result = pip_short_circuit(cache, pt, gpoly);
                                if (pip_result == 1)
                                        found_completely_inside = LW_TRUE;
 
                                if (pip_result == -1) /* completely outside */
                                {
                                        retval = LW_FALSE;
                                        break;
                                }
                        }
 
                        retval = retval && found_completely_inside;
                        lwmpoint_free(mpoint);
                }
                else
                {
                        /* Never get here */
                        elog(ERROR,"Type isn't point or multipoint!");
                        PG_RETURN_BOOL(false);
                }
 
                return retval > 0;
        }
        else
        {
                POSTGIS_DEBUGF(3, "Contains: type1: %d, type2: %d", gserialized_get_type(geom1), gserialized_get_type(geom2));
        }
 
        initGEOS(lwpgnotice, lwgeom_geos_error);
 
        prep_cache = GetPrepGeomCache(fcinfo, shared_geom1, NULL);
 
        if ( prep_cache && prep_cache->prepared_geom && prep_cache->gcache.argnum == 1 )
        {
                g1 = POSTGIS2GEOS(geom2);
                if (!g1)
                        HANDLE_GEOS_ERROR("Geometry could not be converted to GEOS");
 
                POSTGIS_DEBUG(4, "containsPrepared: cache is live, running preparedcontains");
                result = GEOSPreparedContains( prep_cache->prepared_geom, g1);
                GEOSGeom_destroy(g1);
        }
        else
        {
                g1 = POSTGIS2GEOS(geom1);
                if (!g1) HANDLE_GEOS_ERROR("First argument geometry could not be converted to GEOS");
                g2 = POSTGIS2GEOS(geom2);
                if (!g2)
                {
                        HANDLE_GEOS_ERROR("Second argument geometry could not be converted to GEOS");
                        GEOSGeom_destroy(g1);
                }
                POSTGIS_DEBUG(4, "containsPrepared: cache is not ready, running standard contains");
                result = GEOSContains( g1, g2);
                GEOSGeom_destroy(g1);
                GEOSGeom_destroy(g2);
        }
 
        if (result == 2) HANDLE_GEOS_ERROR("GEOSContains");
 
        PG_RETURN_BOOL(result > 0);
}

References gbox_contains_2d(), PrepGeomCache::gcache, LWMPOINT::geoms, GetPrepGeomCache(), GetRtreeCache(), gserialized_error_if_srid_mismatch(), gserialized_get_gbox_p(), gserialized_get_type(), gserialized_is_empty(), HANDLE_GEOS_ERROR, is_point(), is_poly(), LW_FALSE, LW_TRUE, lwgeom_as_lwmpoint(), lwgeom_as_lwpoint(), lwgeom_free(), lwgeom_from_gserialized(), lwgeom_geos_error(), lwmpoint_free(), lwpoint_is_empty(), MULTIPOINTTYPE, LWMPOINT::ngeoms, pip_short_circuit(), POINTTYPE, POSTGIS2GEOS(), PrepGeomCache::prepared_geom, and result.

Referenced by _lwt_AddFaceSplit(), _lwt_AddPoint(), _lwt_CheckEdgeCrossing(), _lwt_FindFaceContainingRing(), lwpoly_split_by_line(), lwpoly_to_points(), rt_raster_contains(), rt_raster_contains_properly(), and within().

Here is the call graph for this function:

Here is the caller graph for this function: