Definition
ST_Within returns 1 (Oracle and SQLite) or t (PostgreSQL) if the first ST_Geometry object is completely inside the second; otherwise, it returns 0 (Oracle and SQLite) or f (PostgreSQL).
Syntax
Oracle and PostgreSQL
sde.st_within (geometry1 sde.st_geometry, geometry2 sde.st_geometry)
SQLite
st_within (geometry1 geometryblob, geometry2 geometryblob)
Return type
Boolean
Example
In the example below, two tables are created: zones and squares. The SELECT statement finds all squares that intersect but are not completely within a lot.
Oracle
CREATE TABLE squares (
id integer,
shape sde.st_geometry);
CREATE TABLE zones (
id integer,
shape sde.st_geometry);
INSERT INTO squares (id, shape) VALUES (
1,
sde.st_polygon ('polygon ((0 0, 0 10, 10 10, 10 0, 0 0))', 4326)
);
INSERT INTO squares (id, shape) VALUES (
2,
sde.st_polygon ('polygon ((20 0, 20 10, 30 10, 30 0, 20 0))', 4326)
);
INSERT INTO squares (id, shape) VALUES (
3,
sde.st_polygon ('polygon ((40 0, 40 10, 50 10, 50 0, 40 0))', 4326)
);
INSERT INTO zones (id, shape) VALUES (
1,
sde.st_polygon ('polygon ((-1 -1, -1 11, 11 11, 11 -1, -1 -1))', 4326)
);
INSERT INTO zones (id, shape) VALUES (
2,
sde.st_polygon ('polygon ((19 -1, 19 11, 29 9, 31 -1, 19 -1))', 4326)
);
INSERT INTO zones (id, shape) VALUES (
3,
sde.st_polygon ('polygon ((39 -1, 39 11, 51 11, 51 -1, 39 -1))', 4326)
);
SELECT s.id sq_id
FROM SQUARES s, ZONES z
WHERE sde.st_intersects (s.shape, z.shape) = 1
AND sde.st_within (s.shape, z.shape) = 0;
SQ_ID
2
PostgreSQL
CREATE TABLE squares (
id integer,
shape sde.st_geometry);
CREATE TABLE zones (
id integer,
shape sde.st_geometry);
INSERT INTO squares (id, shape) VALUES (
1,
sde.st_polygon ('polygon ((0 0, 0 10, 10 10, 10 0, 0 0))', 4326)
);
INSERT INTO squares (id, shape) VALUES (
2,
sde.st_polygon ('polygon ((20 0, 20 10, 30 10, 30 0, 20 0))', 4326)
);
INSERT INTO squares (id, shape) VALUES (
3,
sde.st_polygon ('polygon ((40 0, 40 10, 50 10, 50 0, 40 0))', 4326)
);
INSERT INTO zones (id, shape) VALUES (
1,
sde.st_polygon ('polygon ((-1 -1, -1 11, 11 11, 11 -1, -1 -1))', 4326)
);
INSERT INTO zones (id, shape) VALUES (
2,
sde.st_polygon ('polygon ((19 -1, 19 11, 29 9, 31 -1, 19 -1))', 4326)
);
INSERT INTO zones (id, shape) VALUES (
3,
sde.st_polygon ('polygon ((39 -1, 39 11, 51 11, 51 -1, 39 -1))', 4326)
);
SELECT s.id
AS sq_id
FROM squares s, zones z
WHERE st_intersects (s.shape, z.shape) = 't'
AND st_within (s.shape, z.shape) = 'f';
sq_id
2
SQLite
CREATE TABLE squares (
id integer
);
SELECT AddGeometryColumn(
NULL,
'squares',
'shape',
4326,
'polygon',
'xy',
'null'
);
CREATE TABLE zones (
id integer
);
SELECT AddGeometryColumn(
NULL,
'zones',
'shape',
4326,
'polygon',
'xy',
'null'
);
INSERT INTO squares (id, shape) VALUES (
1,
st_polygon ('polygon ((0 0, 0 10, 10 10, 10 0, 0 0))', 4326)
);
INSERT INTO squares (id, shape) VALUES (
2,
st_polygon ('polygon ((20 0, 20 10, 30 10, 30 0, 20 0))', 4326)
);
INSERT INTO squares (id, shape) VALUES (
3,
st_polygon ('polygon ((40 0, 40 10, 50 10, 50 0, 40 0))', 4326)
);
INSERT INTO zones (id, shape) VALUES (
1,
st_polygon ('polygon ((-1 -1, -1 11, 11 11, 11 -1, -1 -1))', 4326)
);
INSERT INTO zones (id, shape) VALUES (
2,
st_polygon ('polygon ((19 -1, 19 11, 29 9, 31 -1, 19 -1))', 4326)
);
INSERT INTO zones (id, shape) VALUES (
3,
st_polygon ('polygon ((39 -1, 39 11, 51 11, 51 -1, 39 -1))', 4326)
);
SELECT s.id
AS "sq_id"
FROM squares s, zones1 z
WHERE st_intersects (s.shape, z.shape) = 1
AND st_within (s.shape, z.shape) = 0;
sq_id
2