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:
|
|||