Appends all or part of 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. |
| offset | The offset into the str argument at which to start reading the characters to append. |
| len | The number of characters from the str argument to append to the CLOB value. |
Return Value
If successful, setString() returns the number of characters appended.
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 JVM cannot allocate enough memory for the method to write the string to the Clob | indicate that available JVM heap memory has run out, setting the SQLException fields as follows:
|
|||
one of the following:
|
indicate that a Java external routine called a Blob or Clob method with an invalid argument, setting the SQLException fields as follows:
|
|||