write_text Function

This function transmits a text message to a service on an open connection.

Syntax

UTL_TCP.WRITE_TEXT (c    IN OUT NOCOPY connection,
                    data IN            VARCHAR2,
                    len  IN            PLS_INTEGER DEFAULT NULL) 
                                       RETURN PLS_INTEGER;

Table 83-9 write_text Function Parameters

Parameter	Description
c (IN OUT NOCOPY)	The TCP connection to send data to.
data (IN)	The buffer containing the data to be sent.
len (IN)	The number of characters of data to transmit. When len is NULL, the whole length of data is written. The actual amount of data written may be less because of network condition.
return value	The actual number of characters of data transmitted.

Usage Notes

The connection must have already been opened via a call to open_connection(). Text messages will be converted to the on-the-wire character set, specified when the connection was opened, before they are transmitted on the wire.

Related Functions

write_raw(), write_line(), flush()