User's Guide and Reference

ST_MPolyFromWKB

ST_MPolyFromWKB takes a well-known binary representation of type multipolygon and a spatial reference system identity and returns a multipolygon.

Syntax

db2gse.ST_MPolyFromWKB(WKBMultiPolygon Blob(1M), cr db2gse.coordref)

Return type

db2gse.ST_MultiPolygon

Examples

The following code fragment populates the LOTS table.

The LOTS table stores the LOT_ID, which uniquely identifies each lot, and the LOT multipolygon, which contains the lot line geometry.

CREATE TABLE LOTS (lot_id   integer, lot   db2gse.ST_MultiPolygon);
 
/* Create the SQL insert statement to populate the lot_id, and lot. The
   question marks are parameter markers that indicate the lot_id, and lot
   values that will be retrieved at runtime. */
strcpy (wkb_sql,"insert into LOTS (lot_id,lot)
values (?, db2gse.ST_MPolyFromWKB (cast(? as blob(1m)),
db2gse.coordref()..srid(0)))");
 
/* Allocate memory for the SQL statement handle and associate the
   statement handle with the connection handle. */
rc = SQLAllocStmt (handle, &hstmt);
 
/* Prepare the SQL statement for execution. */
rc = SQLPrepare (hstmt, (unsigned char *)wkb_sql, SQL_NTS);
 
/* Bind the lot_id integer value to the first parameter. */
pcbvalue1 = 0;
rc = SQLBindParameter (hstmt, 1, SQL_PARAM_INPUT, SQL_C_INTEGER,
     SQL_INTEGER, 0, 0, &lot_id, 0, &pcbvalue1);
 
/* Bind the lot shape to the second parameter. */
pcbvalue2 = lot_len;
rc = SQLBindParameter (hstmt, 2, SQL_PARAM_INPUT, SQL_C_BINARY,
     SQL_BLOB, lot_len, 0, lot_wkb, lot_len, &pcbvalue2);
 
/* Execute the insert statement. */
rc = SQLExecute (hstmt);


[ Top of Page | Previous Page | Next Page ]