Available in versions: Dev (3.18) | Latest (3.17) | 3.16

This documentation is for the unreleased development version of jOOQ. Click on the above version links to get this documentation for a supported version of jOOQ.

ST_NumInteriorRings

Applies to ❌ Open Source Edition   ✅ Express Edition   ✅ Professional Edition   ✅ Enterprise Edition

This function returns the number of interior rings of a polygon geometry. For example:

create.select(stNumInteriorRings(
  stGeomFromText("""
    POLYGON (
      (-3 -3, 3 -3, 3 3, -3 3, -3 -3),
      (-2 -2, 2 -2, 2 2, -2 2, -2 -2), 
      (-1 -1, 1 -1, 1 1, -1 1, -1 -1)
    )
  """)
)).fetch();

The result being, for example

+---------------------+
| ST_NumInteriorRings |
+---------------------+
| 2                   |
+---------------------+

To access the Nth interior ring (1-based), use ST_InteriorRingN.

Dialect support

This example using jOOQ:

stNumInteriorRings(geometry)

Translates to the following dialect specific expressions:

-- AURORA_MYSQL, AURORA_POSTGRES, COCKROACHDB, MYSQL, POSTGRES, REDSHIFT
st_numinteriorring(geometry)

-- MARIADB
st_numinteriorrings(geometry)

-- ORACLE
(
  SELECT (nullif(
    count(*),
    0
  ) - 1)
  FROM table(sdo_util.extract_all(geometry))
)

-- SQLSERVER
geometry.STNumInteriorRing()

-- ACCESS, ASE, BIGQUERY, DB2, DERBY, EXASOL, FIREBIRD, H2, HANA, HSQLDB, INFORMIX, MEMSQL, SNOWFLAKE, SQLDATAWAREHOUSE, 
-- SQLITE, SYBASE, TERADATA, VERTICA, YUGABYTEDB
/* UNSUPPORTED */

(These are currently generated with jOOQ 3.18, see #10141), or translate your own on our website

Feedback

Do you have any feedback about this page? We'd love to hear it!

The jOOQ Logo