Appends the given string to the end of the CLOB value that this Clob object represents and returns the number of characters written.
Arguments
Argument | Description |
---|---|
pos | Reserved for future use. |
str | The string to append to the CLOB value that this Clob object represents. |
Return Value
If successful, setString() returns the number of characters written.
Exceptions
IF … | THEN setString() throws an SQLException to … | |||
---|---|---|---|---|
there is an error accessing the CLOB value | indicate a failure while writing data into a LOB, setting the SQLException fields as follows:
|
|||
the str argument is null -or- the value of the pos argument is less than 1 |
indicate that a Java external routine called a Blob or Clob method with invalid arguments, setting the SQLException fields as follows:
|
|||
the JVM cannot allocate enough memory for the method to write the string to the Clob | indicate that the available JVM heap memory has run out, setting the SQLException fields as follows:
|