Name

st_may_contain, st_get_chainbox, st_dv_geo_length — spatial-index and storage-layer helpers

Synopsis

integer st_may_contain( in outer any,
  in inner any,
  in precision double precision);
 
any st_get_chainbox( in geom any);
 
integer st_dv_geo_length( in buf varbinary);
 

Description

st_may_contain is the index-friendly cheap upper-bound counterpart of st_contains. It returns 1 if outer might contain inner based on bounding-box and chain-box tests, and 0 when it definitely cannot. False positives are possible, false negatives are not, so the function is suitable as a pre-filter before the expensive exact st_contains check. The optional precision argument controls how tight the bounding test is.

st_get_chainbox returns the array of bounding boxes that make up the geometry's spatial-index chain-box decomposition, or SQL NULL when the geometry has no chain-box cache. Each element of the returned vector is itself a BOX geometry inheriting the SRID and float/double flag of the input. Mainly useful for debugging spatial-index behaviour and for diagnostic visualisations.

st_dv_geo_length returns the on-disk length in bytes of the serialized geometry contained in the raw row-encoding buf, counting both the header and the payload. This is a storage-engine helper used while walking row-formatted data and is not normally invoked from application code.


© 1992 - OpenLink Software. All rights reserved.

Making Technology Work for You®