ST_Geometry値のサイズおよびその値がLOBとして保存されるかを含め、ST_Geometry値に関する情報を返します。
構文
void FNC_GetGeometryInfo(GEO_HANDLE geoHandle, FNC_GeomSize_t *maxLength, int *numLobs)
構文要素
- geoHandle
- 外部ルーチンへの入力または出力パラメータとして定義されたST_Geometry型へのハンドル。
- maxLength
- このST_Geometry値に対して有効な最大長。
- numLobs
- このST_Geometryオブジェクトがその値をLOBとして保存する場合、numLobsは1、その他の場合、numLobsは0です。
使用上の注意
FNC_GetGeomInfoは、最大サイズなど、ST_Geometry値に関する情報と、その値を保存するためにLOBが使用されるかどうかを返します。ST_Geometry値のGEO_HANDLEは入力として渡され、最大サイズと、その値をLOBとして保存できるかどうかが呼び出し側に返されます。
例: FNC_GeomGetWKTを使用してST_Geometry WKTを取得する
次の例の関数では、ST_Geometryパラメータを取り、ジオメトリのWell Known Text形式を取得します。文字列をST_Geometry戻りパラメータで返します。
CREATE FUNCTION geomUDF1(P1 st_geometry(1000))
RETURNS ST_GEOMETRY(1000)
NO SQL
PARAMETER STYLE SQL
DETERMINISTIC
LANGUAGE C
EXTERNAL NAME 'CS!geomUDF1!geomUDF1.c';
void geomUDF1(GEO_HANDLE* geom_handle,
GEO_HANDLE* return_handle,
int* indicator_thisGeom,
int* indicator_returnGeom,
char sqlstate[6],
SQL_TEXT extname[129],
SQL_TEXT specific_name[129],
SQL_TEXT error_message[257] )
{
FNC_GeomSize_t geomsize;
FNC_GeomSize_t wktSize;
char* wktBuffer;
FNC_GeomSize_t wktBufferSize;
int srid , max_length, numLobs;
/* Get the Geometry Info */
FNC_GetGeometryInfo(*geom_handle,&max_length, &numLobs);
if(numLobs == 0)
{
/* Get the Geometry WKT Size */
geomsize = FNC_GeomGetWKTSize(*geom_handle);
/* Allocate the buffer to hold the WKT. Note that we add
1 for the null termination character. */
wktBuffer = (char*)FNC_Malloc(geomsize + 1);
wktBufferSize = geomsize + 1;
/* Get the WKT string */
FNC_GeomGetWKT(*geom_handle,wktBuffer, wktBufferSize,
&wktSize, &srid);
/* Set the WKT string as return value */
FNC_GeomSetWKT(*return_handle, wktBuffer, wktSize,0);
*indicator_returnGeom = 0;
FNC_free(wkbBuffer);
}
}