GET_TEXT

GET_TEXTは、読み取ったテキストデータを返すために使用されます。

構文

UTL_TCP.GET_TEXT (
   c    IN OUT NOCOPY connection,
   len  IN            PLS_INTEGER DEFAULT 1,
   peek IN            BOOLEAN     DEFAULT FALSE)
 RETURN VARCHAR2;

パラメータの説明

戻り値

読み取ったテキスト行の内容を返します。

使用方法

• open_connectionで既に開いている接続である必要があります。
• 明示的に上書きしない限り、バッファサイズはバイト数です。パラメータlenは、読み取る最大文字数を指定します。バッファサイズは少なくとも1文字を収容できるようにする必要があります。通常、バッファサイズは読み取る文字数 × 単一文字の最大バイト数に設定する必要があります。
• メッセージテキストは、接続を開いたときのオンライン文字セットからデータベース文字セットに変換された後、返されます。
• 接続を開く際に転送タイムアウトが設定されている場合、この関数はデータパケットの読み取りをタイムアウトが発生するまで継続的に待機し、読み取りを停止して、正常に読み取ったすべてのデータを返します。いかなるデータも正常に読み取れない場合は、transfer_timeout例外が発生します。