Get_raw
is a function that reads data and returns it as a RAW. The
peek parameter allows one to look ahead in the buffer
without actually consuming the message. The
len parameter allows specifying the number of bytes to
get.
|
Argument
|
Type
|
In / Out
|
Default Value
|
|
C
|
UTL_TCP.CONNECTION
|
IN | OUT
|
|
|
LEN
|
BOOLEAN
|
IN
|
1
|
|
PEEK
|
BOOLEAN
|
IN
|
FALSE
|
Table 6.162:
Get_raw Parameters
Get_text
is a function that reads data, and returns it as a VARCHAR2.
|
Argument
|
Type
|
In / Out
|
Default Value
|
|
C
|
UTL_TCP.CONNECTION
|
IN | OUT
|
|
|
LEN
|
BOOLEAN
|
IN
|
1
|
|
PEEK
|
BOOLEAN
|
IN
|
FALSE
|
Table 6.163:
Get_text Parameters
Get_text_nchar
is a function that reads data and returns it as an NVARCHAR2.
|
Argument
|
Type
|
In / Out
|
Default Value
|
|
C
|
UTL_TCP.CONNECTION
|
IN | OUT
|
|
|
LEN
|
BOOLEAN
|
IN
|
1
|
|
PEEK
|
BOOLEAN
|
IN
|
FALSE
|
Table 6.164:
Get_text_nchar Parameters
Open_connection
is a function that simply opens a TCP/IP connection. It returns that
connection information as type
utl_tcp.connection..
|
Argument
|
Type
|
In / Out
|
Default Value
|
|
REMOTE_HOST
|
VARCHAR2
|
IN
|
|
|
REMOTE_PORT
|
PLS_INTEGER
|
IN
|
|
|
LOCAL_HOST
|
VARCHAR2
|
IN
|
NULL
|
|
LOCAL_PORT
|
PLS_INTEGER
|
IN
|
NULL
|
|
IN_BUFFER_SIZE
|
PLS_INTEGER
|
IN
|
NULL
|
|
OUT_BUFFER_SIZE
|
PLS_INTEGER
|
IN
|
NULL
|
|
CHARSET
|
VARCHAR2
|
IN
|
NULL
|
|
NEWLINE
|
VARCHAR2
|
IN
|
CRLF
|
|
TX_TIMEOUT
|
PLS_INTEGER
|
IN
|
NULL
|
Table 6.165:
Open_connection Parameters
Read_line
is a function that reads a line of data from a service and returns a
pls_integer for the number of characters read. The
peek parameter allows one to look ahead in the buffer
without actually consuming the message.
|
Argument
|
Type
|
In / Out
|
Default Value
|
|
C
|
UTL_TCP.CONNECTION
|
IN | OUT
|
|
|
DATA
|
VARCHAR2
|
IN | OUT
|
|
|
PEEK
|
BOOLEAN
|
IN
|
FALSE
|
Table 6.166:
Read_line Parameters
Read_raw
is a function that reads a line of data from a service and returns a
pls_integer for the number of bytes read.
|
Argument
|
Type
|
In / Out
|
Default Value
|
|
C
|
UTL_TCP.CONNECTION
|
IN | OUT
|
|
|
DATA
|
RAW
|
IN | OUT
|
|
|
LEN
|
PLS_INTEGER
|
IN
|
1
|
|
PEEK
|
BOOLEAN
|
IN
|
FALSE
|
Table 6.167:
Read_raw parameters
Read_text
is a function that reads a line of data from a service and returns a
pls_integer for the number of characters read.
|
Argument
|
Type
|
In / Out
|
Default Value
|
|
C
|
UTL_TCP.CONNECTION
|
IN | OUT
|
|
|
DATA
|
VARCHAR2
|
IN | OUT
|
|
|
LEN
|
PLS_INTEGER
|
IN
|
1
|
|
PEEK
|
BOOLEAN
|
IN
|
FALSE
|
Table 6.168:
Read_text Parameters
Write_line
is a function that transmits a line of data to a service and returns a
pls_integer for the number of characters sent.
|
Argument
|
Type
|
In / Out
|
Default Value
|
|
C
|
UTL_TCP.CONNECTION
|
IN | OUT
|
|
|
DATA
|
VARCHAR2
|
IN | OUT
|
|
Table 6.169:
Write_line Parameters
Write_raw
is a function that transmits a line of data to a service and returns a
pls_integer for the number of bytes sent.
|
Argument
|
Type
|
In / Out
|
Default Value
|
|
C
|
UTL_TCP.CONNECTION
|
IN | OUT
|
|
|
DATA
|
RAW
|
IN | OUT
|
|
|
LEN
|
PLS_INTEGER
|
IN
|
1
|
Table 6.170:
Write_raw Parameters
Write_text
is a function that transmits a line of data from a service and returns
a
pls_integer for the number of characters sent.
|
Argument
|
Type
|
In / Out
|
Default Value
|
|
C
|
UTL_TCP.CONNECTION
|
IN | OUT
|
|
|
DATA
|
VARCHAR2
|
IN | OUT
|
|
|
LEN
|
PLS_INTEGER
|
IN
|
1
|
Table 6.171:
Write_text Parameters
For more
information concerning this utility from the developer’s point of
view, please refer to Chapter 9.
