GET_TEXTは読み取ったテキストデータを返すために使用されます。
適用対象
この内容はOceanBaseデータベースのOracleモードにのみ適用されます。
構文
UTL_TCP.GET_TEXT (
c IN OUT NOCOPY connection,
len IN PLS_INTEGER DEFAULT 1,
peek IN BOOLEAN DEFAULT FALSE)
RETURN VARCHAR2;
パラメータの説明
| パラメータ | 説明 |
|---|---|
| c | TCP/IP接続。 |
| len | 受信する文字数。デフォルト値は1です。 |
| peek | true の場合、データを確認しますが、入力キューからは削除されません（入力バッファが存在する必要があります）。 |
戻り値
読み取ったテキスト行の内容を返します。
使用方法
open_connectionで既に接続が開いている必要があります。- 明示的に書き換えない限り、バッファサイズはバイト数です。パラメータ
lenでは、読み取る最大文字数を指定します。バッファサイズは少なくとも1文字を収容できるようにする必要があります。通常、バッファサイズは読み取る必要がある文字数 × 単一文字の最大バイト数に設定するべきです。 - メッセージテキストは、接続を開いた時点でのオンライン文字セットからデータベースの文字セットに変換されてから返されます。
- 接続を開く際に転送タイムアウトが設定されている場合、この関数はタイムアウトが発生するまでデータパケットの読み取りを継続し、読み取りを停止して正常に読み取ったすべてのデータを返します。データが正常に読み取れない場合は、
transfer_timeout例外が発生します。