目的
Latin文字セットの文字列で表現したジオメトリのWKT (Well-Known Text)を使用してジオメトリ型の値を設定します。
構文規則
void FNC_GeomGetWKT(GEO_HANDLE geoHandle, unsigned char* wkt, FNC_GeomSize_t wktSize, int srid)
- GEO_HANDLE geoHandle
- UDF/UDMの戻り値であると定義されているか、または外部ストアド プロシージャに対するINOUT/OUTパラメータであると定義されている、ジオメトリ型へのハンドル。
- unsigned char* wkt
- Latin文字セットのWKT文字列へのポインタ。
- FNC_GeomSize_t wktSize
- WKT文字列のバイト単位のサイズ。
- int srid
- 設定するジオメトリの空間参照系の識別子。
使用上の注意
FNC_GeomSetWKT関数は、 WKT文字列表現を使用してジオメトリの値を設定します。ジオメトリに対して設定されるWKT文字列、wktSize、およびSRIDを含むwktパラメータが入力として渡されます。
FNC_GeomSetWKT関数はインラインST_Geometry値に対してのみ呼び出す必要があります。LOBベースのST_Geometry値と使用されると、次の7579エラーが発生します: FNC_GeomSetWKTは、インラインのST_Geometry値に対してのみ有効です
例: 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);
}
}