GET_LINEは、行末または入力終了が検出されるまで読み取ったテキスト行データを返します。
機能の適用範囲
この内容はOceanBaseデータベースのOracleモードでのみ適用されます。
構文
UTL_TCP.GET_LINE (
c IN OUT NOCOPY connection,
remove_crlf IN BOOLEAN DEFAULT FALSE,
peek IN BOOLEAN DEFAULT FALSE)
RETURN VARCHAR2;
パラメータの説明
パラメータ |
説明 |
|---|---|
| c | TCP/IP接続。 |
| remove_crlf | trueの場合、行末の1つまたは複数のCRLF改行文字を削除します。 |
| peek | trueの場合、データを確認しますが、入力キューからは削除しません(入力バッファが存在する必要があります)。 |
戻り値
読み取ったテキスト行の内容を返します。
使用方法
open_connectionで既に開いている接続である必要があります。- この関数は、行末または入力終了が検出されるまで戻りません。
- メッセージテキストは、接続時のオンライン文字セットからデータベース文字セットに変換された後、返されます。
- 接続時に転送タイムアウトが設定されている場合、この関数はデータパケットの読み取りを継続して待機し、タイムアウトが発生すると読み取りを停止し、正常に読み取ったすべてのデータを返します。いずれのデータも正常に読み取れない場合は、
transfer_timeout例外が発生します。